إعداد تقارير الإحالات الناجحة

يمكنك إعداد تقارير عن الإحالات الناجحة في 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_view.

على سبيل المثال، يستعرِض طلب البحث التالي مقياسَي 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 Ads API ولا يمكن استردادها في التقارير.

ربط مقاييس واجهة المستخدم

عند عرض حملة باستخدام واجهة مستخدم إعلانات Google، هناك عدد كبير من الأعمدة المحتملة التي تتوافق مع المقاييس في Google Ads API. يلخّص الجدول التالي عملية ربط الأعمدة في واجهة المستخدِم بالمقاييس المكافئة في واجهة برمجة التطبيقات.

واجهة المستخدم	API
كل الإحالات الناجحة	metrics.all_conversions
كل الإحالات الناجحة (حسب وقت الإحالة الناجحة)	metrics.all_conversions_by_conversion_date
معدل كل الإحالات الناجحة	metrics.all_conversions_value
قيمة كل الإحالات الناجحة / التكلفة	metrics.all_conversions_value_per_cost
قيمة كل الإحالات الناجحة (حسب وقت الإحالة الناجحة)	metrics.all_conversions_value_by_conversion_date
الإحالات الناجحة	metrics.conversions
الإحالات الناجحة (حسب وقت الإحالة الناجحة)	metrics.conversions_by_conversion_date
الإحالات الناجحة (النموذج الحالي)	metrics.current_model_attributed_conversions
معدّل الإحالات الناجحة	metrics.conversions_from_interactions_rate
معدّل الإحالات الناجحة (النموذج الحالي)	metrics.current_model_attributed_conversions_from_interactions_rate
قيمة الإحالة الناجحة	metrics.conversions_value
قيمة الإحالة الناجحة (حسب وقت الإحالة الناجحة)	metrics.conversions_value_by_conversion_date
قيمة الإحالات الناجحة (النموذج الحالي)	metrics.current_model_attributed_conversions_value
قيمة الإحالة الناجحة / التكلفة	metrics.conversions_value_per_cost
قيمة الإحالة الناجحة / التكلفة (النموذج الحالي)	metrics.current_model_attributed_conversions_value_per_cost
قيمة الإحالة الناجحة / نقرة	metrics.all_conversions_from_interactions_value_per_interaction
قيمة الإحالة الناجحة/النقرة (النموذج الحالي)	metrics.current_model_attributed_conversions_from_interactions_value_per_interaction
التكلفة/كل الإحالات الناجحة	metrics.cost_per_all_conversions
تكلفة الإحالة الناجحة	metrics.cost_per_conversion
تكلفة الإحالة الناجحة (النموذج الحالي)	metrics.cost_per_current_model_attributed_conversion
الإحالات الناجحة باستخدام أكثر من جهاز واحد	metrics.cross_device_conversions
إحالات SKAdNetwork الناجحة	metrics.sk_ad_network_conversions
زيارات المتجر	metrics.all_conversions_from_store_visit
القيمة / كل الإحالات الناجحة	metrics.value_per_all_conversions
القيمة / كل الإحالات الناجحة (حسب وقت الإحالة الناجحة)	metrics.value_per_all_conversions_by_conversion_date
القيمة / الإحالة الناجحة	metrics.value_per_conversion
القيمة / الإحالة الناجحة (حسب وقت الإحالة الناجحة)	metrics.value_per_conversions_by_conversion_date
القيمة / الإحالة الناجحة (النموذج الحالي)	metrics.value_per_current_model_attributed_conversion
الإحالة الناجحة بعد رؤية الإعلان فقط	metrics.view_through_conversions