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

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

لاسترداد أحدث بيانات تشخيص البيانات غير الإلكترونية لحسابك، استخدِم أحد المَوردَين التاليَين:

• offline_conversion_upload_client_summary تجمع بيانات تشخيص عمليات الاستيراد على مستوى الحساب.
• offline_conversion_upload_conversion_action_summary تجمع بيانات تشخيص عمليات الاستيراد على مستوى إجراء الإحالة الناجحة.

بيانات التشخيص على مستوى الحساب

لاسترداد بيانات تشخيص عمليات تحميل الإحالات الناجحة على مستوى الحساب، استخدِم طلب بحث 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_id,
  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 = <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.