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

تنظيم صفحاتك في مجموعات يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.

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

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

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