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

يمكنك إعداد تقارير عن الإحالات الناجحة في 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_action في عبارة SELECT إلى تغيير مستوى التفاصيل لنتائج طلب البحث إلى صف واحد لكل إجراء إحالة ناجحة لكل حملة، ويتم استبعاد الصفوف التي تتضمّن صفر إحالات ناجحة من الردّ.

قد لا تتوفّر بعض الحقول المرتبطة بالإحالات الناجحة، مثل 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_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