Method: customers.customerSkAdNetworkConversionValueSchemas.mutate

สร้างหรืออัปเดต CustomerSkAdNetworkConversionValueSchema

รายการข้อผิดพลาดที่ปรากฏ: AuthenticationError AuthorizationError FieldError InternalError MutateError

คำขอ HTTP

POST https://googleads.googleapis.com/v16/customers/{customerId}/customerSkAdNetworkConversionValueSchemas:mutate

URL ใช้ไวยากรณ์การแปลง gRPC

พารามิเตอร์เส้นทาง

พารามิเตอร์
customerId

string

รหัสของลูกค้าที่มีการแก้ไขชุดที่ใช้ร่วมกัน

เนื้อหาของคำขอ

เนื้อหาของคำขอมีข้อมูลซึ่งมีโครงสร้างต่อไปนี้

การแสดง JSON 
{
  "operation": {
    object (CustomerSkAdNetworkConversionValueSchemaOperation)
  },
  "validateOnly": boolean,
  "enableWarnings": boolean
}
ช่อง
operation

object (CustomerSkAdNetworkConversionValueSchemaOperation)

การดำเนินการที่จะทำ
validateOnly

boolean

หากเป็น "จริง" ระบบจะตรวจสอบคําขอแต่ไม่ได้ดําเนินการ ระบบจะแสดงเฉพาะข้อผิดพลาดเท่านั้น ไม่ใช่ผลลัพธ์
enableWarnings

boolean

ไม่บังคับ หากเป็น "จริง" ระบบจะเปิดใช้การแสดงคำเตือน คำเตือนจะแสดงข้อความแสดงข้อผิดพลาดและรหัสข้อผิดพลาดโดยไม่บล็อกการดำเนินการเปลี่ยนแปลง

เนื้อหาการตอบกลับ

ข้อความตอบกลับสำหรับ customerSkAdNetworkConversionValueSchemas.mutate

หากทำสำเร็จ เนื้อหาการตอบกลับจะมีข้อมูลซึ่งมีโครงสร้างดังต่อไปนี้

การแสดง JSON 
{
  "result": {
    object (MutateCustomerSkAdNetworkConversionValueSchemaResult)
  },
  "warning": {
    object (Status)
  }
}
ช่อง
result

object (MutateCustomerSkAdNetworkConversionValueSchemaResult)

ผลลัพธ์ทั้งหมดสำหรับการเปลี่ยนแปลง
warning

object (Status)

ข้อผิดพลาดที่ไม่ใช่การบล็อกซึ่งให้รายละเอียดความล้มเหลวในการตรวจสอบสคีมา แสดงผลเฉพาะเมื่อenableWARNINGs = true เท่านั้น

ขอบเขตการให้สิทธิ์

ต้องใช้ขอบเขต OAuth ต่อไปนี้

  • https://www.googleapis.com/auth/adwords

โปรดดูข้อมูลเพิ่มเติมที่ภาพรวมของ OAuth 2.0

CustomerSkAdNetworkConversionValueSchemaOperation

การดำเนินการอัปเดตครั้งเดียวสำหรับ CustomerSkAdNetworkConversionValueSchema

การแสดง JSON 
{
  "update": {
    object (CustomerSkAdNetworkConversionValueSchema)
  }
}
ช่อง
update

object (CustomerSkAdNetworkConversionValueSchema)

การดำเนินการอัปเดต: สคีมาควรมีชื่อทรัพยากรที่ถูกต้อง

CustomerSkAdNetworkConversionValueSchema

CustomerSkAdNetworkConversionValueSchema

การแสดง JSON 
{
  "resourceName": string,
  "schema": {
    object (SkAdNetworkConversionValueSchema)
  }
}
ช่อง
resourceName

string

เอาต์พุตเท่านั้น ชื่อทรัพยากรของสคีมา ชื่อทรัพยากร CustomerSkAdNetworkConversionValueSchema มีรูปแบบดังนี้: customer/{customerId}/customerSkAdNetworkConversionValueSchemas/{accountLinkId}
schema

object (SkAdNetworkConversionValueSchema)

เอาต์พุตเท่านั้น สคีมาสำหรับทรัพยากรที่ระบุ

SkAdNetworkConversionValueSchema

SkAdNetworkConversionValueSchema ของ CustomerLink โดยเฉพาะ

การแสดง JSON 
{
  "appId": string,
  "measurementWindowHours": integer,
  "fineGrainedConversionValueMappings": [
    {
      object (FineGrainedConversionValueMappings)
    }
  ],
  "postbackMappings": [
    {
      object (PostbackMapping)
    }
  ]
}
ช่อง
appId

string

ต้องระบุ เอาต์พุตเท่านั้น รหัสแอป Apple App Store
measurementWindowHours

integer

เอาต์พุตเท่านั้น กรอบเวลา (วัดเป็นชั่วโมง) หลังการติดตั้ง หลังจากที่ App Attribution Partner หรือผู้ลงโฆษณาหยุดเรียกใช้ updateConversionValue
fineGrainedConversionValueMappings[]

object (FineGrainedConversionValueMappings)

เอาต์พุตเท่านั้น การแมปมูลค่า Conversion แบบละเอียด สำหรับ SkAdNetwork เวอร์ชัน >= 4.0 ที่รองรับกรอบเวลา Conversion หลายกรอบเวลา การแมปมูลค่า Conversion แบบละเอียดจะใช้ได้กับระบบรายงานผล Conversion ครั้งแรกเท่านั้น
postbackMappings[]

object (PostbackMapping)

เอาต์พุตเท่านั้น การแมปมูลค่า Conversion ต่อระบบรายงานผล Conversion สำหรับระบบรายงานผล Conversion ในกรอบเวลา Conversion หลายหน้าต่าง ใช้ได้กับ SkAdNetwork เวอร์ชัน >= 4.0 เท่านั้น

FineGrainedConversionValueMappings

การแมปสำหรับมูลค่า Conversion แบบละเอียด

การแสดง JSON 
{
  "fineGrainedConversionValue": integer,
  "conversionValueMapping": {
    object (ConversionValueMapping)
  }
}
ช่อง
fineGrainedConversionValue

integer

เอาต์พุตเท่านั้น มูลค่า Conversion แบบละเอียด ค่าที่ถูกต้องจะอยู่ในช่วงการรวม [0,63]
conversionValueMapping

object (ConversionValueMapping)

เอาต์พุตเท่านั้น เหตุการณ์ Conversion ที่แมปมูลค่า Conversion แบบละเอียด

ConversionValueMapping

แสดงการแมปจากมูลค่า Conversion 1 รายการกับเหตุการณ์ Conversion อย่างน้อย 1 รายการ

การแสดง JSON 
{
  "minTimePostInstallHours": string,
  "maxTimePostInstallHours": string,
  "mappedEvents": [
    {
      object (Event)
    }
  ]
}
ช่อง
minTimePostInstallHours

string (int64 format)

เอาต์พุตเท่านั้น ช่วงเวลาต่ำสุดที่ผู้ใช้ใช้งานครั้งล่าสุดในระหว่างกรอบเวลาการวัด
maxTimePostInstallHours

string (int64 format)

เอาต์พุตเท่านั้น ค่าสูงสุดของช่วงเวลาที่ผู้ใช้ใช้งานครั้งล่าสุดในระหว่างกรอบเวลาการวัด
mappedEvents[]

object (Event)

เอาต์พุตเท่านั้น มูลค่า Conversion อาจจับคู่กับหลายเหตุการณ์ที่มีแอตทริบิวต์ต่างกัน

เหตุการณ์

กําหนดเหตุการณ์ Conversion ของ Google ที่จับคู่กับมูลค่า Conversion

การแสดง JSON 
{
  "mappedEventName": string,
  "currencyCode": string,

  // Union field revenue_rate can be only one of the following:
  "eventRevenueRange": {
    object (RevenueRange)
  },
  "eventRevenueValue": number
  // End of list of possible types for union field revenue_rate.

  // Union field event_rate can be only one of the following:
  "eventOccurrenceRange": {
    object (EventOccurrenceRange)
  },
  "eventCounter": string
  // End of list of possible types for union field event_rate.
}
ช่อง
mappedEventName

string

เอาต์พุตเท่านั้น ชื่อเหตุการณ์ Google ที่แสดงด้วยมูลค่า Conversion นี้
currencyCode

string

เอาต์พุตเท่านั้น สกุลเงินที่รายงานสำหรับ event_revenue รหัสสกุลเงิน 3 ตัวอักษรตามมาตรฐาน ISO 4217 เช่น "USD"
ฟิลด์สหภาพ revenue_rate ช่วงหรือมูลค่าที่เฉพาะเจาะจงสําหรับรายได้จากเหตุการณ์ revenue_rate ต้องเป็นค่าใดค่าหนึ่งต่อไปนี้เท่านั้น
eventRevenueRange

object (RevenueRange)

เอาต์พุตเท่านั้น ช่วงรายได้ของเหตุการณ์
eventRevenueValue

number

เอาต์พุตเท่านั้น มูลค่ารายได้จากเหตุการณ์ที่เฉพาะเจาะจง
ฟิลด์สหภาพ event_rate ช่วงหรือค่าเฉพาะสำหรับตัวนับเหตุการณ์ event_rate ต้องเป็นค่าใดค่าหนึ่งต่อไปนี้เท่านั้น
eventOccurrenceRange

object (EventOccurrenceRange)

เอาต์พุตเท่านั้น ช่วงตัวนับเหตุการณ์
eventCounter

string (int64 format)

เอาต์พุตเท่านั้น สำหรับค่าตัวนับเหตุการณ์ที่เฉพาะเจาะจง

RevenueRange

กำหนดช่วงสำหรับค่ารายได้

การแสดง JSON 
{
  "minEventRevenue": number,
  "maxEventRevenue": number
}
ช่อง
minEventRevenue

number

เอาต์พุตเท่านั้น สำหรับช่วงรายได้ ค่าต่ำสุดในสกุลเงิน currencyCode ที่จะอัปเดตมูลค่า Conversion นี้ ค่า 0 จะถือว่าไม่ได้ตั้งค่า
maxEventRevenue

number

เอาต์พุตเท่านั้น สำหรับช่วงรายได้ ค่าสูงสุดในสกุลเงิน currencyCode ที่จะอัปเดตมูลค่า Conversion นี้ ค่า 0 จะถือว่าไม่ได้ตั้งค่า

EventOccurrenceRange

กำหนดช่วงสำหรับค่าตัวนับเหตุการณ์

การแสดง JSON 
{
  "minEventCount": string,
  "maxEventCount": string
}
ช่อง
minEventCount

string (int64 format)

เอาต์พุตเท่านั้น ค่าต่ำสุดของช่วงที่กำหนดไว้สำหรับช่วงตัวนับเหตุการณ์ ค่า 0 จะถือว่าไม่ได้ตั้งค่า
maxEventCount

string (int64 format)

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

PostbackMapping

การแมปสําหรับระบบรายงานผล Conversion แต่ละรายการในกรอบเวลา Conversion หลายกรอบเวลา

การแสดง JSON 
{
  "postbackSequenceIndex": integer,
  "coarseGrainedConversionValueMappings": {
    object (CoarseGrainedConversionValueMappings)
  },

  // Union field lock_window_trigger can be only one of the following:
  "lockWindowCoarseConversionValue": enum (SkAdNetworkCoarseConversionValue),
  "lockWindowFineConversionValue": integer,
  "lockWindowEvent": string
  // End of list of possible types for union field lock_window_trigger.
}
ช่อง
postbackSequenceIndex

integer

เอาต์พุตเท่านั้น ดัชนีฐาน 0 ที่ระบุลำดับของระบบรายงานผล Conversion ค่าที่ถูกต้องจะอยู่ในช่วงการรวม [0,2]
coarseGrainedConversionValueMappings

object (CoarseGrainedConversionValueMappings)

เอาต์พุตเท่านั้น การแมปมูลค่า Conversion สําหรับมูลค่า Conversion แบบละเอียดทั้งหมด
ฟิลด์สหภาพ lock_window_trigger เหตุการณ์หรือมูลค่า Conversion ที่ใช้สำหรับการล็อกกรอบเวลา Conversion lock_window_trigger ต้องเป็นค่าใดค่าหนึ่งต่อไปนี้เท่านั้น
lockWindowCoarseConversionValue

enum (SkAdNetworkCoarseConversionValue)

เอาต์พุตเท่านั้น มูลค่า Conversion แบบละเอียดที่ทำให้เกิดการล็อกกรอบเวลา Conversion
lockWindowFineConversionValue

integer

เอาต์พุตเท่านั้น มูลค่า Conversion แบบละเอียดที่ทำให้เกิดการล็อกกรอบเวลา Conversion
lockWindowEvent

string

เอาต์พุตเท่านั้น ชื่อเหตุการณ์ที่ทำให้เกิดการล็อกกรอบเวลา Conversion

CoarseGrainedConversionValueMappings

การแมปสำหรับมูลค่า Conversion แบบละเอียด

การแสดง JSON 
{
  "lowConversionValueMapping": {
    object (ConversionValueMapping)
  },
  "mediumConversionValueMapping": {
    object (ConversionValueMapping)
  },
  "highConversionValueMapping": {
    object (ConversionValueMapping)
  }
}
ช่อง
lowConversionValueMapping

object (ConversionValueMapping)

เอาต์พุตเท่านั้น การแมปสำหรับมูลค่า Conversion หยาบระดับ "ต่ำ"
mediumConversionValueMapping

object (ConversionValueMapping)

เอาต์พุตเท่านั้น การแมปสำหรับมูลค่า Conversion หยาบระดับ "ปานกลาง"
highConversionValueMapping

object (ConversionValueMapping)

เอาต์พุตเท่านั้น การแมปสําหรับมูลค่า Conversion หยาบ "สูง"

MutateCustomerSkAdNetworkConversionValueSchemaResult

ผลลัพธ์สำหรับการเปลี่ยนแปลง CustomerSkAdNetworkConversionValueSchema

การแสดง JSON 
{
  "resourceName": string,
  "appId": string
}
ช่อง
resourceName

string

ชื่อทรัพยากรของลูกค้าที่แก้ไข
appId

string

รหัสแอปของ SkanConversionValue ที่แก้ไข