مراقبة بيانات تشخيص البيانات بلا اتصال بالإنترنت
تنظيم صفحاتك في مجموعات
يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.
استخدِم 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"، ستحتوي النتائج على إدخالات منفصلة لقيم 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"، ستحتوي النتائج على إدخالات منفصلة لقيم 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 مفيدًا، أن يكون لديك مهمة أو عملية واحدة تستورد عددًا كبيرًا من الإحالات الناجحة باستخدام طلبات متعددة. إذا ضبطت قيمة job_id على القيمة نفسها في كل طلب من هذه الطلبات، يمكنك استرداد إدخال واحد للمهمة من job_summaries. في المقابل، إذا سمحت لواجهة Google Ads API بتعيين قيمة من إنشاء النظام إلى job_id لكل طلب، سيحتوي job_summaries على إدخال منفصل لكل طلب، ما قد يصعّب تحليل الحالة العامة لمهمتك.
كيفية استخدام الملخّصات
لضمان تسجيل عمليات الاستيراد للإحالات الناجحة والتحسينات على النحو المتوقّع، عليك استرداد الملخّصات بشكل دوري لكل حساب من حساباتك. إذا لم تكن قيمة
status لأي ملخّص هي EXCELLENT، استخدِم قائمة الأخطاء ضمن
alerts لإرشادك خلال تعديل عملية الاستيراد بهدف تقليل هذه الأخطاء أو إزالتها.
على سبيل المثال:
إذا كانت الحالة NEEDS_ATTENTION، يعني ذلك أنّ جزءًا كبيرًا من عمليات الاستيراد قد فشل. راجِع الأخطاء ضمن alerts وعدِّل عملية الاستيراد لتقليل هذه الأخطاء أو إزالتها.
إذا كانت الحالة NO_RECENT_UPLOADS، يعني ذلك أنّ "إعلانات Google" لم تتلقَّ أي عمليات استيراد حديثة لـ 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 هو العميل نفسه الذي استخدمته مؤخرًا لاستيراد الإحالات الناجحة.
على سبيل المثال، قد لا يحتوي حساب عميل يستخدم ميزة تتبُّع الإحالات الناجحة في جميع الحسابات على أي بيانات تشخيصية. ومع ذلك، يمكنك استرداد بيانات التشخيص عن طريق إرسال طلب يتطابق فيه customer_id مع customer_id لحساب المدير الذي تستخدمه في عمليات الاستيراد.
تتعامل "إعلانات Google" مع أخطاء CLICK_NOT_FOUND من عمليات استيراد الإحالات الناجحة المحسّنة للعملاء المحتملين على أنّها تحذيرات. نتيجةً لذلك، إذا كان alerts يتضمّن إدخالاً لهذا الخطأ، سيظل يُنظر إلى العمليات المقابلة على أنّها ناجحة وسيتم تضمينها في successful_event_count.
إنّ محتوى هذه الصفحة مرخّص بموجب ترخيص Creative Commons Attribution 4.0 ما لم يُنصّ على خلاف ذلك، ونماذج الرموز مرخّصة بموجب ترخيص Apache 2.0. للاطّلاع على التفاصيل، يُرجى مراجعة سياسات موقع Google Developers. إنّ Java هي علامة تجارية مسجَّلة لشركة 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`."]]
