Pinterest Conversions API v5

Tracking server-side des conversions Pinterest

Vos conversions partent de votre serveur vers l'API Conversions de Pinterest. L'achat est déclenché par la commande validée dans votre boutique, pas par le chargement d'une page.

Pinterest a un cycle d'achat long : quelqu'un épingle aujourd'hui et achète des semaines plus tard. C'est précisément le cas où un envoi côté serveur, avec un identifiant exploitable, sait encore relier la vente à l'épingle.

Envoi depuis votre serveur Identifiants hachés avant l'envoi Hébergé dans l'UE
Le chemin d'un achat
Votre boutique La commande validée déclenche l'envoi, même des semaines après l'épingle
Dispatcher DataFirefly Consentement vérifié, identifiants hachés
Pinterest Conversions API v5 checkout, avec la valeur et les produits
page_visit add_to_cart checkout lead
Le problème

Où une boutique perd ses conversions Pinterest

La balise Pinterest vit dans le navigateur, et le délai entre la découverte et l'achat est justement le moment où le navigateur oublie.

Le délai efface la piste

Entre l'épingle et l'achat il se passe souvent des semaines. Les cookies tiers ne survivent pas à ce délai, l'envoi serveur avec identifiant, si.

La balise est bloquée

Comme partout, une part des visiteurs ne l'exécute jamais. Ces ventes existent, elles ne sont simplement pas comptées.

Des étapes sans équivalent

Pinterest n'a pas d'événement pour chaque étape d'un tunnel. Envoyées n'importe comment, elles gonflent le nombre d'achats : nous les envoyons en événement générique, ce qui les conserve sans fausser le compte.

Installation

Trois étapes, et rien à réécrire

Le connecteur s'installe sur votre boutique ; le reste se règle dans la console.

1 : Installer le connecteur

Le module PrestaShop, le plugin WooCommerce ou l'extension Shopware, téléchargés depuis votre console.

2 : Coller deux valeurs

L'identifiant du compte publicitaire et le jeton de l'API Conversions, pris dans votre propre compte Pinterest.

3 : Regarder l'Inspecteur

Chaque événement envoyé apparaît avec le retour de Pinterest, accepté ou refusé, et la raison.

Correspondances

Ce que Pinterest reçoit, événement par événement

Pinterest nomme l'achat « checkout ». Les étapes sans équivalent officiel partent en événement générique plutôt que d'être forcées dans un nom voisin : elles restent visibles sans gonfler vos achats.

Notre nom Nom chez la plateforme
page_viewpage_visit
view_contentpage_visit
add_to_cartadd_to_cart
initiate_checkoutcustom
add_payment_infocustom
purchasecheckout
leadlead
complete_registrationsignup
searchsearch
view_item_listview_category
Les limites

Ce que Pinterest ne saura pas faire

Le vocabulaire de Pinterest est plus court que le nôtre. Voici comment nous traitons l'écart, plutôt que de le cacher.

Deux étapes partent en événement générique

Le début de commande et la saisie du moyen de paiement n'ont pas d'équivalent Pinterest. Nous les envoyons en événement custom : ils restent visibles dans vos rapports sans gonfler le nombre d'achats, ce qui arriverait si on les faisait passer pour des checkout.

La vue de contenu et la page vue se confondent

Pinterest n'a qu'un page_visit pour les deux. Ce n'est pas une perte de donnée, la distinction reste entière dans votre console, mais elle n'existe pas côté Pinterest, et il vaut mieux le savoir avant de comparer les deux interfaces.

Vérifiable

Ce que la console vous montrera pour cette destination

Un argument que nous pouvons tenir parce que la page existe : vous n'avez pas à nous croire sur parole, vous regardez.

Chaque événement, avec le retour de la plateforme

L'Inspecteur liste ce qui est parti, ce que la destination en a fait, et la raison exacte d'un refus. Un identifiant invalide ou un jeton expiré se lit en clair, le jour même.

La couverture des identifiants

Combien de vos événements portaient de quoi rapprocher la conversion d'une personne. C'est ce qui décide de la qualité d'appariement, donc du ROAS que vous lirez chez l'annonceur.

Les périodes où plus rien n'est parti

L'anomalie la plus coûteuse et la plus discrète : un tableau de bord vide se lit comme une mauvaise semaine, jamais comme une panne. La console les nomme.

Prérequis

Ce qu'il vous faut

Deux valeurs, prises dans votre propre compte Pinterest.

L'identifiant du compte publicitaire

Ads Manager → Business Access → Ad accounts. C'est un nombre.

Un jeton de l'API Conversions

Généré dans le même espace, envoyé en Bearer. Chiffré au repos chez nous.

Rien d'autre

Pas de mot de passe, pas d'accès à votre compte : nous n'écrivons jamais dans vos campagnes, nous envoyons des conversions.

Confidentialité

Ce qui ne quitte pas notre infrastructure

Un produit qui manipule des données de clients doit dire où il s'arrête.

Les identifiants sont hachés avant l'envoi

Normalisés puis hachés chez nous : la destination reçoit une empreinte, jamais l'adresse e-mail ou le numéro de téléphone.

Le consentement décide, y compris côté serveur

Chaque événement porte l'état du consentement enregistré par votre bandeau. Un refus reste un refus : passer par le serveur ne contourne rien.

Hébergé dans l'Union européenne

Le dispatcher, la base et la console sont en Allemagne. Vos jetons sont chiffrés au repos et ne réapparaissent jamais en clair dans une page.

Sans surprise

Simple à installer, et sans coût qui s'ajoute

C'est un choix de conception, pas une promesse commerciale : il n'y a rien à héberger, et rien à débloquer palier par palier.

Un module, comme les autres

Le connecteur s'installe comme n'importe quelle extension de votre boutique. Rien à héberger : pas de conteneur à louer, pas de serveur à maintenir, pas de sous-domaine à configurer.

Toutes les destinations, à tous les forfaits

Y compris le gratuit. Les forfaits ne diffèrent que par le nombre de sites et d'événements, aucune destination n'est réservée à un palier, ce qui est pourtant l'usage.

Commencer ne coûte rien

Le forfait gratuit couvre un site et 10 000 événements par mois, sans carte bancaire. Rien ne casse si vous dépassez le quota.

Ce qu'on nous demande

Questions fréquentes

Pourquoi le server-side compte-t-il autant sur Pinterest ?

Parce que le délai y est long. Entre l'épingle et l'achat il se passe souvent des semaines, et les cookies tiers ne survivent pas à ce délai. Un envoi depuis votre serveur, portant un identifiant, sait encore relier la vente à sa source.

Mes conversions vont-elles être comptées en double ?

Non : la balise Pinterest et l'envoi serveur portent le même identifiant d'événement, construit sur votre numéro de commande.

Quelles données personnelles sont envoyées ?

Les identifiants sont normalisés puis hachés avant l'envoi. Pinterest reçoit une empreinte, jamais l'adresse elle-même, et rien ne part sans le consentement enregistré par votre bandeau.

Puis-je vérifier ce qui est réellement parti ?

Oui. L'Inspecteur de votre console liste les événements avec le retour de Pinterest pour chacun, et la raison exacte d'un refus.

Branchez cette destination en quelques minutes

Le forfait gratuit inclut toutes les destinations. Sans engagement et sans carte bancaire.