- Permintaan HTTP
- Parameter lokasi
- Isi permintaan
- Isi respons
- Cakupan otorisasi
- CallConversion
- CallConversionResult
- Cobalah!
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 |
Wajib. ID pelanggan yang melakukan upload. |
Isi permintaan
Isi permintaan memuat data dengan struktur berikut:
Representasi JSON |
---|
{
"conversions": [
{
object ( |
Kolom | |
---|---|
conversions[] |
Wajib. Konversi yang sedang diupload. |
partialFailure |
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 |
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 ( |
Kolom | |
---|---|
partialFailureError |
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[] |
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 ( |
Kolom | |
---|---|
customVariables[] |
Variabel kustom yang terkait dengan konversi ini. |
consent |
Setelan izin untuk peristiwa. |
callerId |
Nomor penelepon yang digunakan untuk melakukan panggilan ini. ID penelepon diharapkan dalam format E.164 dengan tanda '+', misalnya, "+16502531234". |
callStartDateTime |
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 |
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 |
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 |
Nilai konversi untuk pengiklan. |
currencyCode |
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 |
Nomor penelepon yang digunakan untuk melakukan panggilan ini. ID penelepon diharapkan dalam format E.164 dengan tanda '+' sebelumnya. |
callStartDateTime |
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 |
Nama resource tindakan konversi yang terkait dengan konversi ini. |
conversionDateTime |
Tanggal waktu saat konversi terjadi. Formatnya adalah "yyyy-mm-dd hh:mm:ss+|-hh:mm", misalnya, "2019-01-01 12:32:45-08:00". |