Test de l'intégration du SDK web de PBA

Recommandé pour

Développeurs

Dernière mise à jour : 26 août 2024 13:34

En bref : Tester l'intégration du plugin PBA du SDK web.

Tester les événements web PBA

Principes d'utilisation de la page de test

Le SDK web envoie des événements web à la PBA, qui sont mis à disposition via les tableaux de bord PBA et les rapports de données brutes, après un traitement quotidien. Pour permettre un processus de test efficace, vous envoyez des événements de test sans attendre le traitement quotidien. Les évènements de test sont les suivants :

Analysé et validé à la réception.
Mis à votre disposition dans l'interface utilisateur. Cela inclut les erreurs de traitement. Si elles existent, envoyez à nouveau des événements corrigés pour vous assurer qu'elles sont traitées correctement.
Elles sont traitées comme n'importe quel autre événement dans le cadre du traitement quotidien. Cela signifie qu'elles sont ajoutées aux tableaux de bord et aux données brutes.

Page de test d'intégration du SDK web

Vue principale de la page

Les événements les plus récents apparaissent en premier.
Cache de l'événement :
- Contient jusqu'à 100 événements
- Les anciens événements sont supprimés pour laisser la place à des événements plus récents
- Les événements mis en cache sont supprimés après 24 heures
Contrôles des pages :
- Indicateur de taux de rafraîchissement: La page est rafraîchie automatiquement toutes les 5 secondes.
- Tout supprimer : Efface définitivement les événements du cache. Attention ! Le cache est commun aux sites web partageant la même clé web dev. Ainsi, si un autre développeur utilise la page de test, celle-ci s'affichera également pour lui.
- Pause/démarrage : Interrompt le rafraîchissement automatique. Les nouveaux événements ne s'affichent pas tant que vous n'avez pas cliqué sur démarrer.

Colonnes du tableau des événements

Champ	Description
Heure (UTC)	Heure de l'évènement
Type d'événement	Les types d'événements sont les suivants : Événements envoyés par vous : `EVENT` `setCustomerUserId` `pageLoad` : Envoyé par le SDK web à chaque fois qu'une page est chargée/réactualisée sur votre site web.
Contenu de l'événement	La charge utile de l'événement, telle qu'enregistrée par PBA.
Commentaires	Valide : PBA a reçu et enregistré l'événement. Aucune autre action n'est requise. Invalide : Liste des erreurs nécessitant une action corrective. Le format du message d'erreur est le suivant : nom du champ de l'événement : description de l'erreur Survolez les messages d'erreur pour en voir les détails :

Vue en étude détaillée

Cliquez sur une ligne d'événement pour afficher son contenu après traitement. Pour plus d'informations, voir les paramètres d'événement du SDK web

Procédures

Complétez les procédures suivantes.

Activer le mode test

Conditions techniques

Avant de procéder aux tests, le SDK web doit être mis en œuvre sur votre site web ou sur un site web de test.

Limitation du navigateur

Si le mode test est activé sur un navigateur donné, quel que soit l'onglet, le navigateur ne peut être utilisé que pour se connecter au site web spécifié et à aucun autre site web. Utiliser un autre navigateur, par exemple Safari au lieu de Chrome, pour se connecter à un autre site web à partir de la même machine.

Pour activer le mode test :

Vérifiez que le SDK est chargé :
1. Dans AppsFlyer, dans le menu supérieur, sélectionnez Mes applications > Voir les bundles de marques.
2. Sélectionnez le test d'intégration SDK web requis.
  La page d'intégration s'ouvre. La clé web dev s'affiche.
3. Dans un nouvel onglet du navigateur, accédez à votre site web (sur lequel le SDK web est installé).
4. Cliquez avec le bouton droit de la souris et sélectionnez inspecter pour ouvrir les outils de développement du navigateur.
5. Allez dans l'onglet Console.
6. Dans la console, entrez :
```
window.AF_SDK.initPluginsConfig.pba.webAppId
```
  Le webAppID s'affiche.
7. Vérifiez que l'identifiant webAppID est identique à la clé web dev dans la page de test d'intégration du SDK web.
Activer le mode test :
1. Dans l'onglet du navigateur du site web, allez à l'onglet Console.
2. Saisissez :
```
window.AF_SDK.PLUGINS.PBA.turnOnDevMode()
```
  La fonction renvoie undefined.
Vérifiez que le mode test est activé :
- Dans l'onglet Console, appuyez sur Entrée :
```
window.AF_SDK.PLUGINS.PBA.isDevModeOn()
```
  La valeur de retour est true. Ceci indique que le mode test est actif.

Envoyer des événements de test

En mode test, les événements que vous envoyez sont affichés dans la page d'intégration des tests.
Attention ! Les événements de test sont traités et seront ensuite inclus dans les rapports PBA. Pour éviter de fausser les rapports, remplissez eventRevenue avec des valeurs faibles (petites). Si aucune valeur n'est envoyée, PBA remplit le champ avec 0.

Envoyez des exemples d'événements pour chacun des types décrits.

Étape

Action

(Saisir les commandes)

Page d'intégration des tests du SDK web

(Résultat attendu)

Ouvrez un nouvel onglet dans le navigateur et accédez à n'importe quelle page de votre site web.

PBA enregistre un événement 'pageLoad' chaque fois que votre site web s'ouvre/se rafraîchit :

Connectez-vous/enregistrez-vous sur votre site web en tant qu'utilisateur pour déclencher un événement setCustomerUserId.

Commencez à envoyer des événements web pour vérifier que PBA les traite correctement.

Remarque :

Si elles ne sont pas spécifiées, eventRevenue et eventRevenueCurrency sont remplies avec des valeurs par défaut :

eventRevenueCurrency: "USD"
eventRevenue: 0

Voir les paramètres d'événement du SDK web pour plus de détails.

Dépannage

Les événements ne s'affichent pas sur la page de test

Dans les outils de développement du navigateur, allez dans l'onglet Réseau.
Dans le champ du filtre, entrez "websdk".
En fonction du code de réponse HTTP, procédez comme suit :
- 200 : Contactez le support technique d'AppsFlyer.
- 400 : Vérifiez que tous les paramètres sont entourés de " ".