Extension de transfert d’événement Pinterest

Pinterest est un moteur de découverte visuelle qui permet de trouver des idées telles que des recettes, des décors maison, des modèles inspirés, etc. Il y a des milliards de pin's sur Pinterest, qui peut également être partagé avec d’autres utilisateurs de Pinterest. Vous pouvez rassembler les événements d’interaction de l’utilisateur et tirer parti de Pinterest Analytics pour comprendre le comportement des utilisateurs et exécuter des publicités ciblées.

La variable Pinterest Conversions API transfert d’événement l’extension vous permet d’exploiter les données capturées dans Adobe Experience Platform Edge Network 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 à votre 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 la variable Pinterest API.

Cas d’utilisation

Cette extension doit être utilisée si vous souhaitez utiliser les données du réseau Edge 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 en utilisant cette extension de transfert d’événement.

Les équipes marketing et d’analyse peuvent alors tirer parti des Pinterest Fonctionnalités d’Analytics permettant de comprendre les principales interactions et le comportement des utilisateurs, ce qui vous permet de mieux comprendre les utilisateurs et de les cibler pour des campagnes publicitaires ciblées.

Pour plus d’informations sur les cas d’utilisation spécifiques à Pinterest, reportez-vous au Pinterest cas d’utilisation la documentation.

Conditions préalables de Pinterest prerequisites

Vous devez disposer d’un Pinterest compte commercial afin d’utiliser cette extension. Accédez au Pinterest page d’enregistrement pour enregistrer et créer un compte si vous n’en avez pas déjà un.

Vous aurez également besoin d’une Pinterest , qui doit être associé à votre Pinterest compte professionnel. Pour associer votre compte développeur à votre compte professionnel, reportez-vous à la section Pinterest ​ compte 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 Pinterest Identifiant De Compte Ads. Reportez-vous à la documentation de Pinterestpour obtenir des conseils.
123456789012
Jeton d’accès à la conversion
Votre Pinterest Jeton d’accès à la conversion. Voir Pinterest API de conversion document à titre indicatif.
Vous n’aurez besoin de le faire qu’une seule fois, car ce jeton n’expire pas.

Installez et configurez le Pinterest extension install

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

Dans le volet de navigation de gauche, sélectionnez Extensions. Sélectionner Installer sur la carte de la variable Pinterest dans le Catalogue .

Catalogue affichant le Pinterest extension avec Installer surlignée.

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électionner Configurer sur la carte de la variable Pinterest dans le InstalléOnglet **.

Pinterest l’extension affichée dans la Installer avec Configurer surlignée.

Dans l’écran suivant, saisissez la variable Identifiant de compte Ads et Jeton d’accès à la conversion que vous avez précédemment rassemblé dans la variable détails de configuration . Lorsque vous avez terminé, sélectionnez Enregistrer.

La variable Pinterest Configurer mise en surbrillance de l’écran Identifiant de compte Ads et Jeton d’accès à la conversion champs de saisie.

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éer règle dans la 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 la variable Type d’action to Envoyer un événement.

La variable Pinterest Envoyer un événement création de règles.

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

Données d’événement

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 tirer parti de Pinterest Analytics il est recommandé d’utiliser Pinterest codes d’événement
* paiement
* 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, voir la section Pinterest API.
1433188255.500 indique 1433188255 secondes et 500 millisecondes après l’époque, ou le lundi 1er juin 2015 à 7:50:17 h GMT.
Identifiant 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.
ba7816bf8f01cfea414140de5dae2223b00361a396177a9cb410ff61f20015ad
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" }

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

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

Nom du champ
Description
URL source de l’é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 "identifiants de publicité Google" (GAID) ou "identifiant Apple 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 sur les clients
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" }

La variable Pinterest Données utilisateur surligné 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 à la variable Pinterest Point de terminaison de l’API, 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 elle n’est pas fournie, Pinterest est définie 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. Envoi order_id will help Pinterest dédupliquez 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é.

La variable Pinterest Données personnalisées surligné 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é à la variable Pinterest L’API s’affiche comme prévu dans Pinterest Interface utilisateur.

Si la collecte d’événements et Experience Platform l’intégration a réussi, vous verrez des événements dans la variable Pinterest Interface utilisateur.

La variable Pinterest gestionnaire dévénements

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

La variable Pinterest répartition des données

Étapes suivantes

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

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