- JSON gösterimi
- TransactionAttribute
- StoreAttribute
- ItemAttribute
- UserAttribute
- ShoppingLoyalty
- EventAttribute
- EventItemAttribute
Kullanıcı tanımlayıcılarını ve özelliklerini barındıran kullanıcı verileri.
JSON gösterimi |
---|
{ "userIdentifiers": [ { object ( |
Alanlar | |
---|---|
userIdentifiers[] |
Kullanıcı kimlik bilgileri. Zorunlu. |
transactionAttribute |
Kullanıcıyla ilişkili ek işlemler/özellikler. Mağaza satış verileri güncellenirken gereklidir. |
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 ( |
Alanlar | |
---|---|
storeAttribute |
İşlemin mağaza özellikleri. 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 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 |
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 |
İşlem para birimi kodu. ISO 4217 standartlarına uygun üç harfli kod kullanılır. Zorunlu. |
conversionAction |
Dönüşümlerin raporlanacağı dönüşüm işleminin kaynak adı. Zorunlu. |
orderId |
İşlem siparişi 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 mağaza özellikleri.
JSON gösterimi |
---|
{ "storeCode": string } |
Alanlar | |
---|---|
storeCode |
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 |
Bir ürünün benzersiz tanımlayıcısıdır. Merchant Center Öğe Kimliği veya GTIN (Global Ticari Öğe Numarası) olabilir. |
countryCode |
Öğ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 |
Öğelerinizin yüklendiği feed ile ilişkili dilin ISO 639-1 kodu |
quantity |
Satılan öğelerin sayısı. Ayarlanmamışsa varsayılan değeri 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ı. 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 |
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 |
Reklamveren, kullanıcının ortalama satın alma değerini mikro olarak tanımladı. |
acquisitionDateTime |
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 |
İ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 |
İ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[] |
İ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 |
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 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 |
Ü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 ( |
Alanlar | |
---|---|
event |
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 |
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[] |
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ıdır. Merchant Center Öğe Kimliği veya GTIN (Global Ticari Öğe Numarası) olabilir. |