Method: customers.uploadConversionAdjustments

ประมวลผลการปรับ Conversion ที่ระบุ

รายการข้อผิดพลาดที่เกิดขึ้น: AuthenticationError AuthorizationError HeaderError InternalError PartialFailureError QuotaError RequestError หรือไม่

คำขอ HTTP

POST https://googleads.googleapis.com/v14/customers/{customerId}:uploadConversionAdjustments

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

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

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

string

ต้องระบุ รหัสของลูกค้าที่ทำการอัปโหลด

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

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

การแสดง JSON 
{
  "conversionAdjustments": [
    {
      object (ConversionAdjustment)
    }
  ],
  "partialFailure": boolean,
  "validateOnly": boolean
}
ช่อง
conversionAdjustments[]

object (ConversionAdjustment)

ต้องระบุ กําลังอัปโหลดการปรับ Conversion
partialFailure

boolean

ต้องระบุ หากค่าเป็น "จริง" ระบบจะดําเนินการสําเร็จและการดําเนินการที่ไม่ถูกต้องจะแสดงข้อผิดพลาด หากเป็นเท็จ การดำเนินการทั้งหมดจะเกิดขึ้นในธุรกรรมเดียวในกรณีที่การดำเนินการทั้งหมดถูกต้องเท่านั้น ควรตั้งค่าเป็น "จริง" เสมอ ดูข้อมูลเพิ่มเติมเกี่ยวกับข้อผิดพลาดบางส่วนได้ที่ https://developers.google.com/google-ads/api/docs/best-practices/partial-failures
validateOnly

boolean

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

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

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

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

การแสดง JSON 
{
  "partialFailureError": {
    object (Status)
  },
  "results": [
    {
      object (ConversionAdjustmentResult)
    }
  ],
  "jobId": string
}
ช่อง
partialFailureError

object (Status)

ข้อผิดพลาดที่เกี่ยวข้องกับความล้มเหลวในการปรับ Conversion ในโหมดความล้มเหลวบางส่วน แสดงผลเมื่อเกิดข้อผิดพลาดทั้งหมดภายในการปรับเปลี่ยน หากมีข้อผิดพลาดเกิดขึ้นนอกการปรับเปลี่ยน (เช่น ข้อผิดพลาดในการตรวจสอบสิทธิ์) เราจะแสดงข้อผิดพลาดระดับ RPC ดูข้อมูลเพิ่มเติมเกี่ยวกับข้อผิดพลาดบางส่วนได้ที่ https://developers.google.com/google-ads/api/docs/best-practices/partial-failures
results[]

object (ConversionAdjustmentResult)

แสดงผลสําหรับการปรับ Conversion ที่ประมวลผลเรียบร้อยแล้ว Proto จะว่างเปล่าสำหรับแถวที่ได้รับข้อผิดพลาด ระบบจะไม่ส่งกลับผลลัพธ์เมื่อบันทึกการตรวจสอบเป็น "จริง" เท่านั้น
jobId

string (int64 format)

รหัสงานสำหรับกลุ่มการอัปโหลด

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

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

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

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

ConversionAdjustment

การปรับ Conversion

การแสดง JSON 
{
  "gclidDateTimePair": {
    object (GclidDateTimePair)
  },
  "adjustmentType": enum (ConversionAdjustmentType),
  "restatementValue": {
    object (RestatementValue)
  },
  "userIdentifiers": [
    {
      object (UserIdentifier)
    }
  ],
  "orderId": string,
  "conversionAction": string,
  "adjustmentDateTime": string,
  "userAgent": string
}
ช่อง
gclidDateTimePair

object (GclidDateTimePair)

สำหรับการปรับเปลี่ยน จะระบุ Conversion ที่รายงานโดยไม่มีรหัสคำสั่งซื้อโดยไม่ซ้ำกัน หากการปรับราคาเสนอเป็นประเภท ENHANCEMENT คุณไม่จำเป็นต้องระบุค่านี้ แต่จะตั้งค่านอกเหนือจากรหัสคำสั่งซื้อได้
adjustmentType

enum (ConversionAdjustmentType)

ประเภทการปรับ
restatementValue

object (RestatementValue)

ข้อมูลที่จําเป็นในการระบุค่าของ Conversion ใหม่ ต้องระบุสำหรับการระบุซ้ำ ไม่ควรระบุสำหรับการเพิกถอน ระบบจะแสดงข้อผิดพลาดหากมีการระบุไว้สำหรับการเพิกถอน หมายเหตุ: หากต้องการอัปโหลดการระบุซ้ำรายการที่ 2 โดยใช้ค่าที่ปรับต่างกัน รายการนั้นต้องมีเวลาที่เกิดการปรับใหม่ที่เป็นปัจจุบันกว่า มิฉะนั้น ระบบจะถือว่าเป็นค่าซ้ำกับการระบุซ้ำก่อนหน้านี้และละเว้นไว้
userIdentifiers[]

object (UserIdentifier)

ตัวระบุผู้ใช้เพื่อปรับปรุง Conversion เดิม ConversionadjustUploadService ยอมรับเฉพาะตัวระบุผู้ใช้ในการเพิ่มประสิทธิภาพเท่านั้น จำนวนตัวระบุผู้ใช้สูงสุดสำหรับการเพิ่มประสิทธิภาพแต่ละรายการคือ 5 รายการ
orderId

string

รหัสคำสั่งซื้อของ Conversion ที่จะปรับ หากมีการรายงาน Conversion ที่มีรหัสคำสั่งซื้อที่ระบุไว้ จะต้องใช้รหัสคำสั่งซื้อนั้นเป็นตัวระบุที่นี่ ต้องระบุรหัสคำสั่งซื้อสำหรับการเพิ่มประสิทธิภาพ
conversionAction

string

ชื่อทรัพยากรของการกระทำที่ถือเป็น Conversion ที่เชื่อมโยงกับการปรับเปลี่ยน Conversion นี้ หมายเหตุ: แม้ว่าชื่อทรัพยากรนี้จะมีรหัสลูกค้าและรหัสการกระทำที่ถือเป็น Conversion แต่การตรวจสอบจะไม่สนใจรหัสลูกค้าและใช้รหัสการกระทำที่ถือเป็น Conversion เป็นตัวระบุเพียงอย่างเดียวของการกระทำที่ถือเป็น Conversion
adjustmentDateTime

string

วันที่และเวลาที่เกิดการปรับค่าใช้จ่าย ต้องอยู่หลัง conversionDateTime ต้องระบุเขตเวลา โดยอยู่ในรูปแบบ "yyyy-mm-dd hh:mm:ss+|-hh:mm" เช่น "2019-01-01 12:32:45-08:00"
userAgent

string

User Agent เพื่อเพิ่มประสิทธิภาพ Conversion เดิม ซึ่งสามารถดูได้ในส่วนหัวของคำขอ HTTP ของผู้ใช้เมื่อพวกเขาทำ Conversion ในหน้าเว็บของคุณ ตัวอย่างเช่น "Mozilla/5.0 (iPhone; CPU iPhone OS 12_2 เช่น Mac OS X)" ระบุ User Agent ได้ในการเพิ่มประสิทธิภาพด้วยตัวระบุผู้ใช้เท่านั้น ซึ่งควรตรงกับ User Agent ของคําขอที่ส่ง Conversion เดิมเพื่อให้ Conversion และการเพิ่มประสิทธิภาพได้รับการระบุแหล่งที่มาเป็นอุปกรณ์เดียวกันหรือระบุแหล่งที่มาเป็นข้ามอุปกรณ์ทั้งคู่

GclidDateTimePair

ระบุ Conversion ที่ถูกรายงานโดยไม่ได้ระบุรหัสคำสั่งซื้อ

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

string

Google Click ID (gclid) ที่เชื่อมโยงกับ Conversion เดิมสำหรับการปรับนี้
conversionDateTime

string

วันที่และเวลาที่เกิด Conversion เดิมสําหรับการปรับเปลี่ยนนี้ ต้องระบุเขตเวลา โดยอยู่ในรูปแบบ "yyyy-mm-dd hh:mm:ss+|-hh:mm" เช่น "2019-01-01 12:32:45-08:00"

ConversionAdjustmentType

การดำเนินการต่างๆ ที่ผู้ลงโฆษณาทำได้เพื่อปรับ Conversion ที่รายงานแล้ว การเพิกถอนจะยกเลิก Conversion การระบุซ้ำจะเปลี่ยนมูลค่าของ Conversion

Enum
UNSPECIFIED ไม่ได้ระบุ
UNKNOWN แสดงถึงค่าที่ไม่รู้จักในเวอร์ชันนี้
RETRACTION ลบล้าง Conversion เพื่อให้มูลค่าและจำนวนรวมเป็น 0
RESTATEMENT เปลี่ยนมูลค่าของ Conversion
ENHANCEMENT เสริม Conversion ที่มีอยู่ด้วยตัวระบุผู้ใช้และ User Agent ที่ให้มา ซึ่ง Google สามารถใช้เพื่อเพิ่มจำนวน Conversion ได้

RestatementValue

มีข้อมูลที่จําเป็นในการระบุค่าของ Conversion ใหม่

การแสดง JSON 
{
  "adjustedValue": number,
  "currencyCode": string
}
ช่อง
adjustedValue

number

มูลค่า Conversion ที่ระบุ นี่คือมูลค่าของ Conversion หลังการเปลี่ยนค่า เช่น หากต้องการเปลี่ยนมูลค่า Conversion จาก 100 เป็น 70 คุณควรรายงานมูลค่าที่ปรับแล้วเป็น 70 หมายเหตุ: หากต้องการอัปโหลดการระบุซ้ำรายการที่ 2 โดยใช้ค่าที่ปรับต่างกัน รายการนั้นต้องมีเวลาที่เกิดการปรับใหม่ที่เป็นปัจจุบันกว่า มิฉะนั้น ระบบจะถือว่าเป็นค่าซ้ำกับการระบุซ้ำก่อนหน้านี้และละเว้นไว้
currencyCode

string

สกุลเงินของมูลค่าที่ระบุอีกครั้ง หากไม่ระบุ ระบบจะใช้สกุลเงินเริ่มต้นจากการกระทำที่ถือเป็น Conversion และหากไม่ได้ตั้งค่าไว้ ระบบจะใช้สกุลเงินของบัญชี นี่คือรหัสสกุลเงิน 3 อักขระตามมาตรฐาน ISO 4217 เช่น USD หรือ EUR

ConversionAdjustmentResult

ข้อมูลที่ระบุ Conversionadjust ที่ประมวลผลสําเร็จ

การแสดง JSON 
{
  "gclidDateTimePair": {
    object (GclidDateTimePair)
  },
  "orderId": string,
  "adjustmentType": enum (ConversionAdjustmentType),
  "conversionAction": string,
  "adjustmentDateTime": string
}
ช่อง
gclidDateTimePair

object (GclidDateTimePair)

gclid และเวลาและวันที่ของ Conversion ของการเกิด Conversion
orderId

string

รหัสคำสั่งซื้อของ Conversion ที่จะปรับ
adjustmentType

enum (ConversionAdjustmentType)

ประเภทการปรับ
conversionAction

string

ชื่อทรัพยากรของการกระทำที่ถือเป็น Conversion ที่เชื่อมโยงกับการปรับเปลี่ยน Conversion นี้
adjustmentDateTime

string

วันที่และเวลาที่เกิดการปรับค่าใช้จ่าย โดยอยู่ในรูปแบบ "yyyy-mm-dd hh:mm:ss+|-hh:mm" เช่น "2019-01-01 12:32:45-08:00"