การวินิจฉัย

เวิร์กโฟลว์ที่แนะนำเพื่อยืนยันประสิทธิภาพของการอัปโหลดเหตุการณ์และกลุ่มเป้าหมาย รวมถึงระบุปัญหาเกี่ยวกับข้อมูลมีดังนี้

  1. ส่งคำขอเพื่อส่งเหตุการณ์ หรือส่งหรือนำ สมาชิกกลุ่มเป้าหมายออก

  2. ตรวจสอบสถานะโดยรวมของคำขอแต่ละรายการ คำขอที่สำเร็จจะมี Status ที่มี code เท่ากับ 0 (ค่า enum OK, การตอบกลับ HTTP 200 OK) และแสดงผล IngestEventsResponse, IngestAudienceMembersResponse หรือ RemoveAudienceMembersResponse

    หากคำขอไม่สำเร็จ ให้แก้ไขคำขอเพื่อแก้ข้อผิดพลาด แล้วส่งคำขออีกครั้ง

    หากคำขอสำเร็จ ให้บันทึก request_id ของการตอบกลับเพื่อใช้ดึงข้อมูลการวินิจฉัยในขั้นตอนถัดไป

  3. ส่งคำขอ RetrieveRequestStatus สำหรับ request_id ที่สำเร็จแต่ละรายการ

  4. ตรวจสอบ RetrieveRequestStatusResponse แต่ละรายการเพื่อยืนยัน ว่าการอัปโหลดทำงานอย่างถูกต้องและระบุปัญหาเกี่ยวกับข้อมูล

  5. แก้ไขปัญหาเกี่ยวกับข้อมูล

  6. กลับไปที่ขั้นตอนที่ 1 และทำซ้ำจนกว่าคุณจะแก้ปัญหาทั้งหมดเกี่ยวกับการอัปโหลด

ส่งคำขอ

A RetrieveRequestStatusRequest มีฟิลด์ request_id เดียว ส่งคำขอ 1 รายการสำหรับรหัสคำขอที่สำเร็จแต่ละรายการที่คุณบันทึกไว้เมื่อส่งคำขอการนำเข้า

ลองส่งคำขอในเบราว์เซอร์โดยใช้ API Explorer

ตรวจสอบคำตอบ

request_status_per_destination ใน RetrieveRequestStatusResponse จะมีรายการแยกต่างหากสำหรับ ปลายทางแต่ละรายการในคำขอการนำเข้าที่เกี่ยวข้อง

ตัวอย่างเช่น หาก IngestAudienceMembersRequest มี 3 รายการในรายการ destinations เพื่อส่งข้อมูลไปยังกลุ่มเป้าหมาย 3 กลุ่มที่แตกต่างกัน การตอบกลับสถานะจะมี 3 รายการใน request_status_per_destination (1 รายการต่อกลุ่มเป้าหมาย)

ตรวจสอบสถานะปลายทางโดยรวม

ขั้นตอนแรก ให้ตรวจสอบฟิลด์ request_status เพื่อดูว่า Data Manager API ประมวลผลข้อมูลสำหรับ destination ของ RequestStatusPerDestination เสร็จแล้วหรือไม่ ค่าที่เป็นไปได้ ของ request_statusมีดังนี้

  • PROCESSING: ระบบยังคงประมวลผลข้อมูลสำหรับปลายทาง
  • SUCCESS: การประมวลผลคำขอสำหรับปลายทางเสร็จสมบูรณ์โดยไม่มีข้อผิดพลาด
  • FAILURE: บันทึกทั้งหมดสำหรับปลายทางไม่สำเร็จเนื่องจากมีข้อผิดพลาด
  • PARTIAL_SUCCESS: บันทึกบางรายการสำหรับปลายทางสำเร็จ แต่บางรายการไม่สำเร็จเนื่องจากมีข้อผิดพลาด

ตรวจสอบสถานะเหตุการณ์หรือกลุ่มเป้าหมายต่อปลายทาง

ตรวจสอบฟิลด์สถานะที่สอดคล้องกับประเภทคำขอการนำเข้า ระบบจะตั้งค่าฟิลด์ต่อไปนี้เพียง ฟิลด์เดียว ใน RequestStatusPerDestination แต่ละรายการ

สถานะการนำเข้าเหตุการณ์

ระบบจะป้อนข้อมูลในฟิลด์ events_ingestion_status หากคำขอเป็น IngestEventsRequest

ตรวจสอบ record_count ของ IngestEventStatus เพื่อยืนยันว่าจำนวนบันทึกทั้งหมดที่ได้รับตรงกับที่คุณ คาดไว้ record_count ประกอบด้วยบันทึกที่สำเร็จและไม่สำเร็จ

สถานะการนำเข้าสมาชิกกลุ่มเป้าหมาย

ระบบจะป้อนข้อมูลในฟิลด์ audience_members_ingestion_status หากคำขอเป็น IngestAudienceMembersRequest ต่อไปนี้คือฟิลด์ IngestAudienceMembersStatus ที่ต้องตรวจสอบสำหรับ ข้อมูลกลุ่มเป้าหมายแต่ละประเภท ระบบจะตั้งค่าฟิลด์เหล่านี้เพียง ฟิลด์เดียว

user_data_ingestion_status

ตรวจสอบ record_count ของ IngestUserDataStatus เพื่อยืนยันว่าจำนวน บันทึกทั้งหมดที่ได้รับตรงกับที่คุณคาดไว้ record_count ประกอบด้วยบันทึกที่สำเร็จและไม่สำเร็จ

ตรวจสอบ user_identifier_count เพื่อยืนยันว่าจำนวน ตัวระบุผู้ใช้ที่ได้รับตรงกับที่คุณ คาดไว้

หากคำขอมีจำนวนบันทึกเพียงพอ upload_match_rate_range จะมี ช่วงอัตราการจับคู่ สำหรับบันทึกในคำขอ

mobile_data_ingestion_status

ตรวจสอบ record_count ของ IngestMobileDataStatus เพื่อยืนยันว่า จำนวนบันทึกทั้งหมดที่ได้รับตรงกับที่คุณคาดไว้ record_count ประกอบด้วยบันทึกที่สำเร็จและไม่สำเร็จ

ตรวจสอบ mobile_id_count เพื่อยืนยันว่าจำนวนรหัสอุปกรณ์เคลื่อนที่ที่ได้รับตรงกับที่คุณคาดไว้

pair_data_ingestion_status

ตรวจสอบ record_count ของ IngestPairDataStatus เพื่อยืนยันว่าจำนวน บันทึกทั้งหมดที่ได้รับตรงกับที่คุณคาดไว้ record_count ประกอบด้วยบันทึกที่สำเร็จและไม่สำเร็จ

ตรวจสอบ pair_id_count เพื่อยืนยันว่าจำนวนรหัส PAIR ที่ได้รับตรงกับที่คุณคาดไว้

ppid_data_ingestion_status

ตรวจสอบ record_count ของ IngestPpidDataStatus เพื่อยืนยันว่าจำนวน บันทึกทั้งหมดที่ได้รับตรงกับที่คุณคาดไว้ record_count ประกอบด้วยบันทึกที่สำเร็จและไม่สำเร็จ

ตรวจสอบ ppid_count เพื่อยืนยันว่าจำนวน PPID ที่ได้รับตรงกับที่คุณคาดไว้

user_id_data_ingestion_status

ตรวจสอบ record_count ของ IngestUserIdDataStatus เพื่อยืนยันว่าจำนวน บันทึกทั้งหมดที่ได้รับตรงกับที่คุณคาดไว้ record_count ประกอบด้วยบันทึกที่สำเร็จและไม่สำเร็จ

ตรวจสอบ user_id_count เพื่อยืนยันว่าจำนวน User ID ที่ได้รับตรงกับที่คุณคาดไว้

สถานะการนำสมาชิกกลุ่มเป้าหมายออก

ระบบจะป้อนข้อมูลในฟิลด์ audience_members_removal_status หากคำขอเป็น RemoveAudienceMembersRequest ต่อไปนี้คือฟิลด์ RemoveAudienceMembersStatus ที่ต้องตรวจสอบสำหรับข้อมูลกลุ่มเป้าหมายแต่ละ ประเภท ระบบจะตั้งค่าฟิลด์เหล่านี้เพียง ฟิลด์เดียว

user_data_removal_status
สถานะการนำข้อมูลผู้ใช้ออก
mobile_data_removal_status
สถานะการนำข้อมูลอุปกรณ์เคลื่อนที่ออก
pair_data_removal_status
สถานะการนำข้อมูล PAIR ออก
ppid_data_removal_status
สถานะการนำข้อมูล PPID ออก.
user_id_data_removal_status
สถานะการนำข้อมูล User ID ออก

ตรวจสอบ record_count เพื่อยืนยันว่าจำนวนบันทึกทั้งหมดที่ได้รับตรงกับที่คุณคาดไว้ record_count ประกอบด้วยบันทึกที่สำเร็จและไม่สำเร็จ

นอกจากนี้ ให้ตรวจสอบ user_identifier_count, mobile_id_count หรือ pair_id_count เพื่อยืนยันจำนวนตัวระบุผู้ใช้ รหัสอุปกรณ์เคลื่อนที่ หรือรหัส PAIR ทั้งหมดที่ได้รับ

ตรวจสอบคำเตือนและข้อผิดพลาด

นอกเหนือจากฟิลด์สถานะสำหรับปลายทางและประเภทคำขอแล้ว 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 อย่างน้อย 1 รายการ

ต่อไปนี้คือฟิลด์การตอบกลับที่มีข้อมูลคำเตือนและข้อผิดพลาด

warning_info
รายการออบเจ็กต์ WarningCount Each WarningCount แต่ละรายการจะมี reason ที่มีประเภทคำเตือน และ record_count ที่ระบุจำนวนบันทึกที่มีคำเตือนประเภท นั้น
error_info
รายการออบเจ็กต์ ErrorCount ErrorCount แต่ละรายการจะมี reason ที่มีประเภทข้อผิดพลาด และ record_count ที่ระบุจำนวนบันทึกที่ไม่สำเร็จเนื่องจากข้อผิดพลาดประเภทนั้น