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

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

الإحالات الناجحة غير الإلكترونية

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

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

نوع إجراء الإحالة الناجحة مصدر "إعلانات Google" دليل إعداد واجهة برمجة التطبيقات
UPLOAD_CLICKS تتبُّع الإحالات الناجحة من النقرات والإحالات الناجحة المحسّنة للعملاء المحتملين استخدِم Data Manager API
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 الإحالات الناجحة المحسّنة للعملاء المحتملين
تحسِّن عملية قياس المعاملات غير الإلكترونية التي تأتي من عميل محتمل أو زائر للموقع الإلكتروني 		استخدِم Data Manager API
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 ولا يتم عرض أي قيمة بخلاف ذلك. تحقَّق من حقل presence للتمييز بين الحالتَين.
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.

السابق
نظرة عامة
التالي
بدء استخدام الإحالات الناجحة