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

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

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

• offline_conversion_upload_client_summary รวบรวม การวินิจฉัยการนําเข้าที่ระดับบัญชี
• offline_conversion_upload_conversion_action_summaryรวบรวมการวินิจฉัยการนำเข้าที่ระดับการกระทำที่ถือเป็น 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_id,
  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 = <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