DocumentationExperience PlatformBalises

Extension de transfert d’événement Pinterest

Last update: Tue Jul 16 2024 00:00:00 GMT+0000 (Coordinated Universal Time)
  • Rubriques :

Créé pour :

  • Développeur

Pinterest est un moteur de découverte visuelle qui permet de trouver des idées telles que des recettes, un décor, une inspiration de style, etc. Il existe des milliards de pin's sur Pinterest, qui peuvent également être partagés avec d'autres sur Pinterest. Vous pouvez rassembler les événements d’interaction de l’utilisateur et exploiter Pinterest Analytics pour comprendre le comportement de l’utilisateur et exécuter des publicités ciblées.

L’extension Pinterest Conversions API de transfert d’événement vous permet d’exploiter les données capturées dans l’Edge Network Adobe Experience Platform et de les envoyer à Pinterest. Ce document couvre les cas d’utilisation de l’extension, comment l’installer et comment intégrer ses fonctionnalités dans le transfert d’événement rules.

Les jetons d’accès aux conversions sont la méthode d’authentification utilisée par Pinterest lors de l’interaction avec l’API Pinterest.

Cas d’utilisation

Cette extension doit être utilisée si vous souhaitez utiliser les données de l’Edge Network dans Pinterest pour tirer parti de ses fonctionnalités d’analyse client.

Prenons l’exemple d’une équipe marketing au sein d’une organisation. L’équipe capture les données d’événement d’interaction de l’utilisateur à partir de son site web et les charge dans Pinterest à l’aide de cette extension de transfert d’événement.

Les équipes de marketing et d’analyse peuvent ensuite exploiter les fonctionnalités Pinterest d’Analytics pour comprendre les interactions et le comportement des utilisateurs clés, ce qui vous permet de mieux comprendre les utilisateurs et de les cibler pour les campagnes publicitaires ciblées.

Pour plus d'informations sur les cas d'utilisation spécifiques à Pinterest, consultez la documentation Pinterest Cas d'utilisation .

Conditions préalables de Pinterest prerequisites

Pour utiliser cette extension, vous devez disposer d'un Pinterest compte d'entreprise valide. Accédez à la Pinterest page d'inscription pour vous enregistrer et créer un compte si vous n'en avez pas déjà un.

Vous aurez également besoin d’un compte de développeur Pinterest, qui devra être associé à votre compte d’entreprise Pinterest. Pour associer votre compte de développeur à votre compte d'entreprise, reportez-vous au Pinterest ​ compte de développeur.

Collecte des détails de configuration requis configuration-details

Pour connecter l’Experience Platform à Pinterest, les entrées suivantes sont requises :

Informations d’identification
Description
Exemple
Identifiant de compte Ads
Votre Identifiant De Compte Ads Pinterest. Reportez-vous à la documentation de Pinterestpour obtenir des conseils.
123456789012
Jeton d’accès à la conversion
Votre Jeton d’accès à la conversion Pinterest. Consultez le document Pinterest API de conversion pour obtenir des conseils.
Vous n’aurez besoin de le faire qu’une seule fois, car ce jeton n’expire pas.

Installation et configuration de l’extension Pinterest install

Pour installer l’extension, créez une propriété de transfert d’événement ou choisissez une propriété existante à modifier à la place.

Dans le volet de navigation de gauche, sélectionnez Extensions. Sélectionnez Install sur la carte de l’extension Pinterest dans l’onglet Catalog.

Catalogue affichant l’extension Pinterest avec Install en surbrillance.

Configuration de l’extension Pinterest

IMPORTANT
En fonction des besoins de mise en oeuvre, vous devrez peut-être créer un schéma, des éléments de données et un jeu de données avant de configurer l’extension. Avant de commencer, consultez toutes les étapes de configuration afin de déterminer les entités à configurer pour votre cas d’utilisation.

Dans le volet de navigation de gauche, sélectionnez Extensions. Sélectionnez Configurer sur la carte de l’extension Pinterest dans l’onglet Installé**.

Extension Pinterest affichée dans longlet Installer avec Configurer en surbrillance.

Sur l’écran suivant, saisissez les Ads Account Id et Conversion Access Token que vous avez précédemment rassemblés dans la section configuration details . Lorsque vous avez terminé, sélectionnez Enregistrer.

L’écran Pinterest de configuration surlignant les champs d’entrée Ads Account Id et Conversion Access Token.

Configurer une règle de transfert d’événement config-rule

Une fois tous vos éléments de données configurés, vous pouvez commencer à créer des règles de transfert d’événement qui déterminent quand et comment vos événements seront envoyés à Pinterest.

Créez une règle dans votre propriété de transfert d’événement. Sous Actions, ajoutez une nouvelle action et définissez l’extension sur Pinterest. Pour envoyer des événements Edge Network à Pinterest, définissez le Type d’action sur Envoyer l’événement.

Création de la règle Pinterest Envoyer l’événement.

Une fois la sélection effectuée, d’autres commandes s’affichent pour configurer davantage l’événement. Vous devez mapper les propriétés d’événement Pinterest aux éléments de données que vous avez précédemment créés.

​ Event Data

Les données d’événement suivantes seront nécessaires pour créer la règle :

Nom du champ
Description
Exemple
Nom de l’événement
Type de l’événement utilisateur. Il peut toutefois s'agir de n'importe quel type d'événement. Pour utiliser Pinterest Analytics, il est recommandé d'utiliser Pinterest code d'événement
* passage en caisse
* add_to_cart
* page_visit
* inscription
* [Événement défini par l’utilisateur]
Action Source
Source indiquant où l’événement de conversion s’est produit.
* app_android
* app_ios
* web
* hors ligne
Heure de l’événement
Cela fait référence à l’heure de l’événement. Le format d’heure par défaut utilisé est UNIX, au format <seconds>.<miliseconds> selon votre fuseau horaire local. Pour plus d’informations, reportez-vous à l’ Pinterest API.
La version 1433188255.500 indique 1433188255 secondes et 500 millisecondes après l’époque, ou le lundi 1er juin 2015, à 7:50:55 PM GMT.
ID d’événement
Chaîne d’identifiant unique qui identifie cet événement et peut être utilisée pour dédupliquer les événements ingérés à la fois via l’API de conversion et le suivi Pinterest. Sans cela, les données de l’événement seront probablement comptabilisées deux fois et signaleront le gonflement des mesures.
ba7816bf8f01cfea414140de5dae223b00361a396177a9cb410ff61f20015ad
Propriétés de l’événement
Objet JSON contenant des propriétés personnalisées de l’événement. Choisissez entre fournir un fichier JSON brut ou utiliser un jeu simplifié d’entrées clé-valeur.
{ "event_source_url": "http://site.com" }

Pinterest Données de l’événement surlignées dans l’action de règle.

Les propriétés d’événement suivantes peuvent être configurées :

Nom du champ
Description
URL Source d’événement
URL de l’événement de conversion web.
ID de magasin d’applications
Identifiant de l’application de la boutique d’applications.
Nom de l’application
Nom de l’application.
Application Version
Version de l’application.
Marque du périphérique
Marque du périphérique utilisé par l’utilisateur.
Opérateur de périphérique
Opérateur de téléphonie mobile de l’utilisateur pour son appareil.
Modèle de périphérique
Modèle du périphérique de l’utilisateur.
Type d’appareil
Type de périphérique utilisé par l’utilisateur.
Version du système d’exploitation
Version du système d’exploitation du périphérique.
Langue de l’utilisateur
Code de langue ISO-639-1 à deux caractères indiquant la langue de l’utilisateur.

Données utilisateur

Les données utilisateur suivantes peuvent être saisies à l’aide de ne sont pas des champs obligatoires :

Nom du champ
Description
Exemple
E-mail.
Adresse électronique de l’utilisateur ou hachage SHA256 de l’adresse électronique de l’utilisateur.
ebd543592…f2b7e1
Identifiants de publicité mobile
hachages Sha256 des "Google Advertising IDs" (GAID) ou "Apple Identifier pour les annonceurs" (IDFA) de l’utilisateur ;
ebd543592…f2b7e1
Adresse IP du client
Adresse IP de l’utilisateur, qui peut être au format IPv4 ou IPv6. Utilisé pour la correspondance.
192.168.0.1
Agent utilisateur client
Chaîne de l’agent utilisateur du navigateur web de l’utilisateur.
Mozilla/5.0 (plate-forme ; rv:geckoversion) Gecko/geckotrail Firefox/firefoxversion
Données d’informations sur le client
Objet JSON contenant d’autres informations sur le client. Choisissez entre fournir un fichier JSON brut ou utiliser un jeu simplifié d’entrées clé-valeur.
{ "ph": "122333445" }

Pinterest Données utilisateur surlignées dans l’action de règle.

Les propriétés d’informations sur les clients qui peuvent être configurées sont les suivantes :

Nom du champ
Description
Téléphone
Numéro de contact de l'utilisateur. Seuls les chiffres sont acceptés et doivent être renseignés avec l'indicatif du pays, l'indicatif régional et le numéro.
Genre
Le genre peut être renseigné en tant que "f" pour féminin, "m" pour masculin ou "n" pour non-binaire.
Date de naissance
Date de naissance, saisie sous forme d’année, de mois et de jour.
Nom
Nom de l’utilisateur.
Prénom
Prénom de l’utilisateur.
Ville
Ville de résidence de l’utilisateur. Il est principalement utilisé à des fins de facturation.
État
État de l’utilisateur, fourni en minuscules sous forme de code à deux lettres.
Code postal
Code postal de l’utilisateur, principalement utilisé à des fins de facturation.
Pays
Code de pays ISO-3166 à deux caractères indiquant le pays de l’utilisateur.
Identifiant externe
Identifiant unique de l’annonceur qui identifie un utilisateur dans son espace. Par exemple, identifiant utilisateur, identifiant de fidélité, etc.
ID de clic
Identifiant unique stocké dans le cookie _epik sur votre domaine ou le paramètre de requête &epik= dans l’URL.
IMPORTANT
Avant d’envoyer les données au point de terminaison de l’API Pinterest, l’extension hachera et normalisera les valeurs des champs suivants : Email, Numéro de téléphone, Prénom, Nom, Genre, Date de naissance, Ville, État, Code postal, Pays et Identifiant externe. L’extension ne hachera pas la valeur de ces champs si une chaîne SHA256 est déjà présente.

Données personnalisées

Les données personnalisées suivantes peuvent être saisies pour la règle :

Nom du champ
Description
Devise
Code de devise ISO-4217. Si cette valeur n’est pas fournie, Pinterest sera défini par défaut sur la devise de l’annonceur définie lors de la création du compte.
Valeur
Valeur totale de l’événement. Acceptée comme chaîne dans la requête. Ce chiffre sera analysé dans un double chiffre.
Chaîne de recherche
Chaîne de recherche associée à l’événement de conversion de l’utilisateur.
ID de commande
ID de commande. L'envoi de order_id aidera Pinterest à dédupliquer les événements si nécessaire.
Nombre de produits
Nombre total de produits de l’événement. Par exemple, le nombre total d’articles achetés dans un événement de passage en caisse.
ID de contenu
Liste (tableau) des ID de produits.
Contenu
Liste (tableau) d’objets contenant des informations sur les produits, telles que le prix et la quantité.

Pinterest Données personnalisées surlignées dans l’action de règle.

Validation des données dans Pinterest

Une fois la règle de transfert d’événement créée et exécutée, vérifiez si l’événement envoyé à l’API Pinterest s’affiche comme prévu dans l’interface utilisateur de Pinterest.

Si la collecte d’événements et l’intégration de Experience Platform ont réussi, des événements s’affichent dans l’interface utilisateur de Pinterest.

Le Pinterest gestionnaire d’événements

Vous pouvez approfondir l’analyse et afficher la distribution des données d’événement Pinterest.

La Pinterest distribution de données

Étapes suivantes

Ce guide explique comment installer et configurer l’extension de transfert d’événement Pinterest dans l’interface utilisateur. Pour plus d'informations, consultez la documentation officielle :

recommendation-more-help
12b4e4a9-5028-4d88-8ce6-64a580811743