فئات إجراءات الإحالات الناجحة

يوفّر هذا الدليل قائمة بالأنواع المختلفة لإجراءات الإحالات الناجحة التي يمكنك إنشاؤها باستخدام Google Ads API، ومعلومات عن كيفية ربطها بواجهة الويب في "إعلانات Google".

الإحالات الناجحة بلا إنترنت

تساعدك الإحالات الناجحة بلا إنترنت في تتبُّع أحداث الإحالات الناجحة التي تحدث في العالم الواقعي، مثل مكتبك أو موقع نشاطك التجاري أو عبر الهاتف.

يوضّح الجدول التالي المَعلمات المكافئة ConversionActionType لواجهة برمجة التطبيقات لاستخدامها لكلّ مصدر في واجهة الويب في "إعلانات Google"، ورابطًا إلى المستندات لكلّ نوع محدّد من إجراءات الإحالات الناجحة:

نوع إجراء الإحالة الناجحة مصدر "إعلانات Google" دليل إعداد واجهة برمجة التطبيقات
UPLOAD_CLICKS تتبُّع الإحالات الناجحة من خلال النقرات والإحالات الناجحة المحسّنة لل leads دليل إدارة الإحالات الناجحة الناتجة عن النقرات بلا إنترنت
دليل الإحالات الناجحة المُحسّنة للعملاء المحتملين
UPLOAD_CALLS تتبع الإحالات الناجحة من المكالمات دليل استيراد الإحالات الناجحة عبر الاتصال الهاتفي
STORE_SALES تتبُّع الإحالات الناجحة للمبيعات في المتاجر دليل استيراد الإحالات الناجحة المتعلّقة بمبيعات المتجر

الإحالات الناجحة على الإنترنت (الموقع الإلكتروني)

تتيح لك الإحالة الناجحة على الموقع الإلكتروني تتبُّع إجراءات الموقع الإلكتروني، مثل المبيعات على الإنترنت، والنقرات على الروابط، ومشاهدات الصفحة، والاشتراكات.

لتتبُّع الإحالات الناجحة على موقعك الإلكتروني، عليك إنشاء ConversionAction مع تحديد ConversionActionType على WEBPAGE، وإضافة مقتطف رمز يُعرف باسم علامة إلى صفحة الإحالة الناجحة على موقعك الإلكتروني.

يتضمّن ConversionAction عدة أنواع من الإحالات الناجحة للموقع الإلكتروني، ويتم تمييزها في واجهة برمجة التطبيقات باستخدام الحقل type في كل TagSnippet مُدرَج في الحقل tag_snippets في ConversionAction.

يوفّر TagSnippet رمز التتبّع الذي يجب إدراجه في موقعك الإلكتروني لتتبُّع إجراءات إحالاتك الناجحة. تتطلّب الإحالات الناجحة الناتجة عن الموقع الإلكتروني والنقر على رقم الهاتف استخدام العلامة event_snippet، التي يجب وضعها على صفحات الويب التي تشير إلى إجراء إحالة ناجحة، مثل تأكيد الدفع أو صفحة إرسال نموذج العملاء المحتملين، وglobal_site_tag، التي يجب تثبيتها على كل صفحة من صفحات موقعك الإلكتروني. يمكنك استرداد كلٍّ من هذه السمتَين باستخدام ConversionActionService. يمكنك الانتقال إلى مركز المساعدة للاطّلاع على المزيد من المعلومات حول كيفية الإشارة إلى صفحاتك.

يعرض الجدول التالي مَعلمات واجهة برمجة التطبيقات المماثلة التي يجب استخدامها لكلّ مصدر في واجهة الويب في "إعلانات Google":

نوع رمز التتبّع مصدر "إعلانات Google"
WEBPAGE الموقع الإلكتروني، الموقع الإلكتروني (إحصاءات Google‏ 4)
WEBPAGE_ONCLICK الموقع الإلكتروني، الموقع الإلكتروني (إحصاءات Google‏ 4)
CLICK_TO_CALL نقرات رقم الهاتف

الإحالات الناجحة للتطبيق

تتيح لك الإحالة الناجحة للتطبيق تتبُّع عمليات تثبيت التطبيق المتوافق مع الأجهزة الجوّالة أو عمليات الشراء داخل التطبيق من متجر Google Play.

يعرض الجدول التالي ConversionActionType مَعلمات واجهة برمجة التطبيقات المماثلة التي يجب استخدامها لكل مصدر في واجهة الويب في "إعلانات Google":

نوع إجراء الإحالة الناجحة مصدر "إعلانات Google"
GOOGLE_PLAY_DOWNLOAD Google Play > عمليات التثبيت
GOOGLE_PLAY_IN_APP_PURCHASE Google Play > عمليات الشراء داخل التطبيقات

لتتبُّع إجراءات أخرى للتطبيقات المتوافقة مع الأجهزة الجوّالة باستخدام مواقع "إحصاءات Google‏ 4" أو إحصاءات التطبيقات التابعة لجهات خارجية، اطّلِع على أنواع إجراءات الإحالات الناجحة الإضافية.

إحالات ناجحة المكالمات الهاتفية

تتيح لك ميزة تتبُّع الإحالات الناجحة عبر المكالمات الهاتفية تتبُّع المكالمات الواردة من الإعلانات، والمكالمات الواردة إلى رقم على موقعك الإلكتروني، والنقرات على الأرقام على المواقع الإلكترونية المتوافقة مع الأجهزة الجوّالة.

يعرض الجدول التالي ConversionActionType مَعلمات واجهة برمجة التطبيقات المماثلة التي يجب استخدامها لكل مصدر في واجهة الويب في "إعلانات Google":

نوع إجراء الإحالة الناجحة مصدر "إعلانات Google"
AD_CALL المكالمات من الإعلانات التي تستخدم إضافات المكالمات أو الإعلانات للاتصال فقط
WEBSITE_CALL المكالمات الواردة إلى رقم هاتف مُدرَج في موقعك الإلكتروني
CLICK_TO_CALL النقرات التي يتم إجراؤها على رقم في موقعك للجوّال

AD_CALL

يظهر إجراء الإحالة الناجحة AD_CALL كإحالة ناجحة من النوع المكالمات الواردة من الإعلانات في واجهة الويب في "إعلانات Google". بعد إنشاء إجراء الإحالة الناجحة AD_CALL، حدِّد اسم المورد في حقل call_conversion_action عند إنشاء CallAsset. تتيح لك مواد عرض الاتصال عرض رقم هاتف مباشرةً في إعلاناتك.

يتم تسجيل المكالمة كإحالة ناجحة إذا استمرت لفترة أطول من مدة محدّدة. المدة التلقائية هي 60 ثانية.

WEBSITE_CALL

يظهر إجراء الإحالة الناجحة WEBSITE_CALL كإحالة ناجحة من النوع المكالمات الواردة من موقع إلكتروني في واجهة "إعلانات Google" على الويب.

على عكس AD_CALL، يتطلب هذا المتتبّع إضافة event_snippet وglobal_site_tag إلى موقعك الإلكتروني لاسترداد رقم توجيه المكالمات الديناميكي من Google لتتبُّع المكالمات على الأرقام المدرَجة في موقعك الإلكتروني. بالإضافة إلى ذلك، عليك إعداد مادة عرض مكالمة وربطها على مستوى العميل أو الحملة أو المجموعة الإعلانية.

CLICK_TO_CALL

يظهر إجراء الإحالة الناجحة CLICK_TO_CALL كإحالة ناجحة من النوع النقرات على رقمك على موقعك الإلكتروني المتوافق مع الأجهزة الجوّالة في واجهة الويب في "إعلانات Google".

يختلف نوع CLICK_TO_CALL عن نوع AD_CALL لأنّه لا يتتبّع المكالمات الهاتفية الفعلية. بدلاً من ذلك، CLICK_TO_CALL يتتبّع فقط النقرات على رقم هاتف من جهاز جوّال. يكون ذلك مفيدًا عندما يتعذّر عليك استخدام رقم توجيه المكالمات من Google لتتبُّع المكالمات الهاتفية.

الإحالات الناجحة المحسّنة

تساعدك ميزة الإحالات الناجحة المحسّنة في تحسين دقة قياس الإحالات الناجحة من خلال إضافة علامات الإحالات الناجحة الحالية إلى بيانات الإحالات الناجحة التابعة لطرف أول، مثل عنوان البريد الإلكتروني والاسم وعنوان المنزل ورقم الهاتف.

يوضِّح الجدول التالي مَعلمات واجهة برمجة التطبيقات المماثلة لاستخدامها مع كلّ نوع إحالة ناجحة محسّنة:

نوع إجراء الإحالة الناجحة نوع الإحالة الناجحة المحسّنة دليل إعداد واجهة برمجة التطبيقات
UPLOAD_CLICKS الإحالات الناجحة المحسّنة للعملاء المحتملين
تحسِّن عملية قياس المعاملات التي تتم خارج إطار الإنترنت والتي تنتج عن عميل محتمل أو زائر للموقع الإلكتروني. 		دليل إعداد واجهة برمجة التطبيقات
WEBPAGE الإحالات الناجحة المحسّنة للويب
تحسِّن عملية قياس الإحالات الناجحة على الإنترنت. 		دليل إعداد واجهة برمجة التطبيقات

أنواع إجراءات الإحالات الناجحة الإضافية

توفّر Google Ads API أنواعًا إضافية من إجراءات الإحالات الناجحة في التقارير، ولكن قد تحدّ من إنشاء هذه الإجراءات أو تعديلها أو تحظرها.

إحالات SKAdNetwork الناجحة

إذا كنت تُدير حملات تطبيقات iOS ونفّذت SKAdNetwork، يمكنك الوصول إلى بيانات SKAdNetwork المقدَّمة إلى Google على مستوىCustomer وCampaign باستخدام الموارد التالية:

حقل التقرير الوصف
metrics.sk_ad_network_installs عدد عمليات التثبيت التي أبلغت عنها Apple لا يمكن تقسيم هذا المقياس إلا حسب أيّ مجموعة من شرائح segments.sk_ad_network_conversion_value و ذات الصلة بالتاريخ.
metrics.sk_ad_network_total_conversions إجمالي عدد الإحالات الناجحة، بما في ذلك عمليات التثبيت وأنواع أخرى من الإحالات الناجحة التي أبلغت عنها Apple لا يمكن تقسيم هذا المقياس إلا من خلال الشرائح المرتبطة بـ SKAdNetwork والشرائح المرتبطة بالتاريخ.
segments.sk_ad_network_ad_event_type نوع الحدث الذي حدث لإحالة ناجحة معيّنة.
segments.sk_ad_network_attribution_credit كيفية تحديد نسبة المساهمة في إحالة ناجحة معيّنة
segments.sk_ad_network_fine_conversion_value

قيمة الإحالة الناجحة التي أبلغت عنها Apple. لا يمكن تطبيق هذه الشريحة على أي مقاييس غير metrics.sk_ad_network_installs metrics.sk_ad_network_total_conversions، ولا يمكن دمجها إلا مع الشرائح المرتبطة بالتاريخ.

يتم عرض القيمة 0 إذا أبلغت Apple عن قيمة 0، ولا يتم عرض أي قيمة بخلاف ذلك. تحقّق من مدى توفّر الحقل للتمييز بين الحالتَين.
segments.sk_ad_network_coarse_conversion_value القيمة التقريبية لإحالة ناجحة فردية.
segments.sk_ad_network_postback_sequence_index موضع تسجيل الإحالة الناجحة، بالتسلسل، لإحالة ناجحة معيّنة.
segments.sk_ad_network_source_app.sk_ad_network_source_app_id رقم تعريف التطبيق الذي تمّ عرض الإعلان عليه والذي أدّى إلى تثبيت شبكة إعلانات iOS StoreKit
segments.sk_ad_network_source_domain الموقع الإلكتروني الذي تمّ فيه عرض الإعلان الذي أدّى إلى تثبيت شبكة إعلانات iOS StoreKit تعني القيمة الخالية أنّ هذه الشريحة غير قابلة للتطبيق، على سبيل المثال، إحدى الحملات التي لا تعمل على نظام التشغيل iOS، أو لم تكن متوفّرة في أي عمليات تسجيل إحالات ناجحة أرسلتها Apple.
segments.sk_ad_network_source_type نوع المصدر الذي تمّ فيه عرض الإعلان الذي أدّى إلى تثبيت شبكة إعلانات iOS StoreKit تعني القيمة الخالية أنّ هذا الجزء غير قابل للتطبيق، مثلاً، الحملة غير المخصّصة لنظام التشغيل iOS، أو أنّ النطاق المصدر أو التطبيق المصدر لم يكنا مُدرَجين في أي عمليات تسجيل إحالات ناجحة أرسلتها Apple.
segments.sk_ad_network_user_type نوع المستخدِم الذي أنشأ إحالة ناجحة معيّنة.
segments.sk_ad_network_redistributed_fine_conversion_value تتضمّن قيم الإحالات الناجحة في هذا المقطع قيمًا فارغة تمت إعادتها توزيعها على قيم الإحالات الناجحة. تمثّل هذه الشريحة مجموع قيم الإحالات الناجحة الجيدة المرصودة التي تعرضها Apple والقيم الفارغة المستندة إلى نموذج من Google.
segments.sk_ad_network_version إصدار iOS Store Kit Ad Network API الذي تم استخدامه

إحصاءات Google

تحتوي الإحالات الناجحة من موقع مرتبط على "إحصاءات Google" على إحدى قيم type التالية:

  • الإحالة الناجحة لموقع "إحصاءات Google‏ 4":

    • GOOGLE_ANALYTICS_4_CUSTOM
    • GOOGLE_ANALYTICS_4_PURCHASE

    يمكنك أيضًا استرداد رقم تعريف الموقع واسم الموقع واسم الحدث على "إحصاءات Google‏ 4" من حقل google_analytics_4_settings.

يمكنك إجراء التغييرات التالية على إحالة ناجحة لموقع على "إحصاءات Google‏ 4":

تؤدي أي محاولة لتعديل سمات أخرى لإحالة ناجحة مستورَدة من "إحصاءات Google‏ 4" أو أي سمات لإحالة ناجحة مستورَدة من Universal Analytics إلى MUTATE_NOT_ALLOWED خطأ. ولا يمكنك إجراء هذه التغييرات إلا باستخدام واجهة مستخدم "إعلانات Google".

Firebase وإحصاءات التطبيقات التابعة لجهات خارجية

لاستيراد إحصاءات تطبيقات تابعة لجهات خارجية أو الإحالات الناجحة من Firebase، غيِّر status في ConversionAction من HIDDEN إلى ENABLED باستخدام طريقة mutate في ConversionActionService. لا يمكن تعديل app_id في إجراءات الإحالات الناجحة هذه.

  • FIREBASE_ANDROID_FIRST_OPEN
  • FIREBASE_ANDROID_IN_APP_PURCHASE
  • FIREBASE_ANDROID_CUSTOM
  • FIREBASE_IOS_FIRST_OPEN
  • FIREBASE_IOS_IN_APP_PURCHASE
  • FIREBASE_IOS_CUSTOM
  • THIRD_PARTY_APP_ANALYTICS_ANDROID_FIRST_OPEN
  • THIRD_PARTY_APP_ANALYTICS_ANDROID_IN_APP_PURCHASE
  • THIRD_PARTY_APP_ANALYTICS_ANDROID_CUSTOM
  • THIRD_PARTY_APP_ANALYTICS_IOS_FIRST_OPEN
  • THIRD_PARTY_APP_ANALYTICS_IOS_IN_APP_PURCHASE
  • THIRD_PARTY_APP_ANALYTICS_IOS_CUSTOM

المبيعات في المتاجر: الاستيراد إلى إجراء الإحالة الناجحة مع إعداد التقارير

على الرغم من أنّه لا يمكنك إنشاء إجراءات إحالات ناجحة STORE_SALES أو STORE_SALES_DIRECT_UPLOAD باستخدام Google Ads API، تتيح واجهة برمجة التطبيقات استيراد معاملات المبيعات في المتاجر.

  • STORE_SALES
  • STORE_SALES_DIRECT_UPLOAD

أنواع إجراءات الإحالات الناجحة للقراءة فقط

تكون أنواع إجراءات الإحالات الناجحة التالية للقراءة فقط في Google Ads API ويتم توفيرها لأغراض إعداد التقارير.

  • ANDROID_APP_PRE_REGISTRATION
  • ANDROID_INSTALLS_ALL_OTHER_APPS
  • FLOODLIGHT_ACTION
  • FLOODLIGHT_TRANSACTION
  • GOOGLE_HOSTED
  • LEAD_FORM_SUBMIT
  • SALESFORCE
  • SEARCH_ADS_360
  • SMART_CAMPAIGN_AD_CLICKS_TO_CALL
  • SMART_CAMPAIGN_MAP_CLICKS_TO_CALL
  • SMART_CAMPAIGN_MAP_DIRECTIONS
  • SMART_CAMPAIGN_TRACKED_CALLS
  • STORE_VISITS
  • WEBPAGE_CODELESS

غير معروف

إذا كان حسابك على "إعلانات Google" يتضمّن أنواعًا أخرى من إجراءات الإحالات الناجحة، قد تلاحظ أنّ طلبات البحث والتقارير تعرض إجراءات إحالات ناجحة يكون فيها قيمة ConversionAction.type هي UNKNOWN. لا تتيح واجهة برمجة التطبيقات إدارة إجراءات الإحالات الناجحة هذه، ولكنها تعرضها في التقارير لتقديم نتائج كاملة لمقاييس الإحالات الناجحة الرئيسية مثل metrics.conversions وmetrics.conversions_value.

السابق
نظرة عامة
التالي
البدء