Method: customers.uploadCallConversions

Memproses konversi panggilan yang ditentukan.

Daftar error yang ditampilkan: AuthenticationError AuthorizationError HeaderError InternalError PartialFailureError QuotaError RequestError

Permintaan HTTP

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

URL menggunakan sintaksis gRPC Transcoding.

Parameter jalur

Parameter
customerId

string

Wajib. ID pelanggan yang melakukan upload.

Isi permintaan

Isi permintaan memuat data dengan struktur berikut:

Representasi JSON 
{
  "conversions": [
    {
      object (CallConversion)
    }
  ],
  "partialFailure": boolean,
  "validateOnly": boolean
}
Kolom
conversions[]

object (CallConversion)

Wajib. Konversi yang sedang diupload.
partialFailure

boolean

Wajib. Jika true (benar), operasi yang berhasil akan dilakukan dan operasi yang tidak valid akan menampilkan error. Jika salah (false), semua operasi akan dilakukan dalam satu transaksi jika dan hanya jika semuanya valid. Nilai ini harus selalu ditetapkan ke true (benar). Lihat https://developers.google.com/google-ads/api/docs/best-practices/partial-failures untuk informasi selengkapnya tentang kegagalan sebagian.
validateOnly

boolean

Jika true (benar), permintaan divalidasi tetapi tidak dijalankan. Hanya error yang ditampilkan, bukan hasil.

Isi respons

Pesan respons untuk ConversionUploadService.UploadCallConversions.

Jika berhasil, isi respons memuat data dengan struktur berikut:

Representasi JSON 
{
  "partialFailureError": {
    object (Status)
  },
  "results": [
    {
      object (CallConversionResult)
    }
  ]
}
Kolom
partialFailureError

object (Status)

Error yang berkaitan dengan kegagalan konversi dalam mode kegagalan sebagian. Ditampilkan saat semua error terjadi di dalam konversi. Jika terjadi error di luar konversi (misalnya, error autentikasi), kami akan menampilkan error tingkat RPC. Lihat https://developers.google.com/google-ads/api/docs/best-practices/partial-failures untuk informasi selengkapnya tentang kegagalan sebagian.
results[]

object (CallConversionResult)

Ditampilkan untuk konversi yang berhasil diproses. Proto akan kosong untuk baris yang mengalami error. Hasil tidak ditampilkan jika validationOnly bernilai true (benar).

Cakupan otorisasi

Memerlukan cakupan OAuth berikut ini:

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

Untuk informasi selengkapnya, lihat Ringkasan OAuth 2.0.

CallConversion

Konversi panggilan.

Representasi JSON 
{
  "customVariables": [
    {
      object (CustomVariable)
    }
  ],
  "consent": {
    object (Consent)
  },
  "callerId": string,
  "callStartDateTime": string,
  "conversionAction": string,
  "conversionDateTime": string,
  "conversionValue": number,
  "currencyCode": string
}
Kolom
customVariables[]

object (CustomVariable)

Variabel kustom yang terkait dengan konversi ini.
consent

object (Consent)

Setelan izin untuk peristiwa.
callerId

string

Nomor penelepon yang digunakan untuk melakukan panggilan ini. ID penelepon diharapkan dalam format E.164 dengan tanda '+', misalnya, "+16502531234".
callStartDateTime

string

Tanggal waktu saat panggilan terjadi. Zona waktu harus ditentukan. Formatnya adalah "yyyy-mm-dd hh:mm:ss+|-hh:mm", misalnya, "2019-01-01 12:32:45-08:00".
conversionAction

string

Nama resource tindakan konversi yang terkait dengan konversi ini. Catatan: Meskipun nama resource ini terdiri dari ID pelanggan dan ID tindakan konversi, validasi akan mengabaikan ID pelanggan dan menggunakan ID tindakan konversi sebagai satu-satunya ID tindakan konversi.
conversionDateTime

string

Tanggal waktu saat konversi terjadi. Harus setelah waktu panggilan. Zona waktu harus ditentukan. Formatnya adalah "yyyy-mm-dd hh:mm:ss+|-hh:mm", misalnya, "2019-01-01 12:32:45-08:00".
conversionValue

number

Nilai konversi untuk pengiklan.
currencyCode

string

Mata uang yang terkait dengan nilai konversi. Ini adalah kode mata uang 3 karakter ISO 4217. Misalnya: USD, EUR.

CallConversionResult

Informasi pengidentifikasi untuk CallConversionUpload yang berhasil diproses.

Representasi JSON 
{
  "callerId": string,
  "callStartDateTime": string,
  "conversionAction": string,
  "conversionDateTime": string
}
Kolom
callerId

string

Nomor penelepon yang digunakan untuk melakukan panggilan ini. ID penelepon diharapkan dalam format E.164 dengan tanda '+' sebelumnya.
callStartDateTime

string

Tanggal waktu saat panggilan terjadi. Formatnya adalah "yyyy-mm-dd hh:mm:ss+|-hh:mm", misalnya, "2019-01-01 12:32:45-08:00".
conversionAction

string

Nama resource tindakan konversi yang terkait dengan konversi ini.
conversionDateTime

string

Tanggal waktu saat konversi terjadi. Formatnya adalah "yyyy-mm-dd hh:mm:ss+|-hh:mm", misalnya, "2019-01-01 12:32:45-08:00".