Method: customers.uploadCallConversions

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

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

คำขอ HTTP

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

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

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

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

string

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

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

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

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

object (CallConversion)

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

boolean

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

boolean

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

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

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

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

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

object (Status)

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

object (CallConversionResult)

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

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

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

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

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

CallConversion

Conversion การโทร

การแสดง JSON 
{
  "customVariables": [
    {
      object (CustomVariable)
    }
  ],
  "consent": {
    object (Consent)
  },
  "callerId": string,
  "callStartDateTime": string,
  "conversionAction": string,
  "conversionDateTime": string,
  "conversionValue": number,
  "currencyCode": string
}
ช่อง
customVariables[]

object (CustomVariable)

ตัวแปรที่กําหนดเองที่เชื่อมโยงกับ Conversion นี้
consent

object (Consent)

การตั้งค่าความยินยอมสําหรับเหตุการณ์
callerId

string

หมายเลขผู้โทรที่ใช้การโทรนี้ หมายเลขผู้โทรต้องอยู่ในรูปแบบ E.164 โดยมีเครื่องหมาย "+" นำหน้า เช่น "+16502531234"
callStartDateTime

string

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

string

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

string

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

number

มูลค่าของ Conversion สำหรับผู้ลงโฆษณา
currencyCode

string

สกุลเงินที่เชื่อมโยงกับมูลค่า Conversion นี่คือรหัสสกุลเงิน 3 อักขระตามมาตรฐาน ISO 4217 เช่น USD, EUR

CallConversionResult

การระบุข้อมูลสำหรับ CallConversionUpload ที่ประมวลผลสำเร็จ

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

string

หมายเลขผู้โทรที่ใช้การโทรนี้ หมายเลขผู้โทรต้องอยู่ในรูปแบบ E.164 โดยมีเครื่องหมาย "+" นำหน้า
callStartDateTime

string

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

string

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

string

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