استخدِم Google Ads API لاسترداد بيانات تشخيص البيانات المتوفّرة بلا إنترنت التي تحتوي على معلومات عن الحالة العامة لتحميل الإحالات الناجحة وعمليات التسوية.
لاسترداد أحدث بيانات تشخيص البيانات المتوفّرة بلا إنترنت لحسابك، استخدِم أحد الموارد التالية:
- تجمع
offline_conversion_upload_client_summary
بيانات تشخيص التحميل في مستوى الحساب. offline_conversion_upload_conversion_action_summary
(تتوفّر فقط في الإصدار 17 أو الإصدارات الأحدث) يجمّع بيانات تشخيص التحميل على مستوى إجراء الإحالة الناجحة.
بيانات التشخيص على مستوى الحساب
لاسترداد بيانات تشخيص تحميل الإحالات الناجحة على مستوى الحساب، استخدِم ما يلي: استعلام 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_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
خطأ من الإحالات الناجحة المحسّنة لعدد العملاء المحتملين كتحذيرات. بالنسبة نتيجة لذلك، إذا كانalerts
يحتوي على إدخال لهذا الخطأ، فإن العمليات لا تزال ناجحة ويتم تضمينها فيsuccessful_event_count