REST Resource: properties.dataStreams.sKAdNetworkConversionValueSchema

المورد: SKAdNetworkConversionValueSchema

إعدادات قيمة الإحالة الناجحة في SKAdNetwork لتدفق بيانات iOS

تمثيل JSON 
{
  "name": string,
  "postbackWindowOne": {
    object (PostbackWindow)
  },
  "postbackWindowTwo": {
    object (PostbackWindow)
  },
  "postbackWindowThree": {
    object (PostbackWindow)
  },
  "applyConversionValues": boolean
}
الحقول
name

string

المعرّف. اسم مورد المخطّط سيكون هذا المورد فرعيًا لتدفق بيانات iOS فقط، ويمكن أن يكون هناك مورد فرعي واحد على الأكثر من هذا النوع ضمن تدفق بيانات iOS. التنسيق: properties/{property}/dataStreams/{dataStream}/sKAdNetworkConversionValueSchema
postbackWindowOne

object (PostbackWindow)

الحقل مطلوب. إعدادات قيمة الإحالة الناجحة لفترة تسجيل الإحالات الناجحة الأولى تختلف هذه الإعدادات عن قيم فترة تسجيل الإحالات الناجحة الثانية والثالثة من حيث أنّها تحتوي على قيمة إحالة ناجحة "دقيقة" (قيمة رقمية).

يجب ضبط قيم الإحالات الناجحة لفترة تسجيل الإحالات الناجحة هذه. أما الفترات الأخرى، فهي اختيارية وقد تكتسب إعدادات هذه الفترة إذا لم يتم ضبطها أو تم إيقافها.
postbackWindowTwo

object (PostbackWindow)

إعدادات قيمة الإحالة الناجحة لفترة تسجيل الإحالات الناجحة الثانية

يجب ضبط هذا الحقل فقط إذا كانت هناك حاجة إلى تحديد قيم إحالات ناجحة مختلفة لفترة تسجيل الإحالات الناجحة هذه.

إذا تم ضبط enable_postback_window_settings على "خطأ" لفترة تسجيل الإحالات الناجحة هذه، سيتم استخدام القيم من postbackWindowOne.
postbackWindowThree

object (PostbackWindow)

إعدادات قيمة الإحالة الناجحة لفترة تسجيل الإحالات الناجحة الثالثة

يجب ضبط هذا الحقل فقط إذا اختار المستخدم تحديد قيم إحالات ناجحة مختلفة لفترة تسجيل الإحالات الناجحة هذه. يُسمح بضبط الفترة 3 بدون ضبط الفترة 2. في حال تم ضبط إعدادات الفترتين 1 و2 وتم ضبط enable_postback_window_settings لفترة تسجيل الإحالات الناجحة هذه على "خطأ"، سيكتسب المخطّط الإعدادات من postbackWindowTwo.
applyConversionValues

boolean

في حال تفعيل هذا الخيار، سيضبط حزمة تطوير البرامج (SDK) في "إحصاءات Google" قيم الإحالات الناجحة باستخدام تعريف المخطّط هذا، وسيتم تصدير المخطّط إلى أيّ حسابات على "إعلانات Google" مرتبطة بهذا الموقع. في حال إيقاف هذا الخيار، لن تضبط حزمة تطوير البرامج (SDK) في "إحصاءات Google" قيم الإحالات الناجحة تلقائيًا، ولن يتم أيضًا تصدير المخطّط إلى "إعلانات Google".

PostbackWindow

إعدادات فترة تسجيل الإحالات الناجحة في SKAdNetwork

تمثيل JSON 
{
  "conversionValues": [
    {
      object (ConversionValues)
    }
  ],
  "postbackWindowSettingsEnabled": boolean
}
الحقول
conversionValues[]

object (ConversionValues)

سيتم استخدام ترتيب الحقل المتكرّر لتحديد أولوية إعدادات قيمة الإحالة الناجحة. تكون الأولوية أعلى للإدخالات التي تحمل فهرسًا أقل. سيتم اختيار أول إعداد لقيمة الإحالة الناجحة يتم تقييمه على أنّه "صحيح". يجب أن يحتوي على إدخال واحد على الأقل إذا تم ضبط enable_postback_window_settings على "صحيح". يمكن أن يحتوي على 128 إدخالاً كحد أقصى.
postbackWindowSettingsEnabled

boolean

إذا كانت enable_postback_window_settings مضبوطة على "صحيح"، يجب ملء conversionValues وسيتم استخدامها لتحديد متى وكيفية ضبط قيمة الإحالة الناجحة على جهاز العميل وتصدير المخطّط إلى حسابات "إعلانات Google" المرتبطة. إذا كانت مضبوطة على "خطأ"، لن يتم استخدام الإعدادات، ولكن سيتم الاحتفاظ بها لاستخدامها في المستقبل. يجب أن تكون هذه القيمة "صحيح" دائمًا بالنسبة إلى postbackWindowOne.

ConversionValues

إعدادات قيمة الإحالة الناجحة لفترة تسجيل الإحالات الناجحة في مخطّط قيمة الإحالة الناجحة في SKAdNetwork

تمثيل JSON 
{
  "displayName": string,
  "coarseValue": enum (CoarseValue),
  "eventMappings": [
    {
      object (EventMapping)
    }
  ],
  "lockEnabled": boolean,
  "fineValue": integer
}
الحقول
displayName

string

الاسم المعروض لقيمة الإحالة الناجحة في SKAdNetwork الحد الأقصى لطول الاسم المعروض المسموح به هو 50 وحدة رمز UTF-16.
coarseValue

enum (CoarseValue)

الحقل مطلوب. قيمة إحالة ناجحة عامّة

لا يُضمَن أن تكون هذه القيمة فريدة.
eventMappings[]

object (EventMapping)

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

boolean

إذا كانت القيمة "صحيح"، يجب أن تقفل حزمة تطوير البرامج (SDK) على قيمة الإحالة الناجحة هذه لفترة تسجيل الإحالات الناجحة الحالية.
fineValue

integer

قيمة الإحالة الناجحة الدقيقة لا ينطبق ذلك إلا على فترة تسجيل الإحالات الناجحة الأولى. القيم الصالحة هي [0,63]، بما في ذلك كلا القيمتَين. يجب ضبط هذه القيمة لفترة تسجيل الإحالات الناجحة الأولى، ويجب عدم ضبطها لفترتَي تسجيل الإحالات الناجحة الثانية والثالثة. لا يُضمَن أن تكون هذه القيمة فريدة.

إذا تم إعادة استخدام إعدادات فترة تسجيل الإحالات الناجحة الأولى لفترتَي تسجيل الإحالات الناجحة الثانية أو الثالثة، لن يكون لهذا الحقل أي تأثير.

CoarseValue

قيمة الإحالة الناجحة العامّة التي يتم ضبطها في طلب updatePostbackConversionValue في حزمة تطوير البرامج (SDK) عند استيفاء شروط ConversionValues.event_mappings لمزيد من المعلومات، يُرجى الاطّلاع على SKAdNetwork.CoarseConversionValue.

عمليات التعداد
COARSE_VALUE_UNSPECIFIED لم يتم تحديد قيمة عامّة.
COARSE_VALUE_LOW قيمة عامّة منخفضة
COARSE_VALUE_MEDIUM قيمة عامّة متوسّطة
COARSE_VALUE_HIGH قيمة عامّة مرتفعة

EventMapping

شروط إعدادات الحدث لمطابقة حدث

تمثيل JSON 
{
  "eventName": string,
  "minEventCount": string,
  "maxEventCount": string,
  "minEventValue": number,
  "maxEventValue": number
}
الحقول
eventName

string

الحقل مطلوب. اسم حدث "إحصاءات Google" يجب ضبط هذا الحقل دائمًا. الحد الأقصى لطول الاسم المعروض المسموح به هو 40 وحدة رمز UTF-16.
minEventCount

string (int64 format)

يجب ضبط قيمة واحدة على الأقل من القيم الأربع التالية للحد الأدنى/الأقصى. سيتم ربط القيم التي تم ضبطها باستخدام "و" لتأهيل حدث. الحد الأدنى لعدد مرات وقوع الحدث إذا لم يتم ضبط هذا الحقل، لن يتم التحقّق من الحد الأدنى لعدد مرات وقوع الحدث.
maxEventCount

string (int64 format)

الحد الأقصى لعدد مرات وقوع الحدث إذا لم يتم ضبط هذا الحقل، لن يتم التحقّق من الحد الأقصى لعدد مرات وقوع الحدث.
minEventValue

number

الحد الأدنى للإيرادات الناتجة عن الحدث سيتم تحديد عملة الإيرادات على مستوى الموقع. إذا لم يتم ضبط هذا الحقل، لن يتم التحقّق من الحد الأدنى لقيمة الحدث.
maxEventValue

number

الحد الأقصى للإيرادات الناتجة عن الحدث سيتم تحديد عملة الإيرادات على مستوى الموقع. إذا لم يتم ضبط هذا الحقل، لن يتم التحقّق من الحد الأقصى لقيمة الحدث.

الطُرق

create

 إنشاء SKAdNetworkConversionValueSchema

delete

 حذف SKAdNetworkConversionValueSchema المستهدَف

get

 البحث عن SKAdNetworkConversionValueSchema واحد

list

 إدراج SKAdNetworkConversionValueSchema في تدفق بيانات

patch

 تعديل SKAdNetworkConversionValueSchema