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

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

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

للمساعدة في اختيار نوع إجراء الإحالة الناجحة ودليل الإعداد الصحيحَين لعملية الدمج، استخدِم مسار اتخاذ القرار التالي:

  1. أين يحدث حدث الإحالة الناجحة؟

    • في العالم غير الإلكتروني (مثلاً، في مكتبك أو موقع مؤسستك أو عبر الهاتف): انتقِل إلى الخطوة 2.
    • مباشرةً على موقعك الإلكتروني (مثلاً، عمليات الشراء أو الاشتراكات أو إرسال النماذج على الموقع الإلكتروني): انتقِل إلى الخطوة 3.
    • داخل تطبيق متوافق مع الأجهزة الجوّالة: انتقِل إلى الخطوة 4.
    • عبر مكالمة هاتفية يتم طلبها مباشرةً من إعلاناتك: استخدِم المكالمات من الإعلانات (AD_CALL) (باستخدام CallAsset).

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

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

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

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

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

يوضّح الجدول التالي مَعلمات ConversionActionType API المكافئة التي يجب استخدامها لكل مصدر في واجهة مستخدم "إعلانات 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 API المكافئة التي يجب استخدامها لكل مصدر في واجهة مستخدم "إعلانات Google" على الويب:

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

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

الإحالات الناجحة عبر الاتصال الهاتفي

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

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

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

AD_CALL

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

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

WEBSITE_CALL

يظهر إجراء الإحالة الناجحة A 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 ولا يتم عرض أي قيمة بخلاف ذلك. تحقَّق من وجود الحقل للتمييز بين الحالتَين.
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.

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