- Permintaan HTTP
- Parameter lokasi
- Isi permintaan
- Isi respons
- Cakupan otorisasi
- ConversionAdjustment
- GclidDateTimePair
- ConversionAdjustmentType
- RestatementValue
- ConversionAdjustmentResult
- Cobalah!
Memproses penyesuaian konversi tertentu.
Daftar error yang ditampilkan: AuthenticationError AuthorizationError HeaderError InternalError PartialFailureError QuotaError RequestError
Permintaan HTTP
POST https://googleads.googleapis.com/v15/customers/{customerId}:uploadConversionAdjustments
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 |
---|
{
"conversionAdjustments": [
{
object ( |
Kolom | |
---|---|
conversionAdjustments[] |
Wajib. Penyesuaian 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. |
jobId |
Opsional. Input opsional untuk menetapkan ID tugas. Harus berupa angka non-negatif yang kurang dari 2^31 jika disediakan. Jika kolom ini tidak disediakan, API akan menghasilkan ID pekerjaan dalam rentang [2^31, (2^63)-1]. API akan menampilkan nilai untuk permintaan ini di kolom |
Isi respons
Pesan respons untuk ConversionAdjustmentUploadService.UploadConversionAdjustments
.
Jika berhasil, isi respons memuat data dengan struktur berikut:
Representasi JSON |
---|
{ "partialFailureError": { object ( |
Kolom | |
---|---|
partialFailureError |
Error yang berkaitan dengan kegagalan penyesuaian konversi dalam mode kegagalan sebagian. Ditampilkan saat semua error terjadi dalam penyesuaian. Jika terjadi error di luar penyesuaian (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 penyesuaian konversi yang berhasil diproses. Proto akan kosong untuk baris yang menerima error. Hasil tidak ditampilkan jika validasiOnly benar. |
jobId |
ID tugas untuk batch upload. |
Cakupan otorisasi
Memerlukan cakupan OAuth berikut ini:
https://www.googleapis.com/auth/adwords
Untuk informasi selengkapnya, lihat Ringkasan OAuth 2.0.
ConversionAdjustment
Penyesuaian konversi.
Representasi JSON |
---|
{ "gclidDateTimePair": { object ( |
Kolom | |
---|---|
gclidDateTimePair |
Untuk penyesuaian, secara unik mengidentifikasi konversi yang dilaporkan tanpa ID pesanan yang ditentukan. Jika adjustmentType adalah ENHANCEMENT, nilai ini bersifat opsional, tetapi dapat ditetapkan selain orderId. |
adjustmentType |
Jenis penyesuaian. |
restatementValue |
Informasi yang diperlukan untuk menyatakan ulang nilai konversi. Diperlukan untuk pernyataan ulang. Seharusnya tidak diberikan untuk pencabutan. Error akan ditampilkan jika disediakan untuk pencabutan. CATATAN: Jika Anda ingin mengupload pernyataan ulang kedua dengan nilai yang disesuaikan yang berbeda, nilai tersebut harus memiliki waktu terjadinya penyesuaian yang baru dan lebih baru. Jika tidak, data akan diperlakukan sebagai duplikat dari pernyataan ulang sebelumnya dan diabaikan. |
userIdentifiers[] |
ID pengguna untuk meningkatkan konversi asli. ConversionAdjustmentUploadService hanya menerima ID pengguna dalam penyempurnaan. Jumlah maksimum ID pengguna untuk setiap peningkatan adalah 5. |
orderId |
ID pesanan konversi yang akan disesuaikan. Jika konversi dilaporkan dengan ID pesanan yang ditentukan, ID pesanan tersebut harus digunakan sebagai ID di sini. ID pesanan diperlukan untuk peningkatan. |
conversionAction |
Nama resource tindakan konversi yang terkait dengan penyesuaian 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. |
adjustmentDateTime |
Tanggal saat penyesuaian terjadi. Harus setelah conversionDateTime. Zona waktu harus ditentukan. Formatnya adalah "yyyy-mm-dd hh:mm:ss+|-hh:mm", misalnya, "2019-01-01 12:32:45-08:00". |
userAgent |
Agen pengguna untuk meningkatkan konversi asli. Hal ini dapat ditemukan di header permintaan HTTP pengguna saat mereka melakukan konversi di halaman web Anda. Misalnya, "Mozilla/5.0 (iPhone; CPU iPhone OS 12_2 like Mac OS X)". Agen pengguna hanya dapat ditentukan dalam penyempurnaan dengan ID pengguna. ID ini harus cocok dengan agen pengguna permintaan yang mengirim konversi asli sehingga konversi dan peningkatannya dapat diatribusikan sebagai perangkat yang sama atau keduanya diatribusikan sebagai lintas-perangkat. |
GclidDateTimePair
Secara unik mengidentifikasi konversi yang dilaporkan tanpa ID pesanan yang ditentukan.
Representasi JSON |
---|
{ "gclid": string, "conversionDateTime": string } |
Kolom | |
---|---|
gclid |
ID klik Google (gclid) yang dikaitkan dengan konversi asli untuk penyesuaian ini. |
conversionDateTime |
Tanggal saat konversi asli untuk penyesuaian ini terjadi. Zona waktu harus ditentukan. Formatnya adalah "yyyy-mm-dd hh:mm:ss+|-hh:mm", misalnya, "2019-01-01 12:32:45-08:00". |
ConversionAdjustmentType
Berbagai tindakan yang dapat dilakukan pengiklan untuk menyesuaikan konversi yang telah mereka laporkan. Pembatalan akan meniadakan konversi. Perubahan konversi mengubah nilai konversi.
Enum | |
---|---|
UNSPECIFIED |
Tidak ditentukan. |
UNKNOWN |
Mewakili nilai yang tidak diketahui pada versi ini. |
RETRACTION |
Menegasi konversi sehingga nilai total dan jumlahnya nol. |
RESTATEMENT |
Mengubah nilai konversi. |
ENHANCEMENT |
Melengkapi konversi yang ada dengan ID pengguna dan agen pengguna yang diberikan, yang dapat digunakan oleh Google untuk meningkatkan jumlah konversi. |
RestatementValue
Berisi informasi yang diperlukan untuk menyatakan ulang nilai konversi.
Representasi JSON |
---|
{ "adjustedValue": number, "currencyCode": string } |
Kolom | |
---|---|
adjustedValue |
Nilai konversi yang dinyatakan ulang. Ini adalah nilai konversi setelah pernyataan ulang. Misalnya, untuk mengubah nilai konversi dari 100 menjadi 70, nilai yang disesuaikan sebesar 70 harus dilaporkan. CATATAN: Jika Anda ingin mengupload pernyataan ulang kedua dengan nilai yang disesuaikan yang berbeda, nilai tersebut harus memiliki waktu terjadinya penyesuaian yang baru dan lebih baru. Jika tidak, data akan diperlakukan sebagai duplikat dari pernyataan ulang sebelumnya dan diabaikan. |
currencyCode |
Mata uang dari nilai yang dinyatakan kembali. Jika tidak diberikan, mata uang default dari tindakan konversi akan digunakan. Jika tidak ditetapkan, mata uang akun akan digunakan. Ini adalah kode mata uang 3 karakter ISO 4217, misalnya, USD atau EUR. |
ConversionAdjustmentResult
Informasi yang mengidentifikasi ConversionPenyesuaian yang berhasil diproses.
Representasi JSON |
---|
{ "gclidDateTimePair": { object ( |
Kolom | |
---|---|
gclidDateTimePair |
Waktu gclid dan tanggal konversi konversi. |
orderId |
ID pesanan konversi yang akan disesuaikan. |
adjustmentType |
Jenis penyesuaian. |
conversionAction |
Nama resource tindakan konversi yang terkait dengan penyesuaian konversi ini. |
adjustmentDateTime |
Tanggal saat penyesuaian terjadi. Formatnya adalah "yyyy-mm-dd hh:mm:ss+|-hh:mm", misalnya, "2019-01-01 12:32:45-08:00". |