Method: customers.customerSkAdNetworkConversionValueSchemas.mutate

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

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

คำขอ HTTP

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

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

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

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

string

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

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

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

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

object (CustomerSkAdNetworkConversionValueSchemaOperation)

การดำเนินการ
validateOnly

boolean

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

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

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

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

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

object (MutateCustomerSkAdNetworkConversionValueSchemaResult)

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

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

ต้องใช้ขอบเขต 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)
    }
  ]
}
ช่อง
appId

string

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

integer

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

object (FineGrainedConversionValueMappings)

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

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 ระบบจะถือว่าไม่ได้ตั้งค่า

MutateCustomerSkAdNetworkConversionValueSchemaResult

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

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

string

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

string

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