مراقبة بيانات تشخيص البيانات بلا اتصال بالإنترنت

استخدِم Google Ads API لاسترداد بيانات تشخيص البيانات المتوفّرة بلا إنترنت، التي تحتوي على معلومات عن الحالة العامة لعمليات تحميل الإحالات الناجحة والتعديلات عليها.

لاسترداد أحدث بيانات تشخيص للبيانات المتوفّرة بلا إنترنت لحسابك، أرسِل الطلب التالي لموارد offline_conversion_upload_client_summary باستخدام GoogleAdsService:

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.resource_name,
  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.

يحتوي كل OfflineConversionUploadClientSummary على حقل status يعكس الحالة الإجمالية لعمليات التحميل في client. وتحتوي أيضًا على عدد إجمالي الأحداث التي تم تلقّيها، وعدد الأحداث التي تمت معالجتها بنجاح، وحقل alerts يقدّم ملخّصًا للأخطاء مجمّعة حسب OfflineConversionError. تحتوي كل هذه الحقول على معلومات من آخر يوم تقويمي كامل لعمليات التحميل. استخدِم هذه المعلومات لتقييم مدى كفاءة عمليات التحميل الحالية.

بالإضافة إلى ذلك، يحتوي كل OfflineConversionUploadClientSummary على نوعَين مختلفَين من التقارير:

daily_summaries

successful_count وfailed_count من طلبات التحميل من آخر 7 أيام، مجمّعة حسب عملية التحميل date.

job_summaries

تمثّل هذه السمة successful_count وfailed_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 في daily_summaries وjob_summaries لتحديد ما إذا كان هناك تاريخ تحميل أو مهمة محدّدة أرسلت عددًا كبيرًا من الأحداث التي لم تتم معالجتها بنجاح.

القيود

يجب مراعاة ما يلي عند استرداد ملخّصات التحميل:

• لا تعرض واجهة Google Ads API بيانات التشخيص للبيانات المتوفّرة بلا إنترنت إلا إذا كان customer_id من الطلب searchStream أو search هو العميل نفسه الذي استخدمته مؤخرًا لتحميل الإحالات الناجحة.

  على سبيل المثال، قد لا يحتوي حساب العميل الذي يستخدِم ميزة تتبُّع الإحالات الناجحة في جميع الحسابات على أيّ بيانات تشخيص. يمكنك استرداد بيانات التشخيص من خلال إرسال طلب يتطابق فيه customer_id مع customer_id للحساب الإداري الذي تستخدمه في عمليات التحميل.

• تتعامل "إعلانات Google" مع أخطاء CLICK_NOT_FOUND الناتجة من عمليات تحميل الإحالات الناجحة المحسّنة للعملاء المحتملين على أنّها تحذيرات. ونتيجةً لذلك، إذا كان alerts يحتوي على إدخال لهذا الخطأ، تُعتبَر العمليات المقابلة ناجحة ويتم تضمينها في successful_event_count.