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

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

لاسترداد أحدث بيانات تشخيص للبيانات المتوفّرة بلا إنترنت لحسابك، أرسِل طلب البحث التالي لموارد offline_conversion_upload_client_summary باستخدام GoogleAdsService:

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.resource_name,
  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.

يتضمّن كل OfflineConversionUploadClientSummary حقل status يعكس الحالة العامة للتحميلات client. ويحتوي التقرير أيضًا على عدد إجمالي الأحداث التي تم تلقّيها، وعدد الأحداث التي تمت معالجتها بنجاح، وحقل alerts الذي يقدّم ملخّصًا بالأخطاء، مجمّعًا حسب OfflineConversionError. تحتوي كل هذه الحقول على معلومات من آخر يوم تقويمي كامل لعمليات التحميل. استخدِم هذه المعلومات لتقييم الحالة الحالية لعمليات التحميل.

بالإضافة إلى ذلك، يحتوي كل OfflineConversionUploadClientSummary على نوعَين مختلفَين من التقارير:

daily_summaries

successful_count وfailed_count من طلبات التحميل من آخر 7 أيام، مجمّعة حسب التحميل date.

job_summaries

successful_count وfailed_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 لكل من daily_summaries وjob_summaries لتحديد ما إذا كان هناك تاريخ تحميل أو مهمة معيّنة أرسلت عددًا كبيرًا من الأحداث التي لم تتم معالجتها بنجاح.

الشروط

عند استرداد ملخّصات التحميل، يُرجى أخذ النقاط التالية في الاعتبار:

• لا تعرض Google Ads API بيانات التشخيص للبيانات المتوفّرة بلا إنترنت إلا إذا كان customer_id من طلب searchStream أو search هو العميل نفسه الذي استخدمته مؤخرًا لتحميل الإحالات الناجحة.

  على سبيل المثال، قد لا يحتوي حساب العميل الذي يستخدم ميزة "تتبُّع الإحالات الناجحة في جميع الحسابات" على أي بيانات تشخيص. ويمكنك استرداد بيانات التشخيص من خلال إرسال طلب يتطابق فيه customer_id مع customer_id للحساب الإداري الذي تستخدمه في عمليات التحميل.

• تتعامل "إعلانات Google" مع أخطاء CLICK_NOT_FOUND الواردة من عمليات تحميل الإحالات الناجحة المحسّنة للعملاء المحتملين كتحذيرات. ونتيجةً لذلك، إذا تضمّن alerts إدخال لهذا الخطأ، ستظل العمليات المقابلة ناجحة وسيتم تضمينها في successful_event_count.