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

إذا كانت وحدة البت BasicForGoal لأحد إجراءات الإحالة الناجحة غير صحيحة، لا يمكن تقديم عروض أسعار لإجراء الإحالة الناجحة في جميع الحملات بغض النظر عن هدف الإحالة الناجحة للعميل أو هدف الإحالة الناجحة للحملة. وفي المقابل، لا تراعي أهداف الإحالات الناجحة المخصّصة PrimaryForGoal، وبالتالي إذا كانت الحملة تحتوي على هدف إحالة ناجحة مخصّص تم إعداده باستخدام PrimaryForGoal = إجراء إحالة ناجحة خاطئ، سيظل بالإمكان تقديم عروض أسعار لإجراء الإحالة الناجحة هذا. بشكلٍ تلقائي، ستكونPrimaryForGoal صحيحة في حال عدم ضبطها. في الإصدار V9، لا يمكن ضبط baseForGoal على "خطأ" إلا بعد الإنشاء من خلال عملية "تعديل" لأنّه لم يتم تعريفها على أنّها اختيارية.
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".