Method: customers.customerSkAdNetworkConversionValueSchemas.mutate

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

รายการข้อผิดพลาด: AuthenticationError AuthorizationError FieldError InternalError MutateError

คำขอ HTTP

POST https://googleads.googleapis.com/v17/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)

ข้อผิดพลาดที่ไม่บล็อกซึ่งให้รายละเอียดเกี่ยวกับความล้มเหลวในการตรวจสอบสคีมา แสดงผลเมื่อ enabledWARNINGs = 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 หนึ่งกับเหตุการณ์ 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 ที่แก้ไข