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

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

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

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

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