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

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

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

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

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

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

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

  4. الإحالات الناجحة للتطبيقات على الأجهزة الجوّالة:

    • هل يكفي تتبُّع عمليات التثبيت أو الشراء من "متجر Google Play"؟
    • هل يتم تتبُّع إجراءات التطبيق باستخدام "إحصاءات Google‏ 4" (GA4) أو إحصاءات التطبيقات الخارجية؟

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

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

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

نوع إجراء الإحالة الناجحة مصدر "إعلانات Google" دليل إعداد واجهة برمجة التطبيقات
UPLOAD_CLICKS تتبُّع الإحالات الناجحة من خلال النقرات والإحالات الناجحة المحسّنة للعملاء المحتملين استخدِم Data Manager API (يُنصح به) أو اطّلِع على المقالة إدارة الإحالات الناجحة الناتجة عن النقرات غير الإلكترونية لعمليات الدمج الحالية مع Google Ads 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 (يُنصح به) أو اطّلِع على إدارة الإحالات الناجحة الناتجة عن النقرات غير الإلكترونية لعمليات الدمج الحالية في Google Ads API
WEBPAGE الإحالات الناجحة المحسّنة للويب
تحسِّن عملية قياس الإحالات الناجحة على الإنترنت
دليل إعداد واجهة برمجة التطبيقات

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

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

SELECT
  conversion_action.id,
  conversion_action.name,
  conversion_action.type,
  conversion_action.origin,
  conversion_action.category,
  conversion_action.status
FROM conversion_action

إحالات 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 إصدار واجهة برمجة التطبيقات Store Kit Ad Network لنظام التشغيل iOS الذي تم استخدامه

إحصاءات Google

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

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

    • GOOGLE_ANALYTICS_4_CUSTOM
    • GOOGLE_ANALYTICS_4_PURCHASE

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

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

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

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

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

  • FIREBASE_ANDROID_APP_AD_IMPRESSION
  • FIREBASE_ANDROID_FIRST_OPEN
  • FIREBASE_ANDROID_IN_APP_PURCHASE
  • FIREBASE_ANDROID_CUSTOM
  • FIREBASE_IOS_APP_AD_IMPRESSION
  • 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" تلقائيًا إحالات ناجحة من الإجراءات المحلية لتتبُّع الإجراءات على منتجات Google وخدماتها المستندة إلى الموقع الجغرافي (مثل "خرائط Google") بعد تفاعل أحد المستخدمين مع إعلان.

في Google Ads API، تكون جميع الإحالات الناجحة من الإجراءات المحلية موارد ConversionAction للقراءة فقط مع قيم الحقول التالية:

يحدّد الحقلان name (المترجمان إلى لغة الحساب) وcategory كل إحالة ناجحة من الإجراءات المحلية، كما هو موضّح في الجدول التالي. يستخدم كلّ من الإجراءات المحلية - زيارات الموقع الإلكتروني والإجراءات المحلية - مرات مشاهدة القائمة الفئة "PAGE_VIEW"، ويتم تمييزهما في التقارير من خلال conversion_action.name أو conversion_action.id.

اسم إجراء الإحالة الناجحة في "إعلانات Google" حقل ConversionAction.category الوصف
النقرات للاتصال CONTACT النقرات على زرّ الاتصال في إعلان أو خدمة من Google تستند إلى الموقع الجغرافي
الإجراءات المحلية - الاتجاهات GET_DIRECTIONS النقرات على زرّ الحصول على الاتجاهات في إعلان أو خدمة تستند إلى الموقع الجغرافي من Google
الإجراءات المحلية - زيارات الموقع الإلكتروني PAGE_VIEW النقرات على رابط الموقع الإلكتروني في إعلان أو خدمة تستند إلى الموقع الجغرافي من Google
الإجراءات المحلية - مرات مشاهدة القائمة PAGE_VIEW النقرات على رابط القائمة في إعلان أو خدمة تستند إلى الموقع الجغرافي من Google
الإجراءات المحلية - الطلبات BEGIN_CHECKOUT النقرات على زرّ الطلب في إعلان أو خدمة تستند إلى الموقع الجغرافي من Google
الإجراءات المحلية - تفاعلات أخرى ENGAGEMENT النقرات على الإجراءات الأخرى التي يتم تتبّعها (مثل مشاركة موقع جغرافي أو حفظه) في إعلان أو خدمة يستندان إلى الموقع الجغرافي من Google

بشكل تلقائي، تكون جميع أهداف الإحالات الناجحة في "GOOGLE_HOSTED" غير قابلة للمزايدة (biddable هي false). يمكنك تفعيل المزايدة فقط لأهداف الإجراءات المحلية التالية:

  • الإجراءات المحلية - الاتجاهات (category هو GET_DIRECTIONS، وorigin هو GOOGLE_HOSTED):
    • على مستوى الحساب: اضبط الحقل biddable على true في المورد CustomerConversionGoal للفئة GET_DIRECTIONS والمصدر GOOGLE_HOSTED، أو أدرِج إجراء الإحالة الناجحة في CustomConversionGoal.
    • على مستوى الحملة ("حملات الأداء الأفضل" و"حملات شبكة البحث" و"حملات تسوّق" فقط): اضبط الحقل biddable على true في مورد CampaignConversionGoal للفئة GET_DIRECTIONS والمصدر GOOGLE_HOSTED.
  • النقرات للاتصال (category هو CONTACT، وorigin هو GOOGLE_HOSTED):
    • على مستوى الحملة ("حملات الأداء الأفضل" فقط): اضبط الحقل biddable على true في مورد CampaignConversionGoal للفئة CONTACT والمصدر GOOGLE_HOSTED. لا يمكن استخدام عروض الأسعار على مستوى الحساب باستخدام "CustomerConversionGoal" لهذا الهدف.

جميع فئات GOOGLE_HOSTED الأخرى (PAGE_VIEW وBEGIN_CHECKOUT وENGAGEMENT) غير قابلة للمزايدة. لمزيد من المعلومات، يُرجى الاطّلاع على أهداف الإحالات الناجحة.

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

تكون أنواع إجراءات الإحالات الناجحة التالية للقراءة فقط في 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.