Method: customers.uploadConversionAdjustments

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

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

คำขอ HTTP

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

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

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

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

string

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

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

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

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

object (ConversionAdjustment)

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

boolean

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

boolean

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

integer

ไม่บังคับ อินพุตที่ไม่บังคับเพื่อตั้งค่ารหัสงาน ต้องเป็นตัวเลขที่ไม่ติดลบที่น้อยกว่า 2^31 หากมี หากไม่ระบุช่องนี้ API จะสร้างรหัสงานในช่วง [2^31, (2^63)-1] API จะแสดงผลค่าของคำขอนี้ในช่อง jobId ของ UploadConversionAdjustmentsResponse

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

ข้อความตอบกลับสำหรับ 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 จะว่างเปล่าสำหรับแถวที่ได้รับข้อผิดพลาด ระบบจะไม่แสดงผลลัพธ์เมื่อ checkOnly เป็น "จริง"
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 ที่รายงานโดยไม่มีรหัสคำสั่งซื้อที่ระบุ หาก AdjustType เป็น ENHANCEMENT ค่านี้เป็นตัวเลือกที่ไม่บังคับ แต่อาจตั้งค่าเพิ่มเติมจากรหัสคำสั่งซื้อ
adjustmentType

enum (ConversionAdjustmentType)

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

object (RestatementValue)

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

object (UserIdentifier)

ตัวระบุผู้ใช้เพื่อเพิ่มประสิทธิภาพ Conversion เดิม ConversionการปรับราคาเสนอUploadService ยอมรับเฉพาะตัวระบุผู้ใช้ในการเพิ่มประสิทธิภาพเท่านั้น จำนวนตัวระบุผู้ใช้สูงสุดสำหรับการเพิ่มประสิทธิภาพแต่ละรายการคือ 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 like 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"