ใช้ 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_summariessuccessful_count,failed_countและpending_countของคำขอนำเข้าจาก 7 วันที่ผ่านมา ซึ่งจัดกลุ่มตามdateการนำเข้าjob_summariessuccessful_count,failed_countและpending_countของคำขอนำเข้าล่าสุด 7 รายการ โดยจัดกลุ่มตามjob_idjob_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