- คำขอ HTTP
- พารามิเตอร์เส้นทาง
- เนื้อความของคำขอ
- เนื้อหาการตอบกลับ
- ขอบเขตการให้สิทธิ์
- CallConversion
- CallConversionResult
- ลองใช้งาน
ประมวลผล Conversion การโทรที่ระบุ
รายการข้อผิดพลาดที่เกิดขึ้น: AuthenticationError AuthorizationError HeaderError InternalError PartialFailureError QuotaError RequestError
คำขอ HTTP
POST https://googleads.googleapis.com/v16/customers/{customerId}:uploadCallConversions
URL ใช้ไวยากรณ์การแปลง gRPC
พารามิเตอร์เส้นทาง
พารามิเตอร์ | |
---|---|
customerId |
ต้องระบุ รหัสลูกค้าที่ทำการอัปโหลด |
เนื้อหาของคำขอ
เนื้อหาของคำขอมีข้อมูลซึ่งมีโครงสร้างต่อไปนี้
การแสดง JSON |
---|
{
"conversions": [
{
object ( |
ช่อง | |
---|---|
conversions[] |
ต้องระบุ Conversion ที่กําลังอัปโหลด |
partialFailure |
ต้องระบุ หาก "จริง" ระบบจะดำเนินการสำเร็จและการดำเนินการที่ไม่ถูกต้องจะแสดงข้อผิดพลาด หากเป็นเท็จ การดำเนินการทั้งหมดจะดำเนินการในธุรกรรมเดียวในกรณีที่ทั้งหมดถูกต้องเท่านั้น ควรตั้งค่าเป็น "จริง" เสมอ ดูข้อมูลเพิ่มเติมเกี่ยวกับความล้มเหลวบางส่วนได้ที่ https://developers.google.com/google-ads/api/docs/best-practices/partial-failures |
validateOnly |
หากเป็น "จริง" ระบบจะตรวจสอบคําขอแต่ไม่ได้ดําเนินการ ระบบจะแสดงเฉพาะข้อผิดพลาดเท่านั้น ไม่ใช่ผลลัพธ์ |
เนื้อหาการตอบกลับ
ข้อความตอบกลับสำหรับ ConversionUploadService.UploadCallConversions
หากทำสำเร็จ เนื้อหาการตอบกลับจะมีข้อมูลซึ่งมีโครงสร้างดังต่อไปนี้
การแสดง JSON |
---|
{ "partialFailureError": { object ( |
ช่อง | |
---|---|
partialFailureError |
ข้อผิดพลาดที่เกี่ยวข้องกับความล้มเหลวในการแปลงในโหมดความล้มเหลวบางส่วน แสดงผลเมื่อข้อผิดพลาดทั้งหมดเกิดขึ้นภายใน Conversion หากเกิดข้อผิดพลาดนอก Conversion (เช่น ข้อผิดพลาดในการตรวจสอบสิทธิ์) เราจะแสดงผลข้อผิดพลาดระดับ RPC ดูข้อมูลเพิ่มเติมเกี่ยวกับความล้มเหลวบางส่วนได้ที่ https://developers.google.com/google-ads/api/docs/best-practices/partial-failures |
results[] |
แสดงผล Conversion ที่ประมวลผลเรียบร้อยแล้ว Proto จะว่างเปล่าสำหรับแถวที่ได้รับข้อผิดพลาด ระบบจะไม่แสดงผลลัพธ์เมื่อ checkOnly เป็น "จริง" |
ขอบเขตการให้สิทธิ์
ต้องใช้ขอบเขต OAuth ต่อไปนี้
https://www.googleapis.com/auth/adwords
โปรดดูข้อมูลเพิ่มเติมที่ภาพรวมของ OAuth 2.0
CallConversion
Conversion การโทร
การแสดง JSON |
---|
{ "customVariables": [ { object ( |
ช่อง | |
---|---|
customVariables[] |
ตัวแปรที่กําหนดเองที่เชื่อมโยงกับ Conversion นี้ |
consent |
การตั้งค่าความยินยอมสําหรับเหตุการณ์ |
callerId |
หมายเลขผู้โทรที่โทรนี้ หมายเลขผู้โทรควรอยู่ในรูปแบบ E.164 โดยมีเครื่องหมาย "+" นำหน้า เช่น "+16502531234" |
callStartDateTime |
วันที่และเวลาที่เกิดการโทร ต้องระบุเขตเวลา โดยอยู่ในรูปแบบ "yyyy-mm-dd hh:mm:ss+|-hh:mm" เช่น "2019-01-01 12:32:45-08:00" |
conversionAction |
ชื่อทรัพยากรของการกระทำที่ถือเป็น Conversion ที่เชื่อมโยงกับ Conversion นี้ หมายเหตุ: แม้ว่าชื่อทรัพยากรนี้ประกอบด้วยรหัสลูกค้าและรหัสการกระทำที่ถือเป็น Conversion แต่การตรวจสอบจะไม่สนใจรหัสลูกค้าและใช้รหัสการกระทำที่ถือเป็น Conversion เป็นตัวระบุเพียงอย่างเดียวของการกระทำที่ถือเป็น Conversion |
conversionDateTime |
วันที่และเวลาที่เกิด Conversion ต้องอยู่หลังเวลาโทร ต้องระบุเขตเวลา โดยอยู่ในรูปแบบ "yyyy-mm-dd hh:mm:ss+|-hh:mm" เช่น "2019-01-01 12:32:45-08:00" |
conversionValue |
มูลค่าของ Conversion สำหรับผู้ลงโฆษณา |
currencyCode |
สกุลเงินที่เชื่อมโยงกับมูลค่า Conversion นี่คือรหัสสกุลเงิน 3 อักขระตามมาตรฐาน ISO 4217 เช่น USD, EUR |
CallConversionResult
การระบุข้อมูลสำหรับ CallConversionUpload ที่ประมวลผลสำเร็จ
การแสดง JSON |
---|
{ "callerId": string, "callStartDateTime": string, "conversionAction": string, "conversionDateTime": string } |
ช่อง | |
---|---|
callerId |
หมายเลขผู้โทรที่โทรนี้ หมายเลขผู้โทรต้องอยู่ในรูปแบบ E.164 โดยมีเครื่องหมาย "+" นำหน้า |
callStartDateTime |
วันที่และเวลาที่เกิดการโทร โดยอยู่ในรูปแบบ "yyyy-mm-dd hh:mm:ss+|-hh:mm" เช่น "2019-01-01 12:32:45-08:00" |
conversionAction |
ชื่อทรัพยากรของการกระทำที่ถือเป็น Conversion ที่เชื่อมโยงกับ Conversion นี้ |
conversionDateTime |
วันที่และเวลาที่เกิด Conversion โดยอยู่ในรูปแบบ "yyyy-mm-dd hh:mm:ss+|-hh:mm" เช่น "2019-01-01 12:32:45-08:00" |