Analytics データ収集のデバッグ
この記事では、Adobe Analyticsに送信されたデータをデバッグする際に確認すべき内容について説明します。 次の表で実装方法を見つけ、その節に従います。 予期しないレポートデータを調査する場合は、 リクエストとレポートの比較から始めます。
ネットワーク要求のキャプチャ、デバッグログの有効化、キャンセルされた要求の調査など、すべてのAdobe データ収集に適用される手順とツールについては、 データ収集のデバッグとトラブルシューティング を参照してください。
AppMeasurementとAnalytics拡張機能 appmeasurement
リクエストを見つける appmeasurement-find
ネットワーク要求をキャプチャ し、/b/ss/に対してフィルターを実行します。 Adobe Experience Platform Debuggerなどのタグデバッガーを使用して、これらのリクエストを識別およびデコードできます。
/b/ss/ リクエストが表示されない場合：
- ブラウザーコンソールでJavaScript エラーを確認します。
- Analytics タグ拡張機能を使用する場合は、タグ埋め込みコードがページの
<head>要素の中にあり、ライブラリがテスト対象の環境に公開されていることを確認します。 タグのデバッグモード は、ヒットを送信するルールが実行されたかどうかを示します。 - AppMeasurementを自分でホストしている場合は、ライブラリのURLを直接開いて、ファイルが読み込まれ、コードが含まれていることを確認します。
- リクエストの送信を妨げる可能性のある、広告ブロッカーなどのブラウザー拡張機能を無効にします。
- デバッガーは、iframe内から送信されたリクエストを認識しません。 代わりに、ブラウザー開発者ツールを使用してください。 iFramesでのAppMeasurementの使用を参照してください。
Analyticsが受け取った内容を確認 appmeasurement-contents
- レポートスイート:
/b/ss/の後のパスセグメントには、ヒットを受け取ったレポートスイート IDが一覧表示されます。 開発ページの開発レポートスイートなど、期待するレポートスイートであることを確認します。 - 変数:Raw リクエストでは、変数名ではなくクエリパラメーター名が使用されます。例えば、eVar1は
v1として表示され、prop1はc1として表示されます。 変数参照を参照してください。 リクエストが長すぎると、AppMeasurementはHTTPPOSTでリクエストを送信するので、変数はURLではなくリクエスト本文に表示されます。 - ヒットの種類:
tl()が送信したリクエストにはpeパラメーターが含まれており、ページビューを増分しません。t()様が送信したリクエストにはpeが含まれていません。
値が存在するが間違っている場合は、引用符、大文字/小文字、空白などの一般的な原因については、JavaScript実装のトラブルシューティング を参照してください。
応答を確認 appmeasurement-response
2xx応答は、データ収集サーバーがリクエストを受信したことを確認するだけで、ヒットが記録されたことを確認するものではありません。 デフォルトの応答タイプでは、ヒットがドロップされた場合でも、リクエストは成功を返すことができます。 新規訪問者の最初のリクエストに対する302応答が必要です。 HTTP応答コード を参照してください。
AppMeasurementは、useBeaconが有効になっているときに、終了リンクリクエストとすべてのリクエストをnavigator.sendBeacon()とともに送信します。 開発者ツールは、ブラウザーがリクエストを送信した場合でも、リクエストにキャンセルとしてラベル付けすることができます。 中断されたリクエスト を参照してください。
Web SDK web-sdk
リクエストを見つける web-sdk-find
Web SDKでは、ブラウザーはAnalyticsに直接ではなくEdge Networkにイベントを送信するため、/b/ss/ リクエストは表示されません。 Edge Network リクエスト を確認し、次の点を確認します。
configIdパラメーターは、Adobe Analytics サービス が有効になっているデータストリームと、想定されるレポートスイートが一致しています。- ペイロードは、ページビューまたはリンクイベントとして認定されます。 Analyticsは、ページの詳細もweb インタラクションタイプも含まないペイロードを無視します。 Adobe Analytics🔗のEdge Network イベントタイプを参照してください。
Analyticsが受け取った内容を確認 web-sdk-contents
Edge トレース を開始し、アクションを再現します。 Analytics自動マッピングで始まる行を見つけ、その下のmappedQueryParamsとレポートスイート IDを展開します。
- 変数: マッピングされた値は、AppMeasurement リクエストと同じクエリパラメーター名を使用します。ページ名には
gn、商品にはplなどの短縮形を使用する場合があります。 XDM オブジェクトフィールドマッピング および データオブジェクトフィールドマッピング を参照してください。 - コンテキストデータ:Analytics変数にマッピングされないXDM フィールドは、
c.a.x.接頭辞を持つコンテキストデータとして表示されます。 処理ルール を使用して、変数に割り当てます。 - レポートスイート: レポートスイートの上書きを使用すると、Edge Network Traceのデータストリーム設定行に、Edgeが使用したレポートスイートが表示されます。
処理を確認 web-sdk-processing
Edge トレースが開くAssurance セッションで、hitdebuggerのイベントを検索します。 これらのイベントはベンダーcom.adobe.analytics.hitdebuggerを使用し、それらのペイロードは、Experience Cloud ID （mcvisId）やpageNameなどのAnalytics処理後の値を示します。
ガイド付きチュートリアルについては、Adobe Experience Platform Web SDKを使用したAdobe Analyticsの設定を参照してください。
リクエストとレポートの比較 reports
Analyticsに到達したヒットは、レポートにすぐに表示されず、レポート値がリクエストの値と異なる場合があります。
- 待ち時間：完全なデータは、通常、収集から約2時間後にレポートに表示されます。 タイムスタンプ付きヒットなどの一部のデータには、時間がかかる場合があります。 データの可用性と待ち時間を参照してください。
- 処理：処理ルール、VISTA ルール、ボットルール、およびその他の処理ステップは、収集後に値を変更または除外できます。 Adobe Analytics🔗でのデータの処理順序を参照してください。 Assuranceの後処理データは、個々のヒットに対する処理の結果を示します。
- レポートスイート：リクエストまたはデータストリームがターゲットとしたのと同じレポートスイートを表示していることを確認します。
- 予期しない値: ディメンションに予期しないスパイクまたは値が表示される場合は、 ハッシュの衝突を参照してください。
より広範なトラフィックの変更については、 データのスパイクとドロップのトラブルシューティング を参照してください。