データ収集のデバッグとトラブルシューティング

データ収集のデバッグでは、実装の動作と、送信されるデータの処理の両方を確認する必要があります。 症状から始め、イベントが期待どおりに動作しなくなる場所が見つかるまで、収集の各ステージを通してイベントを追跡します。

デバッグログは、ブラウザーまたはアプリケーションランタイムでSDK コマンド、タグ実行、警告、およびエラーを公開します。 リクエスト検査は、ペイロード、応答、およびサポートされているワークフローのサーバーサイド処理を公開します。 これらのアプローチは、多くの場合、互いに補完し合います。ログは、イベントが遅延した理由を説明できます。一方、ネットワークキャプチャは、リクエストが送信されたかどうかを示すことができます。

コレクションを通じてイベントをフォロー diagnostic-workflow

次の段階を順番に調べます。 ある段階が成功したという証拠は、後の段階も成功したことを証明するものではありません。

  1. 実装の実行: SDK コマンドまたはタグ ルールが実行されましたか? 診断メッセージとエラーを確認します。 同意またはID処理によってイベントが遅延する場合は、ネットワークリクエストを探す前にその状態を調査します。 ​ デバッグログの有効化を参照してください。
  2. 送信リクエスト:リクエストは送信されましたが、予想されるデータが含まれていますか? ペイロードを調べ、コマンド入力またはデータ要素と比較します。 Web リクエストの調査または​ モバイルとサーバーのリクエストの調査を参照してください。
  3. サーバーのレシート:収集エンドポイントはリクエストを受信しましたか? 利用可能なレスポンスを調べるか、サポートされているサーバーサイドのトレースを使用します。 リクエストが送信されたことを示すクライアントログは、受信の確認ではありません。
  4. Edgeの処理とルーティング: イベントは意図したデータストリームと設定されたサービスを使用しましたか? Web SDKの場合、リクエストのconfigId パラメーターは使用したデータストリームを示し、Edge TraceはEdge Networkがイベントをどのように処理したかを示します。
  5. ダウンストリーム処理:宛先はイベントを受け入れて処理しましたか? 宛先の製品固有のデバッグ ​ ガイダンスを使用します。 Adobe Edge Networkによる回答が成功したからといって、あらゆるレポートやストアでデータが利用可能であることを証明できるわけではありません。

開始点を選択 choose-a-starting-point

次の表は、一般的なタスクに関する有用な証拠を示しています。 両方のアプローチが適用される場合、それらは調査の異なる部分に答えます。 使用可能なメッセージとツールは、SDK、ランタイム、設定されたサービスによって異なります。

タスクまたは症状
デバッグログ
調査の依頼
次のチェック
予期されたイベントが表示されない
同意やIDの遅延に関するコマンドやルールの実行、エラー、メッセージを確認します。
リクエストが発行されたかどうかを確認し、そのペイロードと応答を調べます。
loggingから開始し、次に​ リクエストを調査します。 IDに関連する症状については、IDのトラブルシューティング ​を参照してください。
リクエストに予期しないデータが含まれています
SDK コマンドの入力とタグの実行を、送信する値と比較します。
実際の送信ペイロードを調べます。変換が関係する場合は、Edge Traceと比較してください。
データ要素、コマンド入力、および​ データストリーム設定を確認します。
ナビゲーション中にリクエストがキャンセルされたようです
SDKがイベントを送信しようとしたか、まだ保持しているかどうかを確認します。
リクエストと、可能な場合はサーバーのレスポンスまたはEdge Traceを調べます。 ブラウザーのキャンセルされたラベルだけでは結論が出ません。
中断されたリクエスト ​およびWeb SDK documentUnloadingを参照してください。
リクエストは成功したようですが、宛先データがありません
使用する設定と実装を入力します。 クライアントログは、ダウンストリーム処理を確認できません。
Edge Trace、Assurance、宛先固有の診断を使用します。
データストリーム、有効なサービス、ルーティング、宛先処理を確認します。 ​ トレース Edge Network処理および製品固有のデバッグ ​を参照してください。
イベントが重複しています
繰り返されるコマンド呼び出しまたはタグルールの実行を探します。
リクエスト数、ペイロード、識別子の比較。 重複の原因として考えられるのは、複数のクライアントリクエストだけではありません。
再試行と少なくとも1回の配信、および繰り返し実行されるクライアントの実行を調査します。 ​ イベントの重複処理を参照してください。
モバイルまたはサーバーの実装が予期せず動作する
ブラウザーコンソールだけでなく、アプリケーションまたはサーバーランタイムでSDK出力を確認します。
サポートされているモバイルワークフローにはAssuranceを使用するか、アプリケーションのHTTP トラフィックを調べます。 ブラウザーツールはサーバーの発信コールを表示できません。
​ モバイル SDKとServer SDKのログ記録と​ モバイルとサーバーのリクエストの調査を参照してください。

製品固有のデバッグ product-specific

この節の記事は、すべてのExperience Platform データ収集に適用されます。 データを受け取るAdobe アプリケーションは、独自のエンドポイント、リクエスト形式、検証ビュー、処理を使用できます。 Edge Networkがイベントを受信してルーティングしたことを確認した後、または実装がアプリケーションに直接データを送信した場合は、そのアプリケーションのデバッグガイダンスに進みます。

調査を続行 next-steps

ログ、トレース、ネットワークキャプチャを共有する前に、組織のポリシーに従って、資格情報、訪問者識別子、その他の機密情報を削除します。

recommendation-more-help
experience-platform-help-collection