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 เท่านั้น และสตรีมย่อยดังกล่าวจะมีได้สูงสุด 1 รายการในสตรีม iOS รูปแบบ: properties/{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 และตั้งค่า enable_postback_window_settings สําหรับกรอบเวลาการรายงานผล Conversion นี้เป็นเท็จ สคีมาจะรับค่าการตั้งค่าจาก postbackWindowTwo
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 รายการหากตั้งค่า enable_postback_window_settings เป็น "จริง" โดยจะมีรายการได้สูงสุด 128 รายการ
postbackWindowSettingsEnabled

boolean

หาก enable_postback_window_settings เป็น True จะต้องป้อนข้อมูล conversionValues และใช้เพื่อกําหนดเวลาและวิธีกําหนดมูลค่า Conversion ในอุปกรณ์ไคลเอ็นต์และส่งออกสคีมาไปยังบัญชี Google Ads ที่ลิงก์ หากเป็นเท็จ ระบบจะไม่ใช้การตั้งค่า แต่ระบบจะเก็บการตั้งค่าไว้เผื่อว่าอาจต้องใช้ในอนาคต ค่านี้ต้องเป็นจริงเสมอสําหรับ postbackWindowOne

ConversionValues

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

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

string

ชื่อที่แสดงของมูลค่า Conversion ของ SKAdNetwork ชื่อที่แสดงมีความยาวสูงสุดได้ 50 หน่วยโค้ด 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 แบบหยาบที่ตั้งค่าไว้ในการเรียก SDK updatePostbackConversionValue เมื่อเป็นไปตามเงื่อนไข 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

ต้องระบุ ชื่อเหตุการณ์ Google Analytics ต้องตั้งค่าเสมอ ชื่อที่แสดงมีความยาวสูงสุดที่อนุญาตคือ 40 หน่วยโค้ด 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