ConversionAction

إجراء إحالة ناجحة.

تمثيل JSON 
{
  "resourceName": string,
  "status": enum (ConversionActionStatus),
  "type": enum (ConversionActionType),
  "origin": enum (ConversionOrigin),
  "category": enum (ConversionActionCategory),
  "valueSettings": {
    object (ValueSettings)
  },
  "countingType": enum (ConversionActionCountingType),
  "attributionModelSettings": {
    object (AttributionModelSettings)
  },
  "tagSnippets": [
    {
      object (TagSnippet)
    }
  ],
  "mobileAppVendor": enum (MobileAppVendor),
  "firebaseSettings": {
    object (FirebaseSettings)
  },
  "thirdPartyAppAnalyticsSettings": {
    object (ThirdPartyAppAnalyticsSettings)
  },
  "googleAnalytics4Settings": {
    object (GoogleAnalytics4Settings)
  },
  "id": string,
  "name": string,
  "primaryForGoal": boolean,
  "ownerCustomer": string,
  "includeInConversionsMetric": boolean,
  "clickThroughLookbackWindowDays": string,
  "viewThroughLookbackWindowDays": string,
  "phoneCallDurationSeconds": string,
  "appId": string
}
الحقول
resourceName

string

غير قابل للتغيير. اسم المورد لإجراء الإحالة الناجحة. وتكون أسماء موارد إجراءات الإحالات الناجحة على النحو التالي:

customers/{customerId}/conversionActions/{conversion_action_id}
status

enum (ConversionActionStatus)

حالة إجراء الإحالة الناجحة هذا لتجميع أحداث الإحالات الناجحة.
type

enum (ConversionActionType)

غير قابل للتغيير. نوع إجراء الإحالة الناجحة هذا
origin

enum (ConversionOrigin)

النتائج فقط. مصدر الإحالة الناجحة لإجراء الإحالة الناجحة هذا.
category

enum (ConversionActionCategory)

فئة الإحالات الناجحة التي تم الإبلاغ عنها لإجراء الإحالة الناجحة هذا.
valueSettings

object (ValueSettings)

الإعدادات ذات الصلة بقيمة أحداث الإحالة الناجحة المرتبطة بإجراء الإحالة الناجحة هذا.
countingType

enum (ConversionActionCountingType)

طريقة احتساب أحداث الإحالات الناجحة لإجراء الإحالة الناجحة.
attributionModelSettings

object (AttributionModelSettings)

الإعدادات ذات الصلة بنموذج تحديد المصدر لإجراء الإحالة الناجحة هذا
tagSnippets[]

object (TagSnippet)

النتائج فقط. المقتطفات المستخدمة لتتبُّع الإحالات الناجحة.
mobileAppVendor

enum (MobileAppVendor)

النتائج فقط. مورِّد التطبيق المتوافق مع الأجهزة الجوّالة لإجراء إحالة ناجحة للتطبيق.
firebaseSettings

object (FirebaseSettings)

النتائج فقط. إعدادات Firebase لأنواع الإحالات الناجحة في Firebase.
thirdPartyAppAnalyticsSettings

object (ThirdPartyAppAnalyticsSettings)

النتائج فقط. إعدادات تحليلات التطبيقات التابعة لجهات خارجية لأنواع الإحالات الناجحة التابعة لجهات خارجية.
googleAnalytics4Settings

object (GoogleAnalytics4Settings)

النتائج فقط. إعدادات "إحصاءات Google 4" لأنواع الإحالات الناجحة في "إحصاءات Google 4".
id

string (int64 format)

النتائج فقط. رقم تعريف إجراء الإحالة الناجحة.
name

string

اسم إجراء الإحالة الناجحة.

هذا الحقل مطلوب ويجب ألا يكون فارغًا عند إنشاء إجراءات إحالات ناجحة جديدة.
primaryForGoal

boolean

في حال كانت وحدة الإدخال التوجيهيPrimaryForGoal لأحد إجراءات الإحالة الناجحة غير صحيحة، لا يمكن تقديم عروض أسعار لإجراء الإحالة الناجحة في جميع الحملات بصرف النظر عن هدف الإحالة الناجحة للعميل أو هدف الإحالة الناجحة للحملة. وفي المقابل، لا تلتزم أهداف الإحالات الناجحة المخصّصة بـPrimaryForGoal، ولذلك إذا كانت إحدى الحملات تحتوي على هدف إحالة ناجحة مخصّص تم ضبطه باستخدام إجراء إحالة ناجحة أساسي ForGoal = إجراء إحالة ناجحة خاطئ، سيظل بإمكانك تقديم عروض أسعار لإجراء الإحالة الناجحة. في حال عدم تحديد قيمة السياسة، ستكون فئةPrimaryForGoal صحيحة تلقائيًا. في الإصدار 9، لا يمكن ضبط فئةPrimaryForGoal على "خطأ" إلا بعد الإنشاء من خلال عملية "التحديث" لعدم تعريفها بأنّها اختيارية.
ownerCustomer

string

النتائج فقط. اسم المورد للعميل مالك إجراء الإحالة الناجحة، أو قيمة فارغة إذا كان هذا إجراء إحالة ناجحة من تحديد النظام.
includeInConversionsMetric

boolean

ما إذا كان يجب تضمين إجراء الإحالة الناجحة هذا في مقياس "الإحالات الناجحة".
clickThroughLookbackWindowDays

string (int64 format)

الحد الأقصى لعدد الأيام التي يمكن أن تنقضي بين تفاعل (على سبيل المثال، نقرة) وحدث إحالة ناجحة.
viewThroughLookbackWindowDays

string (int64 format)

الحد الأقصى لعدد الأيام التي يمكن أن تنقضي بين مرة ظهور وإحالة ناجحة بدون تفاعل.
phoneCallDurationSeconds

string (int64 format)

مدة المكالمة الهاتفية بالثواني التي يجب بعدها الإبلاغ عن إحالة ناجحة لإجراء الإحالة الناجحة هذا.

يجب أن تتراوح القيمة بين 0 و10000 بشكلٍ شامل.
appId

string

رقم تعريف التطبيق لإجراء إحالة ناجحة للتطبيق.

ConversionActionStatus

الحالات المحتملة لإجراء إحالة ناجحة.

عمليات التعداد
UNSPECIFIED غير محدَّد.
UNKNOWN يُستخدم للقيمة المعروضة فقط. يعرض قيمة غير معروفة في هذا الإصدار.
ENABLED سيتم تسجيل الإحالات الناجحة.
REMOVED لن يتم تسجيل الإحالات الناجحة.
HIDDEN لن يتم تسجيل الإحالات الناجحة ولن يظهر إجراء الإحالة الناجحة في واجهة المستخدم.

ConversionActionType

الأنواع المحتملة من إجراء الإحالة الناجحة.

عمليات التعداد
UNSPECIFIED غير محدَّد.
UNKNOWN يُستخدم للقيمة المعروضة فقط. يعرض قيمة غير معروفة في هذا الإصدار.
AD_CALL الإحالات الناجحة التي تحدث عندما ينقر المستخدم على إضافة المكالمة في الإعلان.
CLICK_TO_CALL الإحالات الناجحة التي تحدث عندما ينقر مستخدم على جهاز جوّال على رقم هاتف.
GOOGLE_PLAY_DOWNLOAD الإحالات الناجحة التي تحدث عندما يُنزِّل المستخدِم تطبيقًا متوافقًا مع الأجهزة الجوّالة من "متجر Google Play".
GOOGLE_PLAY_IN_APP_PURCHASE الإحالات الناجحة التي تحدث عندما يُجري المستخدم عملية شراء في أحد التطبيقات من خلال فوترة Android.
UPLOAD_CALLS إحالات ناجحة المكالمات التي يتتبعها المعلن ويحمّلها.
UPLOAD_CLICKS الإحالات الناجحة التي يتتبعها المعلن ويتم تحميلها مع النقرات المنسوبة.
WEBPAGE الإحالات الناجحة التي تحدث على صفحة ويب.
WEBSITE_CALL الإحالات الناجحة التي تحدث عندما يتصل أحد المستخدِمين برقم هاتف تم إنشاؤه ديناميكيًا من الموقع الإلكتروني للمعلِن.
STORE_SALES_DIRECT_UPLOAD الإحالات الناجحة للمبيعات في المتاجر استنادًا إلى عمليات تحميل بيانات تاجر الطرف الأول أو التابع لطرف ثالث. يمكن فقط للعملاء المدرَجين في القائمة المسموح بها استخدام أنواع التحميل المباشر للمبيعات في المتاجر.
STORE_SALES الإحالات الناجحة للمبيعات في المتاجر استنادًا إلى عمليات تحميل بيانات تاجر الطرف الأول أو التابع لطرف ثالث و/أو من عمليات الشراء في المتجر باستخدام بطاقات من شبكات الدفع. يمكن فقط للعملاء المدرَجين في القائمة المسموح بها استخدام أنواع المبيعات في المتاجر. للقراءة فقط.
FIREBASE_ANDROID_FIRST_OPEN الإحالات الناجحة المفتوحة الأولى لتطبيقات Android التي يتم تتبُّعها من خلال Firebase.
FIREBASE_ANDROID_IN_APP_PURCHASE الإحالات الناجحة المتمثّلة بعملية شراء تطبيقات Android التي يتم تتبُّعها من خلال Firebase.
FIREBASE_ANDROID_CUSTOM يتم تتبُّع الإحالات الناجحة المخصّصة لتطبيقات Android من خلال Firebase.
FIREBASE_IOS_FIRST_OPEN الإحالات الناجحة المفتوحة لأول مرة لتطبيق iOS والتي يتم تتبعها من خلال Firebase.
FIREBASE_IOS_IN_APP_PURCHASE الإحالات الناجحة المتمثّلة بعملية شراء لتطبيقات iOS والتي يتم تتبُّعها من خلال Firebase.
FIREBASE_IOS_CUSTOM يتم تتبُّع الإحالات الناجحة المخصّصة لتطبيقات iOS من خلال Firebase.
THIRD_PARTY_APP_ANALYTICS_ANDROID_FIRST_OPEN يتم تتبُّع الإحالات الناجحة المفتوحة لأول مرة لتطبيقات Android من خلال إحصاءات التطبيقات التابعة لجهة خارجية.
THIRD_PARTY_APP_ANALYTICS_ANDROID_IN_APP_PURCHASE الإحالات الناجحة المتمثّلة بعملية شراء لتطبيقات Android التي يتم تتبُّعها من خلال إحصاءات التطبيقات التابعة لجهة خارجية.
THIRD_PARTY_APP_ANALYTICS_ANDROID_CUSTOM يتم تتبُّع الإحالات الناجحة المخصّصة لتطبيقات Android من خلال إحصاءات التطبيقات التابعة لجهة خارجية.
THIRD_PARTY_APP_ANALYTICS_IOS_FIRST_OPEN يتم تتبُّع الإحالات الناجحة المفتوحة لأول مرة لتطبيق iOS من خلال إحصاءات التطبيقات التابعة لجهة خارجية.
THIRD_PARTY_APP_ANALYTICS_IOS_IN_APP_PURCHASE الإحالات الناجحة المتمثّلة بعملية شراء لتطبيقات iOS والتي يتم تتبُّعها من خلال إحصاءات التطبيقات التابعة لجهة خارجية.
THIRD_PARTY_APP_ANALYTICS_IOS_CUSTOM يتم تتبُّع الإحالات الناجحة المخصّصة لتطبيقات iOS من خلال إحصاءات التطبيقات التابعة لجهة خارجية.
ANDROID_APP_PRE_REGISTRATION الإحالات الناجحة التي تحدث عندما يُسجِّل المستخدم مسبقًا تطبيقًا متوافقًا مع الأجهزة الجوّالة من "متجر Google Play". للقراءة فقط.
ANDROID_INSTALLS_ALL_OTHER_APPS الإحالات الناجحة التي تتتبّع جميع عمليات تنزيل Google Play التي لا يتم تتبّعها حسب نوع خاص بالتطبيق. للقراءة فقط.
FLOODLIGHT_ACTION نشاط Floodlight الذي يحتسب عدد المرات التي زار فيها المستخدِمون صفحة ويب معيّنة بعد مشاهدة أحد إعلانات المعلِن أو النقر عليه. للقراءة فقط.
FLOODLIGHT_TRANSACTION نشاط Floodlight الذي يتتبّع عدد المبيعات المحقّقة أو عدد السلع المشتراة. ويمكنه أيضًا تحديد القيمة الإجمالية لكل عملية بيع. للقراءة فقط.
GOOGLE_HOSTED الإحالات الناجحة التي تتتبّع الإجراءات المحلية من منتجات Google وخدماتها بعد التفاعل مع إعلان. للقراءة فقط.
LEAD_FORM_SUBMIT يتم الإبلاغ عن الإحالات الناجحة عندما يُرسل أحد المستخدِمين نموذج عملاء محتملين. للقراءة فقط.
SALESFORCE الإحالات الناجحة التي تأتي من Salesforce. للقراءة فقط.
SEARCH_ADS_360 الإحالات الناجحة المستورَدة من بيانات Floodlight في "إعلانات شبكة البحث 360". للقراءة فقط.
SMART_CAMPAIGN_AD_CLICKS_TO_CALL الإحالات الناجحة عبر الاتصال الهاتفي التي تحدث على إعلانات الحملة الذكية بدون إعداد ميزة تتبُّع المكالمات، وذلك باستخدام معايير مخصّصة للحملة الذكية للقراءة فقط.
SMART_CAMPAIGN_MAP_CLICKS_TO_CALL ينقر المستخدم على أحد عناصر الاتصال في "خرائط Google". الحملة الذكية فقط. للقراءة فقط.
SMART_CAMPAIGN_MAP_DIRECTIONS يطلب المستخدم الاتجاهات إلى موقع جغرافي للنشاط التجاري في "خرائط Google". الحملة الذكية فقط. للقراءة فقط.
SMART_CAMPAIGN_TRACKED_CALLS الإحالات الناجحة عبر الاتصال الهاتفي التي تحدث على إعلانات الحملة الذكية مع إعداد ميزة تتبُّع المكالمات، باستخدام معايير مخصّصة للحملة الذكية للقراءة فقط.
STORE_VISITS الإحالات الناجحة التي تحدث عندما يزور أحد المستخدمين متجر البيع بالتجزئة الخاص بأحد المعلنين. للقراءة فقط.
WEBPAGE_CODELESS الإحالات الناجحة التي يتم إنشاؤها من أحداث المواقع الإلكترونية (مثل عمليات إرسال النماذج أو عمليات تحميل الصفحات) والتي لا تستخدِم مقتطفات عن الأحداث مشفّرة بشكل فردي. للقراءة فقط.
UNIVERSAL_ANALYTICS_GOAL الإحالات الناجحة الواردة من أهداف Universal Analytics المرتبطة.
UNIVERSAL_ANALYTICS_TRANSACTION الإحالات الناجحة الواردة من معاملات Universal Analytics المرتبطة.
GOOGLE_ANALYTICS_4_CUSTOM الإحالات الناجحة الواردة من الإحالات الناجحة للأحداث المخصّصة في "إحصاءات Google 4" المرتبطة.
GOOGLE_ANALYTICS_4_PURCHASE الإحالات الناجحة الناتجة عن الإحالات الناجحة المتمثّلة بعملية شراء في "إحصاءات Google 4" المرتبطة

ValueSettings

الإعدادات ذات الصلة بقيمة أحداث الإحالة الناجحة المرتبطة بإجراء الإحالة الناجحة هذا.

تمثيل JSON 
{
  "defaultValue": number,
  "defaultCurrencyCode": string,
  "alwaysUseDefaultValue": boolean
}
الحقول
defaultValue

number

القيمة المطلوب استخدامها عند إرسال أحداث الإحالة الناجحة لإجراء الإحالة الناجحة هذا مع قيمة غير صالحة أو غير مسموح بها أو مفقودة، أو عند ضبط إجراء الإحالة الناجحة هذا لاستخدام القيمة التلقائية دائمًا.
defaultCurrencyCode

string

رمز العملة المطلوب استخدامه عندما يتم إرسال أحداث الإحالة الناجحة لإجراء الإحالة الناجحة هذا برمز عملة غير صالح أو مفقود، أو عند ضبط إجراء الإحالة الناجحة هذا لاستخدام القيمة التلقائية دائمًا.
alwaysUseDefaultValue

boolean

تتحكّم هذه السمة في ما إذا كان يتم استخدام القيمة التلقائية ورمز العملة التلقائي بدلاً من رمز القيمة والعملة المحدّدَين في أحداث الإحالة الناجحة لإجراء الإحالة الناجحة هذا.

ConversionActionCountingType

يشير إلى كيفية احتساب الإحالات الناجحة لهذا الإجراء. لمزيد من المعلومات، يُرجى الاطّلاع على https://support.google.com/google-ads/answer/3438531.

عمليات التعداد
UNSPECIFIED غير محدَّد.
UNKNOWN يُستخدم للقيمة المعروضة فقط. يعرض قيمة غير معروفة في هذا الإصدار.
ONE_PER_CLICK يمكنك احتساب إحالة ناجحة واحدة فقط لكل نقرة.
MANY_PER_CLICK حساب كل الإحالات الناجحة لكل نقرة.

AttributionModelSettings

الإعدادات ذات الصلة بنموذج تحديد المصدر لإجراء الإحالة الناجحة هذا

تمثيل JSON 
{
  "attributionModel": enum (AttributionModel),
  "dataDrivenModelStatus": enum (DataDrivenModelStatus)
}
الحقول
attributionModel

enum (AttributionModel)

نوع نموذج تحديد المصدر لإجراء الإحالة الناجحة هذا
dataDrivenModelStatus

enum (DataDrivenModelStatus)

النتائج فقط. حالة نموذج تحديد المصدر بالاستناد إلى البيانات لإجراء الإحالة الناجحة.

AttributionModel

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

عمليات التعداد
UNSPECIFIED غير محدَّد.
UNKNOWN يُستخدم للقيمة المعروضة فقط. يعرض قيمة غير معروفة في هذا الإصدار.
EXTERNAL تستخدم نموذج تحديد المصدر الخارجي.
GOOGLE_ADS_LAST_CLICK يَنسِب هذا النموذج كلّ نسبة المساهمة في إتمام الإحالة الناجحة إلى النقرة الأخيرة.
GOOGLE_SEARCH_ATTRIBUTION_FIRST_CLICK يَنسِب هذا النموذج كل نسبة المساهمة في إتمام الإحالة الناجحة إلى النقرة الأولى باستخدام نموذج تحديد المصدر على "بحث Google".
GOOGLE_SEARCH_ATTRIBUTION_LINEAR يَنسِب هذا النموذج مصدر الإحالة الناجحة بالتساوي على جميع نقراته باستخدام آلية تحديد المصدر على "بحث Google".
GOOGLE_SEARCH_ATTRIBUTION_TIME_DECAY يَنسِب هذا النموذج جزءًا أكبر من المساهمة في الإحالة الناجحة إلى نقراته الأحدث باستخدام إحالة "بحث Google" (نصف العمر هو أسبوع واحد).
GOOGLE_SEARCH_ATTRIBUTION_POSITION_BASED يَنسِب هذا النموذج% 40 من المساهمة في إتمام الإحالة الناجحة إلى نقراته الأولى والأخيرة. ويتم توزيع نسبة 20% المتبقية بالتساوي على جميع النقرات الأخرى. وهي تستخدم إحالة "بحث Google".
GOOGLE_SEARCH_ATTRIBUTION_DATA_DRIVEN نموذج مرن يستخدم تعلُّم الآلة لتحديد التوزيع المناسب لنسبة الإسهام بين النقرات باستخدام تحديد المصدر على "بحث Google"

DataDrivenModelStatus

تعداد حالات النماذج المستندة إلى البيانات.

عمليات التعداد
UNSPECIFIED غير محدَّد.
UNKNOWN يُستخدم للقيمة المعروضة فقط. يعرض قيمة غير معروفة في هذا الإصدار.
AVAILABLE النموذج المستند إلى البيانات متاح.
STALE النموذج المستند إلى البيانات قديم. لم يتم تعديلها لمدة 7 أيام على الأقل. لا يزال يتم استخدامه، ولكن ستنتهي صلاحيته إذا لم يتم تعديله لمدة 30 يومًا.
EXPIRED انتهت صلاحية النموذج المستند إلى البيانات. ولم يتم تعديلها لمدة 30 يومًا على الأقل ولا يمكن استخدامها. ويعود السبب في ذلك عادةً إلى عدم توفّر العدد المطلوب من الأحداث في آخر 30 يومًا.
NEVER_GENERATED لم يتم إنشاء نموذج يستند إلى البيانات مطلقًا. وغالبًا ما يحدث ذلك بسبب عدم توفّر العدد المطلوب من الأحداث مطلقًا في أي فترة من 30 يومًا.

FirebaseSettings

الإعدادات المرتبطة بإجراء إحالة ناجحة في Firebase

تمثيل JSON 
{
  "propertyId": string,
  "propertyName": string,
  "eventName": string,
  "projectId": string
}
الحقول
propertyId

string (int64 format)

النتائج فقط. رقم تعريف موقع "إحصاءات Google" للإحالة الناجحة.
propertyName

string

النتائج فقط. اسم موقع "إحصاءات Google" للإحالة الناجحة.
eventName

string

النتائج فقط. اسم حدث إحالة ناجحة على Firebase.
projectId

string

النتائج فقط. رقم تعريف مشروع Firebase للإحالة الناجحة.

ThirdPartyAppAnalyticsSettings

الإعدادات المرتبطة بإجراء إحالة ناجحة لإحصاءات التطبيقات التابعة لجهة خارجية.

تمثيل JSON 
{
  "providerName": string,
  "eventName": string
}
الحقول
providerName

string

النتائج فقط. اسم مقدم خدمة تحليلات التطبيقات التابع لجهة خارجية.
eventName

string

النتائج فقط. اسم الحدث لإحالة ناجحة في إحصاءات التطبيقات التابعة لجهة خارجية.

GoogleAnalytics4Settings

الإعدادات المرتبطة بإجراء إحالة ناجحة في "إحصاءات Google 4".

تمثيل JSON 
{
  "eventName": string,
  "propertyName": string,
  "propertyId": string
}
الحقول
eventName

string

النتائج فقط. اسم حدث "إحصاءات Google 4".
propertyName

string

النتائج فقط. اسم موقع "إحصاءات Google 4"
propertyId

string (int64 format)

النتائج فقط. رقم تعريف موقع "إحصاءات Google 4".