- 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/v14/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, 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 akan divalidasi tetapi tidak dieksekusi. 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 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 menerima error. Hasil tidak ditampilkan jika validasiOnly 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. |
callerId |
ID penelepon yang digunakan untuk melakukan panggilan ini. Nomor penelepon diharapkan dalam format E.164 dengan tanda '+' sebelumnya, 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 ID tunggal tindakan konversi. |
conversionDateTime |
Tanggal 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 bagi 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 |
ID penelepon yang digunakan untuk melakukan panggilan ini. Nomor 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 saat konversi terjadi. Formatnya adalah "yyyy-mm-dd hh:mm:ss+|-hh:mm", misalnya, "2019-01-01 12:32:45-08:00". |