REST Resource: properties.dataStreams.sKAdNetworkConversionValueSchema

المرجع: SKAdNetwork ConversionValueSchema

مخطّط قيمة الإحالة الناجحة في SKAdNetwork لمصدر بيانات على نظام التشغيل iOS.

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

string

النتائج فقط. اسم مورد المخطط. ستكون هذه الخطوة فرعية من مصدر بيانات iOS فقط، ويمكن أن يكون هناك عنصر فرعي واحد على الأكثر ضمن مصدر بيانات iOS. التنسيق: domains/{property}/dataStreams/{dataStream}/sKAdNetwork ConversionValueSchema
postbackWindowOne

object (PostbackWindow)

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

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

object (PostbackWindow)

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

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

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

object (PostbackWindow)

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

يجب ضبط هذا الحقل فقط إذا اختار المستخدم تحديد قيم إحالات ناجحة مختلفة لفترة تسجيل الإحالات الناجحة هذه. يُسمح بضبط النافذة 3 بدون ضبط النافذة 2. في حال النافذة، 1 تمّ ضبط إعدادَين وضبط Enable_postback_window_settings لفترة الإبلاغ عن الإحالات الناجحة هذه على "خطأ"، سيكتسب المخطّط الإعدادات من postbackWindow Two.
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 هي قيمة صحيحة، يجب تعبئة قيم الإحالات الناجحة واستخدامها لتحديد وقت وطريقة ضبط قيمة الإحالة الناجحة على جهاز عميل، وتصدير المخطط إلى حسابات "إعلانات 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)

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

boolean

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

integer

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

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

CoarseValue

قيمة الإحالة الناجحة التقريبية التي يتم ضبطها في طلب حزمة تطوير البرامج (SDK) UpdatePostback ConversionValue عند استيفاء شروط 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 4" يجب ضبطها دائمًا. الحد الأقصى المسموح به لطول الاسم المعروض هو 40 وحدة رمز UTF-16.
minEventCount

string (int64 format)

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

string (int64 format)

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

number

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

number

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

الطُرق

create

 تُنشئ SKAdNetwork ConversionValueSchema.

delete

 يؤدي هذا الإجراء إلى حذف SKAdNetwork ConversionValueSchema المستهدف.

get

 البحث عن SKAdNetwork ConversionValueSchema واحد

list

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

patch

 يعدِّل SKAdNetwork ConversionValueSchema.