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/v16/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,
  "jobId": integer
}
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 (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.
jobId

integer

Opsional. Input opsional untuk menetapkan ID tugas. Harus berupa angka yang tidak negatif yang kurang dari 2^31 jika diberikan. Jika kolom ini tidak disediakan, API akan menghasilkan ID pekerjaan dalam rentang [2^31, (2^63)-1]. API akan menampilkan nilai untuk permintaan ini dalam kolom jobId dari UploadConversionAdjustmentsResponse.

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 mengalami error. Hasil tidak ditampilkan jika validationOnly bernilai true (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, mengidentifikasi konversi yang dilaporkan secara unik tanpa ID pesanan yang ditentukan. Jika penyesuaianType adalah PENINGKATAN, nilai ini bersifat opsional, tetapi dapat ditetapkan selain orderId.
adjustmentType

enum (ConversionAdjustmentType)

Jenis penyesuaian.
restatementValue

object (RestatementValue)

Informasi yang diperlukan untuk menyatakan kembali nilai konversi. Diperlukan untuk pernyataan ulang. Tidak boleh diberikan untuk pencabutan klaim. Error akan ditampilkan jika disediakan untuk pencabutan. CATATAN: Jika Anda ingin mengupload pernyataan ulang kedua dengan nilai penyesuaian yang berbeda, waktu terjadinya penyesuaian harus lebih baru dan lebih baru. Jika tidak, pernyataan ini akan diperlakukan sebagai duplikat dari pernyataan ulang sebelumnya dan diabaikan.
userIdentifiers[]

object (UserIdentifier)

ID pengguna untuk meningkatkan kualitas konversi asli. ConversionPenyesuaianUploadService 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 satu-satunya ID tindakan konversi.
adjustmentDateTime

string

Tanggal waktu saat penyesuaian dilakukan. 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. Ini dapat ditemukan di header permintaan HTTP pengguna saat mereka melakukan konversi di halaman Anda. Misalnya, "Mozilla/5.0 (iPhone; CPU iPhone OS 12_2 like Mac OS X)". Agen pengguna hanya dapat disebutkan dalam penyempurnaan dengan ID pengguna. Nama ini harus cocok dengan agen pengguna permintaan yang mengirim konversi asli, sehingga konversi dan penyempurnaannya 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 terkait dengan konversi asli untuk penyesuaian ini.
conversionDateTime

string

Tanggal saat konversi awal 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 membatalkan konversi. Perubahan konversi mengubah nilai konversi.

Enum
UNSPECIFIED Tidak ditentukan.
UNKNOWN Mewakili nilai yang tidak diketahui dalam versi ini.
RETRACTION Menegasikan 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 disajikan kembali. 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 penyesuaian yang berbeda, waktu terjadinya penyesuaian harus lebih baru dan lebih baru. Jika tidak, pernyataan ini akan diperlakukan sebagai duplikat dari pernyataan ulang sebelumnya dan diabaikan.
currencyCode

string

Mata uang dari nilai yang disajikan kembali. Jika tidak diberikan, mata uang default dari tindakan konversi akan digunakan, dan jika mata uang akun tidak ditetapkan, mata uang akun akan digunakan. Ini adalah kode mata uang 3 karakter ISO 4217, misalnya, USD atau EUR.

ConversionAdjustmentResult

Informasi yang mengidentifikasi ConversionAdjustment yang berhasil diproses.

Representasi JSON 
{
  "gclidDateTimePair": {
    object (GclidDateTimePair)
  },
  "orderId": string,
  "adjustmentType": enum (ConversionAdjustmentType),
  "conversionAction": string,
  "adjustmentDateTime": string
}
Kolom
gclidDateTimePair

object (GclidDateTimePair)

GCLID dan waktu 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 waktu saat penyesuaian dilakukan. Formatnya adalah "yyyy-mm-dd hh:mm:ss+|-hh:mm", misalnya, "2019-01-01 12:32:45-08:00".