Dépannage

Ce guide décrit les étapes de dépannage courantes pour corriger les erreurs d'implémentation courantes.

Aucun événement

Si vos événements ne s'affichent pas dans Google Analytics, vous devez rechercher quelques problèmes courants.

Commencez par choisir votre client :

• Utilisez-vous la bonne clé api_secret ?

  Vérifiez que vous utilisez la clé api_secret pour le bon flux. Si vous configurez le protocole de mesure pour plusieurs flux, chacun d'eux aura sa propre clé secrète.

• Votre clé api_secret est-elle toujours valide ?

  Pour lutter contre le spam, vous pouvez révoquer les clés api_secret. Assurez-vous que la clé api_secret que vous utilisez est toujours valide. Il est possible qu'un autre utilisateur ayant accès à votre flux ait révoqué l'accès par erreur.

• Votre clé api_secret est-elle correctement copiée ?

  La clé api_secret est sensible à la casse. Vérifiez que la clé api_secret de l'interface utilisateur Google Analytics est exactement la même que celle que vous utilisez dans votre code.

• N'utilisez pas advertising_id.

  advertising_id n'est pas compatible en tant qu'identifiant d'appareil valide. Utilisez app_instance_id si vous utilisez Firebase et client_id si vous utilisez gtag.js.

• Utilisez-vous le bon firebase_app_id ?

  Assurez-vous d'utiliser l'identifiant d'une application Firebase. Cette valeur se trouve dans la console Firebase sous Project Settings > General > Your Apps > App ID (Paramètres du projet > Général > Vos applications > ID de l'application).

  firebase_app_id est différent de app_instance_id.

• Utilisez-vous le bon app_instance_id ?

  Assurez-vous d'utiliser l'identifiant spécifique à une installation d'une application Firebase. Cette valeur doit être récupérée via le SDK Google Analytics pour Firebase.

  • Android – getAppInstanceId()
  • Kotlin – getAppInstanceId()
  • Swift – appInstanceID()
  • Objective-C – appInstanceID
  • C++ – GetAnalyticsInstanceId()
  • Unity – GetAnalyticsInstanceIdAsync()

  app_instance_id est différent de firebase_app_id.

Identifiants incorrects

Étant donné que le protocole de mesure est compatible avec les ID du SDK Google Analytics pour Firebase et gtag.js, assurez-vous d'utiliser le bon ID. Les ID que vous devez utiliser varient selon que vous utilisez le SDK Google Analytics pour Firebase ou gtag.js. Voici les ID que vous devez utiliser :

SDK Google Analytics pour Firebase

Si vous utilisez le SDK Google Analytics pour Firebase, les ID que vous devez utiliser sont les suivants :

• firebase_app_id : incluez cet ID dans les paramètres de requête pour la requête. Cet ID identifie de manière unique votre application Firebase. Tous les utilisateurs de votre application auront le même firebase_app_id. Il se trouve dans la console Firebase sous :
  Project Settings > General > Your Apps > App ID (Paramètres du projet > Général > Vos applications > ID de l'application)

• app_instance_id : incluez cet ID dans le corps POST de la requête. Cet ID identifie de manière unique une installation donnée d'une application Firebase. Cette valeur sera différente pour chaque installation de votre application. Voici les méthodes permettant de demander cette valeur pour chaque plate-forme Firebase :

  • Android – getAppInstanceId()
  • Kotlin – getAppInstanceId()
  • Swift – appInstanceID()
  • Objective-C – appInstanceID
  • C++ – GetAnalyticsInstanceId()
  • Unity – GetAnalyticsInstanceIdAsync()

Vous ne devez pas utiliser les éléments suivants :

• firebase_instance_id : cet ID ne doit pas être inclus dans votre requête. Cet ID permet d'identifier une instance donnée de l'application, mais il est spécifique à Firebase. Il est utilisé pour des tâches telles que les messages FCM.

gtag.js

Si vous utilisez gtag.js, les ID que vous devez utiliser sont les suivants :

• measurement_id : incluez cet ID dans les paramètres de requête pour la demande. Cet ID identifie de manière unique un flux de données. Tous les utilisateurs de votre site Web auront le même measurement_id. Il se trouve dans l'interface utilisateur Google Analytics sous :
  Administration > Flux de données > choisissez votre flux > ID de mesure
• client_id : incluez cet ID dans le corps POST de la requête. Cet ID identifie de manière unique une instance utilisateur donnée d'un client Web. Cette valeur sera différente pour chaque utilisateur de votre application. Consultez ces exemples pour savoir comment récupérer cette valeur.

Événements de taggage côté serveur manquants

Une installation de Tag Manager côté serveur avec un client de protocole de mesure vous permet d'envoyer des événements au format du protocole de mesure à un conteneur. Le conteneur envoie ensuite ces événements à Google Analytics à l'aide du même mécanisme que tous les autres événements SGTM.

Si vous souhaitez bénéficier de toutes les fonctionnalités du protocole de mesure, envoyez les événements directement au protocole de mesure au lieu de les envoyer à votre conteneur.