Pinterest Tag : installation et aide

Suivez les étapes de la section Démarrage rapide.

Ouvrez "Configure" dans le gestionnaire de modules. Vous avez besoin d'un tag Pinterest et, pour l'envoi serveur, d'un compte publicitaire et d'un jeton d'accès aux conversions pour la destination prévue.

Le tag navigateur exige aussi l’autorisation de données de correspondance, car Pinterest peut réaliser une correspondance automatique. Le seul consentement au stockage/à la catégorie ne suffit pas. Le consentement est lu depuis Cookies Revolution, Cookie Banner, Cookiebot, OneTrust et TCF. Le suivi reste suspendu jusqu’à l’octroi des autorisations requises. Configurez vos décisions de service et de correspondance dans votre CMP.

L'intégration vérifie aussi la politique du personnel/d'exclusion volontaire, la propriété de la destination, les règles de sortie et la sécurité du contexte de page. Un autre pintrk initialisé indépendamment ne peut pas servir de preuve de la destination prévue. Supprimez les chargeurs en double.

Événements standard

Toutes les options standard sont sur Oui par défaut. Désactivez celles qui sont inutiles.

Les événements produit comprennent l'identité catalogue, le nom, la catégorie et le prix disponibles. Les achats comprennent la valeur, la devise, l'identifiant de commande, les lignes d'articles, la quantité et un identifiant d'événement stable comme mprpntg_checkout_order_ORDER_ID. Les variations de panier confirmées contiennent la quantité confirmée ; un clic seul ne fournit pas le prix ou la valeur actuels.

Le module charge https://s.pinimg.com/ct/core.js une fois le consentement et les autres conditions de suivi réunis. Il n’ajoute pas de pixel de suivi noscript.

Valeur d'achat

Les trois options sont sur Non par défaut :

Réglez-les délibérément et comparez une commande test remisée avec taxes et livraison à la charge utile obtenue. Les valeurs par défaut ne correspondent donc pas au montant final payé taxes comprises.

"Track phone-link clicks", "Track actual chat starts", "Track successful contact forms" et "Track product engagement" sont sur Non par défaut. Les clics téléphoniques et les démarrages effectifs compatibles de chat Tawk utilisent des signaux de contact. Les formulaires nécessitent un justificatif confirmé par le serveur ; cliquer sur Envoyer ne suffit pas.

"Send confirmed forms through the server API" est aussi sur Non par défaut. Les conversions de formulaire serveur ne sont pas envoyées, car ces justificatifs de contact ne contiennent pas les données de correspondance exigées par Pinterest. Les signaux de formulaire navigateur sont traités séparément.

Utilisez "Product engagement thresholds" pour la configuration JSON. Les valeurs par défaut sont 3 interactions avec la galerie, 1 changement de déclinaison, 1 interaction avec les détails ou 45 secondes, avec une limitation des options de 1500 ms. Les compteurs acceptent de 1 à 20, la durée de consultation de 5 à 600 secondes et la limitation de 250 à 60000 ms. L'événement d'intention élevée par défaut est limité par produit/session lorsque le stockage est autorisé.

"Track custom events" est sur Non par défaut. "Custom event rules" est initialement vide. Ajoutez vos règles, activez l'option et enregistrez. Utilisez des noms de 1 à 100 lettres, chiffres, traits de soulignement ou traits d'union.

[
  {"event":"GalleryBrowse","trigger":"click","selector":".product-images img,.images-container img","params":{"property":"product_gallery"},"once":false},
  {"event":"LandingPageVisit","trigger":"url","contains":["/sale","/promo"],"params":{"property":"campaign_landing"}},
  {"event":"ContactIntent","trigger":"controller","controllers":["contact"]},
  {"event":"SizeGuideOpen","trigger":"event","dom_event":"mprpntg:custom","params":{"property":"size_guide"}}
]

document.dispatchEvent(new CustomEvent('mprpntg:custom'));

Utilisez des paramètres statiques configurés. Le module ne fusionne pas d'attributs HTML de données arbitraires ou de détails d'événement DOM. L'ancien utilitaire window.mprpntgTrackCustom n'est pas exposé.

Les règles personnalisées sont envoyées uniquement depuis le navigateur. Le format des règles accepte "capi": true, mais la version actuelle n'envoie pas les règles personnalisées ou de panier à CAPI.

Le serveur envoie les consultations de pages, produits, catégories, recherches et du tunnel de commande, les inscriptions et les achats enregistrés à partir de vraies requêtes de la boutique. Il n'accepte pas de données personnalisées ou de panier envoyées par le navigateur. Les achats utilisent les données acheteur enregistrées lors de la commande, les données de correspondance que vous autorisez et la politique de valeur configurée. Avant l'envoi, le worker revérifie le consentement, les autorisations de correspondance, la politique du personnel, la propriété et les règles de sortie.

La correspondance de l'API Pinterest nécessite une adresse e-mail hachée autorisée ou un identifiant publicitaire mobile haché autorisé, ou la paire autorisée adresse IP et user-agent. Un identifiant de clic Pinterest seul ne suffit pas. Sans données de correspondance, l'événement est suspendu. Le point de terminaison serveur est :

https://api.pinterest.com/v5/ad_accounts/AD_ACCOUNT_ID/events

Assurez-vous que votre exécuteur cron MPR partagé exécute :

task: send_pinterest_conversions
callable: mprpinteresttag::cronProcessPinterestConversions
schedule: every:300
context: any
timeout: 30

La file partagée utilise le fournisseur pinterest ; les formulaires sont un canal de contact distinct avec la limitation ci-dessus. Le module peut lire les enregistrements Pinterest partagés avec d'autres modules tout en limitant le travail à la boutique et à la destination actuelles. Des identifiants d'événement stables permettent à Pinterest de rapprocher les événements navigateur et serveur. Contrôlez les rapports réels dans Pinterest.

Utilisez le panneau de diagnostic pour voir les compteurs, lignes récentes et erreurs de la file. Réessayer les événements échoués remet en attente les lignes Pinterest et contact en échec. Il ne libère pas les événements suspendus pour consentement, données acheteur manquantes ou envoi incertain.

L'action test du panneau utilise toujours Pinterest test=true. Elle exige le module et l'API activés, la propriété et les données de correspondance d'un vrai acheteur ayant consenti. Depuis une requête ordinaire du back-office, elle peut renvoyer test_buyer_matching_unavailable ; elle n'invente jamais de données de correspondance ni d'achat. Testez aussi de vrais événements de la boutique en mode test.

Si le tag ne se charge pas, vérifiez "Tag ID", l'option principale, le consentement de catégorie/service, l'autorisation de données de correspondance, la politique du personnel, les URL sûres, les ressources et les chargeurs pintrk en double. Si un événement de panier/liste de souhaits manque, confirmez le signal de réussite et l'identité produit plutôt que de vous fier aux sélecteurs de clic.

Si les événements API sont suspendus, vérifiez l'identifiant du compte publicitaire, le jeton, le mode test, l'enregistrement du worker et les données de correspondance initiales. Examinez les options de valeur d'achat si les montants diffèrent de votre base de rapport prévue. Désactivez le mode test après validation.

Réglez "Enable Pinterest Tag" sur Non et enregistrez pour suspendre cette intégration. Désinstallez via le gestionnaire de modules pour supprimer son menu, son enregistrement cron et sa configuration. Les données partagées de file et d'achats utilisées par d'autres modules de suivi sont conservées. Gérez votre tag, votre compte publicitaire et vos rapports historiques dans Pinterest.

Utilisez les noms de paramètres ci-dessus si une capture de référence diffère de votre version installée.