UserData

Kullanıcı tanımlayıcılarını ve özelliklerini tutan kullanıcı verileri.

JSON gösterimi
{
  "userIdentifiers": [
    {
      object (UserIdentifier)
    }
  ],
  "transactionAttribute": {
    object (TransactionAttribute)
  },
  "userAttribute": {
    object (UserAttribute)
  },
  "consent": {
    object (Consent)
  }
}
Alanlar
userIdentifiers[]

object (UserIdentifier)

Kullanıcı tanımlama bilgileri. Zorunlu.

transactionAttribute

object (TransactionAttribute)

Kullanıcıyla ilişkili ek işlemler/özellikler. Mağaza satış verileri güncellenirken gereklidir.

userAttribute

object (UserAttribute)

Kullanıcıyla ilişkili ek özellikler. Müşteri eşleştirme özellikleri güncellenirken zorunludur. Bunların geçerlilik süresi 540 gündür.

consent

object (Consent)

Kullanıcıyla ilgili izin ayarı. Müşteri Eşleştirme bu alanı yoksayar ve bir uyarı döndürür.

TransactionAttribute

Mağaza satışları işleminin özelliği.

JSON gösterimi
{
  "storeAttribute": {
    object (StoreAttribute)
  },
  "itemAttribute": {
    object (ItemAttribute)
  },
  "transactionDateTime": string,
  "transactionAmountMicros": number,
  "currencyCode": string,
  "conversionAction": string,
  "orderId": string,
  "customValue": string
}
Alanlar
storeAttribute

object (StoreAttribute)

İşlemin özelliklerini saklar. Yalnızca izin verilenler listesindeki müşteriler erişebilir.

itemAttribute

object (ItemAttribute)

İşlemin öğe özellikleri.

transactionDateTime

string

İşlemin gerçekleştiği zaman damgası. Zorunlu. Biçim "YYYY-AA-GG SS:DD:SS[+/-SS:DD]" şeklindedir. Burada [+/-SS:DD], UTC ile olan isteğe bağlı saat dilimi farkını ifade eder. Ofset eksikse API, varsayılan olarak hesabın saat dilimini kullanır. Örnekler: "2018-03-05 09:15:00" veya "2018-02-01 14:34:30+03:00"

transactionAmountMicros

number

Mikro cinsinden işlem tutarı. Zorunlu. İşlem tutarının mikro cinsinden 1.000'den büyük olması gerekir. Öğe Özellikleri sağlanmışsa öğe başına birim fiyat ile ItemAttributes'te sağlanan miktar çarpıldıktan sonra öğelerin toplam değerini gösterir.

currencyCode

string

İşlem para birimi kodu. ISO 4217 standardına uygun üç harfli kod kullanılır. Zorunlu.

conversionAction

string

Dönüşümlerin raporlanacağı dönüşüm işleminin kaynak adı. Zorunlu.

orderId

string

İşlem sipariş kimliği. Yalnızca izin verilenler listesindeki müşteriler erişebilir.

customValue

string

Her işlem için özelleştirilebilen değişkenin değeri. Yalnızca izin verilenler listesindeki müşteriler erişebilir.

StoreAttribute

İşlemin özelliklerini saklar.

JSON gösterimi
{
  "storeCode": string
}
Alanlar
storeCode

string

https://support.google.com/business/answer/3370250#storecode adresinden mağaza kodu

ItemAttribute

İşlemin öğe özellikleri.

JSON gösterimi
{
  "itemId": string,
  "countryCode": string,
  "languageCode": string,
  "quantity": string,
  "merchantId": string
}
Alanlar
itemId

string

Bir ürünün benzersiz tanımlayıcısı. Merchant Center Öğe Kimliği veya GTIN (Global Ticari Öğe Numarası) olabilir.

countryCode

string

Öğelerinizin yüklendiği feed ile ilişkili ülkenin Ortak Yerel Veri Deposu (CLDR) bölge kodu. Daha fazla bilgiyi https://developers.google.com/google-ads/api/reference/data/codes-formats#country-codes adresinde bulabilirsiniz.

languageCode

string

Öğelerinizin yüklendiği feed ile ilişkili dilin ISO 639-1 kodu

quantity

string (int64 format)

Satılan öğelerin sayısı. Ayarlanmamışsa varsayılan olarak 1'dir.

merchantId

string (int64 format)

Merchant Center Hesabının Kimliği.

UserAttribute

Kullanıcı özelliği, yalnızca CUSTOMER_MATCH_WITH_ATTRIBUTES iş türüyle kullanılabilir.

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

string

Kullanıcının gerçekleştirdiği son satın alma işleminin zaman damgası. YYYY-AA-GG SS:DD:SS[+/-SS:DD] şeklindedir. Burada [+/-SS:DD], UTC ile olan isteğe bağlı saat dilimi farkını ifade eder. Ofset eksikse API, varsayılan olarak hesabın saat dilimini kullanır.

averagePurchaseCount

integer

Reklamveren tarafından tanımlanan, 30 günlük süre içinde kullanıcı tarafından yapılan satın alma işlemlerinin ortalama sayısı.

averagePurchaseValueMicros

string (int64 format)

Reklamveren, kullanıcı için mikro olarak ortalama satın alma değerini tanımladı.

acquisitionDateTime

string

Kullanıcının edinildiği zaman damgası. YYYY-AA-GG SS:DD:SS[+/-SS:DD] şeklindedir. Burada [+/-SS:DD], UTC ile olan isteğe bağlı saat dilimi farkını ifade eder. Ofset eksikse API, varsayılan olarak hesabın saat dilimini kullanır.

lifecycleStage

string

İsteğe bağlı. Reklamveren tarafından, kullanıcının yaşam döngüsü aşaması. Kabul edilen değerler "Potansiyel Müşteri", "Etkin" ve "Ayrıldı" şeklindedir.

firstPurchaseDateTime

string

İsteğe bağlı. Kullanıcının gerçekleştirdiği ilk satın alma işleminin zaman damgası. YYYY-AA-GG SS:DD:SS[+/-SS:DD] şeklindedir. Burada [+/-SS:DD], UTC ile olan isteğe bağlı saat dilimi farkını ifade eder. Ofset eksikse API, varsayılan olarak hesabın saat dilimini kullanır.

eventAttribute[]

object (EventAttribute)

İsteğe bağlı. Reklamveren tarafından tanımlanan etkinlikler ve bunların özellikleri. İç içe yerleştirilmiş alanlardaki tüm değerler gereklidir. Bu alan şu anda beta sürümündedir.

lifetimeValueMicros

string (int64 format)

Kullanıcı için reklamveren tarafından tanımlanmış yaşam boyu değer.

lifetimeValueBucket

integer

Kullanıcı için reklamveren tanımlı yaşam boyu değer grubu. Yaşam boyu değer paketi için geçerli aralık 1 (düşük) ile 10 (yüksek) arasındadır. 0'ın da kabul edildiği kaldırma işlemi hariçtir.

shoppingLoyalty

object (ShoppingLoyalty)

Alışveriş sadakatiyle ilgili veriler. Alışveriş, kullanıcılara daha iyi bir deneyim sunmak için bu verilerden yararlanır. Yalnızca kullanıcının izniyle izin verilenler listesindeki satıcılar erişebilir.

ShoppingLoyalty

Alışveriş sadakatiyle ilgili veriler. Alışveriş, kullanıcılara daha iyi bir deneyim sunmak için bu verilerden yararlanır. Yalnızca izin verilenler listesindeki satıcılara erişebilir.

JSON gösterimi
{
  "loyaltyTier": string
}
Alanlar
loyaltyTier

string

Üyelik katmanı. Her satıcının kendi bağlılık sistemi olabileceği için serbest biçimli bir dizedir. Örneğin, 1 ile 10 arasında bir sayı, "Altın" veya "Gümüş" gibi bir dize ve hatta "" boş bir dize olabilir.

EventAttribute

Reklamveren tarafından tanımlanan etkinlikler ve bunların özellikleri. İç içe yerleştirilmiş alanlardaki tüm değerler gereklidir.

JSON gösterimi
{
  "event": string,
  "eventDateTime": string,
  "itemAttribute": [
    {
      object (EventItemAttribute)
    }
  ]
}
Alanlar
event

string

Zorunlu. Yeniden pazarlama için kullanılacak, reklamveren tarafından tanımlanmış etkinlik. Kabul edilen değerler "Görüntülendi", "Alışveriş sepeti", "Satın alındı" ve "Önerilen" değerleridir.

eventDateTime

string

Zorunlu. Etkinliğin gerçekleştiği zaman damgası. YYYY-AA-GG SS:DD:SS[+/-SS:DD] şeklindedir. Burada [+/-SS:DD], UTC ile olan isteğe bağlı saat dilimi farkını ifade eder. Ofset eksikse API, varsayılan olarak hesabın saat dilimini kullanır.

itemAttribute[]

object (EventItemAttribute)

Zorunlu. Etkinliğin öğe özellikleri.

EventItemAttribute

Müşteri Eşleştirme'nin Etkinlik Öğesi özellikleri.

JSON gösterimi
{
  "itemId": string
}
Alanlar
itemId

string

İsteğe bağlı. Bir ürünün benzersiz tanımlayıcısı. Merchant Center Öğe Kimliği veya GTIN (Global Ticari Öğe Numarası) olabilir.