- JSON gösterimi
- TransactionAttribute
- StoreAttribute
- ItemAttribute (Öğe Özelliği)
- UserAttribute
- ShoppingLoyalty
- EventAttribute
- EventItemAttribute
Kullanıcı tanımlayıcılarını ve özelliklerini tutan kullanıcı verileri.
JSON gösterimi |
---|
{ "userIdentifiers": [ { object ( |
Alanlar | |
---|---|
userIdentifiers[] |
Kullanıcı tanımlama bilgileri. Zorunlu. |
transactionAttribute |
Kullanıcıyla ilişkili ek işlemler/özellikler. Mağaza satış verileri güncellenirken gereklidir. |
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 |
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 ( |
Alanlar | |
---|---|
storeAttribute |
İşlemin özelliklerini saklar. Yalnızca izin verilenler listesindeki müşteriler erişebilir. |
itemAttribute |
İşlemin öğe özellikleri. |
transactionDateTime |
İş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 |
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 |
İşlem para birimi kodu. ISO 4217 standardına uygun üç harfli kod kullanılır. Zorunlu. |
conversionAction |
Dönüşümlerin raporlanacağı dönüşüm işleminin kaynak adı. Zorunlu. |
orderId |
İşlem sipariş kimliği. Yalnızca izin verilenler listesindeki müşteriler erişebilir. |
customValue |
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 |
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 |
Bir ürünün benzersiz tanımlayıcısı. Merchant Center Öğe Kimliği veya GTIN (Global Ticari Öğe Numarası) olabilir. |
countryCode |
Öğ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 |
Öğelerinizin yüklendiği feed ile ilişkili dilin ISO 639-1 kodu |
quantity |
Satılan öğelerin sayısı. Ayarlanmamışsa varsayılan olarak 1'dir. |
merchantId |
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 ( |
Alanlar | |
---|---|
lastPurchaseDateTime |
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 |
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 |
Reklamveren, kullanıcı için mikro olarak ortalama satın alma değerini tanımladı. |
acquisitionDateTime |
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 |
İ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 |
İ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[] |
İ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 |
Kullanıcı için reklamveren tarafından tanımlanmış yaşam boyu değer. |
lifetimeValueBucket |
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 |
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 |
Ü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 ( |
Alanlar | |
---|---|
event |
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 |
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[] |
Zorunlu. Etkinliğin öğe özellikleri. |
EventItemAttribute
Müşteri Eşleştirme'nin Etkinlik Öğesi özellikleri.
JSON gösterimi |
---|
{ "itemId": string } |
Alanlar | |
---|---|
itemId |
İ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. |