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