This guide outlines common troubleshooting steps to fix common implementation errors.
If your events aren't showing up in Google Analytics, there are a few common issues you should look for.
First choose your client:
Are you using the correct api_secret?
Check that you're using the
api_secretfor the right stream. If you set up the measurement protocol for multiple streams, each stream will have its own secret.
Is your api_secret still valid?
In order to help combat spam, you're able to revoke
api_secrets. Make sure that the
api_secretyou are using is still valid. It's possible that another user with access to your stream may have revoked access to it by mistake.
Is your api_secret copied correctly?
api_secretis case-sensitive. Double check that the
api_secretin the Google Analytics UI is exactly the same as the one you're using in your code.
advertising_idis not supported as a valid device identifier. Use
app_instance_idif you're using Firebase and
client_idif you're using gtag.js.
Since the Measurement Procotol supports IDs from the Google Analytics for Firebase SDK and gtag.js, it's easy to get mixed up on which IDs you should be using. The IDs you should use changes depending on whether you are using the Google Analytics for Firebase SDK or gtag.js. The following outlines which IDs you should be using:
Google Analytics for Firebase SDK
If you're using the Google Analytics for Firebase SDK the IDs you should use are:
firebase_app_id- Include this ID in the query parameters for the request. This ID uniquely identifies your Firebase App. All users of your app will have the same
firebase_app_id. Found in the Firebase console under:
Project Settings > General > Your Apps > App ID
app_instance_id- Include this ID in the POST body for the request. This ID uniquely identifies a given installation of a Firebase App. This value will be different for every installation of your app. The methods to request this value for each Firebase platform are as follows:
You should not use the following:
firebase_instance_id- This ID should not be included in your request. This ID is used for identifiying a given instance of the app, but is Firebase specific. It's used for tasks such as FCM messages.
If you're using gtag.js, the IDs you should use are:
measurement_id- Include this ID in the query parameters for the request. This ID uniquely identifies a Data Stream. All users of your website will have the same
measurement_id. Found in the Google Analytics UI under:
Admin > Data Streams > choose your stream > Measurement ID
client_id- Include this ID in the POST body for the request. This ID uniquely identifies a given user instance of a web client. This value will be different for every user of your app. See [these examples] for how to retrieve this value.