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 transmettre votre identifiant unique Rokt Account ID. Les autres paramètres sont facultatifs et vous permettent de configurer le comportement de l'intégration.
Propriétés
accountId
• accountId : string
Votre identifiant unique Rokt Account ID. Voir Où puis-je trouver mon Rokt Account ID ? pour savoir comment trouver votre Rokt Account ID.
noFunctional (optionnel)
• noFunctional? : boolean
default false
Un indicateur booléen permettant de gérer la préférence de l'utilisateur pour les cookies fonctionnels. Les cookies fonctionnels vous permettent de fournir les expériences clients 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 ventes supplémentaires). En pratique, définir la valeur sur 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, 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ée sans facteurs externes tels que la durée nécessaire à l'utilisateur pour atteindre cette page. Avec cette information, Rokt peut détecter toute anomalie dans les temps de chargement pouvant impacter l'efficacité de l'intégration.
défaut PerformanceNavigationTiming.responseStart
Voir Détection d'anomalies pour savoir comment Rokt suit la performance de chargement.
Voir Applications monopage pour les détails des intégrations SPA
sandbox (optionnel)
• sandbox? : boolean
défaut false
Un indicateur booléen indiquant si l'environnement sandbox doit être utilisé pour la session.
Cela ne devrait jamais être réglé sur true en production.
L'indicateur est utile dans les cas suivants :
- Un partenaire souhaite effectuer des tests d'acceptation utilisateur avec la configuration de production sans générer de références, 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 des exemples supplémentaires.
sessionId (optionnel)
• sessionId? : string
ID de session Rokt à transmettre au cas où vous auriez déjà généré votre ID de session.
Par exemple, il est possible que votre ID de session soit généré en se connectant au 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é comme 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 les ouvertures de liens. À la place, un événement partenaire LINK_NAVIGATION_REQUEST sera émis.
Ce drapeau est utile dans des 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 lien—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 annonceurs, les partenaires peuvent vérifier si l'URL contient la sous-chaîne "rokt.com".
Pour assurer une bonne gestion des événements, un mécanisme de temporisation 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 en sera informé.