تستخدم Google تكنولوجيا الذكاء الاصطناعي لترجمة المحتوى إلى لغتك المفضّلة، وقد تتضمّن بعض الأخطاء.

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

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

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

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

أين يقع حدث الإحالة الناجحة؟
- خارج إطار الإنترنت (على سبيل المثال، في مكتبك أو موقع نشاطك التجاري أو عبر الهاتف): انتقِل إلى الخطوة 2.
- مباشرةً على موقعك الإلكتروني (على سبيل المثال، عمليات الشراء أو الاشتراك أو إرسال النماذج على الموقع الإلكتروني): انتقِل إلى الخطوة 3.
- ضمن تطبيق متوافق مع الأجهزة الجوّالة: انتقِل إلى الخطوة 4.
- عبر مكالمة هاتفية يتم إجراؤها مباشرةً من إعلاناتك: استخدِم المكالمات من الإعلانات (AD_CALL) (باستخدام CallAsset).
الإحالات الناجحة غير الإلكترونية:
- هل هي مكالمة هاتفية؟
  - نعم: استخدام
    
    استيراد الإحالات الناجحة عبر الاتصال الهاتفي (UPLOAD_CALLS) لتتبُّع نتائج المكالمات
- هل هي عملية بيع في متجر؟
  - نعم: استخدام
    
    الإحالات الناجحة للمبيعات في المتاجر (STORE_SALES):
- هل هي عملية بيع خارج الإنترنت أو تقدّم في جذب العملاء المحتملين ناتج عن زيارة الموقع الإلكتروني؟
  - نعم: استخدِم ميزة الإحالات الناجحة المحسّنة للعملاء المحتملين من خلال Data Manager API (يُنصح بذلك)، أو اطّلِع على مقالة إدارة الإحالات الناجحة الناتجة عن النقرات غير الإلكترونية لعمليات الدمج الحالية في Google Ads API. (ملاحظة: اعتبارًا من 15 يونيو 2026، سيقتصر تحميل الإحالات الناجحة الناتجة عن النقرات باستخدام UploadClickConversions على الرموز المميّزة للمطوّرين التي سبق أن حمّلت إحالات ناجحة ناتجة عن النقرات بلا إنترنت).
الإحالات الناجحة على الإنترنت (الموقع الإلكتروني):
- هل تريد تتبُّع عمليات تحميل الصفحات (عمليات الشراء والإيصالات) أو نقرات المستخدمين؟
  - نعم: استخدِم الإحالات الناجحة على الموقع الإلكتروني مع ضبط مقتطف العلامة على WEBPAGE أو WEBPAGE_ONCLICK.
- هل تريد تتبُّع المكالمات الواردة من رقم هاتف مُدرج في موقعك الإلكتروني؟
  - هل تريد تتبُّع المدة الفعلية للمكالمات؟
    - نعم: استخدام
      
      المكالمات الواردة من موقع إلكتروني (WEBSITE_CALL) باستخدام رقم ديناميكي لتوجيه المكالمات من Google ومقتطف حدث علامة التتبُّع
    - لا (أريد فقط تتبُّع النقرات على الأزرار أو الروابط في الموقع الإلكتروني المتوافق مع الأجهزة الجوّالة) استخدام
      
      النقرات على رقم هاتفك الجوّال (CLICK_TO_CALL)
الإحالات الناجحة للتطبيقات على الأجهزة الجوّالة:
- هل يكفي تتبُّع عمليات التثبيت أو الشراء من "متجر Google Play"؟
  - نعم: استخدِم الإحالات الناجحة للتطبيق (GOOGLE_PLAY_DOWNLOAD أو GOOGLE_PLAY_IN_APP_PURCHASE).
- هل يتم تتبُّع إجراءات التطبيق باستخدام "إحصاءات Google‏ 4" (GA4) أو إحصاءات التطبيقات الخارجية؟
  - نعم: استخدام
    
    Firebase وإحصاءات التطبيقات الخارجية (من خلال تفعيل إجراءات الإحالات الناجحة FIREBASE_* أو THIRD_PARTY_*)

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

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

يوضّح الجدول التالي مَعلمات واجهة برمجة التطبيقات 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" أو إحصاءات التطبيقات التابعة لجهات خارجية، اطّلِع على الأنواع الإضافية لإجراءات الإحالات الناجحة.

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

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

نوع إجراء الإحالة الناجحة	مصدر "إعلانات 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.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" إلى حسابك على "إعلانات 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_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 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.

نظرة عامة

بدء استخدام الإحالات الناجحة