Last updated 27 sept. 2024

Rokt

Le bundle Universal Module Definition (UMD) de Rokt est exposé dans l'objet window et devient disponible après le chargement de la solution Rokt dans la page.

Aperçu

Après avoir chargé le script de Rokt dans la page, le bundle UMD de Rokt sera disponible dans l'objet window sous le nom de window.Rokt. La propriété Rokt peut être utilisée une fois que le script a fini de charger, ce qui peut nécessiter une manipulation supplémentaire si le script est chargé de manière asynchrone.

Exemple de chargement synchrone

<script
  crossorigin="anonymous"
  src="https://apps.rokt.com/wsdk/integrations/launcher.js"
></script>

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

Veuillez noter les paramètres importants suivants dans la liste des arguments ci-dessus :

• https://apps.rokt.com/wsdk/integrations/launcher.js — est l'URL pointant vers la dernière version du lanceur Rokt.
• rokt-account-id — est votre identifiant de compte Rokt unique et doit être remplacé par la valeur correcte. Consultez Où puis-je trouver mon identifiant de compte Rokt ? si vous ne connaissez pas votre identifiant de compte.

Exemple de chargement asynchrone

<script
  async
  crossorigin="anonymous"
  id="rokt-launcher"
  fetchpriority="high"
  src="https://apps.rokt.com/wsdk/integrations/launcher.js"
  type="module"
></script>

await new Promise((resolve) =>
  window.Rokt
    ? resolve()
    : (document.getElementById("rokt-launcher").onload = resolve)
);

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

Veuillez noter les attributs supplémentaires présents sur la balise script :

• async - permet le chargement asynchrone du script
• id="rokt-launcher" - identifiant de l'élément script. Il doit correspondre à l'identifiant passé à document.getElementById('rokt-launcher').
• type="module" - augmente la priorité de la ressource chargée. Voir Bonnes pratiques pour plus de détails.

De plus, l'obtention du bundle UMD de Rokt doit être enveloppée dans une Promise (comme dans l'exemple) pour s'assurer que le code s'exécute uniquement après que le script Rokt chargé de manière asynchrone soit disponible.

Méthodes

createLauncher

▸ createLauncher: (options: IntegrationLauncherOptions): Promise<IntegrationLauncher>

Crée une instance du IntegrationLauncher qui est un point d'entrée pour l'intégration avec Rokt. Il appartient à l'intégrateur de conserver la référence à l'objet créé.

En même temps, une seule instance peut exister. Essayer d'en créer une autre entraînera une erreur à moins que la précédente ne soit terminée.

Paramètres:

Nom	Type	Description
options	IntegrationLauncherOptions	Options pour personnaliser l'intégration

Renvoie: _IntegrationLauncher