진단

다음은 이벤트 및 잠재고객 업로드의 상태를 확인하고 데이터 문제를 식별하는 데 권장되는 워크플로입니다.

이벤트를 전송하거나 잠재고객 구성원을 전송 또는 삭제하는 요청을 실행합니다.
각 요청의 전반적인 상태를 확인합니다. 요청이 성공하면 Status가 code와(과) 같고 0(enum 값 OK, HTTP 응답 200 OK)이며 IngestEventsResponse, IngestAudienceMembersResponse 또는 RemoveAudienceMembersResponse를 반환합니다.

요청이 성공하지 못하면 오류를 해결하도록 요청을 수정한 후 요청을 다시 전송합니다.

요청이 성공하면 다음 단계에서 진단 정보를 가져오는 데 사용할 수 있도록 응답의 request_id를 캡처합니다.

**참고:** `validate_only`가 `true`로 설정되지 않고 성공한 요청에 대해서만 진단 정보를 가져올 수 있습니다.
validate_onlytrue
성공한 각 request_id에 대해 RetrieveRequestStatus 요청을 전송합니다.
각 RetrieveRequestStatusResponse를 검토하여 업로드가 제대로 작동하는지 확인하고 데이터 문제를 식별합니다.
데이터 문제를 수정합니다.
1단계로 돌아가서 업로드와 관련된 모든 문제를 해결할 때까지 반복합니다.

요청 보내기

A RetrieveRequestStatusRequest에는 단일 request_id 필드가 있습니다. 수집 요청을 전송할 때 캡처한 성공한 요청 ID마다 하나의 요청을 전송합니다.

답변 검토

request_status_per_destination의 RetrieveRequestStatusResponse에는 해당 수집 요청의 각 대상에 대한 별도의 항목이 포함되어 있습니다.

예를 들어 IngestAudienceMembersRequest 에 3개의 서로 다른 잠재고객에게 데이터를 전송하기 위한 destinations 목록에 3개의 항목이 포함되어 있는 경우 상태 응답에는 request_status_per_destination에 3개의 항목 (잠재고객당 1개의 항목)이 포함됩니다.

전반적인 대상 상태 확인

첫 번째 단계로 request_status 필드를 확인하여 Data Manager API가 RequestStatusPerDestination의 destination에 대한 데이터 처리를 완료했는지 확인합니다. 다음은 가능한 값입니다 request_status:

PROCESSING: 대상의 데이터가 아직 처리 중입니다.
SUCCESS: 대상에 대한 요청 처리가 오류 없이 완료되었습니다.
FAILURE: 오류로 인해 대상의 모든 레코드가 실패했습니다.
PARTIAL_SUCCESS: 대상의 일부 레코드는 성공했지만 오류로 인해 다른 레코드는 실패했습니다.

대상별 이벤트 또는 잠재고객 상태 확인

수집 요청 유형에 해당하는 상태 필드를 검사합니다. 각 RequestStatusPerDestination에는 다음 필드 중 하나만 설정됩니다.

events_ingestion_status
audience_members_ingestion_status
audience_members_removal_status

이벤트 수집 상태

요청이 IngestEventsRequest인 경우 events_ingestion_status 필드가 채워집니다.

IngestEventStatus의 record_count를 확인하여 수신된 총 레코드 수가 예상과 일치하는지 확인합니다. record_count에는 성공한 레코드와 실패한 레코드가 모두 포함됩니다.

잠재고객 구성원 수집 상태

요청이 IngestAudienceMembersRequest인 경우 audience_members_ingestion_status 필드가 채워집니다. 다음은 각 잠재고객 데이터 유형에 대해 확인할 IngestAudienceMembersStatus 필드입니다. 이러한 필드 중 하나 만 설정됩니다.

user_data_ingestion_status

수신된 총 레코드 수가 예상과 일치하는지 확인하려면 IngestUserDataStatus의 record_count를 확인합니다. record_count 에는 성공한 레코드와 실패한 레코드가 모두 포함됩니다.

user_identifier_count를 확인하여 수신된 사용자 식별자 수가 예상과 일치하는지 확인합니다.

요청에 충분한 수의 레코드가 있는 경우 upload_match_rate_range에는 요청의 레코드에 대한 일치율 범위가 포함됩니다.

mobile_data_ingestion_status

record_count의 IngestMobileDataStatus를 확인하여 수신된 총 레코드 수가 예상과 일치하는지 확인합니다. record_count에는 성공한 레코드와 실패한 레코드가 모두 포함됩니다.

mobile_id_count를 확인하여 수신된 모바일 ID 수가 예상과 일치하는지 확인합니다.

pair_data_ingestion_status

수신된 총 레코드 수가 예상과 일치하는지 확인하려면 IngestPairDataStatus의 record_count을 확인합니다. record_count 에는 성공한 레코드와 실패한 레코드가 모두 포함됩니다.

pair_id_count를 확인하여 수신된 PAIR ID 수가 예상과 일치하는지 확인합니다.

ppid_data_ingestion_status

record_count의 IngestPpidDataStatus를 확인하여 수신된 총 레코드 수가 예상과 일치하는지 확인합니다. record_count 에는 성공한 레코드와 실패한 레코드가 모두 포함됩니다.

ppid_count를 확인하여 수신된 PPID 수가 예상과 일치하는지 확인합니다.

user_id_data_ingestion_status

수신된 총 레코드 수가 예상과 일치하는지 확인하려면 IngestUserIdDataStatus의 record_count을 확인합니다. record_count 에는 성공한 레코드와 실패한 레코드가 모두 포함됩니다.

user_id_count를 확인하여 수신된 사용자 ID 수가 예상과 일치하는지 확인합니다.

잠재고객 구성원 삭제 상태

요청이 RemoveAudienceMembersRequest인 경우 audience_members_removal_status 필드가 채워집니다. 다음은 각 잠재고객 데이터 유형에 대해 확인할 RemoveAudienceMembersStatus 필드입니다. 이러한 필드 중 하나 만 설정됩니다.

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 데이터를 복호화할 수 없는 경우 Data Manager API는 전체 레코드를 거부하고 PROCESSING_ERROR_REASON_USER_IDENTIFIER_DECRYPTION_ERROR 오류를 보고합니다. 유효한 Event에는 ad_identifiers 또는 user_data 중 하나 이상이 있어야 하기 때문입니다.

다음은 경고 및 오류 정보가 포함된 응답 필드입니다.

warning_info: 객체 목록입니다.WarningCount 각 WarningCount에는 경고 유형이 포함된 reason과 해당 유형의 경고가 있는 레코드 수를 나타내는 record_count가 포함됩니다.
error_info: 객체 목록입니다.ErrorCount 각 ErrorCount 에는 오류 유형이 포함된 reason과 해당 유형의 오류로 인해 실패한 레코드 수를 나타내는 record_count이 포함됩니다.