การวินิจฉัย

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

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

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

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

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

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

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

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

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

สร้างคำขอ

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

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

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 ที่ได้รับ ตรงกับที่คุณคาดไว้

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

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

user_data_removal_status
สถานะการนำข้อมูลผู้ใช้ออก
mobile_data_removal_status
สถานะการนำออกสำหรับอินเทอร์เน็ตมือถือ
pair_data_removal_status
สถานะการนำข้อมูล PAIR ออก

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

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

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

นอกจากฟิลด์สถานะสำหรับปลายทางและประเภทคำขอแล้ว RetrieveRequestStatusResponse ยังมีรายละเอียดของคำเตือนและข้อผิดพลาดสำหรับคำขอด้วย

  • ข้อผิดพลาดบ่งบอกว่า API ปฏิเสธระเบียนโดยสมบูรณ์
  • คำเตือนบ่งชี้ว่า API ไม่ได้ปฏิเสธระเบียน แต่ต้อง ละเว้นส่วนต่างๆ ของข้อมูลระเบียน

เช่น หาก Event มีข้อมูล UserIdentifier ที่เข้ารหัสและ AdIdentifiers เช่น gclid และถอดรหัสข้อมูล UserIdentifier ไม่ได้ API ของ Data Manager จะยังคงประมวลผลระเบียนโดยใช้ 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 แต่ละ WarningCountจะมี reason ที่มีประเภทคำเตือน และ record_count ที่ระบุจำนวนระเบียนที่มีคำเตือนประเภทนั้น
error_info
รายการออบเจ็กต์ ErrorCount ErrorCountแต่ละรายการ จะมี reason ที่มีประเภทข้อผิดพลาด และ record_count ที่ระบุ จำนวนระเบียนที่ล้มเหลวเนื่องจากข้อผิดพลาดประเภทนั้น