ตรวจสอบการวินิจฉัยข้อมูลออฟไลน์

ใช้ Google Ads API เพื่อเรียกการวินิจฉัยข้อมูลออฟไลน์ ซึ่งมีข้อมูลเกี่ยวกับประสิทธิภาพโดยรวมของกระบวนการอัปโหลดและการปรับ Conversion

หากต้องการเรียกข้อมูลการวินิจฉัยออฟไลน์ล่าสุดสําหรับบัญชี ให้ใช้แหล่งข้อมูลอย่างใดอย่างหนึ่งต่อไปนี้

  • offline_conversion_upload_client_summary รวบรวมการวินิจฉัยการอัปโหลดที่ระดับบัญชี
  • offline_conversion_upload_conversion_action_summary (ใช้ได้ใน v17 ขึ้นไปเท่านั้น) จะรวบรวมการวินิจฉัยการอัปโหลดที่ระดับการกระทําที่ถือเป็น Conversion

การวินิจฉัยระดับบัญชี

หากต้องการเรียกข้อมูลการวินิจฉัยการอัปโหลด Conversion ระดับบัญชี ให้ใช้การค้นหา GAQL ต่อไปนี้

SELECT
  customer.id,
  offline_conversion_upload_client_summary.alerts,
  offline_conversion_upload_client_summary.client,
  offline_conversion_upload_client_summary.daily_summaries,
  offline_conversion_upload_client_summary.job_summaries,
  offline_conversion_upload_client_summary.last_upload_date_time,
  offline_conversion_upload_client_summary.pending_event_count,
  offline_conversion_upload_client_summary.pending_rate,
  offline_conversion_upload_client_summary.status,
  offline_conversion_upload_client_summary.success_rate,
  offline_conversion_upload_client_summary.successful_event_count,
  offline_conversion_upload_client_summary.total_event_count
FROM offline_conversion_upload_client_summary

การค้นหานี้จะแสดงแถวแยกกันสำหรับไคลเอ็นต์แต่ละประเภทที่ใช้ในการอัปโหลดล่าสุด OfflineConversionUploadClientSummary เช่น หากคุณเพิ่งอัปโหลดโดยใช้ทั้ง Google Ads API และ UI ของ Google Ads ผลลัพธ์จะมีรายการแยกต่างหากสําหรับค่า client ของ GOOGLE_ADS_API และ GOOGLE_ADS_WEB_CLIENT

การวินิจฉัยระดับการกระทําที่ถือเป็น Conversion

หากต้องการเรียกข้อมูลการวินิจฉัยการอัปโหลด Conversion ที่ระดับการกระทําที่ถือเป็น Conversion ให้ใช้การค้นหา GAQL ต่อไปนี้

SELECT
  offline_conversion_upload_conversion_action_summary.conversion_action_name,
  offline_conversion_upload_conversion_action_summary.alerts,
  offline_conversion_upload_conversion_action_summary.client,
  offline_conversion_upload_conversion_action_summary.daily_summaries,
  offline_conversion_upload_conversion_action_summary.job_summaries,
  offline_conversion_upload_conversion_action_summary.last_upload_date_time,
  offline_conversion_upload_conversion_action_summary.pending_event_count,
  offline_conversion_upload_conversion_action_summary.status,
  offline_conversion_upload_conversion_action_summary.successful_event_count,
  offline_conversion_upload_conversion_action_summary.total_event_count
FROM offline_conversion_upload_conversion_action_summary
WHERE offline_conversion_upload_conversion_action_summary.conversion_action_id = < INSERT CONVERSION ACTION ID >

เช่นเดียวกับการวินิจฉัยระดับบัญชี การค้นหานี้จะแสดงผลแถวOfflineConversionUploadConversionActionSummaryแยกกันสำหรับไคลเอ็นต์แต่ละประเภทที่ใช้ในการอัปโหลดล่าสุด เช่น หากคุณเพิ่งอัปโหลดโดยใช้ทั้ง Google Ads API และ UI ของ Google Ads ผลลัพธ์จะมีรายการแยกต่างหากสําหรับค่า client ของ GOOGLE_ADS_API และ GOOGLE_ADS_WEB_CLIENT

วิธีตีความข้อมูลสรุปเหล่านี้

OfflineConversionUploadClientSummary หรือ OfflineConversionUploadConversionActionSummary แต่ละรายการมีฟิลด์ status ซึ่งแสดงสถานะโดยรวมของการอัปโหลดสำหรับ client รวมถึงมีข้อมูลต่อไปนี้ด้วย

  • จํานวนเหตุการณ์ทั้งหมดที่ได้รับ
  • จํานวนเหตุการณ์ที่ประมวลผลสําเร็จ
  • จํานวนเหตุการณ์ที่รอดําเนินการ (เหตุการณ์ที่กําลังประมวลผลอยู่)
  • ฟิลด์ alerts ที่แสดงสรุปข้อผิดพลาดซึ่งจัดกลุ่มตาม OfflineConversionError

ช่องเหล่านี้ทั้งหมดมีข้อมูลจากวันปฏิทินเต็มวันล่าสุดที่มีการอัปโหลด ใช้ข้อมูลนี้เพื่อประเมินคุณภาพปัจจุบันของการอัปโหลด

นอกจากนี้ OfflineConversionUploadClientSummary หรือ OfflineConversionUploadConversionActionSummary แต่ละรายการยังมีรายงาน 2 ประเภทที่แตกต่างกัน ได้แก่

daily_summaries
successful_count, failed_count และ pending_count คำขออัปโหลดจาก 7 วันที่ผ่านมา โดยจัดกลุ่มตามการอัปโหลด date
job_summaries

successful_count, failed_count และ pending_count จากคำขออัปโหลดล่าสุด 7 รายการ โดยจัดกลุ่มตาม job_id job_id เป็นฟิลด์ที่ไม่บังคับของ UploadClickConversionsRequest และ UploadConversionAdjustmentsRequest คุณสามารถตั้งค่า job_id เป็นตัวเลขที่ไม่ใช่ค่าลบซึ่งน้อยกว่า 2^31 หรือให้ Google Ads API กําหนดรหัสงานที่ระบบสร้างขึ้นให้กับคําขอของคุณก็ได้ ไม่ว่าคุณจะเลือกตัวเลือกใด UploadClickConversionsResponse หรือ UploadConversionAdjustmentsResponse จะแสดงผล job_id

กรณีที่การกำหนด job_id ของคุณเองจะมีประโยชน์คือเมื่อคุณมีงานหรือกระบวนการเดียวที่อัปโหลด Conversion จํานวนมากโดยใช้คําขอหลายรายการ หากคุณตั้งค่า job_id ในคําขอแต่ละรายการเป็นค่าเดียวกัน คุณจะเรียกข้อมูลรายการเดียวสําหรับงานจาก job_summaries ได้ หากคุณอนุญาตให้ Google Ads API กําหนดค่าที่ระบบสร้างขึ้นให้กับ job_id ของคําขอแต่ละรายการแทน job_summaries จะมีรายการแยกต่างหากสําหรับคําขอแต่ละรายการ ซึ่งอาจทําให้การวิเคราะห์ประสิทธิภาพโดยรวมของงานทํางานยากขึ้น

วิธีใช้ข้อมูลสรุป

ดึงข้อมูลสรุปของบัญชีแต่ละบัญชีเป็นระยะๆ เพื่อให้แน่ใจว่ากระบวนการอัปโหลดบันทึก Conversion และการปรับปรุงตามที่คาดไว้ หาก status ของสรุปใดไม่ใช่ EXCELLENT ให้ใช้รายการข้อผิดพลาดในส่วน alerts เพื่อแก้ไขขั้นตอนการอัปโหลดเพื่อลดหรือกำจัดข้อผิดพลาดเหล่านั้น

เช่น

  • หากสถานะเป็น NEEDS_ATTENTION แสดงว่าการดำเนินการอัปโหลดส่วนใหญ่ของคุณล้มเหลว ตรวจสอบข้อผิดพลาดในส่วน alerts และแก้ไขขั้นตอนการอัปโหลดเพื่อลดหรือขจัดข้อผิดพลาดเหล่านั้น

  • หากสถานะเป็น NO_RECENT_UPLOADS แสดงว่า Google Ads ยังไม่ได้รับการอัปโหลดล่าสุดสําหรับ client หากไม่คาดคิด ให้ตรวจสอบกระบวนการที่ดำเนินการอัปโหลดโดยใช้ไคลเอ็นต์ดังกล่าว

    เช่น หาก status สำหรับ GOOGLE_ADS_API คือ NO_RECENT_UPLOADS แสดงว่ากระบวนการอัปโหลดที่ใช้ Google Ads API หยุดทำงานไปเมื่อเร็วๆ นี้

  • หากต้องการทราบว่ามีวันที่หรืองานอัปโหลดที่ส่งเหตุการณ์จํานวนมากซึ่งประมวลผลไม่สําเร็จหรือไม่ ให้ตรวจสอบ successful_count, failed_count และ pending_count ของ daily_summaries และ job_summaries เหตุการณ์ใดก็ตามที่อยู่ในสถานะรอดำเนินการอาจใช้เวลาถึง 24 ชั่วโมงจึงจะเสร็จสมบูรณ์

ข้อจำกัด

โปรดคำนึงถึงสิ่งต่อไปนี้เมื่อเรียกข้อมูลสรุปการอัปโหลด

  • Google Ads API จะแสดงเฉพาะการวินิจฉัยข้อมูลออฟไลน์ในกรณีที่ customer_id ของคําขอ searchStream หรือ search เป็นลูกค้ารายเดียวกับที่คุณใช้เมื่อเร็วๆ นี้เพื่ออัปโหลด Conversion

    ตัวอย่างเช่น บัญชีลูกค้าที่ใช้เครื่องมือวัด Conversion ข้ามบัญชีอาจไม่มีการวินิจฉัยใดๆ อย่างไรก็ตาม คุณสามารถเรียกข้อมูลการวินิจฉัยได้โดยส่งคำขอที่ customer_id ตรงกับ customer_id ของบัญชีดูแลจัดการที่คุณใช้ในการอัปโหลด

  • Google Ads จะถือว่าข้อผิดพลาด CLICK_NOT_FOUND จากการอัปโหลด Conversion ที่ปรับปรุงแล้วสําหรับโอกาสในการขายเป็นคําเตือน ด้วยเหตุนี้ หาก alerts มีรายการสำหรับข้อผิดพลาดนี้ ระบบจะยังคงถือว่าการดำเนินการที่เกี่ยวข้องสําเร็จและรวมอยู่ใน successful_event_count