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 นี้เท่านั้น

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

postbackWindowThree

object (PostbackWindow)

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

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

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

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

ConversionValues

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

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

string

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

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 คร่าวๆ ที่ตั้งไว้ในการเรียกใช้ updatePostbackConversionValue 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 40 หน่วย

minEventCount

string (int64 format)

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

maxEventCount

string (int64 format)

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

minEventValue

number

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

maxEventValue

number

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

เมธอด

create

สร้าง SKAdNetwork ConversionValueSchema

delete

ลบ SKAdNetworkConversionValueSchema เป้าหมาย

get

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

list

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

patch

อัปเดต SKAdNetworkConversionValueSchema