Vue d’ensemble

L’API de conversion Pinterest permet aux annonceurs d’envoyer des conversions directement sur Pinterest via une méthode serveur à serveur sans nécessiter de balise Pinterest. Les conversions capturées avec l’API Pinterest peuvent ensuite être utilisées pour le reciblage dans les campagnes et peuvent être vérifiées dans les rapports de conversion pour améliorer la visibilité des conversions.

Grâce à l’API Pinterest pour les conversions, les annonceurs peuvent envoyer :

  • Des conversions Web
  • Des conversions dans l’application
  • Des conversions hors ligne
  • Les événements peuvent être reçus en temps réel ou dans l’heure suivant la capture de l’événement. Les événements reçus en dehors de cette fenêtre ou dans le cadre d’un événement en masse retardé seront comptés comme conversions hors ligne. 

    L’utilisation de l’API Pinterest pour les conversions ainsi que de la balise Pinterest peut contribuer à optimiser la visibilité des conversions capturées. Notre bonne pratique consiste à utiliser les deux solutions de capture de conversion pour vous assurer de bénéficier d’une vue complète des performances de votre campagne de conversion.

    L’API Pinterest

    L’API Pinterest pour les conversions est l’un des nombreux produits qui résident dans l’écosystème de notre API Pinterest. Tous les détenteurs d’un compte Pinterest Business pourront utiliser l’API Pinterest pour les conversions, mais cela n’accorde pas automatiquement l’accès à l’API Pinterest au sens large. 

    La plateforme des développeurs Pinterest fournit des informations sur tous les produits API de Pinterest. 

    Premiers pas

    Tout membre disposant d’un compte Pinterest Business a accès à l’API Pinterest pour les conversions.

    Pour commencer, vous devez d’abord générer un jeton d’accès. Un jeton d’accès est une chaîne de caractères qui vérifie que les demandes sont en cours et sont renvoyées au compte du bon utilisateur. 

    Pour générer un jeton d’accès : 

  • Connectez-vous à votre compte professionnel Pinterest
  • Cliquez sur Annonces dans le menu en haut de la page et choisissez Conversions
  • Sélectionnez la page de jetons d’accès aux conversions dans la barre de navigation de gauche
  • Cliquez sur le bouton Générer un nouveau jeton
  • Copiez le nouveau jeton d’accès et revenez au processus de configuration.
  • Si vous essayez d’accéder à un compte qui ne vous appartient pas, vous devez d’abord configurer Business Access. 

    …pour un résultat excellent

    Événements de conversion : tous les types d’événements pouvant être capturés sur la balise Pinterest sont également disponibles via l’API Pinterest pour les conversions. Vous trouverez une liste complète des événements ainsi que d’autres informations sur leur importance dans notre documentation développeur sur l’API Pinterest.

    La configuration d’une intégration d’API de serveur à serveur nécessite des ressources de développement et d’ingénierie de la part du propriétaire du site Web. La quantité d’efforts du développeur technique variera en fonction :

  • Des connaissances des intégrations d’API de votre développeur. S’il n’a jamais effectué d’intégration d’API auparavant, cela peut lui demander davantage d’efforts.  Si vous avez implémenté d’autres API de conversion, votre développeur ne devrait avoir besoin d’apporter que quelques modifications progressives.
  • Du nombre d’événements suivis et à quelle étape du processus de conversion les données nous seront envoyées.
  • De la volonté ou du besoin d’un annonceur d’utiliser un tiers pour s’intégrer (c’est-à-dire Shopify, GTM, Tealium).
  • Si vous utilisez déjà la balise Pinterest

    Nous vous recommandons vivement d’utiliser l’API Pinterest pour les conversions à côté de la balise Pinterest pour vous assurer de maximiser vos conversions. 

    Si vous avez déjà configuré la balise Pinterest précédemment, vous devrez vous assurer que les conversions ne sont pas comptées deux fois, une fois via la balise Pinterest et une fois via l’API. 

    Pour y parvenir, vous devrez vous assurer que le paramètre event_id est transmis avec des conversions capturées à la fois par la balise Pinterest et l’API Pinterest pour les conversions. 

    Notre système reconnaîtra alors les event_ids comme des doublons et ne conservera que la première conversion capturée. Pour garantir la réussite de cette déduplication :

  • Les event_ids doivent être identiques entre les mêmes conversions. Lorsqu’un utilisateur accède à une page Web, une conversion de visite de page est déclenchée à la fois par la balise Pinterest et par l’API Pinterest. Les deux conversions devront renvoyer des event_ids correspondantes pour que notre système reconnaisse qu’il s’agit de la même conversion. 
  • Les event_ids doivent être uniques pour les conversions différentes. Lorsqu’un utilisateur accède à une page Web, une conversion de visite de page est déclenchée à la fois par la balise Pinterest et par l’API Pinterest. Si l’utilisateur ajoute ensuite un T-shirt dans son panier, cela déclenche l’événement AddToCart sur la balise Pinterest et l’API Pinterest. Bien que les event_ids déclenchés pour les mêmes événements doivent correspondre, les event_ids envoyés pour l’événement Visite de page et l’événement AddToCart doivent être uniques. De cette façon, notre système les reconnaît comme des événements séparés.
  • En fonction de cet identifiant d’événement et de l’event_name, Pinterest supprimera tous les événements dupliqués de l’enregistrement, à condition (a) que l’événement n’ait pas eu lieu hors ligne (le action_source n’est pas hors ligne) et (b) que Pinterest reçoive les événements dupliqués avec un intervalle de 48 heures maximum entre les deux.

    Vérification de votre configuration

    Une fois la configuration de l’API terminée, vous pouvez vous assurer que les événements de conversion sont bien reçus en vérifiant :

  • Les codes de réponse : le développeur qui configure votre intégration API peut examiner les codes de réponse renvoyés à chaque demande après le déclenchement d’une conversion. 
  • La page de déduplication dans le Gestionnaire d’annonces : les conversions post-dédupliquées s’afficheront sur la page Déduplication du Gestionnaire d’annonces. Pour accéder à la page de déduplication :
    • Connectez-vous à votre compte professionnel Pinterest
    • Cliquez sur Annonces dans le menu en haut de la page et choisissez Conversions
    • Sélectionnez Déduplication dans la barre de navigation de gauche.
  • Qualité et résilience

    La résilience est le statut d’une API de conversions qui permet le plus haut niveau de correspondance et d’attribution du signal. Ces données supplémentaires nous aideront à fournir des rapports plus précis au fur et à mesure de l’évolution des politiques du secteur de l’annonce.

    Statut de résilience

    Il existe deux catégories de statut de résilience : Bonne et Faible. Votre statut de résilience est visible dans la section État des conversions du Gestionnaire d’annonces.

    Bonne résilience

    Option 1 : couverture de l’identifiant spécifique

  • Couverture de l’identifiant
    • 90 % des événements ou plus devraient avoir une adresse IP/UA, 
    • 10 % des événements au bas du funnel ou plus ont une adresse e-mail hachée ou un MAID, 
    • 10 % des événements ou plus ont un ID externe.
  • Chevauchement avec les données de la balise (le cas échéant)
    • 90 %* des événements de balise ou plus doivent être reçus par l’intermédiaire du CAPI 
  • Ou :

    Option 2 : obtenir le taux de correspondance de base

  • Taux de correspondance des utilisateurs CAPI de 60 % ou plus
  • Chevauchement avec les données de la balise (le cas échéant)
  • 90 %* des événements de balise ou plus doivent être reçus par l’intermédiaire du CAPI 


  • Faible résilience

    Toute configuration qui n’est pas Bonne.

    ID et signaux de résilience

    Envoyez les signaux suivants pour atteindre un statut d’annonceur résilient.

    Signaux/ID d’API Poids/Classement
    adresse_ip_du_client + agent_utilisateur_du_client Élevé
    em Élevé
    external_id Élevé
    hashed_maid Élevé
    click_id Élevé
    fn + ln Faible
    ph Faible
    ge, bd, ct, st, zp, pays Faible

    *Poids/classement en fonction de la probabilité d’augmentation du taux de correspondance

    Implémentation par un tiers

    Pinterest propose plusieurs intégrations tierces pour vous aider à soutenir le processus d’adoption de votre API. 

    Google Tag Manager – Côté serveur

    En associant votre compte Google Tag Manager à votre API de conversion Pinterest, vous pouvez voir l’impact qu’a Pinterest sur le trafic de votre boutique et sur la vente de vos produits.

    Cette intégration vous oblige à déployer un conteneur serveur à l’aide de votre fournisseur de cloud préféré et de vos connaissances en matière d’identification côté serveur. Pour plus d’informations sur les conditions préalables, consultez le site destiné aux développeurs

    Shopify

    L’API pour l’intégration des conversions complète la balise Pinterest pour garantir une couverture et une qualité élevées des données. Tant que l’application Shopify est installée, aucune action n’est requise pour profiter de cette amélioration. Les modifications seront automatiquement appliquées à la boutique du commerçant.

    Tealium

    Les annonceurs intéressés par Tealium peuvent mettre en place l’API pour les conversions directement avec le tiers. Tealium construit le modèle et facilite l’intégration avec l’annonceur. 

    Le processus d’implémentation est décrit dans le centre d’apprentissage de Tealium. Toute question concernant l’aide à l’implémentation peut être envoyée à support [at] tealium.com (support[at]tealium[dot]com)

    Si des intégrations tierces supplémentaires vous intéressent, contactez votre représentant en ventes pour en savoir plus. 

    Comprendre le traitement limité des données

    À partir du 1er janvier 2023, les annonceurs pourront utiliser un drapeau signalant un traitement limité des données, qui les aidera à mieux se conformer à la législation California Consumer Privacy Act, telle qu’amendée par la California Privacy Rights Act (communément appelées la législation CCPA). Ce drapeau permettra à Pinterest de limiter l’utilisation de certaines données, afin d’aider les annonceurs à respecter les paramètres de confidentialité des utilisateurs. Un annonceur pourra par exemple appliquer le drapeau visant à limiter le traitement des données pour les utilisateurs résidant en Californie ayant refusé de vendre ou de partager leurs données comme les y autorise la législation CCPA. Lorsque le drapeau indiquant le traitement limité des données sera utilisé, Pinterest agira en tant que fournisseur de services conformément au CCPA en ce qui concerne les données signalées des utilisateurs résidant en Californie.

    Les annonceurs sont tenus de respecter les souhaits des utilisateurs, ainsi que d’identifier leur État de résidence, lors de l’utilisation du drapeau de traitement limité des données.

    End of Other articles Links
    Still need help? Contact us
    User feedback
    Cet article vous a-t-il été utile ?

    collection_fields

    Comment pouvons-nous améliorer cet article ?