Risoluzione dei problemi

Questa guida descrive i passaggi comuni per la risoluzione dei problemi per correggere gli errori di implementazione comuni.

Nessun evento

Se i tuoi eventi non vengono visualizzati in Google Analytics, ci sono alcuni problemi comuni che devi cercare.

Per prima cosa, scegli il cliente:

• Stai utilizzando il valore api_secret corretto?

  Verifica di utilizzare api_secret per lo stream corretto. Se configuri il protocollo di misurazione per più stream, ogni stream avrà il proprio segreto.

• Il tuo api_secret è ancora valido?

  Per contribuire a combattere lo spam, puoi revocare i api_secret. Assicurati che l'api_secret che stai utilizzando sia ancora valido. È possibile che un altro utente con accesso al tuo stream abbia revocato l'accesso per errore.

• Il valore di api_secret è stato copiato correttamente?

  api_secret è sensibile alle maiuscole. Verifica che api_secret nell'interfaccia utente di Google Analytics sia esattamente lo stesso che utilizzi nel codice.

• Non utilizzare advertising_id.

  advertising_id non è supportato come identificatore di dispositivo valido. Utilizza app_instance_id se utilizzi Firebase e client_id se utilizzi gtag.js.

• Stai utilizzando il firebase_app_id corretto?

  Assicurati di utilizzare l'identificatore di un'app Firebase. Questo valore si trova nella console Firebase in Impostazioni progetto > Generale > Le tue app > ID app.

  firebase_app_id è diverso da app_instance_id.

• Stai utilizzando il app_instance_id corretto?

  Assicurati di utilizzare l'identificatore specifico per un'installazione di un'app Firebase. Questo valore deve essere recuperato tramite l'SDK Google Analytics for Firebase.

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

  app_instance_id è diverso da firebase_app_id.

ID non validi

Poiché Measurement Protocol supporta gli ID dell'SDK Google Analytics for Firebase e di gtag.js, assicurati di utilizzare l'ID corretto. Gli ID da utilizzare cambiano a seconda che tu stia utilizzando l'SDK Google Analytics for Firebase o gtag.js. Di seguito sono riportati gli ID che devi utilizzare:

SDK Google Analytics per Firebase

Se utilizzi l'SDK Google Analytics for Firebase, gli ID che devi utilizzare sono:

• firebase_app_id: includi questo ID nei parametri di query per la richiesta. Questo ID identifica in modo univoco la tua app Firebase. Tutti gli utenti della tua app avranno lo stesso firebase_app_id. Disponibile nella console Firebase in:
  Impostazioni progetto > Generale > Le tue app > ID app

• app_instance_id: includi questo ID nel corpo POST della richiesta. Questo ID identifica in modo univoco una determinata installazione di un'app Firebase. Questo valore sarà diverso per ogni installazione della tua app. I metodi per richiedere questo valore per ogni piattaforma Firebase sono i seguenti:

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

Non devi utilizzare quanto segue:

• firebase_instance_id: questo ID non deve essere incluso nella richiesta. Questo ID viene utilizzato per identificare una determinata istanza dell'app, ma è specifico per Firebase. Viene utilizzato per attività come i messaggi FCM.

gtag.js

Se utilizzi gtag.js, gli ID che devi utilizzare sono:

• measurement_id: includi questo ID nei parametri di query per la richiesta. Questo ID identifica in modo univoco un flusso di dati. Tutti gli utenti del tuo sito web avranno lo stesso measurement_id. Si trova nell'interfaccia utente di Google Analytics in:
  Amministrazione > Stream di dati > scegli il tuo stream > ID misurazione
• client_id: includi questo ID nel corpo POST della richiesta. Questo ID identifica in modo univoco una determinata istanza utente di un client web. Questo valore sarà diverso per ogni utente della tua app. Consulta questi esempi per scoprire come recuperare questo valore.

Eventi di tagging lato server mancanti

Un'installazione di Tag Manager lato server con un client Measurement Protocol ti consente di inviare eventi nel formato Measurement Protocol a un contenitore. Il contenitore invia quindi questi eventi a Google Analytics utilizzando lo stesso meccanismo di tutti gli altri eventi SGTM.

Se vuoi tutte le funzionalità di Measurement Protocol, invia gli eventi direttamente a Measurement Protocol anziché al contenitore.