データ収集のデバッグとトラブルシューティング
データ収集のデバッグでは、実装の動作と、送信されるデータの処理の両方を確認する必要があります。 症状から始め、イベントが期待どおりに動作しなくなる場所が見つかるまで、収集の各ステージを通してイベントを追跡します。
デバッグログは、ブラウザーまたはアプリケーションランタイムでSDK コマンド、タグ実行、警告、およびエラーを公開します。 リクエスト検査は、ペイロード、応答、およびサポートされているワークフローのサーバーサイド処理を公開します。 これらのアプローチは、多くの場合、互いに補完し合います。ログは、イベントが遅延した理由を説明できます。一方、ネットワークキャプチャは、リクエストが送信されたかどうかを示すことができます。
コレクションを通じてイベントをフォロー diagnostic-workflow
次の段階を順番に調べます。 ある段階が成功したという証拠は、後の段階も成功したことを証明するものではありません。
- 実装の実行: SDK コマンドまたはタグ ルールが実行されましたか? 診断メッセージとエラーを確認します。 同意またはID処理によってイベントが遅延する場合は、ネットワークリクエストを探す前にその状態を調査します。 デバッグログの有効化を参照してください。
- 送信リクエスト:リクエストは送信されましたが、予想されるデータが含まれていますか? ペイロードを調べ、コマンド入力またはデータ要素と比較します。 Web リクエストの調査または モバイルとサーバーのリクエストの調査を参照してください。
- サーバーのレシート:収集エンドポイントはリクエストを受信しましたか? 利用可能なレスポンスを調べるか、サポートされているサーバーサイドのトレースを使用します。 リクエストが送信されたことを示すクライアントログは、受信の確認ではありません。
- Edgeの処理とルーティング: イベントは意図したデータストリームと設定されたサービスを使用しましたか? Web SDKの場合、リクエストの
configIdパラメーターは使用したデータストリームを示し、Edge TraceはEdge Networkがイベントをどのように処理したかを示します。 - ダウンストリーム処理:宛先はイベントを受け入れて処理しましたか? 宛先の製品固有のデバッグ ガイダンスを使用します。 Adobe Edge Networkによる回答が成功したからといって、あらゆるレポートやストアでデータが利用可能であることを証明できるわけではありません。
開始点を選択 choose-a-starting-point
次の表は、一般的なタスクに関する有用な証拠を示しています。 両方のアプローチが適用される場合、それらは調査の異なる部分に答えます。 使用可能なメッセージとツールは、SDK、ランタイム、設定されたサービスによって異なります。
タスクまたは症状
デバッグログ
調査の依頼
次のチェック
予期されたイベントが表示されない
同意やIDの遅延に関するコマンドやルールの実行、エラー、メッセージを確認します。
リクエストが発行されたかどうかを確認し、そのペイロードと応答を調べます。
リクエストに予期しないデータが含まれています
SDK コマンドの入力とタグの実行を、送信する値と比較します。
実際の送信ペイロードを調べます。変換が関係する場合は、Edge Traceと比較してください。
データ要素、コマンド入力、および データストリーム設定を確認します。
ナビゲーション中にリクエストがキャンセルされたようです
SDKがイベントを送信しようとしたか、まだ保持しているかどうかを確認します。
リクエストと、可能な場合はサーバーのレスポンスまたはEdge Traceを調べます。 ブラウザーのキャンセルされたラベルだけでは結論が出ません。
中断されたリクエスト およびWeb SDK
documentUnloadingを参照してください。リクエストは成功したようですが、宛先データがありません
使用する設定と実装を入力します。 クライアントログは、ダウンストリーム処理を確認できません。
Edge Trace、Assurance、宛先固有の診断を使用します。
データストリーム、有効なサービス、ルーティング、宛先処理を確認します。 トレース Edge Network処理および製品固有のデバッグ を参照してください。
イベントが重複しています
繰り返されるコマンド呼び出しまたはタグルールの実行を探します。
リクエスト数、ペイロード、識別子の比較。 重複の原因として考えられるのは、複数のクライアントリクエストだけではありません。
再試行と少なくとも1回の配信、および繰り返し実行されるクライアントの実行を調査します。 イベントの重複処理を参照してください。
モバイルまたはサーバーの実装が予期せず動作する
ブラウザーコンソールだけでなく、アプリケーションまたはサーバーランタイムでSDK出力を確認します。
サポートされているモバイルワークフローにはAssuranceを使用するか、アプリケーションのHTTP トラフィックを調べます。 ブラウザーツールはサーバーの発信コールを表示できません。
製品固有のデバッグ product-specific
この節の記事は、すべてのExperience Platform データ収集に適用されます。 データを受け取るAdobe アプリケーションは、独自のエンドポイント、リクエスト形式、検証ビュー、処理を使用できます。 Edge Networkがイベントを受信してルーティングしたことを確認した後、または実装がアプリケーションに直接データを送信した場合は、そのアプリケーションのデバッグガイダンスに進みます。
- Adobe Analytics: Analytics データ収集のデバッグ
- ストリーミングメディア用Adobe Analytics: Assuranceのストリーミングメディア用Adobe Analytics ビュー
- Adobe Audience Manager: DCS エラーコード、メッセージ、および例
- Adobe Experience Platform データセットとReal-Time Customer Profile: ストリーミング取り込みのトラブルシューティングガイド
- Adobe Journey Optimizer: コードベースのエクスペリエンスをテスト 、Assuranceおよび決定検証ビューを使用してアプリ内メッセージを検証します
- Adobe Target: Web SDKを使用したTargetのデバッグ およびDebuggerを使用したat.js実装のテスト
- Customer Journey Analytics: 接続設定の表示、トラブルシューティング、変更
調査を続行 next-steps
- デバッグログを有効にする: Web SDK、タグ、Server SDK、およびMobile SDKの診断出力を有効、検査、および無効にします。
- データ収集リクエストの調査:リクエストの取得、Edge Network リクエストの証拠の解釈、Edge処理の追跡、キャンセルされたリクエストの調査。
- デバッグツール: Adobe ツール、タグデバッガー、ブラウザー開発者用ツール、HTTP プロキシを比較します。
- 件名に固有のガイダンス: 同意とID、 ドキュメントのアンロード 、 イベントの複製など、詳細な調査を設定やAPI参照に近づけることができます。
ログ、トレース、ネットワークキャプチャを共有する前に、組織のポリシーに従って、資格情報、訪問者識別子、その他の機密情報を削除します。
recommendation-more-help
experience-platform-help-collection