Last updated 27 sept. 2024

ConversionAttribution

La configuration de la conversion automatique aide les clients de Rokt Ads à mesurer l'impact de vos campagnes sur votre entreprise. Rokt offre diverses façons d'intégrer vos données de conversion. Pour une précision maximale, nous recommandons d'utiliser le Rokt Web SDK ou l'API d'événements. Les instructions pour chaque méthode sont listées ci-dessous.

Bien que moins précis, nous prenons également en charge le rapport de conversion via transfert de fichier et téléchargement manuel.

Rapport de conversion sans code

Les propriétaires de boutiques Shopify peuvent installer l'application Rokt Shopify en un clic pour commencer à rapporter les données de conversion. Contactez votre gestionnaire de compte si vous souhaitez explorer l'option Shopify.

Veuillez consulter notre hub d'intégration Rokt Ads pour des étapes d'intégration détaillées.

SDK Web

Le SDK Web de Rokt est une bibliothèque JavaScript qui vous permet de rapporter automatiquement les conversions depuis le frontend de votre site web.

Ajouter le SDK Web Rokt

Obtenez votre code d'intégration unique auprès de votre gestionnaire de compte Rokt, ou générez-le vous-même sur my.rokt.com.
1. Connectez-vous à my.rokt.com.
2. Cliquez sur votre compte.
3. Cliquez sur Intégrations.
4. Cliquez sur Configurer le Snippet.
5. Sélectionnez Enregistrer les conversions.
6. Choisissez un identifiant client afin que Rokt puisse correctement associer les événements de campagne aux conversions. Nous recommandons d'utiliser l'adresse e-mail client brute ou hachée (SHA-256) comme identifiant.
  remarque
  Comme alternative à l'e-mail haché ou brut, vous pouvez utiliser le Rokt ID (passbackconversiontrackingid) comme identifiant. Cette méthode demande plus de travail de la part de votre équipe de développement, mais ne nécessite aucune information personnellement identifiable.
7. Ajoutez des attributs contextuels pertinents. Les données contextuelles aident Rokt à en savoir plus sur les campagnes et les audiences les plus efficaces pour votre entreprise. Nous utilisons ces apprentissages pour optimiser l'acquisition et aider vos campagnes à mieux performer à l'avenir.
  Votre code d'intégration ressemblera à ceci :

<!DOCTYPE html>
<html lang="en">
<head>
  <!-- Meta tags -->

  <!-- Part #1 - Load the Web SDK -->
  <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>

  <!-- Other scripts and meta tags -->
</head>
<body>
  <!-- Your HTML content here -->

  <!-- Part #2 - As soon as the data attributes are available, execute the below script to display a Rokt placement -->
  <script type="module">
    await window.RoktLauncherScriptPromise;

    const launcher = await window.Rokt.createLauncher({
      accountId: "rokt-account-id"
    });

    await launcher.selectPlacements({
      attributes: {
        //customer identifier - at least one required
        email: "john.smith@gmail.com",
        emailsha256: "",
        passbackconversiontrackingid: "",
        firstname: "",
        lastname: "",
        conversiontype: "",
        billingzipcode: "",
        amount: "",
        mobile: "",
        currency: "",
        quantity: "",
        paymenttype: "",
        margin: "",
        confirmationref: "",
      },
    });
  </script>

  <!-- Your HTML content here -->
</body>
</html>

L'explication des différentes parties de l'exemple de code se trouve dans la documentation de la bibliothèque Web SDK.

attention

Si vous copiez l'exemple ci-dessus, assurez-vous que rokt-account-id est remplacé par l'ID unique de votre compte avant de passer à 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.
1. Vous devriez placer le code d’intégration sur toute page qui suit immédiatement un événement de conversion, généralement 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.
2. 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 balises
  Vous pouvez ajouter le code d'intégration Rokt à votre site en utilisant un gestionnaire de balises, mais cela peut entraîner une réduction des performances 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.
Renseignez vos attributs de données. Assurez-vous qu'au moins votre identifiant client (email ou ID Rokt) est renseigné avec les données correctes. Configurez également tous les attributs contextuels.
1. 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 des données en deux étapes.
Testez que l'intégration est engageante et contient les données correctes. Consultez les instructions de test.

Pour des performances optimales, envisagez d'intégrer à la fois l'API d'événements et le Web SDK. 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énement

L'API d'événement offre une autre option pour les annonceurs cherchant à intégrer des données de conversion avec Rokt. En utilisant l'API d'événement, votre serveur backend peut se connecter en toute sécurité à celui de Rokt, transmettant les données de conversion en temps réel.

Utiliser l'API d'événement comme une intégration autonome pour les données de conversion offre plusieurs avantages :

Vitesse : Permet un échange de données entièrement automatisé et quasi en temps réel, maximisant le potentiel des outils d'optimisation automatisés de Rokt.
Couverture : Permet l'intégration des événements sur tous les canaux et appareils, résultant en une couverture des conversions sur le web, mobile et en magasin.
Fiabilité : En tant qu'intégration serveur à serveur, l'API d'événement n'est pas susceptible d'être perturbée par les technologies web telles que les navigateurs ou les bloqueurs de publicité. Elle prend également en charge la gestion des erreurs, garantissant que les données ne sont jamais perdues.

Ajouter l'API d'événement

Assurez-vous de pouvoir vous connecter à my.rokt.com et obtenir votre ID de compte. Si vous n'avez pas de compte, contactez votre gestionnaire de compte.
Obtenez votre ID d'application et votre secret d'application depuis my.rokt.com. Vous avez besoin de ces informations pour authentifier l'API d'événement. Consultez les étapes pour récupérer vos identifiants.
Assemblez votre charge utile pour l'API d'événement. Vous pouvez utiliser le point de terminaison POST /v1/events pour envoyer tout type d'événement de conversion à Rokt.
1. Pour ce cas d'utilisation, définissez toujours eventType sur conversion afin que Rokt sache qu'il doit déclencher le processus d'attribution de conversion.
2. Incluez des paires clé-valeur pertinentes dans le 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é 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.
Référence complète du point de terminaison
Consultez les détails complets de référence pour l'API d'événement.

Exemple

POST /v1/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 composé 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é SHA-256 (emailsha256), ou Rokt ID (passbackconversiontrackingid) dans objectData afin que Rokt puisse identifier le client.

Pour le cas d'utilisation du rapport de conversion, nous vous recommandons d'inclure les attributs suivants.

Nom du champ	Description	Exemple
`email`	Email passé 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 de Rokt ID. 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 produits 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 transaction, utilisé pour identifier une transaction unique. Remarque : Si fourni, Rokt utilise cet identifiant pour dédupliquer les événements de conversion sur tous les canaux.	`ABC789`
`confirmationref`	ID de référence de confirmation. Identifiant alternatif pouvant ê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 portable du client convertissant	`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 de mapper les noms de champs fournis à nos champs de données internes, cependant nous avons quelques noms de champs recommandés et des exigences de formatage 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 soient gérés en conséquence. De plus, nous pouvons accepter tous les champs supplémentaires si vous souhaitez les fournir à des fins de rapport.

Intégration premium : Combinaison du Web SDK et de l'API d'événements

Si possible, nous recommandons de configurer le rapport de conversion à la fois via le Web SDK et l'API d'événements. Cela aide à identifier toute anomalie et fournit une redondance en cas de problème sur le frontend ou le backend.

Si vous choisissez de configurer les deux intégrations, assurez-vous de remplir l'un des champs transactionid ou confirmationref à la fois dans les intégrations Web SDK et 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 rapports.

SDK Web​

Ajouter le SDK Web Rokt​

API d'événement​

Ajouter l'API d'événement​

Exemple​

Champs objectData suggérés​

Attributs personnalisés​

Intégration premium : Combinaison du Web SDK et de l'API d'événements​