UserData

Nutzerdaten mit Nutzerkennungen und -attributen.

JSON-Darstellung 
{
  "userIdentifiers": [
    {
      object (UserIdentifier)
    }
  ],
  "transactionAttribute": {
    object (TransactionAttribute)
  },
  "userAttribute": {
    object (UserAttribute)
  },
  "consent": {
    object (Consent)
  }
}
Felder
userIdentifiers[]

object (UserIdentifier)

Identifizierungsdaten des Nutzers. Erforderlich.
transactionAttribute

object (TransactionAttribute)

Zusätzliche Transaktionen/Attribute, die mit dem Nutzer verknüpft sind. Erforderlich, wenn Daten zu Ladenverkäufen aktualisiert werden.
userAttribute

object (UserAttribute)

Zusätzliche Attribute, die dem Nutzer zugeordnet sind. Erforderlich, wenn Attribute zum Kundenabgleich aktualisiert werden. Sie laufen nach 540 Tagen ab.
consent

object (Consent)

Die Einwilligungseinstellung für den Nutzer. Beim Kundenabgleich wird dieses Feld ignoriert und es wird eine Warnung zurückgegeben.

TransactionAttribute

Attribut der Transaktion vom Typ „Ladenverkäufe“.

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

object (StoreAttribute)

Speichert Attribute der Transaktion. Nur für Kunden auf der Zulassungsliste zugänglich.
itemAttribute

object (ItemAttribute)

Artikelattribute der Transaktion.
transactionDateTime

string

Zeitstempel der Transaktion. Erforderlich. Das Format ist „JJJJ-MM-TT HH:MM:SS[+/-HH:MM]“, wobei [+/-HH:MM] ein optionaler Zeitzonenunterschied zur UTC ist. Wenn kein Offset vorhanden ist, verwendet die API standardmäßig die Zeitzone des Kontos. Beispiele: „2018-03-05 09:15:00“ oder „2018-02-01 14:34:30+03:00“
transactionAmountMicros

number

Transaktionsbetrag in Mikros. Erforderlich. Der Transaktionsbetrag in Mikros muss größer als 1.000 sein. Wenn Artikelattribute angegeben werden, stellt dies den Gesamtwert der Artikel dar, nachdem der Preis pro Artikel mit der in „ItemAttributes“ angegebenen Menge multipliziert wurde.
currencyCode

string

Währungscode der Transaktion. Es wird der dreistellige ISO 4217-Code verwendet. Erforderlich.
conversionAction

string

Der Ressourcenname der Conversion-Aktion, für die Conversions erfasst werden sollen. Erforderlich.
orderId

string

Auftrags-ID der Transaktion. Nur für Kunden auf der Zulassungsliste zugänglich.
customValue

string

Wert der benutzerdefinierten Variablen für jede Transaktion. Nur für Kunden auf der Zulassungsliste zugänglich.

StoreAttribute

Speichert Attribute der Transaktion.

JSON-Darstellung 
{
  "storeCode": string
}
Felder
storeCode

string

Geschäftscode von https://support.google.com/business/answer/3370250#storecode

ItemAttribute

Artikelattribute der Transaktion.

JSON-Darstellung 
{
  "itemId": string,
  "countryCode": string,
  "languageCode": string,
  "quantity": string,
  "merchantId": string
}
Felder
itemId

string

Eine eindeutige Kennzeichnung eines Produkts. Es kann sich dabei um die Merchant Center-Artikel-ID oder die GTIN (Global Trade Item Number) handeln.
countryCode

string

CLDR-Gebietscode (Common Locale Data Repository) des Landes, das mit dem Feed verknüpft ist, in den Ihre Artikel hochgeladen werden. Weitere Informationen finden Sie unter https://developers.google.com/google-ads/api/reference/data/codes-formats#country-codes.
languageCode

string

ISO 639-1-Code der Sprache, die dem Feed zugeordnet ist, in den Ihre Artikel hochgeladen werden
quantity

string (int64 format)

Die Anzahl der verkauften Artikel. Wenn kein Wert festgelegt ist, wird der Standardwert 1 verwendet.
merchantId

string (int64 format)

ID des Merchant Center-Kontos

UserAttribute

Nutzerattribut, kann nur mit der Art der Dienstleistung CUSTOMER_MATCH_WITH_ATTRIBUTES verwendet werden.

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

string

Zeitstempel des letzten Kaufs des Nutzers. Das Format ist JJJJ-MM-TT HH:MM:SS[+/-HH:MM], wobei [+/-HH:MM] ein optionaler Zeitzonenversatz zur UTC ist. Wenn kein Offset vorhanden ist, verwendet die API standardmäßig die Zeitzone des Kontos.
averagePurchaseCount

integer

Der Werbetreibende legt die durchschnittliche Anzahl der Käufe fest, die der Nutzer in einem Zeitraum von 30 Tagen tätigt.
averagePurchaseValueMicros

string (int64 format)

Der Werbetreibende hat den durchschnittlichen Kaufwert für den Nutzer in Mikros definiert.
acquisitionDateTime

string

Zeitstempel für den Zeitpunkt, zu dem der Nutzer akquiriert wurde. Das Format ist JJJJ-MM-TT HH:MM:SS[+/-HH:MM], wobei [+/-HH:MM] ein optionaler Zeitzonenversatz zur UTC ist. Wenn kein Offset vorhanden ist, verwendet die API standardmäßig die Zeitzone des Kontos.
lifecycleStage

string

Optional. Der Werbetreibende hat die Lebenszyklusphase für den Nutzer festgelegt. Zulässige Werte sind „Lead“, „Aktiv“ und „Abgewandert“.
firstPurchaseDateTime

string

Optional. Zeitstempel des ersten Kaufs des Nutzers. Das Format ist JJJJ-MM-TT HH:MM:SS[+/-HH:MM], wobei [+/-HH:MM] ein optionaler Zeitzonenversatz zur UTC ist. Wenn kein Offset vorhanden ist, verwendet die API standardmäßig die Zeitzone des Kontos.
eventAttribute[]

object (EventAttribute)

Optional. Vom Werbetreibenden definierte Ereignisse und deren Attribute. Alle Werte in den verschachtelten Feldern sind erforderlich. Dieses Feld befindet sich derzeit in der Betaphase.
lifetimeValueMicros

string (int64 format)

Der Werbetreibende hat den Lifetime-Wert für den Nutzer definiert.
lifetimeValueBucket

integer

Der Werbetreibende hat die Lifetime-Wert-Gruppe für den Nutzer definiert. Der gültige Bereich für eine Lifetime-Wert-Gruppe liegt zwischen 1 (niedrig) und 10 (hoch). Eine Ausnahme bildet der Entfernungsvorgang, bei dem 0 ebenfalls akzeptiert wird.
shoppingLoyalty

object (ShoppingLoyalty)

Die Daten zur Shopping-Treue. Google Shopping nutzt diese Daten, um Nutzern ein besseres Erlebnis zu bieten. Nur für Händler auf der Zulassungsliste mit Einwilligung des Nutzers zugänglich.

ShoppingLoyalty

Die Daten zur Shopping-Treue. Google Shopping nutzt diese Daten, um Nutzern ein besseres Erlebnis zu bieten. Nur für Händler auf der Zulassungsliste zugänglich.

JSON-Darstellung 
{
  "loyaltyTier": string
}
Felder
loyaltyTier

string

Die Mitgliedschaftsstufe. Es handelt sich um einen kostenlosen String, da jeder Händler sein eigenes Treuepunktesystem haben kann. Dies kann beispielsweise eine Zahl von 1 bis 10, ein String wie „Golden“ oder „Silber“ oder auch ein leerer String „“ sein.

EventAttribute

Vom Werbetreibenden definierte Ereignisse und deren Attribute. Alle Werte in den verschachtelten Feldern sind erforderlich.

JSON-Darstellung 
{
  "event": string,
  "eventDateTime": string,
  "itemAttribute": [
    {
      object (EventItemAttribute)
    }
  ]
}
Felder
event

string

Erforderlich. Vom Werbetreibenden definiertes Ereignis, das für das Remarketing verwendet werden soll. Zulässige Werte sind „Angesehen“, „Einkaufswagen“, „Gekauft“ und „Empfohlen“.
eventDateTime

string

Erforderlich. Zeitstempel, zu dem das Ereignis aufgetreten ist. Das Format ist JJJJ-MM-TT HH:MM:SS[+/-HH:MM], wobei [+/-HH:MM] ein optionaler Zeitzonenversatz zur UTC ist. Wenn kein Offset vorhanden ist, verwendet die API standardmäßig die Zeitzone des Kontos.
itemAttribute[]

object (EventItemAttribute)

Erforderlich. Artikelattribute des Ereignisses.

EventItemAttribute

Ereignisartikelattribute des Kundenabgleichs

JSON-Darstellung 
{
  "itemId": string
}
Felder
itemId

string

Optional. Eine eindeutige Kennzeichnung eines Produkts. Es kann sich dabei um die Merchant Center-Artikel-ID oder die GTIN (Global Trade Item Number) handeln.