Adobe Experience Platform
Adobe Experience Platform est la fondation de données centralisée et connectée qui alimente la gestion de l'expérience client à travers Adobe Real-Time CDP, Adobe Customer Journey Analytics et Adobe Journey Optimizer. Adobe Experience Platform abrite une grande variété de produits et de services qui offrent aux clients la capacité de gérer leurs flux de marketing de performance, les parcours clients, la collecte de données, les balises et les flux de travail analytiques.
Ce guide décrit les étapes nécessaires pour configurer votre intégration Rokt Event API au sein d'AEP afin d'envoyer facilement des données de conversion complètes et enrichies à Rokt pour connecter l'activité marketing, comme un parrainage, à des résultats qui génèrent de la valeur commerciale, tels qu'une conversion client (par exemple, achats, abonnements ou téléchargements d'applications).
Configuration de l'intégration
Authentification
Authentifier avec l'extension de transfert Rokt Event API nécessite une clé publique Rokt, un secret Rokt et un ID de compte. Contactez votre responsable de compte pour obtenir ces identifiants.
Configuration de l'extension
Les extensions fournissent des types d'éléments de données et des règles avec lesquels vous pouvez travailler. Pour installer l'extension Rokt Event API - Serveur, vous devez d'abord créer une propriété de transfert d'événements. Pour en savoir plus, veuillez vous référer à la documentation Créer une propriété de transfert d'événements.
Allez à l'onglet Transfert d'événements dans la collecte de données à https://experience.adobe.com. Recherchez l'extension Rokt Event API dans le catalogue d'extensions et cliquez sur installer.
En cliquant sur Installer, vous serez invité à entrer votre ID de compte Rokt, votre clé publique Rokt et votre secret Rokt. Il est recommandé de les stocker en tant que Secrets et de les référencer en tant qu'Éléments de données.
Configurez vos éléments de données
Les éléments de données sont un moyen facile de référencer les données qui existent ailleurs. Ils créent des raccourcis qui peuvent être utilisés dans les règles et les configurations d'extension. Lorsque l'emplacement des données sous-jacentes change, ils peuvent être mis à jour pour pointer vers le nouvel emplacement sans avoir à mettre à jour les règles ou les extensions individuelles. En savoir plus sur Éléments de données
Les éléments de données peuvent être les suivants :
- Code personnalisé
- Chemin d'attribut dans votre arc (Contexte de demande Adobe)
- Secret
- IP
Configurez votre règle
Les règles sont une collection de composants de règle (événements, conditions et actions) qui contrôlent le comportement de la propriété de transfert d'événements côté serveur déployée. En savoir plus sur Rules.
Créez une nouvelle règle, donnez-lui un nom unique et ajoutez une condition qui déclenchera votre Action.
Configurez votre action en sélectionnant l'Extension API d'Événement Rokt et en sélectionnant l'action Envoyer l'Événement.
Utilisez vos éléments de données définis ci-dessus pour remplir les champs de votre réponse API d'Événement.
Les données de l'événement doivent contenir des informations sur l'événement
Conversion, telles qu'un temps d'événement (le moment où la conversion a eu lieu) et un identifiant unique (ID d'Événement Client) pour la demande.Les données de l'objet doivent contenir des propriétés d'identification utilisateur sur l'événement de conversion (au moins une des propriétés email, emailsha256 & passbackconversiontrackingid).
La section des données d'informations client doit avoir d'autres attributs que vous pouvez envoyer via l'extension API d'Événement (utilisez
{}pour du JSON brut si vous envoyez uniquement au moins une des 3 propriétés d'identification utilisateur requises).
- Ajoutez des Mappages de Champs Rokt
Pour garantir que les conversions et les métadonnées associées sont envoyées à Rokt dans le bon format, les éléments suivants doivent être capturés et finalement reçus par Rokt (référez-vous à notre public documentation pour une liste complète) :
| Paramètre | Description | Requis / Recommandé |
|---|---|---|
| ID d'Événement | Un identifiant utilisé pour identifier de manière unique un événement | Requis |
| Temps d'Événement | Temps de l'événement en UTC | Requis |
| Email passé en texte brut, en minuscules et sans espaces superflus | L'un des éléments suivants est nécessaire : email, emailsha256, passbackconversiontrackingid. | |
| EmailSHA256 | Hash SHA-256 de l'adresse e-mail, déjà hachée | Voir ci-dessus |
| Passback Conversion Tracking ID | Un ID généré par Rokt utilisé pour faire correspondre les événements de conversion au clic d'origine | Voir ci-dessus |
| Mobile | Numéro de téléphone mobile du client convertissant | Recommandé |
| First Name | Prénom du client | Recommandé |
| Last Name | Nom de famille du client | Recommandé |
La liste complète des fonctionnalités acceptées peut être trouvée dans la section des données d'information client dans le menu déroulant.
- Cliquez sur Enregistrer.
Vous avez maintenant terminé de configurer la Configuration de votre Extension & Action de Règle. Les événements de vos extensions d'étiquettes côté client et vos flux de données du schéma XDM (Experience Data Model) peuvent être configurés pour transmettre des données de conversion à Rokt lorsque certaines conditions sont remplies.