- คำขอ HTTP
- พารามิเตอร์เส้นทาง
- เนื้อความของคำขอ
- เนื้อหาการตอบกลับ
- ขอบเขตการให้สิทธิ์
- CallConversion
- CallConversionResult
- ลองใช้งาน
ประมวลผล Conversion การโทรที่ระบุ
รายการข้อผิดพลาดที่เกิดขึ้น: AuthenticationError AuthorizationError HeaderError InternalError PartialFailureError QuotaError RequestError หรือไม่
คำขอ HTTP
POST https://googleads.googleapis.com/v14/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 จะว่างเปล่าสำหรับแถวที่ได้รับข้อผิดพลาด ระบบจะไม่ส่งกลับผลลัพธ์เมื่อบันทึกการตรวจสอบเป็น "จริง" เท่านั้น |
ขอบเขตการให้สิทธิ์
ต้องใช้ขอบเขต OAuth ต่อไปนี้
https://www.googleapis.com/auth/adwords
ดูข้อมูลเพิ่มเติมได้ที่ภาพรวมของ OAuth 2.0
CallConversion
Conversion การโทร
การแสดง JSON |
---|
{
"customVariables": [
{
object ( |
ช่อง | |
---|---|
customVariables[] |
ตัวแปรที่กําหนดเองที่เชื่อมโยงกับ Conversion นี้ |
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" |