UserData

Dane użytkownika zawierające identyfikatory i atrybuty użytkownika.

Zapis JSON 
{
  "userIdentifiers": [
    {
      object (UserIdentifier)
    }
  ],
  "transactionAttribute": {
    object (TransactionAttribute)
  },
  "userAttribute": {
    object (UserAttribute)
  }
}
Pola
userIdentifiers[]

object (UserIdentifier)

Dane identyfikacyjne użytkownika. Wymagane.
transactionAttribute

object (TransactionAttribute)

Dodatkowe transakcje/atrybuty powiązane z użytkownikiem. Wymagany przy aktualizacji danych o sprzedaży w sklepie.
userAttribute

object (UserAttribute)

Atrybuty dodatkowe powiązane z użytkownikiem. Wymagany przy aktualizacji atrybutów kierowania na listę klientów. Wygasają one po 540 dniach.

TransactionAttribute

Atrybut transakcji sprzedaży w sklepie.

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

object (StoreAttribute)

Przechowuj atrybuty transakcji. Dostępne tylko dla klientów z listy dozwolonych.
itemAttribute

object (ItemAttribute)

Atrybuty transakcji.
transactionDateTime

string

Sygnatura czasowa wystąpienia transakcji. To pole jest wymagane. Format to „RRRR-MM-DD GG:MM:SS[+/-GG:MM]”, gdzie [+/-HH:MM] to opcjonalne przesunięcie strefy czasowej względem czasu UTC. Jeśli brak przesunięcia, interfejs API użyje jako domyślnej strefy czasowej konta. Przykłady: „2018-03-05 09:15:00” lub „2018-02-01 14:34:30+03:00”.
transactionAmountMicros

number

Kwota transakcji w mikro. To pole jest wymagane. Kwota transakcji w mikro musi być większa niż 1000. Jeśli podajesz atrybuty produktu, reprezentuje ona łączną wartość produktów po pomnożeniu ceny jednostkowej produktu przez liczbę podaną w atrybucie ItemAttributes.
currencyCode

string

Kod waluty transakcji. Używany jest 3-literowy kod ISO 4217. To pole jest wymagane.
conversionAction

string

Nazwa zasobu działania powodującego konwersję, w którego przypadku mają być raportowane konwersje. To pole jest wymagane.
orderId

string

Identyfikator zamówienia transakcji. Dostępne tylko dla klientów z listy dozwolonych.
customValue

string

Wartość zmiennej niestandardowej dla każdej transakcji. Dostępne tylko dla klientów z listy dozwolonych.

StoreAttribute

Przechowuj atrybuty transakcji.

Zapis JSON 
{
  "storeCode": string
}
Pola
storeCode

string

Kod sklepu z https://support.google.com/business/answer/3370250#storecode

ItemAttribute

Atrybuty transakcji.

Zapis JSON 
{
  "itemId": string,
  "countryCode": string,
  "languageCode": string,
  "quantity": string,
  "merchantId": string
}
Pola
itemId

string

Unikalny identyfikator produktu. Może to być identyfikator produktu w Merchant Center lub numer GTIN (globalny numer jednostki handlowej).
countryCode

string

Kod regionu CLDR (Common Locale Data Repositories) kraju powiązanego z plikiem danych, w którym przesyłane są Twoje produkty. Więcej informacji znajdziesz na stronie https://developers.google.com/google-ads/api/reference/data/codes-formats#country-codes.
languageCode

string

Kod ISO 639-1 języka powiązanego z plikiem danych, w którym przesyłasz produkty
quantity

string (int64 format)

Liczba sprzedanych produktów. Jeśli nie zostanie ustawiony, domyślna wartość to 1.
merchantId

string (int64 format)

Identyfikator konta Merchant Center.

UserAttribute

Atrybut użytkownika. Można go używać tylko z typem zadania CUSTOMER_MATCH_WITH_ATTRIBUTES.

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

string

Sygnatura czasowa ostatniego zakupu dokonanego przez użytkownika. Format to RRRR-MM-DD GG:MM:SS[+/-GG:MM], gdzie [+/-HH:MM] to opcjonalne przesunięcie strefy czasowej względem czasu UTC. Jeśli brak przesunięcia, interfejs API użyje jako domyślnej strefy czasowej konta.
averagePurchaseCount

integer

Zdefiniowana przez reklamodawcę średnia liczba zakupów dokonanych przez użytkownika w ciągu 30 dni.
averagePurchaseValueMicros

string (int64 format)

Określona przez reklamodawcę średnia wartość zakupu w mikro dla użytkownika.
acquisitionDateTime

string

Sygnatura czasowa pozyskania użytkownika. Format to RRRR-MM-DD GG:MM:SS[+/-GG:MM], gdzie [+/-HH:MM] to opcjonalne przesunięcie strefy czasowej względem czasu UTC. Jeśli brak przesunięcia, interfejs API użyje jako domyślnej strefy czasowej konta.
lifecycleStage

string

Opcjonalnie. Etap cyklu życia zdefiniowany przez reklamodawcę dla użytkownika. Akceptowane wartości to „Lead” (Potencjalny klient), „Active” (Aktywny) i „Churned” (Rezygnacja).
firstPurchaseDateTime

string

Opcjonalnie. Sygnatura czasowa pierwszego zakupu dokonanego przez użytkownika. Format to RRRR-MM-DD GG:MM:SS[+/-GG:MM], gdzie [+/-HH:MM] to opcjonalne przesunięcie strefy czasowej względem czasu UTC. Jeśli brak przesunięcia, interfejs API użyje jako domyślnej strefy czasowej konta.
eventAttribute[]

object (EventAttribute)

Opcjonalnie. Zdarzenia zdefiniowane przez reklamodawcę i ich atrybuty. Wszystkie wartości w zagnieżdżonych polach są wymagane. Obecnie to pole jest w wersji beta.
lifetimeValueMicros

string (int64 format)

Zdefiniowana przez reklamodawcę wartość od początku śledzenia dla użytkownika.
lifetimeValueBucket

integer

Zdefiniowana przez reklamodawcę grupa wartości od początku śledzenia dla użytkownika. Prawidłowy zakres dla segmentu wartości od początku śledzenia wynosi od 1 (niska) do 10 (wysoka) z wyjątkiem operacji usuwania, w której akceptowana jest też wartość 0.
shoppingLoyalty

object (ShoppingLoyalty)

Dane związane z programem lojalnościowym w Zakupach Google. Zakupy Google wykorzystują te dane, aby zapewnić użytkownikom lepsze wrażenia. Dostępne tylko dla sprzedawców z listy dozwolonych za zgodą użytkownika.

ShoppingLoyalty

Dane związane z programem lojalnościowym w Zakupach Google. Zakupy Google wykorzystują te dane, aby zapewnić użytkownikom lepsze wrażenia. Dostępne tylko dla sprzedawców z listy dozwolonych.

Zapis JSON 
{
  "loyaltyTier": string
}
Pola
loyaltyTier

string

Poziom wspierania. Jest to dowolny ciąg znaków, ponieważ każdy sprzedawca może mieć swój własny system lojalnościowy. Może to być na przykład liczba od 1 do 10, ciąg znaków taki jak „Złoty” lub „Srebrny” albo pusty ciąg znaków „”.

EventAttribute

Zdarzenia zdefiniowane przez reklamodawcę i ich atrybuty. Wszystkie wartości w zagnieżdżonych polach są wymagane.

Zapis JSON 
{
  "event": string,
  "eventDateTime": string,
  "itemAttribute": [
    {
      object (EventItemAttribute)
    }
  ]
}
Pola
event

string

To pole jest wymagane. Zdarzenie zdefiniowane przez reklamodawcę do remarketingu. Akceptowane wartości to „Obejrzane”, „Koszyk”, „Kupione” i „Zalecane”.
eventDateTime

string

To pole jest wymagane. Sygnatura czasowa wystąpienia zdarzenia. Format to RRRR-MM-DD GG:MM:SS[+/-GG:MM], gdzie [+/-HH:MM] to opcjonalne przesunięcie strefy czasowej względem czasu UTC. Jeśli brak przesunięcia, interfejs API użyje jako domyślnej strefy czasowej konta.
itemAttribute[]

object (EventItemAttribute)

To pole jest wymagane. Atrybuty elementu zdarzenia.

EventItemAttribute

Atrybuty elementu zdarzenia w kierowaniu na listę klientów.

Zapis JSON 
{
  "itemId": string
}
Pola
itemId

string

Opcjonalnie. Unikalny identyfikator produktu. Może to być identyfikator produktu w Merchant Center lub numer GTIN (globalny numer jednostki handlowej).