Aller au contenu principal

Intégration directe

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​

Avant de commencer, assurez-vous d'avoir votre identifiant de compte Rokt. Pour le trouver, consultez les instructions ici.

  1. Obtenez votre code d'intégration unique auprès de votre gestionnaire de compte Rokt, ou générez-le vous-même dans 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 prenons en charge les attributs suivants :

      Nom de l'attributDescription de l'attribut
      emailEmail brut
      emailsha256Email haché (SHA-256)
      passbackconversiontrackingidID Rokt

      Nous vous recommandons d'utiliser l'adresse e-mail brute ou hachée (SHA-256) du client en tant qu'identifiant. En alternative à l'e-mail haché ou brut, vous pouvez utiliser l'ID Rokt 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. Certains attributs que nous recommandons sont :

    • firstname
    • lastname
    • conversiontype
    • amount
    • currency
    • quantity
    • paymenttype
    • marge
    • confirmationref

Exemple d'intégration​

attention

Le code ci-dessous est un exemple d'intégration. Votre code d'intégration sera différent en fonction de l'identifiant du client et des attributs supplémentaires que vous avez décidé d'intégrer.

Voici un exemple d'intégration où un utilisateur a sélectionné :

  • L'e-mail brut comme identifiant du client.
  • Le prénom, le nom, le montant, la devise et le type de paiement comme attributs contextuels.
<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: {
      /// Le client a intégré l'e-mail brut. Lors de la configuration de votre intégration, modifiez cette valeur avec l'identifiant du client que vous avez choisi.
      email: "john.smith@gmail.com",
      /// Le client a choisi les attributs supplémentaires suivants. Lors de la configuration de votre intégration, modifiez ces valeurs avec les attributs supplémentaires que vous avez décidé d'intégrer.
      firstname: "",
      lastname: "",
      amount: "",
      currency: "",
      paymenttype: "",
  });
</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.

  1. 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.

  2. Remplissez vos attributs de données. Assurez-vous qu'au moins votre identifiant client (adresse e-mail ou ID Rokt) est rempli avec les données correctes. Configurez également tous les attributs contextuels.

    1. Si vous souhaitez utiliser une 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 d'intégration des données en deux étapes.

  3. 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 les anomalies qui peuvent se produire dans le navigateur ou sur votre serveur.

Cet article vous a-t-il été utile ?