Options du lanceur d'intégration
Aperçu
Options pour l'instance de IntegrationLauncher. Lorsqu'une instance du lanceur d'intégration est créée, il est nécessaire de passer votre ID de compte Rokt unique. Les autres paramètres sont optionnels et vous permettent de configurer le comportement de l'intégration.
Propriétés
accountId
• accountId : string
Votre ID de compte Rokt unique. Voir Où puis-je trouver mon ID de compte Rokt ? pour savoir comment trouver votre ID de compte Rokt.
noFunctional (optionnel)
• noFunctional? : boolean
default false
Un indicateur booléen permettant la gestion de la préférence utilisateur pour les cookies fonctionnels. Les cookies fonctionnels vous permettent de fournir les expériences client les plus pertinentes et optimales sur votre propre site, avec une personnalisation améliorée. Ils aident également à alimenter des fonctionnalités avancées au sein du processus de paiement (par exemple, la vente de produits supplémentaires). En pratique, définir la valeur à true empêche Rokt d'utiliser des identifiants de suivi de première partie. Détails sur la fonctionnalité et l'impact de l'utilisation de cette option.
pageInitTimestamp (optionnel)
• pageInitTimestamp? : Date
Dans le cas où le lanceur d'intégration est initialisé sur une page virtuelle d'une SPA (Single Page Application), cette valeur vous permet de fournir le timestamp de la page en cours d'initialisation. Cela permet à Rokt de mesurer correctement la performance de chargement par rapport à la page qui l'a déclenché sans facteurs externes tels que la durée prise par l'utilisateur pour atteindre cette page. Avec cette information, Rokt peut détecter toute anomalie dans les temps de chargement qui pourrait impacter l'efficacité de l'intégration.
par défaut PerformanceNavigationTiming.responseStart
Voir Détection d'anomalies pour savoir comment Rokt suit la performance de chargement.
Voir Applications à page unique pour les détails des intégrations SPA
sandbox (optionnel)
• sandbox? : boolean
par défaut false
Un indicateur booléen indiquant si l'environnement sandbox doit être utilisé pour la session.
Cela ne doit jamais être réglé sur true en production.
Le drapeau est utile dans les cas suivants :
- Un partenaire souhaite effectuer des tests d'acceptation utilisateur sur la configuration de production sans générer de recommandations, avant de lancer en production.
- Le sandbox est utilisé dans un environnement d'intégration continue côté partenaire.
Voir intégration sandbox pour des informations et exemples supplémentaires.
sessionId (optionnel)
• sessionId? : string
ID de session Rokt à transmettre au cas où vous avez déjà généré votre ID de session.
Par exemple, il est possible de générer votre ID de session en se connectant avec le backend Rokt avant de visiter une page où votre balise est affichée. Dans ce cas, vous devez fournir l'ID de session Rokt précédemment généré en tant que ce paramètre afin que Rokt puisse associer les deux interactions ensemble.
overrideLinkNavigation (optionnel)
• overrideLinkNavigation? : boolean
default false
Lorsqu'il est défini sur true, Rokt ne gérera plus directement l'ouverture des liens. À la place, un événement partenaire LINK_NAVIGATION_REQUEST sera émis.
Ce drapeau est utile dans les scénarios où les partenaires nécessitent une gestion personnalisée des liens. Un cas d'utilisation courant est la gestion de différents comportements de liens—comme l'ouverture des liens dans un WebView tout en utilisant un navigateur externe pour les liens de Rokt et des annonceurs. Pour distinguer entre les liens Rokt et ceux des annonceurs, les partenaires peuvent vérifier si l'URL contient la sous-chaîne "rokt.com".
Pour garantir une gestion correcte des événements, un mécanisme de délai d'attente est en place. Si un événement LINK_NAVIGATION_REQUEST n'est pas consommé dans les 3 secondes, une erreur sera levée. Cette précaution garantit que des abonnements actifs existent du côté du partenaire pour traiter l'événement et si ce n'est pas le cas, alors Rokt sera notifié.