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 على false لهذه الفترة المسموح بها لتسجيل الإحالات الناجحة، سيتم استخدام القيم من postbackWindowOne.
postbackWindowThree

object (PostbackWindow)

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

يجب عدم ضبط هذا الحقل إلا إذا اختار المستخدِم تحديد قيم إحالات ناجحة مختلفة لهذه الفترة الزمنية للإبلاغ عن الإحالات الناجحة. يُسمح بضبط النافذة 3 بدون ضبط النافذة 2. في حال ضبط إعدادات النافذتَين 1 و2 وضبط enable_postback_window_settings لهذه النافذة على false، سيرث المخطّط الإعدادات من postbackWindowTwo.
applyConversionValues

boolean

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

PostbackWindow

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

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

object (ConversionValues)

سيتم استخدام ترتيب الحقل المتكرّر لمنح الأولوية لإعدادات قيمة الإحالة الناجحة. يتم منح الأولوية الأعلى للإدخالات التي تمّت فهرستها مؤخرًا. سيتم اختيار أول إعداد لقيمة الإحالة الناجحة الذي يُقيّم على أنّه صحيح. يجب أن يحتوي على إدخال واحد على الأقل إذا تم ضبط enable_postback_window_settings على true. يمكن أن يحتوي على 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] مع تضمين القيمتَين. يجب ضبطه لفترة الإبلاغ عن الإحالة الناجحة 1، ويجب عدم ضبطه لفترتي الإبلاغ عن الإحالة الناجحة 2 و3. لا يمكن ضمان أن تكون هذه القيمة فريدة.

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

CoarseValue

قيمة الإحالة الناجحة التقريبية التي تمّ ضبطها في طلب حزمة تطوير البرامج (SDK) updatePostbackConversionValue عند استيفاء شروط 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)

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

string (int64 format)

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

number

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

number

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

الطُرق

create

 تُنشئ SKAdNetworkConversionValueSchema.

delete

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

get

 تبحث عن SKAdNetworkConversionValueSchema واحد.

list

 يُدرج SKAdNetworkConversionValueSchema في مصدر بيانات.

patch

 تعديل SKAdNetworkConversionValueSchema