- المورد: SKAdNetworkConversionValueSchema
- PostbackWindow
- ConversionValues
- CoarseValue
- EventMapping
- الطُرق
المرجع: مخطط قيمة الإحالة الناجحة على SKAdNetwork
مخطّط قيمة الإحالة الناجحة في SKAdNetwork لمصدر بيانات نظام التشغيل iOS
تمثيل JSON |
---|
{ "name": string, "postbackWindowOne": { object ( |
الحقول | |
---|---|
name |
النتائج فقط. اسم مورد المخطط. وهذا سيكون ثانويًا من مصدر بيانات iOS فقط، ويمكن أن يكون هناك واحد على الأكثر من هذا النوع ضمن مصدر بيانات iOS. التنسيق: خصائص/{property}/dataStreams/{dataStream}/sKAdNetworkConversionValueSchema |
postbackWindowOne |
مطلوبة. إعدادات قيمة الإحالة الناجحة لأول فترة للإبلاغ عن الإحالات الناجحة. تختلف هذه القيم عن قيم الفترة الثانية والثالثة للإبلاغ عن الإحالات الناجحة من حيث أنّها تحتوي على قيمة إحالة ناجحة متقنة (قيمة رقمية). يجب ضبط قيم الإحالات الناجحة لفترة الإبلاغ عن الإحالات الناجحة هذه. أمّا النوافذ الأخرى، فهي اختيارية، وقد تكتسب إعدادات هذه النافذة في حال لم يتم ضبطها أو تم إيقافها. |
postbackWindowTwo |
إعدادات قيمة الإحالة الناجحة لفترة الإبلاغ عن الإحالات الناجحة الثانية. يجب ضبط هذا الحقل فقط عند الحاجة إلى تحديد قيم إحالات ناجحة مختلفة لفترة الإبلاغ عن الإحالات الناجحة هذه. في حال ضبطenable_postback_window_settings على "خطأ" لفترة الإبلاغ عن الإحالات الناجحة هذه، سيتم استخدام القيم من postbackWindowOne. |
postbackWindowThree |
إعدادات قيمة الإحالة الناجحة لفترة الإبلاغ عن الإحالات الناجحة الثالثة. يجب ضبط هذا الحقل فقط إذا اختار المستخدم تحديد قيم إحالات ناجحة مختلفة لفترة الإبلاغ عن الإحالات الناجحة هذه. يُسمح بضبط النافذة 3 بدون إعداد النافذة 2. في حال ضبط إعدادات النافذة 1 و2 وضبط المعلمةenable_postback_window_settings لفترة الإبلاغ عن الإحالات الناجحة هذه على "خطأ"، سيكتسب المخطّط الإعدادات من postbackWindowTwo. |
applyConversionValues |
وفي حال التفعيل، ستضبط حزمة تطوير البرامج (SDK) لخدمة "إحصاءات Google" قيم الإحالات الناجحة باستخدام تعريف المخطط هذا، وسيتم تصدير المخطط إلى أي حسابات على "إعلانات Google" مرتبطة بهذا الموقع. وفي حال إيقافها، لن تضبط حزمة تطوير البرامج (SDK) لخدمة "إحصاءات Google" قيم الإحالات الناجحة تلقائيًا، ولن يتم تصدير المخطط إلى "إعلانات Google". |
PostbackWindow
إعدادات فترة الإبلاغ عن الإحالات الناجحة في SKAdNetwork للإحالات الناجحة
تمثيل JSON |
---|
{
"conversionValues": [
{
object ( |
الحقول | |
---|---|
conversionValues[] |
وسيتم استخدام ترتيب الحقل المتكرّر لتحديد الأولوية لإعدادات قيمة الإحالة الناجحة. وتُعطى الأولوية للإدخالات المفهرَسة الأقل. وسيتم اختيار إعداد قيمة الإحالة الناجحة الأول الذي يتم تقييمه على "صحيح". يجب أن يحتوي على إدخال واحد على الأقل في حال ضبطenable_postback_window_settings على "صحيح". يمكن أن يحتوي على 128 إدخالاً كحدّ أقصى. |
postbackWindowSettingsEnabled |
إذا كانت قيمةenable_postback_window_settings صحيحة، يجب تعبئة قيم الإحالة الناجحة، وسيتم استخدامها لتحديد وقت وطريقة ضبط قيمة الإحالة الناجحة على جهاز عميل وتصدير المخطط إلى حسابات "إعلانات Google" المرتبطة. وفي حال اختيار القيمة "خطأ"، لا يتم استخدام الإعدادات، ولكن يتم الاحتفاظ بها في حال إمكانية استخدامها في المستقبل. يجب أن يكون هذا صحيحًا دائمًا بالنسبة إلى postbackWindowOne. |
ConversionValues
إعدادات قيمة الإحالة الناجحة لفترة الإبلاغ عن الإحالات الناجحة لمخطط قيمة الإحالة الناجحة في SKAdNetwork
تمثيل JSON |
---|
{ "displayName": string, "coarseValue": enum ( |
الحقول | |
---|---|
displayName |
الاسم المعروض لقيمة الإحالة الناجحة على SKAdNetwork. الحد الأقصى المسموح به لطول الاسم المعروض هو 50 وحدة رمز UTF-16. |
coarseValue |
مطلوبة. قيمة إحالة ناجحة دقيقة تقريبية. لا يمكن ضمان أن تكون هذه القيمة فريدة. |
eventMappings[] |
شروط الحدث التي يجب استيفاؤها حتى يتم تحقيق قيمة الإحالة الناجحة هذه. يتم ربط الشروط في هذه القائمة معًا. ويجب أن يحتوي على إدخال واحد كحد أدنى و3 إدخالات كحد أقصى، في حال تفعيل فترة الإبلاغ عن الإحالات الناجحة. |
lockEnabled |
في حال اختيار القيمة الصحيحة، من المفترض أن يتم قفل حزمة تطوير البرامج (SDK) بقيمة الإحالة الناجحة هذه لفترة الإبلاغ عن الإحالات الناجحة الحالية. |
fineValue |
قيمة الإحالة الناجحة الدقيقة. لا ينطبق ذلك إلا على فترة الإبلاغ عن الإحالات الناجحة الأولى. وقيمته الصالحة هي [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 |
مطلوبة. اسم حدث "إحصاءات Google 4" ويجب ضبطها دائمًا. الحد الأقصى المسموح به لطول الاسم المعروض هو 40 وحدة رمز UTF-16. |
minEventCount |
يجب ضبط قيمة واحدة على الأقل من قيم الحد الأدنى/الأقصى الأربع التالية. وسيتم ربط مجموعة القيم باستخدام AND معًا لتأهيل حدث. تمثّل هذه السمة الحد الأدنى لعدد مرات وقوع الحدث. وفي حال تركها بدون ضبط، لن يتم التحقّق من الحد الأدنى لعدد الأحداث. |
maxEventCount |
تمثّل هذه السمة الحد الأقصى لعدد مرات وقوع الحدث. وفي حال تم ترك السياسة بدون ضبط، لن يتم التحقّق من الحد الأقصى لعدد الأحداث. |
minEventValue |
تمثّل هذه السمة الحد الأدنى للأرباح التي تم تحقيقها بسبب الحدث. سيتم تحديد عملة الأرباح على مستوى الموقع. وفي حال ترك هذه السياسة بدون ضبط، لن يتم التحقّق من الحد الأدنى لقيمة الحدث. |
maxEventValue |
الحدّ الأقصى للأرباح التي تمّ تحقيقها بسبب الحدث. سيتم تحديد عملة الأرباح على مستوى الموقع. وفي حال ترك هذه السياسة بدون ضبط، لن يتم التحقّق من الحد الأقصى لقيمة الحدث. |
الطُرق |
|
---|---|
|
تُنشئ مخطط قيمة الإحالة الناجحة على SKAdNetwork |
|
يحذف مخطط قيمة SKAdNetwork ConversionValueSchema المستهدَف. |
|
البحث عن مخطط قيمة الإحالة الناجحة على SKAdNetwork واحد. |
|
يسرد SKAdNetworkConversionValueSchema في مصدر بيانات. |
|
تعمل على تعديل مخطط قيمة الإحالة الناجحة على SKAdNetwork |