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