UserData

Kullanıcı tanımlayıcılarını ve özelliklerini barındıran kullanıcı verileri.

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

object (UserIdentifier)

Kullanıcı kimlik 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şkilendirilen ek özellikler. Müşteri eşleştirme özellikleri güncellenirken zorunludur. Bu kodların geçerlilik süresi 540 gündür.

TransactionAttribute

Mağaza satışı 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 mağaza özellikleri. 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 arasındaki 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 "01-02-2018 14:34:30+03:00"

transactionAmountMicros

number

Mikro cinsinden işlem tutarı. Zorunlu. Mikro cinsinden işlem tutarı 1.000'den büyük olmalıdır. Öğe Özellikleri sağlanırsa öğe başına birim fiyat, ItemAttributes özelliğinde sağlanan miktarla çarpıldıktan sonra bu özelliklerin toplam değerini gösterir.

currencyCode

string

İşlem para birimi kodu. ISO 4217 standartları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şi 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 mağaza özellikleri.

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

string

https://support.google.com/business/answer/3370250#storecode adresindeki 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ıdır. 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 Ayar Veri Deposu (CLDR) bölge kodu. Daha fazla bilgi için https://developers.google.com/google-ads/api/reference/data/codes-formats#country-codes adresini ziyaret edin.

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 değeri 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ı. Biçim YYYY-AA-GG SS:DD:SS[+/-SS:DD] şeklindedir. Burada [+/-SS:DD], UTC'ye göre isteğe bağlı bir saat dilimi farkını ifade eder. Ofset eksikse API, varsayılan olarak hesabın saat dilimini kullanır.

averagePurchaseCount

integer

Reklamveren, 30 günlük süre içinde kullanıcının yaptığı ortalama satın alma işlemi sayısını tanımlamıştır.

averagePurchaseValueMicros

string (int64 format)

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

acquisitionDateTime

string

Kullanıcının edinildiği zaman damgası. Biçim YYYY-AA-GG SS:DD:SS[+/-SS:DD] şeklindedir. Burada [+/-SS:DD], UTC'ye göre isteğe bağlı bir 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, kullanıcının yaşam döngüsü aşamasını tanımlamıştır. Kabul edilen değerler "Potansiyel müşteri", "Etkin" ve "Ayrıldı" şeklindedir.

firstPurchaseDateTime

string

İsteğe bağlı. Kullanıcı tarafından gerçekleştirilen ilk satın alma işleminin zaman damgası. Biçim YYYY-AA-GG SS:DD:SS[+/-SS:DD] şeklindedir. Burada [+/-SS:DD], UTC'ye göre isteğe bağlı bir 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 zorunludur. 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 verileri kullanır. Yalnızca kullanıcının izniyle izin verilenler listesindeki satıcılar tarafından erişilebilir.

ShoppingLoyalty

Alışveriş sadakatiyle ilgili veriler. Alışveriş, kullanıcılara daha iyi bir deneyim sunmak için bu verileri kullanır. Yalnızca izin verilenler listesindeki satıcılar tarafından erişilebilir.

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 bu 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 zorunludur.

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

string

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

eventDateTime

string

Zorunlu. Etkinliğin gerçekleştiği zaman damgası. Biçim YYYY-AA-GG SS:DD:SS[+/-SS:DD] şeklindedir. Burada [+/-SS:DD], UTC'ye göre isteğe bağlı bir 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ıdır. Merchant Center Öğe Kimliği veya GTIN (Global Ticari Öğe Numarası) olabilir.