ใช้ 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_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