ใช้ Google Ads API เพื่อเรียกการวินิจฉัยข้อมูลออฟไลน์ ซึ่งมีข้อมูลเกี่ยวกับประสิทธิภาพโดยรวมของกระบวนการอัปโหลดและการปรับ Conversion
หากต้องการเรียกข้อมูลการวินิจฉัยออฟไลน์ล่าสุดสําหรับบัญชี ให้ใช้แหล่งข้อมูลอย่างใดอย่างหนึ่งต่อไปนี้
offline_conversion_upload_client_summary
รวบรวมการวินิจฉัยการอัปโหลดที่ระดับบัญชีoffline_conversion_upload_conversion_action_summary
(ใช้ได้ใน v17 ขึ้นไปเท่านั้น) จะรวบรวมการวินิจฉัยการอัปโหลดที่ระดับการกระทําที่ถือเป็น 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