نظارت بر تشخیص داده های آفلاین
با مجموعهها، منظم بمانید
ذخیره و طبقهبندی محتوا براساس اولویتهای شما.
از Google Ads API برای بازیابی عیب‌یابی داده‌های آفلاین استفاده کنید، که حاوی اطلاعاتی درباره سلامت کلی فرآیندهای وارد کردن و تنظیم تبدیل شما است.
برای بازیابی آخرین عیب‌یابی داده‌های آفلاین برای حساب خود، از یکی از منابع زیر استفاده کنید:
تشخیص سطح حساب
برای بازیابی عیب‌یابی آپلود تبدیل سطح حساب، از عبارت 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 و Google Ads UI وارد کرده‌اید، نتایج حاوی ورودی‌های جداگانه برای مقادیر client GOOGLE_ADS_API و GOOGLE_ADS_WEB_CLIENT هستند.
تشخیص سطح اقدام تبدیل
برای بازیابی عیب‌یابی آپلود تبدیل در سطح اقدام تبدیل، از عبارت 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 و Google Ads UI وارد کرده‌اید، نتایج حاوی ورودی‌های جداگانه برای مقادیر client GOOGLE_ADS_API و GOOGLE_ADS_WEB_CLIENT هستند.
چگونه این خلاصه ها را تفسیر کنیم
هر OfflineConversionUploadClientSummary یا OfflineConversionUploadConversionActionSummary دارای یک فیلد status است که نشان دهنده سلامت کلی واردات برای client است. همچنین حاوی اطلاعات زیر است:
- تعداد کل رویدادهای دریافت شده
- تعداد رویدادهایی که با موفقیت پردازش شده اند.
- تعداد رویدادهای معلق (رویدادهایی که هنوز در حال پردازش هستند).
- یک فیلد
alerts ، که خلاصه‌ای از خطاها را ارائه می‌کند، گروه‌بندی شده بر اساس OfflineConversionError .
همه این فیلدها حاوی اطلاعاتی از آخرین روز تقویم کامل واردات هستند. از این اطلاعات برای ارزیابی سلامت فعلی واردات خود استفاده کنید.
علاوه بر این، هر OfflineConversionUploadClientSummary یا OfflineConversionUploadConversionActionSummary شامل دو نوع گزارش مختلف است:
-
daily_summaries - یک
successful_count ، failed_count date pending_count -
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 خودتان مفید است، زمانی است که یک کار یا فرآیند واحد دارید که تعداد زیادی تبدیل را با استفاده از چندین درخواست وارد می‌کند. اگر job_id برای هر یک از این درخواست‌ها روی یک مقدار تنظیم کنید، می‌توانید یک ورودی برای کار از job_summaries بازیابی کنید. اگر به جای آن به Google Ads API اجازه دهید یک مقدار ایجاد شده توسط سیستم را به job_id هر درخواست اختصاص دهد، job_summaries شامل یک ورودی جداگانه برای هر درخواست است که می تواند تجزیه و تحلیل سلامت کلی شغل شما را چالش برانگیزتر کند.
نحوه استفاده از خلاصه ها
برای اطمینان از اینکه فرآیندهای واردات شما طبق انتظار، تبدیل‌ها و پیشرفت‌ها را ثبت می‌کنند، به‌طور دوره‌ای خلاصه‌های هر یک از حساب‌های خود را بازیابی کنید. اگر status هر خلاصه ای EXCELLENT نیست، از لیست خطاهای زیر alerts استفاده کنید تا شما را در اصلاح فرآیند واردات برای کاهش یا حذف آن خطاها راهنمایی کند.
به عنوان مثال:
اگر وضعیت NEEDS_ATTENTION باشد، بخش قابل توجهی از عملیات واردات شما ناموفق است. خطاهای زیر alerts را بررسی کنید و فرآیند واردات خود را برای کاهش یا حذف آن خطاها اصلاح کنید.
اگر وضعیت NO_RECENT_UPLOADS باشد، Google Ads هیچ واردات اخیری را برای client دریافت نکرده است. اگر این غیرمنتظره است، فرآیندهایی را که با استفاده از آن کلاینت واردات را انجام می دهند، مرور کنید.
برای مثال، اگر status GOOGLE_ADS_API NO_RECENT_UPLOADS باشد، می‌تواند نشان دهد که فرآیند واردات شما که از API Google Ads استفاده می‌کند اخیراً اجرا نشده است.
برای تعیین اینکه آیا تاریخ یا کار وارد کردن خاصی وجود داشته است که تعداد زیادی رویداد را ارسال کرده است که پردازش نشدند، successful_count ، failed_count ، و pending_count daily_summaries و job_summaries را بررسی کنید. هر رویدادی در حالت معلق ممکن است تا 24 ساعت طول بکشد.
اطلاعات بیشتر در مورد نحوه بهبود تشخیص داده‌های آفلاین را می‌توانید در مرکز راهنمایی بیابید.
محدودیت ها
هنگام بازیابی خلاصه واردات موارد زیر را در نظر داشته باشید:
Google Ads API فقط در صورتی عیب‌یابی داده آفلاین را برمی‌گرداند که customer_id مربوط به searchStream یا درخواست search همان مشتری باشد که اخیراً برای وارد کردن تبدیل‌ها استفاده کرده‌اید.
برای مثال، حساب مشتری که از ردیابی تبدیل بین حساب‌ها استفاده می‌کند ممکن است حاوی هیچ عیب‌یابی نباشد. با این حال، می‌توانید با ارسال درخواستی که در آن customer_id با customer_id حساب مدیری که در واردات استفاده می‌کنید، عیب‌یابی را بازیابی کنید.
Google Ads با CLICK_NOT_FOUND خطاهای تبدیل‌های پیشرفته برای واردات سرنخ‌ها به عنوان هشدار برخورد می‌کند. در نتیجه، اگر alerts حاوی ورودی برای این خطا باشد، عملیات مربوطه همچنان موفق تلقی می‌شوند و در successful_event_count گنجانده می‌شوند.
جز در مواردی که غیر از این ذکر شده باشد،محتوای این صفحه تحت مجوز Creative Commons Attribution 4.0 License است. نمونه کدها نیز دارای مجوز Apache 2.0 License است. برای اطلاع از جزئیات، به خطمشیهای سایت Google Developers مراجعه کنید. جاوا علامت تجاری ثبتشده Oracle و/یا شرکتهای وابسته به آن است.
تاریخ آخرین بهروزرسانی 2025-08-26 بهوقت ساعت هماهنگ جهانی.
[null,null,["تاریخ آخرین بهروزرسانی 2025-08-26 بهوقت ساعت هماهنگ جهانی."],[[["\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`."]]
