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

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