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. Format: 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 لهذه النافذة على 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

إذا كانت القيمة صحيحة، من المفترض أن تضبط حزمة تطوير البرامج هذه قيمة الإحالة الناجحة هذه لفترة تسجيل الإحالات الناجحة الحالية.
fineValue

integer

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

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

CoarseValue

قيمة الإحالة الناجحة التقريبية التي تمّ ضبطها في طلب حزمة تطوير البرامج 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

 البحث عن مخطّط قيمة إحالة ناجحة واحد في SKAdNetwork

list

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

patch

 تعديل SKAdNetworkConversionValueSchema