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

استخدِم 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.