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

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

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

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