Last updated 24 oct. 2023

ConversionAttribution

La mise en place d'un rapport de conversion automatique permet aux clients de Rokt Ads de mesurer l'impact de vos campagnes sur votre entreprise. Rokt propose plusieurs 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 indiquées ci-dessous.

Bien que moins précis, nous prenons également en charge les rapports de conversion via des outils de mesure tiers, le transfert de fichiers et le 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 centre d'intégration Rokt Ads pour obtenir des instructions détaillées sur l'intégration.

Web SDK

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

Ajouter le Web SDK de 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 faire correspondre correctement les événements de campagne aux conversions. Nous vous recommandons d'utiliser l'adresse e-mail brute ou hachée (SHA-256) du client en tant qu'identifiant.
  remarque
  En alternative à l'e-mail haché ou brut, vous pouvez utiliser l'ID Rokt (passbackconversiontrackingid) en tant qu'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 connaissances pour optimiser l'acquisition et améliorer les performances de vos campagnes à l'avenir.
  Votre code d'intégration ressemblera à ceci :

<script type="module">
  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";
  target.appendChild(script);
  await new Promise((resolve) =>
    window.Rokt
      ? resolve()
      : document
          .getElementById("rokt-launcher")
          .addEventListener("load", () => resolve())
  );

  const launcher = await window.Rokt.createLauncher({
    accountId: "roktAccountId",
  });

  await launcher.selectPlacements({
    attributes: {
      //customer identifier - at least one required
      email: "john.smith@gmail.com",
      emailsha256: "",
      passbackconversiontrackingid: "",

      //attributs contextuels recommandés
      firstname: "",
      lastname: "",
      conversiontype: "",
      amount: "",
      currency: "",
      quantity: "",
      paymenttype: "",
      margin: "",
      confirmationref: "",
    },
  });
</script>

L'explication des différentes parties de l'exemple de code peut être trouvée dans la documentation de la bibliothèque Web SDK.

attention

Si vous copiez l'exemple ci-dessus, assurez-vous de remplacer roktAccountId par l'identifiant unique de votre compte avant de passer à l'étape suivante. Vous pouvez obtenir votre roktAccountId auprès de votre gestionnaire de compte ou sur my.rokt.com.

Ajoutez le code d'intégration à votre page de confirmation.
1. Vous devez placer le code d'intégration sur n'importe quelle 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, entre les balises <head></head>.
2. Assurez-vous que l'intégration enregistre toutes les conversions sur votre site. Rokt peut ensuite gérer le processus d'attribution pour déterminer quelles conversions ont résulté d'un événement de campagne Rokt.
  Gestionnaires de balises
  Vous pouvez ajouter le code d'intégration Rokt à votre site à l'aide d'un gestionnaire de balises, mais cela peut entraîner une réduction des performances en raison de la suppression 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 qu'au moins votre identifiant client (adresse e-mail ou ID Rokt) est renseigné avec les données correctes. Configurez également tous les attributs contextuels.
1. Si vous souhaitez utiliser l'adresse e-mail hachée comme identifiant, vous pouvez utiliser la fonction de hachage pré-construite de Rokt. Vous trouverez des informations supplémentaires sur la page 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 Web SDK. L'utilisation des deux méthodes crée une redondance et aide à identifier les éventuelles anomalies pouvant survenir dans le navigateur ou sur votre serveur.

API d'événement

L'API d'événement offre d'autres options aux annonceurs souhaitant 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.

L'utilisation de l'API d'événement en tant qu'intégration autonome pour les données de conversion offre plusieurs avantages :

Rapidité : Permet un échange de données entièrement automatisé et quasi 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, ce qui se traduit par une couverture des conversions sur le web, le 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 des technologies web telles que les bloqueurs de navigateur ou de publicités. 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 de Rokt et obtenir votre ID de compte. Si vous n'avez pas de compte, contactez votre responsable de compte.
Obtenez votre ID d'application et votre secret d'application depuis my.rokt.com. Vous avez besoin de ces informations pour vous authentifier auprès de l'API d'événement. Consultez les étapes pour récupérer vos informations d'identification.
Assemblez votre charge utile pour l'API d'événement. Vous pouvez utiliser le point de terminaison POST /v1/events pour envoyer n'importe quel type d'événement de conversion à Rokt.
1. Pour ce cas d'utilisation, définissez toujours 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 à optimiser vos campagnes à l'avenir.
  Rokt exige au moins l'un des éléments suivants : l'e-mail (email), l'e-mail haché en SHA-256 (emailsha256) ou l'ID Rokt (passbackconversiontrackingid), afin de pouvoir identifier le client. Les champs suggérés pour objectData sont disponibles dans le tableau ci-dessous.
Référence complète du point de terminaison
Consultez les détails de référence complets 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 suggérés pour `objectData`

L'objet objectData est composé de paires clé-valeur qui contiennent des métadonnées sur l'événement. Afin d'attribuer correctement les conversions, vous devez inclure l'un des champs suivants dans objectData : email (email), email hashé en SHA-256 (emailsha256) ou ID Rokt (passbackconversiontrackingid), 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 en texte brut, en minuscules et sans espaces à la fin	`john@email.com`
`emailsha256`	Hash SHA256 de l'adresse email. Avant le hashage, en minuscules et sans espaces à la 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 (autorise les décimales)	`100.25`
`currency`	Code de devise	`USD`
`quantity`	La quantité (entier) de l'article dans la conversion spécifique	`4`
`conversiontype`	Utilisé pour différencier les différents types d'événements de conversion. Remarque : Applicable uniquement si le type d'événement de conversion par défaut est fourni.	`achatbillet`, `miseàniveauplace` `inscription`
`productname`	Le nom du/des produit(s) acheté(s). Vous pouvez séparer plusieurs articles par une virgule.	`T-shirt Maroon 5, Warriors vs. Raptors`
`sku`	L'identifiant du produit acheté (Remarque : n'accepte qu'un seul SKU)	`230847`, `tshirt-bleu-39487`, `398fhdnff`
`paymenttype`	La méthode de paiement utilisée 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 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 des données qui nous permet de mapper les noms de champ fournis à nos champs de données internes, cependant, nous avons quelques noms de champ recommandés et des exigences de formatage plus tard dans cet article. Si vous souhaitez utiliser des noms de champ alternatifs, faites-le nous savoir et nous veillerons à ce que vos champs soient gérés en conséquence. De plus, nous pouvons accepter des champs supplémentaires si vous souhaitez les fournir à des fins de reporting.

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

Si possible, nous vous recommandons de configurer le reporting des conversions à la fois via le Web SDK et l'API d'événements. Cela permet d'identifier les éventuelles anomalies 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 renseigner l'une des variables transactionid ou confirmationref dans les intégrations du Web SDK et de l'API d'événements. Rokt peut ensuite dédupliquer les événements de conversion entrants en utilisant ces variables, garantissant ainsi l'exactitude de vos rapports.

Web SDK​

Ajouter le Web SDK de Rokt​

API d'événement​

Ajouter l'API d'événement​

Exemple​

Champs suggérés pour objectData​

Attributs personnalisés​

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