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 Format: 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 เป็น "จริง" จะต้องป้อนข้อมูล 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 นี้ เงื่อนไขในรายการนี้จะทำงานร่วมกันแบบ "และ" โดยต้องมีรายการอย่างน้อย 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