REST Resource: properties.dataStreams.sKAdNetworkConversionValueSchema

แหล่งข้อมูล: SKAdNetworkConversionValueSchema

สคีมามูลค่า Conversion ของ SKAdNetwork ของสตรีม iOS

การแสดง JSON 
{
  "name": string,
  "postbackWindowOne": {
    object (PostbackWindow)
  },
  "postbackWindowTwo": {
    object (PostbackWindow)
  },
  "postbackWindowThree": {
    object (PostbackWindow)
  },
  "applyConversionValues": boolean
}
ช่อง
name

string

เอาต์พุตเท่านั้น ชื่อทรัพยากรของสคีมา โดยการตั้งค่าดังกล่าวจะเป็นรายการย่อยของสตรีม iOS เท่านั้น และจะมีรายการย่อยอยู่ใต้สตรีม iOS ได้ไม่เกิน 1 รายการ รูปแบบ: พร็อพเพอร์ตี้/{property}/dataStreams/{dataStream}/sKAdNetworkConversionValueSchema
postbackWindowOne

object (PostbackWindow)

ต้องระบุ การตั้งค่ามูลค่า Conversion สําหรับกรอบเวลาการรายงานผล Conversion แรก ซึ่งแตกต่างจากค่าของกรอบเวลาการรายงานผล Conversion ที่ 2 และ 3 ตรงที่มูลค่า Conversion แบบละเอียด (ค่าตัวเลข)

ต้องกําหนดมูลค่า Conversion สําหรับกรอบเวลาการรายงานผล Conversion นี้ หน้าต่างอื่นๆ เป็นตัวเลือกที่ไม่บังคับและอาจรับช่วงการตั้งค่าของหน้าต่างนี้ได้หากไม่ได้ตั้งค่าหรือปิดใช้งาน
postbackWindowTwo

object (PostbackWindow)

การตั้งค่ามูลค่า Conversion สําหรับกรอบเวลาการรายงานผล Conversion ที่ 2

คุณควรกําหนดค่าช่องนี้เฉพาะในกรณีที่มีความจำเป็นต้องกําหนดมูลค่า Conversion ที่แตกต่างกันสําหรับกรอบเวลาการรายงานผล Conversion นี้

หากตั้งค่าenable_postback_window_settings เป็น "เท็จ" สำหรับกรอบเวลาการรายงานผล Conversion นี้ ระบบจะใช้ค่าจาก PostbackWindowOne
postbackWindowThree

object (PostbackWindow)

การตั้งค่ามูลค่า Conversion สำหรับกรอบเวลาการรายงานผล Conversion ครั้งที่ 3

ควรตั้งค่าช่องนี้เฉพาะในกรณีที่ผู้ใช้เลือกกำหนดมูลค่า Conversion ที่แตกต่างกันสำหรับกรอบเวลาการรายงานผล Conversion นี้ อนุญาตให้กำหนดค่าหน้าต่าง 3 โดยไม่ต้องตั้งค่าหน้าต่าง 2 ในกรณีที่มีการตั้งค่าหน้าต่าง 1 และ 2 และตั้งค่าราคาเสนอ enabled_postback_window_settings สำหรับกรอบเวลาการรายงานผล Conversion นี้เป็นเท็จ สคีมาจะรับช่วงการตั้งค่าจาก PostbackWindowSecond
applyConversionValues

boolean

หากเปิดใช้ GA SDK จะกำหนดมูลค่า Conversion โดยใช้คำจำกัดความของสคีมานี้ และสคีมาจะส่งออกไปยังบัญชี Google Ads ที่ลิงก์กับพร็อพเพอร์ตี้นี้ หากปิดใช้ GA SDK จะไม่กำหนดมูลค่า Conversion โดยอัตโนมัติ และสคีมาจะไม่ส่งออกไปยัง Google Ads

PostbackWindow

การตั้งค่าสำหรับกรอบเวลาการรายงานผล Conversion ของ SKAdNetwork

การแสดง JSON 
{
  "conversionValues": [
    {
      object (ConversionValues)
    }
  ],
  "postbackWindowSettingsEnabled": boolean
}
ช่อง
conversionValues[]

object (ConversionValues)

ระบบจะใช้การจัดลำดับช่องที่ซ้ำเพื่อจัดลําดับความสําคัญของการตั้งค่ามูลค่า Conversion รายการที่ได้รับการจัดทำดัชนีต่ำกว่าจะมีลำดับความสำคัญสูงกว่า ระบบจะเลือกการตั้งค่ามูลค่า Conversion แรกที่ประเมินได้ว่าเป็น "จริง" ต้องมีอย่างน้อย 1 รายการหากตั้งค่า enabled_postback_window_settings เป็น "จริง" ระบุได้สูงสุด 128 รายการ
postbackWindowSettingsEnabled

boolean

หากenable_postback_window_settings เป็นจริง คุณจะต้องป้อนข้อมูลมูลค่า Conversion และจะใช้ในการกำหนดเวลาและวิธีตั้งค่ามูลค่า Conversion ในอุปกรณ์ลูกค้าและส่งออกสคีมาไปยังบัญชีโฆษณาที่ลิงก์ หากเป็น "เท็จ" ระบบจะไม่ใช้การตั้งค่าดังกล่าว แต่จะยังเก็บเอาไว้เผื่อในกรณีที่มีการใช้ในอนาคต ต้องเป็น true สำหรับ postbackWindowOne เสมอ

ConversionValues

การตั้งค่ามูลค่า Conversion ของกรอบเวลาการรายงานผล Conversion สําหรับสคีมามูลค่า Conversion ของ SKAdNetwork

การแสดง JSON 
{
  "displayName": string,
  "coarseValue": enum (CoarseValue),
  "eventMappings": [
    {
      object (EventMapping)
    }
  ],
  "lockEnabled": boolean,
  "fineValue": integer
}
ช่อง
displayName

string

ชื่อที่แสดงของมูลค่า Conversion ของ SKAdNetwork ความยาวชื่อที่แสดงสูงสุดที่อนุญาตคือหน่วยโค้ด UTF-16
coarseValue

enum (CoarseValue)

ต้องระบุ มูลค่า Conversion แบบละเอียด

เราไม่รับประกันว่าค่านี้จะไม่ซ้ำกัน
eventMappings[]

object (EventMapping)

มูลค่า Conversion นี้จะต้องเป็นไปตามเงื่อนไขเหตุการณ์ เงื่อนไขในรายการนี้จะใช้ AND ร่วมกัน ต้องมีอย่างน้อย 1 รายการและสูงสุด 3 รายการ หากเปิดใช้กรอบเวลาการรายงานผล Conversion
lockEnabled

boolean

หากเป็นจริง SDK ควรล็อกไว้ที่มูลค่า Conversion นี้สำหรับกรอบเวลาการรายงานผล Conversion ปัจจุบัน
fineValue

integer

มูลค่า Conversion แบบละเอียด กรณีนี้มีผลเฉพาะกับกรอบเวลาการรายงานผล Conversion แรกเท่านั้น ค่าที่ถูกต้องคือ [0,63] ทั้ง 2 ค่า ต้องตั้งค่าสำหรับกรอบเวลาการรายงานผล Conversion 1 และต้องไม่ตั้งค่ากรอบเวลาการรายงานผล Conversion 2 และ 3 เราไม่รับประกันว่าค่านี้จะไม่ซ้ำกัน

หากใช้การกำหนดค่าสำหรับกรอบเวลาการรายงานผล Conversion แรกซ้ำสำหรับกรอบเวลาการรายงานผล Conversion ครั้งที่ 2 หรือ 3 ช่องนี้จะไม่มีผล

CoarseValue

มูลค่า Conversion คร่าวๆ ที่กําหนดในการเรียกใช้ updatedPostbackConversionValue SDK เมื่อเป็นไปตามเงื่อนไข ConversionValues.event_mappings ดูข้อมูลเพิ่มเติมได้ที่ SKAdNetwork.CoarseConversionValue

Enum
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

ต้องระบุ ชื่อเหตุการณ์ GA4 โดยจะต้องตั้งค่าเสมอ ความยาวชื่อที่แสดงสูงสุดที่อนุญาตคือหน่วยโค้ด UTF-16
minEventCount

string (int64 format)

ต้องตั้งค่าอย่างน้อย 1 ใน 4 ค่าต่อไปนี้ ค่าที่ตั้งไว้จะถูกรวมเข้าด้วยกันเป็น AND เพื่อเข้าเกณฑ์เหตุการณ์ จำนวนครั้งขั้นต่ำที่เกิดเหตุการณ์ หากไม่ได้ตั้งค่า ระบบจะไม่ตรวจสอบจำนวนเหตุการณ์ขั้นต่ำ
maxEventCount

string (int64 format)

จำนวนครั้งสูงสุดที่เกิดเหตุการณ์ หากไม่ได้ตั้งค่า ระบบจะไม่ตรวจสอบจำนวนเหตุการณ์สูงสุด
minEventValue

number

รายได้ขั้นต่ำที่สร้างขึ้นเนื่องจากเหตุการณ์ สกุลเงินของรายได้จะกำหนดที่ระดับพร็อพเพอร์ตี้ หากไม่ได้ตั้งค่า ระบบจะไม่เลือกมูลค่าเหตุการณ์ขั้นต่ำ
maxEventValue

number

รายได้สูงสุดที่สร้างขึ้นเนื่องจากเหตุการณ์ สกุลเงินของรายได้จะกำหนดที่ระดับพร็อพเพอร์ตี้ หากไม่ได้ตั้งค่า ระบบจะไม่เลือกมูลค่าเหตุการณ์สูงสุด

วิธีการ

create

 สร้าง SKAdNetworkConversionValueSchema

delete

 ลบ SKAdNetworkConversionValueSchema เป้าหมาย

get

 ค้นหา SKAdNetworkConversionValueSchema รายการเดียว

list

 แสดงรายการ SKAdNetworkConversionValueSchema ในสตรีม

patch

 อัปเดต SKAdNetworkConversionValueSchema