Last updated 5 déc. 2024

Rokt

Le module de définition universelle (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 window.Rokt. La propriété Rokt peut être utilisée une fois que le script a fini de se charger, ce qui peut nécessiter une gestion supplémentaire si le script est chargé de manière asynchrone.

Exemple de Chargement Synchronous

<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 unique de compte Rokt 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 - active le chargement asynchrone du script
• id="rokt-launcher" - id de l'élément script. Il doit correspondre à l'id passé à document.getElementById('rokt-launcher').
• type="module" - augmente la priorité de la ressource chargée. Voir Best Practices pour plus de détails.

De plus, l'obtention du bundle Rokt UMD 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 de 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, seule 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