Last updated 5 déc. 2024

Tester

Tester votre intégration

Nous recommandons de tester l'intégration du Web SDK pour s'assurer qu'il se charge correctement et charge les attributs de données comme prévu.

Avant de commencer

Vous pouvez suivre les étapes ci-dessous pour tester votre intégration Web SDK Rokt Ecommerce ou Rokt Ads.

1. Ouvrez une nouvelle fenêtre dans votre navigateur.

2. Ouvrez le panneau des outils de développement de votre navigateur. Pour la plupart des navigateurs, vous pouvez le faire en cliquant avec le bouton droit sur votre écran et en cliquant sur Inspecter.

3. Dans le panneau des outils de développement, allez dans l'onglet Réseau et tapez experiences dans la barre de filtre.

4. Naviguez vers le site et la page où le Web SDK a été placé.

   Remarque : Assurez-vous que les outils de développement sont ouverts avant de naviguer vers votre site pour vous assurer que l'appel /experiences est enregistré par le navigateur.

5. Dans l'onglet Réseau du panneau des outils de développement, vous devriez voir au moins une requête /experiences. Cela indique que le Web SDK s'est chargé avec succès.

6. Cliquez sur la requête /experiences (elle devrait avoir un statut de 200). Vérifiez l'onglet Payload/Request pour vérifier les données partagées avec Rokt.

   Remarque : Pendant les tests, vous pourriez voir un autre appel /experiences avec un statut 204. Assurez-vous que vous effectuez la vérification sur l'appel avec un statut de 200.

Dépannage

Le Rokt Web SDK fournit des rapports d'erreur contextuels. Si vous avez des difficultés à valider votre intégration, la meilleure façon de déboguer le problème est de vérifier l'onglet Console dans les outils de développement du navigateur.

Il peut y avoir d'autres erreurs en dehors du code Web SDK. Vous pourriez rencontrer l'une des erreurs courantes suivantes :

Erreurs de syntaxe

Assurez-vous de ne manquer aucune virgule dans votre code d'intégration.

Pour vérifier les erreurs de syntaxe :

1. Allez dans l'onglet Console des outils de développement du navigateur.

2. Si le fichier où vous avez placé le Web SDK a une erreur, elle apparaîtra dans la console. Cliquez sur le fichier pour voir le code et l'erreur du navigateur.

   

3. Toute erreur est indiquée dans le fichier. En particulier, vérifiez que tous les attributs sont séparés par des virgules comme indiqué ci-dessous.

Incorrect :

email: ''
emailsha256: '',

Correct :

email: '',
emailsha256: '',

Autres erreurs courantes

• Assurez-vous que le script a été placé sur la bonne page.
• Si vous utilisez un gestionnaire de balises, assurez-vous que les déclencheurs sont configurés correctement afin que le script se charge sur la bonne page.

Intégration de sandbox

Avec une intégration de sandbox, vous pouvez ajouter un drapeau de configuration pour tester contre un environnement de sandbox. L'environnement de sandbox suit un processus normal d'offres, d'enchères et de correspondance par rapport à votre configuration de production. Bien qu'un environnement de sandbox fasse partie de l'environnement de production Rokt, il ne facture pas les annonceurs et ne génère pas de références. En conséquence, vous pouvez l'utiliser pour les tests d'acceptation avant de déployer en production.

L'intégration suit les mêmes étapes que dans les exemples précédents, avec un drapeau sandbox supplémentaire requis dans la fonction d'initialisation.

Voir Rokt.createLauncher pour plus de détails sur la méthode.

const launcher = await createLauncher({
  accountId: 'rokt-account-id',
  sandbox: true,
});

Une fois que le drapeau sandbox est défini, vous devriez voir la solution de Rokt exécutant des appels API contre https://apps-demo.rokt.com au lieu de la production https://apps.rokt.com, garantissant que le sandboxing fonctionne correctement.

remarque

Le drapeau sandbox ne doit être utilisé que dans des environnements de test.