REST Resource: properties.dataStreams.sKAdNetworkConversionValueSchema

المرجع: مخطط قيمة الإحالة الناجحة على SKAdNetwork

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

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

string

النتائج فقط. اسم مورد المخطط. وهذا سيكون ثانويًا من مصدر بيانات iOS فقط، ويمكن أن يكون هناك واحد على الأكثر من هذا النوع ضمن مصدر بيانات iOS. التنسيق: خصائص/{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 صحيحة، يجب تعبئة قيم الإحالة الناجحة، وسيتم استخدامها لتحديد وقت وطريقة ضبط قيمة الإحالة الناجحة على جهاز عميل وتصدير المخطط إلى حسابات "إعلانات 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 4" ويجب ضبطها دائمًا. الحد الأقصى المسموح به لطول الاسم المعروض هو 40 وحدة رمز UTF-16.

minEventCount

string (int64 format)

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

maxEventCount

string (int64 format)

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

minEventValue

number

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

maxEventValue

number

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

الطُرق

create

تُنشئ مخطط قيمة الإحالة الناجحة على SKAdNetwork

delete

يحذف مخطط قيمة SKAdNetwork ConversionValueSchema المستهدَف.

get

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

list

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

patch

تعمل على تعديل مخطط قيمة الإحالة الناجحة على SKAdNetwork