ConversionAttribution
Configurer le reporting de conversion automatique aide les clients de Rokt Ads à mesurer l'impact de vos campagnes sur leur entreprise. Rokt offre une variété de façons d'intégrer vos données de conversion. Pour une plus grande précision, nous recommandons d'utiliser le Web SDK ou l'Event API. Les instructions pour chaque méthode sont listées ci-dessous.
Bien que moins précises, nous supportons également le reporting de conversion via le transfert de fichiers et le téléchargement manuel.
Les propriétaires de boutiques Shopify peuvent installer l'application Rokt Shopify en un seul clic pour commencer à reporter les données de conversion. Contactez votre gestionnaire de comptes si vous souhaitez explorer l'option Shopify.
Veuillez consulter notre centre d'intégration Rokt Ads pour des étapes d'intégration détaillées.
Web SDK
Le Web SDK de Rokt est une bibliothèque JavaScript qui vous permet de reporter automatiquement les conversions depuis le frontend de votre site web.
Ajouter le SDK Web
Obtenez votre code d'intégration unique auprès de votre responsable de compte Rokt, ou générez-le vous-même dans my.rokt.com.
Connectez-vous à my.rokt.com.
Cliquez sur votre compte.
Cliquez sur Intégrations.
Cliquez sur Configurer le Snippet.
Sélectionnez Enregistrer les conversions.
Choisissez un identifiant client afin que Rokt puisse faire correspondre correctement les événements de campagne aux conversions. Nous vous recommandons d'utiliser l'adresse e-mail client brute ou hachée (SHA-256) comme identifiant.
remarqueEn alternative aux e-mails hachés ou bruts, vous pouvez utiliser l' ID Rokt (
passbackconversiontrackingid) comme identifiant. Cette méthode nécessite plus de travail de la part de votre équipe de développement, mais ne nécessite aucune information personnellement identifiable.Ajoutez des attributs de données pertinents. Les données contextuelles aident Rokt à en apprendre davantage sur les campagnes et les audiences les plus efficaces pour votre entreprise. Nous utilisons ces enseignements pour optimiser l'acquisition et aider vos campagnes à mieux performer à l'avenir.
Votre code d'intégration ressemblera à ceci :
<!DOCTYPE html>
<html lang="fr">
<head>
<!-- Meta tags -->
<!-- Part #1 - Charger le SDK Web -->
<script type="module">
window.RoktLauncherScriptPromise = new Promise((resolve, reject) => {
const target = document.head || document.body;
const script = document.createElement("script");
script.type = "text/javascript";
script.src = "https://apps.rokt.com/wsdk/integrations/launcher.js";
script.fetchpriority = "high";
script.crossOrigin = "anonymous";
script.async = true;
script.id = "rokt-launcher";
script.addEventListener('load', () => resolve());
script.addEventListener('error', (error) => reject(error));
target.appendChild(script);
});
</script>
<!-- Autres scripts et meta tags -->
</head>
<body>
<!-- Votre contenu HTML ici -->
<!-- Part #2 - Dès que les attributs de données sont disponibles, exécutez le script ci-dessous pour afficher un placement Rokt -->
<script type="module">
await window.RoktLauncherScriptPromise;
const launcher = await window.Rokt.createLauncher({
```javascript
accountId: "rokt-account-id"
});
await launcher.selectPlacements({
attributes: {
//identifiant client - au moins un requis
email: "john.smith@gmail.com",
emailsha256: "",
passbackconversiontrackingid: "",
firstname: "",
lastname: "",
conversiontype: "",
billingzipcode: "",
amount: "",
mobile: "",
currency: "",
quantity: "",
paymenttype: "",
margin: "",
confirmationref: "",
},
});
</script>
<!-- Votre contenu HTML ici -->
</body>
</html>
L'explication des différentes parties de l'exemple de code peut être trouvée dans la documentation de la bibliothèque Web SDK.
Si vous copiez l'exemple ci-dessus, assurez-vous que rokt-account-id est remplacé par l'ID unique de votre compte avant de continuer à l'étape suivante. Vous pouvez obtenir votre rokt-account-id auprès de votre gestionnaire de compte ou sur my.rokt.com.
Ajoutez le code d'intégration à votre page de confirmation.
Vous devez placer le code d'intégration sur toute page qui suit immédiatement un événement de conversion, typiquement une page de confirmation ou de remerciement. Collez le code d'intégration directement dans le HTML de la page, en suivant la structure suggérée.
Assurez-vous que l'intégration enregistre toutes les conversions sur votre site. Rokt peut alors gérer le processus d'attribution pour déterminer quelles conversions résultent d'un événement de campagne Rokt.
Gestionnaires de balisesVous pouvez ajouter le code d'intégration Rokt à votre site en utilisant un gestionnaire de balises, mais cela peut entraîner une performance réduite en raison de la perte de certains événements de conversion. Pour de meilleurs résultats, nous recommandons l'intégration directe décrite sur cette page.
Remplissez vos attributs de données. Assurez-vous que votre identifiant client (email ou ID Rokt) est rempli avec les bonnes données. Configurez également tous les attributs de données.
- Si vous souhaitez utiliser une adresse email hachée comme identifiant, vous pouvez utiliser la fonction de hachage préconstruite de Rokt. Vous pouvez trouver des informations supplémentaires sur la page d'intégration de données en deux étapes.
Testez que l'intégration est engageante et contient les bonnes données. Consultez les instructions de test.
Pour des performances optimales, envisagez d'intégrer à la fois l'API d'événements et le SDK Web. L'utilisation des deux méthodes crée une redondance et aide à identifier toute anomalie pouvant survenir dans le navigateur ou sur votre serveur.
### API d'événements {#event-api}
L'API d'événements offre une autre option pour les annonceurs souhaitant intégrer des données de conversion avec Rokt. En utilisant l'API d'événements, votre serveur backend peut se connecter en toute sécurité à celui de Rokt, transmettant les données de conversion en temps réel.
L'utilisation de l'API d'événements comme intégration autonome pour les données de conversion présente plusieurs avantages :
- **Vitesse** : Permet un échange de données entièrement automatisé, presque en temps réel, maximisant le potentiel des outils d'optimisation automatisés de Rokt.
- **Couverture** : Permet l'intégration d'événements sur tous les canaux et appareils, permettant une couverture pour les conversions sur le web, mobile et en magasin.
- **Fiabilité** : En tant qu'intégration serveur à serveur, l'API d'événements n'est pas sujette à des interférences par des technologies web telles que le blocage de publicité ou de navigateur. Elle prend également en charge la gestion des erreurs, garantissant que les données ne sont jamais perdues.
#### Ajouter l'API d'Événement
1. Assurez-vous de pouvoir vous connecter à [my.rokt.com](https://my.rokt.com) et [obtenir votre ID de compte](#account-id). Si vous n'avez pas de compte, contactez votre responsable de compte.
2. Obtenez votre clé publique et votre clé secrète. Contactez votre responsable de compte pour recevoir cet ensemble de clés.
3. Assemblez votre charge utile pour l'API d'Événement. Vous pouvez utiliser le point de terminaison `POST /v2/events` pour envoyer tout type d'événement de conversion à Rokt.
1. Pour ce cas d'utilisation, veillez toujours à définir `eventType` sur `conversion` afin que Rokt sache déclencher le processus d'attribution de conversion.
2. Incluez des paires clé-valeur pertinentes dans `objectData`. Fournir des données contextuelles pertinentes aide Rokt à mieux optimiser vos campagnes à l'avenir.
Rokt nécessite au moins un des éléments suivants : email (`email`), email haché en SHA-256 (`emailsha256`) ou ID Rokt (`passbackconversiontrackingid`) afin que Rokt puisse identifier le client. Les champs `objectData` suggérés sont disponibles dans le [tableau ci-dessous](#suggested-objectdata-fields).
:::note Référence complète du point de terminaison
Consultez les détails de référence complets pour l'[API d'Événement](/developers/api-reference/event-api).
:::
#### Échantillon
```JSON
POST /v2/events
{
"accountId": "12345",
"events": [
{
"clientEventId": "ff3bd69c-ca74-4337-af91-4d5d0bd00e38",
"eventTime": "2020-05-22T10:21:29.339Z",
"eventType": "conversion",
"objectData": [
{
"name": "email",
"value": "email123@emailserver.com"
},
{
"name": "transactionid",
"value": "123456789"
},
{
"name": "amount",
"value": "99.80"
},
{
"name": "currency",
"value": "USD"
},
{
"name": "quantity",
"value": "2"
},
{
"name": "conversiontype",
"value": "hotel_booking"
},
{
"name": "margin",
"value": "10"
},
]
}
]
Champs objectData suggérés
L'objet objectData est constitué de paires clé-valeur contenant des métadonnées sur l'événement. Afin d'attribuer correctement les conversions, vous devez inclure l'un des éléments suivants : email (email), email haché en SHA-256 (emailsha256), ou ID Rokt (passbackconversiontrackingid) dans objectData afin que Rokt puisse identifier le client.
Pour le cas d'utilisation de reporting de conversion, nous vous recommandons d'inclure les attributs suivants.
| Nom du champ | Description | Exemple |
|---|---|---|
email | Email transmis en texte brut, en minuscules et sans espaces de fin | john@email.com |
emailsha256 | Hachage SHA256 de l'adresse email. Avant le hachage, en minuscules et sans espaces de fin. | fab1e2e699b3b927cbf875046a64f222 5df02d5cb306f3857424c2bbb87be61f |
passbackconversiontrackingid | Également connu sous le nom d'ID Rokt. Un ID généré par Rokt utilisé pour faire correspondre les événements de conversion au clic d'origine. Nécessite une intégration séparée. | 1bc29b36f623ba82aaf6724fd3b16718 |
amount | Valeur de la transaction (permet les points décimaux) | 100.25 |
currency | Code de la devise | USD |
quantity | La quantité (entier) d'articles dans la conversion spécifique | 4 |
conversiontype | Utilisé pour différencier les différents événements de conversion. Remarque : Applicable uniquement si le type d'événement de conversion par défaut est fourni. | ticketpurchase, seatupgrade signup |
productname | Le nom du ou des produit(s) achetés. Vous pouvez séparer plusieurs articles par une virgule. | Maroon 5 t-shirt, Warriors vs. Raptors |
sku | L'identifiant du produit acheté (Remarque : n'accepte qu'un seul SKU) | 230847, tshirt-blue-39487, 398fhdnff |
paymenttype | Le mode de paiement utilisé lors de la transaction | VISA, American Express |
margin | Marge bénéficiaire de la conversion | 10 |
transactionid | ID de la transaction, utilisé pour identifier une transaction unique. Remarque : Si fourni, Rokt utilise cet identifiant pour dédupliquer les événements de conversion à travers les canaux. | ABC789 |
confirmationref | ID de référence de confirmation. Identifiant alternatif qui peut être utilisé pour identifier une transaction unique et/ou suivre les confirmations de commande. Remarque : Si fourni, Rokt utilise cet identifiant pour dédupliquer les événements de conversion et transactionid n'est pas disponible. | XYZ123 |
firstname | Prénom du client | John |
lastname | Nom de famille du client | Smith |
mobile | Numéro de téléphone mobile du client converti | 3053211654, +1 (323) 867-5309 |
ipaddress | Adresse IP du client | 172.3.51.182 |
Attributs personnalisés
Rokt dispose d'un système de mappage de données qui nous permet d'associer les noms de champs fournis à nos champs de données internes, cependant nous avons quelques noms de champs et exigences de format recommandés plus loin dans cet article. Si vous souhaitez utiliser des noms de champs alternatifs, faites-le nous savoir et nous nous assurerons que vos champs sont gérés en conséquence. De plus, nous pouvons accepter tout champ supplémentaire si vous souhaitez les fournir à des fins de reporting.
Intégration premium : Combiner le Web SDK et l'API d'événements
Si possible, nous vous recommandons de configurer le reporting de conversion à travers le Web SDK et l'API d'événements. Cela permet d'identifier toute anomalie et offre une redondance en cas de problèmes sur le frontend ou le backend.
Si vous choisissez de configurer les deux intégrations, assurez-vous de remplir l'un des transactionid ou confirmationref dans les intégrations du Web SDK et de l'API d'événements. Rokt peut alors dédupliquer vos événements de conversion entrants en utilisant ces variables, garantissant ainsi l'exactitude de vos reportings.