診断

イベントとオーディエンス のアップロードの状態を確認し、データに関する問題を特定するためのおすすめのワークフローは次のとおりです。

  1. イベントを送信するリクエスト、オーディエンス メンバーを送信または削除するリクエストを発行します。

  2. 各リクエストの全体的なステータスを確認します。リクエストが成功した場合、 Status の code は 0（列挙値 OK、HTTP レスポンス 200 OK）になり、IngestEventsResponse、 IngestAudienceMembersResponse、または RemoveAudienceMembersResponse が返されます。

    リクエストが成功しなかった場合は、エラーに対処するようにリクエストを変更して リクエストを再送信します。

    リクエストが成功した場合は、レスポンスの request_id を取得します。この ID は、次のステップで診断情報を取得するために使用します。

    true

  3. 成功した request_id ごとに RetrieveRequestStatus リクエストを送信します。

  4. 各 RetrieveRequestStatusResponse を確認して、 アップロードが正常に機能していることを確認し、データに関する問題を特定します。

  5. データの問題を修正します。

  6. ステップ 1 に戻り、アップロードに関するすべての問題に対処するまで繰り返します。

リクエストの送信

RetrieveRequestStatusRequest には request_id フィールドが 1 つあります。取り込みリクエストを送信したときに取得した成功したリクエスト ID ごとに 1 つのリクエストを送信します。

API Explorer を使用して、ブラウザでリクエストを試してみてください。

レスポンスを確認する

request_status_per_destination には、対応する取り込みリクエストの宛先ごとに個別のエントリが含まれています。RetrieveRequestStatusResponse

たとえば、IngestAudienceMembersRequest に 3 つのエントリが含まれていて、3 つの異なる オーディエンスにデータを送信する場合、ステータス レスポンスの request_status_per_destination には 3 つのエントリ（オーディエンスごとに 1 つのエントリ）が含まれます。destinations

宛先の全体的なステータスを確認する

まず、request_status フィールドを確認して、 Data Manager API が RequestStatusPerDestination の destination のデータの処理を完了したかどうかを判断します。request_status の値は次のいずれかになります。

  • PROCESSING: 宛先のデータがまだ処理中です。
  • SUCCESS: 宛先のリクエスト処理がエラーなしで完了しました。
  • FAILURE: エラーのため、宛先のすべてのレコードが失敗しました。
  • PARTIAL_SUCCESS: 宛先の一部のレコードは成功しましたが、 他のレコードはエラーのため失敗しました。

宛先ごとのイベントまたはオーディエンスのステータスを確認する

取り込みリクエストのタイプに対応するステータス フィールドを調べます。各 RequestStatusPerDestination には、次のフィールドのいずれか 1 つだけが設定されます。

イベントの取り込みステータス

リクエストが IngestEventsRequestの場合、events_ingestion_status フィールドに入力されます。

IngestEventStatus の record_count を確認して、受信したレコードの合計数が想定どおりであることを確認します。record_count には、成功したレコードと失敗した レコードの両方が含まれます。

オーディエンス メンバーの取り込みステータス

audience_members_ingestion_status フィールドは、リクエストが IngestAudienceMembersRequestの場合に入力されます。オーディエンス データのタイプごとに確認する IngestAudienceMembersStatus フィールドは次のとおりです。これらのフィールドのいずれか 1 つだけが設定されます。

user_data_ingestion_status

IngestUserDataStatus の record_count を確認して、受信したレコードの合計 数が想定どおりであることを確認します。record_count には、成功したレコードと失敗したレコードの両方が含まれます。

user_identifier_count を確認して、受信した ユーザー識別子の数が想定どおりであることを確認します。

リクエストに十分な数のレコードが含まれている場合、 upload_match_rate_range にはリクエスト内のレコードの 一致率 範囲 が含まれます。

mobile_data_ingestion_status

IngestMobileDataStatus の record_count を確認して、 受信したレコードの合計数が想定どおりであることを確認します。 record_count には、成功したレコードと失敗したレコードの両方が含まれます。

mobile_id_count を確認して、受信したモバイル ID の数が 想定どおりであることを確認します。

pair_data_ingestion_status

IngestPairDataStatus の record_count を確認して、受信したレコードの合計 数が想定どおりであることを確認します。record_count には、成功したレコードと失敗したレコードの両方が含まれます。

pair_id_count を確認して、受信した PAIR ID の数が 想定どおりであることを確認します。

ppid_data_ingestion_status

IngestPpidDataStatus の record_count を確認して、受信したレコードの合計 数が想定どおりであることを確認します。record_count には、成功したレコードと失敗したレコードの両方が含まれます。

ppid_count を確認して、受信した PPID の数が 想定どおりであることを確認します。

user_id_data_ingestion_status

IngestUserIdDataStatus の record_count を確認して、受信したレコードの合計 数が想定どおりであることを確認します。record_count には、成功したレコードと失敗したレコードの両方が含まれます。

user_id_count を確認して、受信したユーザー ID の数が想定どおりであることを確認します。

オーディエンス メンバーの削除ステータス

audience_members_removal_status フィールドは、リクエストが RemoveAudienceMembersRequestの場合に入力されます。オーディエンス データのタイプごとに確認する RemoveAudienceMembersStatus フィールドは次のとおりです。これらのフィールドのいずれか 1 つだけが設定されます。

user_data_removal_status
ユーザーデータの削除ステータス。
mobile_data_removal_status
モバイルデータの削除ステータス。
pair_data_removal_status
PAIR データの削除ステータス。
ppid_data_removal_status
PPID データの削除ステータス。
user_id_data_removal_status
ユーザー ID データの削除ステータス

record_count を確認して、受信したレコードの合計数が想定どおりであることを確認します。record_count には、 成功したレコードと失敗したレコードの両方が含まれます。

また、user_identifier_count、mobile_id_count、または pair_id_count を確認して、受信したユーザー識別子、モバイル ID、 または PAIR ID の合計数を確認します。

警告とエラーを確認する

宛先とリクエストのタイプのステータス フィールドに加えて、 RetrieveRequestStatusResponse には、リクエストの 警告とエラーの内訳が含まれています。

  • エラーは、API がレコードを完全に拒否したことを示します。
  • 警告は、API がレコードを拒否しなかったものの、レコードのデータの一部を 無視する必要があったことを示します。

たとえば、Event に暗号化された UserIdentifier データと AdIdentifiers などの gclid が含まれていて、 UserIdentifier データを復号化できない場合でも、Data Manager API は レコードを AdIdentifiers を使用して処理しますが、警告 PROCESSING_WARNING_REASON_USER_IDENTIFIER_DECRYPTION_ERROR を返します。

ただし、Event に AdIdentifiers が含まれておらず、UserIdentifier データを復号化できない場合、有効な Event には ad_identifiers または user_data のいずれか 1 つ以上が含まれている必要があるため、Data Manager API はレコード全体を拒否し、 エラー PROCESSING_ERROR_REASON_USER_IDENTIFIER_DECRYPTION_ERROR を報告します。

警告とエラーの情報を含むレスポンス フィールドは次のとおりです。

warning_info
オブジェクトのリストWarningCount。各 WarningCount には、警告のタイプを示す reason と、そのタイプの警告があったレコードの数を示す record_count が含まれています。
error_info
ErrorCount オブジェクトのリスト。各 ErrorCount には、エラーのタイプを示す reason と、そのタイプのエラーが原因で失敗したレコードの数を示す record_count が含まれています。