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

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

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

• offline_conversion_upload_client_summary تُجمِّع بيانات تشخيص التحميل على مستوى الحساب.
• offline_conversion_upload_conversion_action_summary (متاح فقط في الإصدار 17 أو الإصدارات الأحدث) يجمع بيانات تشخيص التحميل على مستوى الإحالة الناجحة الإجراء.

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

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

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

لاسترداد بيانات تشخيص تحميل الإحالات الناجحة على مستوى إجراء الإحالة الناجحة، استخدِم query التالي في "لغة الاستعلامات في "إحصاءات Google":

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 خطأ من عمليات تحميل الإحالات الناجحة المحسّنة ل leads على أنّها تحذيرات. نتيجةً لذلك، إذا كان alerts يحتوي على إدخال لهذا الخطأ، سيظلّ بالإمكان اعتبار العمليات المقابلة ناجحة ويتم تضمينها في successful_event_count.