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