Method: customers.uploadConversionAdjustments

Memproses penyesuaian konversi tertentu.

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

Permintaan HTTP

POST https://googleads.googleapis.com/v14/customers/{customerId}:uploadConversionAdjustments

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 
{
  "conversionAdjustments": [
    {
      object (ConversionAdjustment)
    }
  ],
  "partialFailure": boolean,
  "validateOnly": boolean
}
Kolom
conversionAdjustments[]

object (ConversionAdjustment)

Wajib. Penyesuaian 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, 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 akan divalidasi tetapi tidak dieksekusi. Hanya error yang ditampilkan, bukan hasil.

Isi respons

Pesan respons untuk ConversionAdjustmentUploadService.UploadConversionAdjustments.

Jika berhasil, isi respons memuat data dengan struktur berikut:

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

object (Status)

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[]

object (ConversionAdjustmentResult)

Ditampilkan untuk penyesuaian konversi yang berhasil diproses. Proto akan kosong untuk baris yang menerima error. Hasil tidak ditampilkan jika validasiOnly benar.
jobId

string (int64 format)

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 (GclidDateTimePair)
  },
  "adjustmentType": enum (ConversionAdjustmentType),
  "restatementValue": {
    object (RestatementValue)
  },
  "userIdentifiers": [
    {
      object (UserIdentifier)
    }
  ],
  "orderId": string,
  "conversionAction": string,
  "adjustmentDateTime": string,
  "userAgent": string
}
Kolom
gclidDateTimePair

object (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

enum (ConversionAdjustmentType)

Jenis penyesuaian.
restatementValue

object (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[]

object (UserIdentifier)

ID pengguna untuk meningkatkan konversi asli. ConversionAdjustmentUploadService hanya menerima ID pengguna dalam penyempurnaan. Jumlah maksimum ID pengguna untuk setiap peningkatan adalah 5.
orderId

string

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

string

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

string

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

string

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

string

ID klik Google (gclid) yang dikaitkan dengan konversi asli untuk penyesuaian ini.
conversionDateTime

string

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

number

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

string

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 (GclidDateTimePair)
  },
  "orderId": string,
  "adjustmentType": enum (ConversionAdjustmentType),
  "conversionAction": string,
  "adjustmentDateTime": string
}
Kolom
gclidDateTimePair

object (GclidDateTimePair)

Waktu gclid dan tanggal konversi konversi.
orderId

string

ID pesanan konversi yang akan disesuaikan.
adjustmentType

enum (ConversionAdjustmentType)

Jenis penyesuaian.
conversionAction

string

Nama resource tindakan konversi yang terkait dengan penyesuaian konversi ini.
adjustmentDateTime

string

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