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

ملاحظة: بالنسبة إلى عمليات استيراد "الإحالات الناجحة المحسّنة للعملاء المحتملين"، استخدِم تقرير تشخيصي لـ "الإحالات الناجحة المحسّنة للعملاء المحتملين" في واجهة مستخدم "إعلانات Google" لتتبُّع حالة عملية الاستيراد.

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

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

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

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

لاسترداد بيانات تشخيص تحميل الإحالات الناجحة على مستوى الحساب، استخدِم طلب البحث التالي في لغة طلب البحث في "إعلانات Google"‏ (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.

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

لاسترداد بيانات تشخيص تحميل الإحالات الناجحة على مستوى إجراء الإحالة الناجحة، استخدِم طلب البحث التالي في لغة طلب البحث في "إعلانات Google"‏ (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.