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