UserData

Nutzerdaten mit Nutzerkennungen und ‐attributen.

JSON-Darstellung 
{
  "userIdentifiers": [
    {
      object (UserIdentifier)
    }
  ],
  "transactionAttribute": {
    object (TransactionAttribute)
  },
  "userAttribute": {
    object (UserAttribute)
  }
}
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. Diese haben eine Gültigkeit von 540 Tagen.

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 Zeitzonenversatz 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 Mikroeinheiten 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 den ItemAttributes angegebenen Menge multipliziert wurde.
currencyCode

string

Währungscode der Transaktion. Es wird ein dreistelliger Code gemäß ISO 4217 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. Dies kann entweder die Merchant Center-Artikel-ID oder die GTIN (Global Trade Item Number) sein.
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 mit dem Feed verknüpft 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 dem Jobtyp 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 durch den Nutzer. 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.
averagePurchaseCount

integer

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

string (int64 format)

Der Werbetreibende legt den durchschnittlichen Kaufwert für den Nutzer in Mikroeinheiten fest.
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 Zeitzonenunterschied 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 Zeitzonenunterschied 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 ihre Attribute. Alle Werte in den verschachtelten Feldern sind erforderlich. Dieses Feld befindet sich derzeit in der Betaphase.
lifetimeValueMicros

string (int64 format)

Der Werbetreibende definiert den Lifetime-Wert des Nutzers.
lifetimeValueBucket

integer

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

object (ShoppingLoyalty)

Die Daten zur Einkaufstreue. Shopping nutzt diese Daten, um Nutzern ein besseres Einkaufserlebnis zu bieten. Nur für Händler auf der Zulassungsliste mit Zustimmung des Nutzers zugänglich.

ShoppingLoyalty

Die Daten zur Einkaufstreue. Shopping nutzt diese Daten, um Nutzern ein besseres Einkaufserlebnis 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. Es kann beispielsweise eine Zahl von 1 bis 10, ein String wie „Golden“ oder „Silver“ oder auch ein leerer String „“ sein.

EventAttribute

Vom Werbetreibenden definierte Ereignisse und ihre 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 Zeitzonenunterschied 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

Ereignisattribute des Kundenabgleichs

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

string

Optional. Eine eindeutige Kennzeichnung eines Produkts. Dies kann entweder die Merchant Center-Artikel-ID oder die GTIN (Global Trade Item Number) sein.