يمكنك إعداد تقارير عن الإحالات الناجحة في Google Ads API من خلال استرداد بيانات حول إجراءات إحالات ناجحة معيّنة أو استرداد مقاييس الإحالات الناجحة لموارد أخرى، مثل الحملات والمجموعات الإعلانية والإعلانات. يوضّح هذا الدليل كيفية استرداد هذه المعلومات، وكيفية ربط مقاييس واجهة مستخدم "إعلانات Google" بمقاييس Google Ads API.
استرداد بيانات عن إجراءات إحالات ناجحة محدّدة
يمكنك استرداد تفاصيل حول إجراءات الإحالات الناجحة الحالية باستخدام مصدر conversion_action
.
على سبيل المثال، يسترد طلب البحث التالي الاسم والنوع والحالة لجميع إجراءات الإحالات الناجحة:
SELECT
conversion_action.resource_name,
conversion_action.name,
conversion_action.type,
conversion_action.status
FROM conversion_action
اطّلِع على جميع الحقول المتاحة في المرجع conversion_action
أو استخدِم أداة إنشاء طلبات البحث في "إعلانات Google" لبدء طلب البحث الخاص بك.
استرداد مقاييس الإحالات الناجحة لمراجع أخرى
يمكنك التقسيم حسب conversion_action
واسترداد مقاييس الإحالات الناجحة، مثل conversions
وall_conversions
، عند طلب البحث عن موارد أخرى، مثل keyword_view
وad_group
.
على سبيل المثال، يستردّ طلب البحث التالي المقياسَين conversions
وconversions_value
لحملاتك، مع تقسيم النتائج حسب conversion_action
:
SELECT
campaign.name,
segments.conversion_action,
metrics.conversions,
metrics.conversions_value
FROM campaign
يُرجى العِلم أنّ بعض الحقول المرتبطة بالإحالات الناجحة، مثل
segments.conversion_or_adjustment_lag_bucket
وحقول المقاييس الأخرى، قد لا تكون متاحة في جميع التقارير. يمكنك الاطّلاع على صفحة المرجع المعنيّ للحصول على قائمة كاملة بالحقول المتوافقة.
المشاكل الشائعة
- بياناتي ليست محدّثة.
- عند الاطّلاع على بيانات الإحالات الناجحة، ضَع في اعتبارك أنّ بيانات الأداء لا تتوفّر على الفور. راجِع دليل حداثة البيانات في "إعلانات Google" للحصول على معلومات حول حداثة بيانات الإحالات الناجحة.
- تقريري فارغ.
- لن يتم عرض الصفوف في التقارير التي تكون جميع مقاييسها صفرًا، مثل الصفوف الخاصة بإجراءات الإحالات الناجحة الجديدة.
- لا يمكنني الوصول إلى أعمدتي المخصّصة من خلال Google Ads API. لا تتوافق
- الأعمدة المخصّصة مع واجهة برمجة التطبيقات في "إعلانات Google"، ولا يمكن استردادها في التقارير.
ربط مقاييس واجهة المستخدم
عند عرض حملة باستخدام واجهة مستخدم إعلانات Google، يتوفّر عدد كبير من الأعمدة المحتملة التي تتوافق مع المقاييس في Google Ads API. يلخّص الجدول التالي عملية ربط الأعمدة في واجهة المستخدم بالمقاييس المكافئة في واجهة برمجة التطبيقات.