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 เป็น false สำหรับกรอบเวลาการรายงานผล Conversion นี้ ระบบจะใช้ค่าจาก postbackWindowOne
postbackWindowThree

object (PostbackWindow)

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

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

boolean

หากเปิดใช้ SDK ของ GA จะตั้งค่า 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 เป็นจริง ระบบจะต้องป้อนข้อมูล 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] ต้องตั้งค่าสำหรับกรอบเวลาการรายงานผล 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 ค่าต่อไปนี้ ระบบจะใช้ค่าที่ตั้งไว้ร่วมกันเพื่อระบุเหตุการณ์ จำนวนครั้งขั้นต่ำที่เหตุการณ์เกิดขึ้น หากไม่ได้ตั้งค่า ระบบจะไม่ตรวจสอบจำนวนเหตุการณ์ขั้นต่ำ
maxEventCount

string (int64 format)

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

number

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

number

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

เมธอด

create

 สร้าง SKAdNetworkConversionValueSchema

delete

 ลบ SKAdNetworkConversionValueSchema เป้าหมาย

get

 ค้นหาสคีมามูลค่า Conversion ของ SKAdNetwork รายการเดียว

list

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

patch

 อัปเดต SKAdNetworkConversionValueSchema