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

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

A 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 หากเป็นเช่นนี้ ให้ตรวจสอบกระบวนการที่ทําการนําเข้าโดยใช้ `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