UserData

Data pengguna yang berisi ID dan atribut pengguna.

Representasi JSON 
{
  "userIdentifiers": [
    {
      object (UserIdentifier)
    }
  ],
  "transactionAttribute": {
    object (TransactionAttribute)
  },
  "userAttribute": {
    object (UserAttribute)
  }
}
Kolom
userIdentifiers[]

object (UserIdentifier)

Info identifikasi pengguna. Wajib diisi.
transactionAttribute

object (TransactionAttribute)

Transaksi/atribut tambahan yang terkait dengan pengguna. Wajib saat memperbarui data penjualan toko.
userAttribute

object (UserAttribute)

Atribut tambahan yang terkait dengan pengguna. Wajib saat memperbarui atribut Customer Match. Tanggal habis masa berlaku adalah 540 hari.

TransactionAttribute

Atribut transaksi penjualan toko.

Representasi JSON 
{
  "storeAttribute": {
    object (StoreAttribute)
  },
  "itemAttribute": {
    object (ItemAttribute)
  },
  "transactionDateTime": string,
  "transactionAmountMicros": number,
  "currencyCode": string,
  "conversionAction": string,
  "orderId": string,
  "customValue": string
}
Kolom
storeAttribute

object (StoreAttribute)

Atribut toko transaksi. Hanya dapat diakses oleh pelanggan dalam daftar yang diizinkan.
itemAttribute

object (ItemAttribute)

Atribut item transaksi.
transactionDateTime

string

Stempel waktu saat transaksi terjadi. Wajib. Formatnya adalah "YYYY-MM-DD HH:MM:SS[+/-HH:MM]", dengan [+/-HH:MM] adalah offset zona waktu opsional dari UTC. Jika offset tidak ada, API akan menggunakan zona waktu akun sebagai default. Contoh: "2018-03-05 09:15:00" atau "2018-02-01 14:34:30+03:00"
transactionAmountMicros

number

Jumlah transaksi dalam mikro. Wajib. Jumlah transaksi dalam mikro harus lebih besar dari 1.000. Jika Atribut item disediakan, atribut ini mewakili total nilai item, setelah mengalikan harga satuan per item dengan jumlah yang diberikan di ItemAttributes.
currencyCode

string

Kode mata uang transaksi. Kode tiga huruf ISO 4217 digunakan. Wajib.
conversionAction

string

Nama resource tindakan konversi yang menjadi tujuan pelaporan konversi. Wajib.
orderId

string

ID pesanan transaksi. Hanya dapat diakses oleh pelanggan dalam daftar yang diizinkan.
customValue

string

Nilai variabel khusus untuk setiap transaksi. Hanya dapat diakses oleh pelanggan dalam daftar yang diizinkan.

StoreAttribute

Atribut toko transaksi.

Representasi JSON 
{
  "storeCode": string
}
Kolom
storeCode

string

Kode toko dari https://support.google.com/business/answer/3370250#storecode

ItemAttribute

Atribut item transaksi.

Representasi JSON 
{
  "itemId": string,
  "countryCode": string,
  "languageCode": string,
  "quantity": string,
  "merchantId": string
}
Kolom
itemId

string

ID unik produk. ID ini dapat berupa ID Item Merchant Center atau GTIN (Nomor Barang Perdagangan Global).
countryCode

string

Kode wilayah Umum Repositori Data Lokalitas (CLDR) negara yang terkait dengan feed tempat item diupload. Lihat https://developers.google.com/google-ads/api/reference/data/codes-formats#country-codes untuk informasi selengkapnya.
languageCode

string

Kode ISO 639-1 bahasa yang terkait dengan feed tempat item diupload
quantity

string (int64 format)

Jumlah item yang terjual. Jika tidak ditetapkan, defaultnya adalah 1.
merchantId

string (int64 format)

ID Akun Merchant Center.

UserAttribute

Atribut pengguna, hanya dapat digunakan dengan jenis tugas CUSTOMER_MATCH_WITH_ATTRIBUTES.

Representasi JSON 
{
  "lastPurchaseDateTime": string,
  "averagePurchaseCount": integer,
  "averagePurchaseValueMicros": string,
  "acquisitionDateTime": string,
  "lifecycleStage": string,
  "firstPurchaseDateTime": string,
  "eventAttribute": [
    {
      object (EventAttribute)
    }
  ],
  "lifetimeValueMicros": string,
  "lifetimeValueBucket": integer,
  "shoppingLoyalty": {
    object (ShoppingLoyalty)
  }
}
Kolom
lastPurchaseDateTime

string

Stempel waktu pembelian terakhir yang dilakukan oleh pengguna. Formatnya adalah YYYY-MM-DD HH:MM:SS[+/-HH:MM], dengan [+/-HH:MM] adalah offset zona waktu opsional dari UTC. Jika offset tidak ada, API akan menggunakan zona waktu akun sebagai default.
averagePurchaseCount

integer

Pengiklan menentukan jumlah rata-rata pembelian yang dilakukan oleh pengguna dalam periode 30 hari.
averagePurchaseValueMicros

string (int64 format)

Nilai pembelian rata-rata yang ditentukan pengiklan dalam mikro untuk pengguna.
acquisitionDateTime

string

Stempel waktu saat pengguna diakuisisi. Formatnya adalah YYYY-MM-DD HH:MM:SS[+/-HH:MM], dengan [+/-HH:MM] adalah offset zona waktu opsional dari UTC. Jika offset tidak ada, API akan menggunakan zona waktu akun sebagai default.
lifecycleStage

string

Opsional. Tahap siklus proses yang ditentukan pengiklan untuk pengguna. Nilai yang diterima adalah "Lead", "Active", dan "Churned".
firstPurchaseDateTime

string

Opsional. Stempel waktu pembelian pertama yang dilakukan oleh pengguna. Formatnya adalah YYYY-MM-DD HH:MM:SS[+/-HH:MM], dengan [+/-HH:MM] adalah offset zona waktu opsional dari UTC. Jika offset tidak ada, API akan menggunakan zona waktu akun sebagai default.
eventAttribute[]

object (EventAttribute)

Opsional. Peristiwa yang ditentukan pengiklan dan atributnya. Semua nilai di kolom bertingkat wajib diisi. Saat ini, kolom ini masih dalam versi beta.
lifetimeValueMicros

string (int64 format)

Nilai umur yang ditentukan pengiklan untuk pengguna.
lifetimeValueBucket

integer

Bucket nilai umur yang ditentukan pengiklan untuk pengguna. Rentang yang valid untuk bucket nilai umur adalah dari 1 (rendah) hingga 10 (tinggi), kecuali untuk operasi penghapusan yang juga menerima 0.
shoppingLoyalty

object (ShoppingLoyalty)

Data terkait loyalitas belanja. Shopping menggunakan data ini untuk memberikan pengalaman yang lebih baik kepada pengguna. Hanya dapat diakses oleh penjual dalam daftar yang diizinkan dengan persetujuan pengguna.

ShoppingLoyalty

Data terkait loyalitas belanja. Shopping menggunakan data ini untuk memberikan pengalaman yang lebih baik kepada pengguna. Hanya dapat diakses oleh penjual dalam daftar yang diizinkan.

Representasi JSON 
{
  "loyaltyTier": string
}
Kolom
loyaltyTier

string

Tingkat langganan. String ini adalah string bentuk bebas karena setiap penjual dapat memiliki sistem loyalitas mereka sendiri. Misalnya, bisa berupa angka dari 1 sampai 10, atau string seperti "Golden" atau "Silver", atau bahkan string kosong "".

EventAttribute

Peristiwa yang ditentukan pengiklan dan atributnya. Semua nilai di kolom bertingkat wajib diisi.

Representasi JSON 
{
  "event": string,
  "eventDateTime": string,
  "itemAttribute": [
    {
      object (EventItemAttribute)
    }
  ]
}
Kolom
event

string

Wajib. Peristiwa yang ditentukan pengiklan untuk digunakan dalam pemasaran ulang. Nilai yang diterima adalah "Dilihat", "Keranjang", "Dibeli", dan "Direkomendasikan".
eventDateTime

string

Wajib. Stempel waktu saat peristiwa terjadi. Formatnya adalah YYYY-MM-DD HH:MM:SS[+/-HH:MM], dengan [+/-HH:MM] adalah offset zona waktu opsional dari UTC. Jika offset tidak ada, API akan menggunakan zona waktu akun sebagai default.
itemAttribute[]

object (EventItemAttribute)

Wajib. Atribut item peristiwa.

EventItemAttribute

Atribut Item Peristiwa Customer Match.

Representasi JSON 
{
  "itemId": string
}
Kolom
itemId

string

Opsional. ID unik produk. ID ini dapat berupa ID Item Merchant Center atau GTIN (Nomor Barang Perdagangan Global).