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

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

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

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

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

نوع إجراء الإحالة الناجحة مصدر "إعلانات Google" دليل إعداد واجهة برمجة التطبيقات
UPLOAD_CLICKS تتبُّع الإحالات الناجحة من خلال النقرات و"الإحالات الناجحة المحسّنة للعملاء المحتملين" دليل إدارة الإحالات الناجحة غير الإلكترونية الناتجة من النقرات
دليل الإحالات الناجحة المحسّنة للعملاء المحتملين
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 الذي تم استخدامه.

إحصاءات Google

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

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

    • GOOGLE_ANALYTICS_4_CUSTOM
    • GOOGLE_ANALYTICS_4_PURCHASE

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

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

  • استورِد الإحالة الناجحة من موقعك على "إحصاءات Google‏ 4" إلى حسابك على "إعلانات Google" من خلال تعديل الحقل status من HIDDEN إلى ENABLED.
  • عدِّل الحقلَين primary_for_goal وcategory لتحديد تأثيره في عروض الأسعار والتقارير على "إعلانات Google".
  • عدِّل name أو value_settings.
  • أزِل الإحالة الناجحة من حسابك على "إعلانات Google" باستخدام عملية remove.

تؤدي أي محاولة لتعديل سمات أخرى لإحالة ناجحة مستورَدة من "إحصاءات 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.

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