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

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

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

عند عرض حملة باستخدام واجهة مستخدِم إعلانات Google، يتوفّر عدد كبير من الأعمدة المحتمَلة التي تتوافق مع المقاييس في Google Ads 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_installs
إجمالي الإحالات الناجحة من SKAdNetwork metrics.sk_ad_network_total_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