Solução de problemas

Neste guia, descrevemos etapas típicas de solução de problemas para corrigir erros comuns de implementação.

Nenhum evento

Se os eventos não estiverem sendo exibidos no Google Analytics, veja se há alguns problemas comuns:

Primeiro, escolha seu cliente:

• Você está usando a api_secret correta?

  Verifique se você está usando a api_secret para o fluxo correto. Se você configurar o Measurement Protocol em vários fluxos, cada um terá a própria chave secreta.

• Sua api_secret ainda é válida?

  Para ajudar a evitar spam, você pode revogar as api_secrets. Verifique se a api_secret que está sendo usada ainda é válida. É possível que outro usuário com acesso ao seu fluxo tenha revogado o acesso por engano.

• Sua api_secret foi copiada corretamente?

  api_secret diferencia maiúsculas de minúsculas. Verifique se a api_secret na IU do Google Analytics é exatamente igual à que você usa no código.

• Não use o advertising_id.

  advertising_id não é compatível como um identificador de dispositivo válido. Utilize app_instance_id se estiver usando o Firebase e client_id se estiver usando a gtag.js.

IDs inválidos

Como o Measurement Procotol é compatível com IDs da gtag.js e do SDK do Google Analytics para Firebase, use o ID correto. Os IDs que você precisa usar mudam no SDK do Google Analytics para Firebase e na gtag.js. Veja a seguir quais IDs precisam ser usados:

SDK do Google Analytics para Firebase

Se você usa o SDK do Google Analytics para Firebase, os IDs que precisa usar são:

• firebase_app_id: inclua esse ID nos parâmetros de consulta da solicitação. Ele identifica o app do Firebase de maneira exclusiva. Todos os usuários do app terão o mesmo parâmetro firebase_app_id. Encontrado no Console do Firebase em:
  Configurações do projeto > Geral > Seus aplicativos > ID do aplicativo

• app_instance_id: inclua esse ID no corpo POST da solicitação. Ele identifica exclusivamente uma determinada instalação de um app do Firebase. Esse valor será diferente em cada instalação do app. Veja a seguir os métodos para solicitar o valor nas plataformas do Firebase:

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

Não use o seguinte:

• firebase_instance_id: esse ID não deve ser incluído na sua solicitação. Ele é usado para identificar uma determinada instância do app, mas é específico do Firebase, sendo utilizado em tarefas como mensagens do FCM.

gtag.js

Se você usa a gtag.js, os IDs precisam ser os seguintes:

• measurement_id: inclua esse ID nos parâmetros de consulta da solicitação. Ele identifica exclusivamente um fluxo de dados. Todos os usuários do site terão o mesmo parâmetro measurement_id. Encontrado na IU do Google Analytics em:
  Administrador > Fluxos de dados > escolha seu fluxo > ID de métricas
• client_id: inclua esse ID no corpo POST da solicitação. Ele identifica de forma exclusiva uma determinada instância de usuário de um cliente da Web. Esse valor será diferente para cada usuário do app. Confira estes exemplos para saber como recuperar o valor.