Qu’est-ce que la Pinterest Conversions API ?
La Pinterest Conversions API, l’API de conversion de Pinterest, vous permet d’envoyer des conversions directement à Pinterest par une connexion de serveur à serveur, en complément des événements que la balise Pinterest envoie depuis le navigateur du client.
Avec WeProfit, un achat Shopify arrive chez Pinterest sous la forme de l’événement checkout, l’événement de Pinterest pour une transaction finalisée, envoyé depuis les serveurs de WeProfit vers le compte publicitaire que vous connectez. Le début du paiement a son propre événement Pinterest, initiate_checkout : ne confondez pas les deux quand vous lisez vos rapports.
Pinterest est inclus dans chaque forfait WeProfit, avec Meta, Google, TikTok, Snapchat, X Ads, Microsoft (programme pilote), Reddit, LinkedIn et Taboola.
Connecter Pinterest dans WeProfit
Connectez d’abord votre boutique Shopify. L’envoi vers Pinterest nécessite deux valeurs : l’ID de votre compte publicitaire Pinterest et un jeton d’accès de conversion. WeProfit ne demande pas d’ID de balise Pinterest, et le formulaire Pinterest n’a pas de champ de code d’événement de test.
- Dans le Gestionnaire de publicités Pinterest, ouvrez Conversions, puis Conversions API, et lancez la configuration de l’API. Choisissez le jeton d’accès de conversion, générez un nouveau jeton et copiez-le.
- Copiez l’ID de votre compte publicitaire : c’est le nombre qui figure dans l’URL du Gestionnaire de publicités Pinterest. Pinterest l’affiche aussi à côté d’un jeton qui vient d’être généré.
- Dans WeProfit, ouvrez Réseaux publicitaires > Pinterest et sélectionnez « Ajouter une destination ». Saisissez l’ID du compte publicitaire et le jeton d’accès de conversion. Le libellé est facultatif et vous aide si vous connectez plusieurs comptes publicitaires.
- Laissez les conditions vides pour envoyer tous les événements éligibles, ou ajoutez des conditions, par exemple sur le pays, l’événement, la valeur de la commande ou la campagne, pour limiter ce que ce compte publicitaire reçoit. Sélectionnez ensuite « Connecter Pinterest ».
- Sélectionnez « Envoyer un test ». WeProfit envoie un événement de test avec l’indicateur de test de Pinterest et indique si Pinterest l’a accepté. Pinterest place les événements de test dans un bac à sable et ne les utilise ni pour les rapports ni pour l’optimisation ; les événements réels ne portent jamais cet indicateur.
Les achats et les événements de paiement envoyés à Pinterest
Depuis une boutique Shopify, WeProfit envoie à Pinterest vos achats et deux étapes du paiement que son pixel web enregistre : le début du paiement et l’ajout des informations de paiement. Les achats proviennent du webhook de commande de Shopify, et l’achat de chaque commande est envoyé au plus une fois à chaque compte publicitaire connecté.
WeProfit n’envoie un événement à Pinterest que s’il contient une adresse e-mail hachée, ou à la fois une adresse IP et un agent utilisateur : c’est le minimum que l’API de Pinterest demande pour un événement web. Il ignore les événements qui ne les ont pas, et un événement ignoré n’a pas de ligne dans le journal d’envoi. Les remboursements ne sont pas envoyés à Pinterest, et rien ne retire un achat que Pinterest a déjà reçu.
Chaque achat contient le total de la commande tel que Shopify l’indique, dans la devise de la commande, les produits avec leur ID, leur prix et leur quantité, le nombre d’articles et l’ID de commande Shopify. Vérifiez dans le Gestionnaire de publicités Pinterest quels événements votre compte publicitaire reçoit.
| Événement de la boutique | Événement Pinterest |
|---|---|
| Checkout started | initiate_checkout |
| Payment information added | add_payment_info |
| Purchase | checkout |
Les informations client envoyées avec chaque achat
Pour aider Pinterest à associer un achat à un utilisateur Pinterest, WeProfit envoie des informations tirées de la commande Shopify, hachées en SHA-256 : l’adresse e-mail et le numéro de téléphone de l’acheteur, ainsi que le prénom et le nom, la ville, l’État ou la région, le code postal et le pays de l’adresse de livraison, ou à défaut de l’adresse de facturation. L’adresse IP et l’agent utilisateur partent non hachés. Quand WeProfit en dispose, il envoie aussi l’ID de clic Pinterest, epik, et un ID externe, c’est-à-dire un hachage SHA-256 de l’ID de visiteur WeProfit.
Pinterest ajoute epik à l’URL d’une visite issue de votre publicité, et la balise Pinterest le conserve dans le cookie _epik. WeProfit lit les deux, mais il ne charge pas la balise Pinterest : le cookie n’existe donc que si votre boutique utilise cette balise.
Balise Pinterest et Conversions API : éviter le double comptage
Pinterest supprime un doublon quand l’eventID de l’événement navigateur, envoyé par la balise Pinterest, est égal à l’event_id de l’événement serveur. Il garde le premier événement reçu et supprime les doublons reçus dans les 48 heures.
WeProfit ne charge pas la balise Pinterest. Il envoie les événements Pinterest depuis son serveur uniquement, chacun avec son propre ID d’événement. Un achat part sous la forme pur_ suivi d’un code de boutique et de l’ID de commande Shopify, par exemple pur_a1b2c3d4-6012345678901, une fois par commande et par compte publicitaire, et une nouvelle tentative réutilise cet ID.
Si la balise Pinterest déclare aussi des achats pour le même compte publicitaire, qu’une application l’ait ajoutée ou qu’elle se trouve dans le code de votre thème, elle utilise ses propres ID d’événement. Ils ne correspondront pas à ceux de WeProfit : Pinterest ne peut donc pas associer les deux copies et peut compter la commande deux fois. Gardez un seul émetteur d’achats par compte publicitaire, puis comparez un achat de test dans le Gestionnaire de publicités Pinterest avec le journal d’envoi WeProfit.
Vérifier l’envoi dans le journal d’envoi CAPI
Ouvrez Réseaux publicitaires > Pinterest dans WeProfit et faites défiler jusqu’au « Journal d’envoi CAPI ». Il liste chaque événement côté serveur envoyé à Pinterest, avec les colonnes Date, Événement, Destination, ID d’événement, Statut, Tentatives et Erreur, et vous pouvez filtrer par destination, par événement et par statut. Le filtre Purchase trouve aussi les événements checkout de Pinterest.
Le journal affiche l’ID d’événement propre à WeProfit, par exemple pur_6012345678901 ; Pinterest le reçoit avec le code de boutique, par exemple pur_a1b2c3d4-6012345678901. Le journal n’a pas de colonne de valeur : vérifiez la valeur d’un achat sur la page Événements de WeProfit. La page Commandes indique l’envoi de chaque commande vers chaque réseau connecté dans sa colonne Réseaux.
Le statut « envoyé » signifie que Pinterest a accepté l’événement, pas qu’il a attribué la commande à une publicité. Si Pinterest refuse le jeton d’accès, WeProfit met la connexion en pause et affiche une bannière ; un nouveau jeton ou un « Envoyer un test » réussi la réactive.
| Statut | Signification |
|---|---|
| en attente | En file d’attente, pas encore envoyé. |
| envoyé | Pinterest a accepté l’événement. |
| échec | Un problème temporaire. WeProfit réessaie automatiquement pendant quelques heures, avec le même ID d’événement. |
| abandonné | WeProfit a abandonné : Pinterest a refusé l’événement, avec son message dans la colonne Erreur, ou les tentatives sont épuisées. |
| ignoré (désactivé) | La destination était désactivée ou en pause quand le tour de l’événement est venu. Les événements ignorés pendant qu’elle est désactivée ne sont pas envoyés plus tard. |
| ignoré (avant installation) | L’achat d’une commande passée avant l’installation de WeProfit. Il n’est jamais envoyé. |
Le détail par campagne de vos publicités Pinterest
WeProfit classe une visite dans Pinterest Ads quand elle porte l’ID de clic epik de Pinterest, ou utm_source=pinterest avec un support payant. Avec les paramètres d’URL automatiques de Pinterest, il lit aussi les ID de la campagne et du groupe d’annonces.
Pour l’ID de la publicité et des noms lisibles, ajoutez une seule fois le modèle d’URL Pinterest de WeProfit pour tout le compte publicitaire : dans Business Manager, ouvrez « Comptes publicitaires », sélectionnez votre compte, ouvrez l’onglet « Paramètres », modifiez les paramètres d’URL pour qu’ils contiennent ceux du modèle WeProfit, puis sélectionnez « Enregistrer et appliquer ». Tant que la case « Appliquer automatiquement les paramètres d’URL à toutes les campagnes actuelles et futures » est cochée, Pinterest les ajoute aux URL de destination de vos publicités ; il n’écrase pas les balises UTM qu’une URL contient déjà. Les modèles ne s’appliquent qu’aux nouveaux clics.
Dans l’attribution de WeProfit, un clic sur une publicité compte pendant 30 jours et le clic le plus récent l’emporte : cela fonctionne comme une attribution au dernier clic, avec une fenêtre de 30 jours pour les clics publicitaires. Pinterest attribue les conversions selon ses propres paramètres d’attribution, donc ses chiffres et ceux de WeProfit peuvent différer pour les mêmes commandes.
utm_source=pinterest&utm_medium=paid&utm_campaign={campaignname}&utm_term={adgroupname}&utm_content={adid}&wpcid={campaignid}&wpasid={adgroupid}&wpadid={adid}