AdsWebSDK

Web SDKLien direct vers Web SDK

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

Ajouter le Rokt Web SDKLien direct vers Ajouter le Rokt Web SDK

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 Integrations.
4. Cliquez sur Integrations.
5. Cliquez sur Set up the Snippet.
6. Sélectionnez Record conversions.
7. 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 Tracking ID (passbackconversiontrackingid) comme identifiant. Cette méthode nécessite plus de travail de la part de votre équipe de développement, mais ne requiert aucune information personnellement identifiable.
8. Ajoutez des attributs de données pertinents. Les données contextuelles aident Rokt à en apprendre davantage sur les campagnes et les audiences qui sont 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 :

<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: {
      //identifiant client - au moins un requis
      email: "john.smith@gmail.com",
      emailsha256: "",
      passbackconversiontrackingid: "",

      //attributs de données 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 que roktAccountId est remplacé par l'ID 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 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, 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 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 Rokt Tracking ID) est renseigné avec les données correctes. Configurez également tous les attributs de données.
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 de 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 (Event API) 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.