تستخدم Google تكنولوجيا الذكاء الاصطناعي لترجمة المحتوى إلى لغتك المفضّلة، وقد تتضمّن بعض الأخطاء.

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

يمكنك إعداد تقارير عن الإحالات الناجحة في 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"، يتوفّر عدد كبير من الأعمدة المحتملة التي تتوافق مع المقاييس في Google Ads API. يلخّص الجدول التالي عملية ربط الأعمدة في واجهة المستخدم بالمقاييس المكافئة في واجهة برمجة التطبيقات.

واجهة المستخدِم	واجهة برمجة التطبيقات
كل الإحالات الناجحة	`metrics.all_conversions`
كل الإحالات الناجحة (حسب وقت الإحالة الناجحة)	`metrics.all_conversions_by_conversion_date`
معدل كل الإحالات الناجحة	`metrics.all_conversions_from_interactions_rate`
قيمة كل الإحالات الناجحة / التكلفة	`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.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`

مراقبة حالة التحميل

تحديد المشاكل وحلّها