このガイドでは、よくある実装エラーを修正するための一般的なトラブルシューティングの手順について説明します。
イベントが表示されない
イベントが Google アナリティクスに表示されない場合は、以下のような一般的な問題をご確認ください。
まず、クライアントを選択してください。
正しい api_secret を使用しているかどうか
正しいストリームの
api_secretを使用していることを確認してください。複数のストリームの測定プロトコルを設定した場合、各ストリームには固有の secret が設定されます。api_secret が引き続き有効かどうか
スパム防止に役立てるため、
api_secretを取り消すことができます。使用しているapi_secretが引き続き有効であることを確認してください。ストリームにアクセスできる別のユーザーが、誤ってそのストリームへのアクセス権を取り消した可能性があります。api_secret が正しくコピーされているかどうか
api_secretでは大文字と小文字が区別されます。Google アナリティクス管理画面のapi_secretが、コードで使用しているものと正確に一致していることを再度確認します。advertising_idを使用していないかどうかadvertising_idは有効なデバイス識別子としてサポートされていません。Firebase を使用している場合はapp_instance_idを使用し、gtag.js を使用している場合はclient_idを使用してください。
ID が無効である
Measurement Protocol では Firebase 向け Google アナリティクス SDK と gtag.js の ID がサポートされているため、正しい ID を使用してください。使用する ID は、Firebase 向け Google アナリティクス SDK と gtag.js のどちらを使用しているかによって異なります。使用する必要のある ID は次のとおりです。
Firebase 向け Google アナリティクス SDK
Firebase 向け Google アナリティクス SDK を使用している場合は、次の ID を使用する必要があります。
firebase_app_id- この ID をリクエストのクエリ パラメータに含めます。この ID によって、Firebase アプリが一意に識別されます。お客様のアプリのユーザーにはすべて同じfirebase_app_idが使用されます。確認するには、Firebase コンソールで以下をクリックします。
[プロジェクト設定] > [全般] > [アプリ] > [アプリ ID]app_instance_id- この ID をリクエストの POST 本文に含めます。この ID によって、Firebase アプリの特定のインストールが一意に識別されます。この値は、アプリのインストールごとに異なります。各 Firebase プラットフォームでこの値をリクエストするためのメソッドは次のとおりです。
次の ID は使用しないでください。
firebase_instance_id- この ID をリクエストに含めることはできません。この ID は、アプリの特定のインスタンスを識別するために使用されますが、Firebase に固有のもので、FCM メッセージなどのタスクに使用されます。
gtag.js
gtag.js を使用している場合は、使用する必要のある ID は次のとおりです。
measurement_id- この ID をリクエストのクエリ パラメータに含めます。この ID によって、データ ストリームが一意に識別されます。お客様のウェブサイトのユーザーにはすべて同じmeasurement_idが使用されます。確認するには、Google アナリティクスの管理画面で以下をクリックします。
[管理] > [データ ストリーム] > [ストリームを選択] > [測定 ID]client_id- この ID をリクエストの POST 本文に含めます。この ID によって、ウェブ クライアントの特定のユーザー インスタンスが一意に識別されます。この値は、アプリのユーザーごとに異なります。この値を取得する方法については、こちらの例をご覧ください。