يمكنك إعداد تقارير عن الإحالات الناجحة في 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 لحملاتك خلال آخر 30 يومًا، مع تقسيم النتائج حسب conversion_action:
SELECT
campaign.name,
segments.conversion_action,
metrics.conversions,
metrics.conversions_value
FROM campaign
WHERE segments.date DURING LAST_30_DAYS
قد لا تتوفّر بعض الحقول المرتبطة بالإحالات الناجحة، مثل
segments.conversion_or_adjustment_lag_bucket وحقول المقاييس الأخرى، في جميع التقارير. راجِع صفحة المرجع المعنيّة للاطّلاع على قائمة كاملة بالحقول المتوافقة.
المخاوف الشائعة
- بياناتي ليست محدّثة.
- عند الاطّلاع على بيانات الإحالات الناجحة، ضَع في اعتبارك أنّ بيانات الأداء لا تتوفّر على الفور. راجِع دليل سرعة توفُّر البيانات في "إعلانات Google" للحصول على معلومات عن سرعة توفُّر بيانات الإحالات الناجحة.
- تقريري فارغ.
- لن يتم عرض الصفوف في التقارير التي تكون فيها جميع المقاييس صفرًا، مثل تلك الخاصة بإجراءات الإحالات الناجحة الجديدة.
- لا يمكنني الوصول إلى أعمدتي المخصّصة من خلال Google Ads API. لا تتوافق
- الأعمدة المخصّصة مع Google Ads API، ولا يمكن استردادها في التقارير.
مقاييس واجهة مستخدم الخريطة
عند الاطّلاع على حملة باستخدام واجهة مستخدم إعلانات Google، يتوفّر عدد كبير من الأعمدة المحتملة التي تتوافق مع المقاييس في Google Ads API. يلخّص الجدول التالي عملية ربط الأعمدة في واجهة المستخدم بالمقاييس المكافئة في واجهة برمجة التطبيقات.