ตรวจสอบการวินิจฉัยข้อมูลออฟไลน์
จัดทุกอย่างให้เป็นระเบียบอยู่เสมอด้วยคอลเล็กชัน บันทึกและจัดหมวดหมู่เนื้อหาตามค่ากำหนดของคุณ
ใช้ Google Ads API เพื่อดึงข้อมูลการวินิจฉัยข้อมูลออฟไลน์ ซึ่งมีข้อมูลเกี่ยวกับสถานะโดยรวมของการนําเข้า 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_summariessuccessful_count, failed_count และ pending_count ของคำขอการนำเข้า จาก 7 วันที่ผ่านมา จัดกลุ่มตามการนำเข้า datejob_summariessuccessful_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
เนื้อหาของหน้าเว็บนี้ได้รับอนุญาตภายใต้ใบอนุญาตที่ต้องระบุที่มาของครีเอทีฟคอมมอนส์ 4.0 และตัวอย่างโค้ดได้รับอนุญาตภายใต้ใบอนุญาต Apache 2.0 เว้นแต่จะระบุไว้เป็นอย่างอื่น โปรดดูรายละเอียดที่นโยบายเว็บไซต์ Google Developers Java เป็นเครื่องหมายการค้าจดทะเบียนของ Oracle และ/หรือบริษัทในเครือ
อัปเดตล่าสุด 2025-08-26 UTC
[[["เข้าใจง่าย","easyToUnderstand","thumb-up"],["แก้ปัญหาของฉันได้","solvedMyProblem","thumb-up"],["อื่นๆ","otherUp","thumb-up"]],[["ไม่มีข้อมูลที่ฉันต้องการ","missingTheInformationINeed","thumb-down"],["ซับซ้อนเกินไป/มีหลายขั้นตอนมากเกินไป","tooComplicatedTooManySteps","thumb-down"],["ล้าสมัย","outOfDate","thumb-down"],["ปัญหาเกี่ยวกับการแปล","translationIssue","thumb-down"],["ตัวอย่าง/ปัญหาเกี่ยวกับโค้ด","samplesCodeIssue","thumb-down"],["อื่นๆ","otherDown","thumb-down"]],["อัปเดตล่าสุด 2025-08-26 UTC"],[[["\u003cp\u003eThe Google Ads API allows retrieval of offline data diagnostics, offering insights into the health of your conversion uploads and adjustments.\u003c/p\u003e\n"],["\u003cp\u003eYou can access these diagnostics at both the account level and the conversion action level using specific GAQL queries.\u003c/p\u003e\n"],["\u003cp\u003eDiagnostics encompass data like total events, successful events, pending events, and alerts on errors, helping assess the upload process.\u003c/p\u003e\n"],["\u003cp\u003eDaily and job summaries are included, offering a detailed view of upload request performance over the past 7 days.\u003c/p\u003e\n"],["\u003cp\u003eRegularly review these summaries to ensure smooth conversion tracking, addressing any alerts to optimize the upload process for better results.\u003c/p\u003e\n"]]],[],null,["# Monitor offline data diagnostics\n\n| **Note:** For enhanced conversions for leads imports, use the [enhanced conversions for leads diagnostics report](//support.google.com/google-ads/answer/15249267) in the Google Ads UI to monitor your import health.\n\nUse the Google Ads API to retrieve\n[offline data diagnostics](//support.google.com/google-ads/answer/13812240),\nwhich contain information about the overall health of your conversion import and\nadjustment processes.\n\nTo retrieve the latest offline data diagnostics for your account, use\none of the following resources:\n\n- [`offline_conversion_upload_client_summary`](/google-ads/api/fields/v21/offline_conversion_upload_client_summary) aggregates import diagnostics at the account level.\n- [`offline_conversion_upload_conversion_action_summary`](/google-ads/api/fields/v21/offline_conversion_upload_conversion_action_summary) aggregates import diagnostics at the conversion action level.\n\nAccount level diagnostics\n-------------------------\n\nTo retrieve account level conversion upload diagnostics, use the following\nGAQL query: \n\n SELECT\n customer.id,\n offline_conversion_upload_client_summary.alerts,\n offline_conversion_upload_client_summary.client,\n offline_conversion_upload_client_summary.daily_summaries,\n offline_conversion_upload_client_summary.job_summaries,\n offline_conversion_upload_client_summary.last_upload_date_time,\n offline_conversion_upload_client_summary.pending_event_count,\n offline_conversion_upload_client_summary.pending_rate,\n offline_conversion_upload_client_summary.status,\n offline_conversion_upload_client_summary.success_rate,\n offline_conversion_upload_client_summary.successful_event_count,\n offline_conversion_upload_client_summary.total_event_count\n FROM offline_conversion_upload_client_summary\n\nThis query returns separate\n[`OfflineConversionUploadClientSummary`](/google-ads/api/reference/rpc/v21/OfflineConversionUploadClientSummary)\nrows for each type of client used in recent imports. For example, if you\nrecently imported using both the Google Ads API and the Google Ads UI, the results\ncontain separate entries for the `client` values of `GOOGLE_ADS_API` and\n`GOOGLE_ADS_WEB_CLIENT`.\n\nConversion action level diagnostics\n-----------------------------------\n\nTo retrieve conversion upload diagnostics at the conversion action level, use\nthe following GAQL query: \n\n SELECT\n offline_conversion_upload_conversion_action_summary.conversion_action_name,\n offline_conversion_upload_conversion_action_summary.alerts,\n offline_conversion_upload_conversion_action_summary.client,\n offline_conversion_upload_conversion_action_summary.daily_summaries,\n offline_conversion_upload_conversion_action_summary.job_summaries,\n offline_conversion_upload_conversion_action_summary.last_upload_date_time,\n offline_conversion_upload_conversion_action_summary.pending_event_count,\n offline_conversion_upload_conversion_action_summary.status,\n offline_conversion_upload_conversion_action_summary.successful_event_count,\n offline_conversion_upload_conversion_action_summary.total_event_count\n FROM offline_conversion_upload_conversion_action_summary\n WHERE offline_conversion_upload_conversion_action_summary.conversion_action_id = \u003c INSERT CONVERSION ACTION ID \u003e\n\nSimilar to account level diagnostics, this query returns separate\n[`OfflineConversionUploadConversionActionSummary`](/google-ads/api/reference/rpc/v21/OfflineConversionUploadConversionActionSummary)\nrows for each type of client used in recent imports. For example, if you\nrecently imported using both the Google Ads API and the Google Ads UI, the results\ncontain separate entries for the `client` values of `GOOGLE_ADS_API` and\n`GOOGLE_ADS_WEB_CLIENT`.\n\nHow to interpret these summaries\n--------------------------------\n\nEach `OfflineConversionUploadClientSummary` or\n`OfflineConversionUploadConversionActionSummary` has a `status` field, that\nreflects the [overall health](//support.google.com/google-ads/answer/13812240#2)\nof imports for the `client`. It also contains the following information:\n\n- The count of total events received.\n- The count of successfully processed events.\n- The count of pending events (events that are still being processed).\n- An `alerts` field, that provides a summary of errors, grouped by [`OfflineConversionError`](/google-ads/api/reference/rpc/v21/OfflineConversionError).\n\nAll of these fields contain information from the most recent full calendar day\nof imports. Use this information to assess the *current* health of your imports.\n\nIn addition, each `OfflineConversionUploadClientSummary` or\n`OfflineConversionUploadConversionActionSummary` contains two different\ntypes of reports:\n\n`daily_summaries`\n: A `successful_count`, `failed_count`, and `pending_count` of import requests\n from the last 7 days, grouped by import `date`.\n\n`job_summaries`\n\n: The `successful_count`, `failed_count`, and `pending_count` of the 7 most\n recent import requests, grouped by `job_id`. The `job_id` is an optional field\n of [`UploadClickConversionsRequest`](/google-ads/api/reference/rpc/v21/UploadClickConversionsRequest) and\n [`UploadConversionAdjustmentsRequest`](/google-ads/api/reference/rpc/v21/UploadConversionAdjustmentsRequest). You can either set the\n `job_id` to a non-negative number less than `2^31` or let the Google Ads API assign a\n system-generated job ID to your request. Regardless of which option you\n choose, the [`UploadClickConversionsResponse`](/google-ads/api/reference/rpc/v21/UploadClickConversionsResponse) or\n [`UploadConversionAdjustmentsResponse`](/google-ads/api/reference/rpc/v21/UploadConversionAdjustmentsResponse) returns the `job_id`.\n\n One scenario where assigning your own `job_id` is useful is when you have a\n single job or process that imports a large number of conversions using\n multiple requests. If you set the `job_id` on each of those requests to the\n same value, then you can retrieve a single entry for the job from\n `job_summaries`. If instead you let the Google Ads API assign a system-generated\n value to the `job_id` of each request, the `job_summaries` contains a separate\n entry for each request, which could make analyzing the overall health of your\n job more challenging.\n\nHow to use summaries\n--------------------\n\nTo ensure your import processes are recording conversions and enhancements as\nexpected, periodically retrieve the summaries for each of your accounts. If the\n`status` of any summary is not `EXCELLENT`, use the list of errors under\n`alerts` to guide you through modifying your import process to reduce or\neliminate those errors.\n\nFor example:\n\n- If the status is `NEEDS_ATTENTION`, then a significant portion of your\n import operations failed. Review the errors under `alerts` and modify your\n import process to reduce or eliminate those errors.\n\n- If the status is `NO_RECENT_UPLOADS`, then Google Ads has not received any recent\n imports for the `client`. If this is unexpected, then review the processes\n that perform imnports using that client.\n\n For example, if the `status` for `GOOGLE_ADS_API` is `NO_RECENT_UPLOADS`, that\n could indicate that your import process that uses the Google Ads API stopped running\n recently.\n- To determine if there was a specific import date or job that sent a large\n number of events that failed to process, check the `successful_count`,\n `failed_count`, and `pending_count` of `daily_summaries` and `job_summaries`.\n Any events in a pending state may take up to 24 hours\n to complete.\n\nMore information on how to improve offline data diagnostics can be found in\nthe [Help center](//support.google.com/google-ads/answer/13812240#4).\n\nRestrictions\n------------\n\nKeep the following in mind when retrieving import summaries:\n\n- The Google Ads API only returns offline data diagnostics if the\n [`customer_id`](/google-ads/api/reference/rpc/v21/SearchGoogleAdsStreamRequest#customer_id) of the\n `searchStream` or `search` request is the same customer you used recently to\n import conversions.\n\n For example, a client account that uses cross-account conversion tracking may\n not contain any diagnostics. However, you can retrieve diagnostics by sending\n a request where the `customer_id` matches the `customer_id` of the manager\n account you use in imports.\n- Google Ads treats `CLICK_NOT_FOUND` errors from [enhanced conversions for\n leads](/google-ads/api/docs/conversions/enhanced-conversions/leads) imports as warnings. As\n a result, if `alerts` contains an entry for this error, the corresponding\n operations are still considered successful and are included in the\n `successful_event_count`."]]
