- Zapis JSON
- TransactionAttribute
- StoreAttribute (Atrybut sklepu)
- ItemAttribute
- UserAttribute (Atrybut użytkownika):
- ShoppingLoyalty
- EventAttribute
- EventItemAttribute
Dane użytkownika zawierające identyfikatory i atrybuty użytkownika.
Zapis JSON |
---|
{ "userIdentifiers": [ { object ( |
Pola | |
---|---|
userIdentifiers[] |
Dane identyfikacyjne użytkownika. Wymagane. |
transactionAttribute |
Dodatkowe transakcje lub atrybuty powiązane z użytkownikiem. Wymagany przy aktualizacji danych o sprzedaży w sklepie. |
userAttribute |
Atrybuty dodatkowe powiązane z użytkownikiem. Wymagany przy aktualizowaniu atrybutów kierowania na listę klientów. Wygasają one po 540 dniach. |
consent |
Ustawienie dotyczące zgody użytkownika. Kierowanie na listę klientów zignoruje to pole i zwróci ostrzeżenie. |
TransactionAttribute
Atrybut transakcji sprzedaży w sklepie.
Zapis JSON |
---|
{ "storeAttribute": { object ( |
Pola | |
---|---|
storeAttribute |
Atrybuty sklepu transakcji. Dostępne tylko dla klientów z listy dozwolonych. |
itemAttribute |
Atrybuty transakcji. |
transactionDateTime |
Sygnatura czasowa dokonania transakcji. To pole jest wymagane. Format to „RRRR-MM-DD GG:MM:SS[+/-GG:MM]”, gdzie [+/-GG:MM] to opcjonalne przesunięcie strefy czasowej względem czasu UTC. Jeśli przesunięcie nie będzie podane, 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 |
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 na produkt przez liczbę podaną w atrybucie ItemAttributes. |
currencyCode |
Kod waluty transakcji. Użyto 3-literowego kodu ISO 4217. To pole jest wymagane. |
conversionAction |
Nazwa zasobu działania powodującego konwersję, w którego przypadku chcesz raportować konwersje. To pole jest wymagane. |
orderId |
Identyfikator zamówienia w ramach transakcji. Dostępne tylko dla klientów z listy dozwolonych. |
customValue |
Wartość zmiennej niestandardowej w przypadku każdej transakcji. Dostępne tylko dla klientów z listy dozwolonych. |
StoreAttribute
Atrybuty sklepu transakcji.
Zapis JSON |
---|
{ "storeCode": string } |
Pola | |
---|---|
storeCode |
Kod sklepu z adresu 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 |
Unikalny identyfikator produktu. Może to być identyfikator produktu w Merchant Center lub numer GTIN (globalny numer jednostki handlowej). |
countryCode |
Kod terytorium CLDR (Common Locale Data Repository) 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 |
Kod ISO 639-1 języka powiązanego z plikiem danych, w którym przesyłasz produkty |
quantity |
Liczba sprzedanych produktów. Jeśli nie zostanie ustawiony, domyślna wartość to 1. |
merchantId |
Identyfikator konta Merchant Center. |
UserAttribute
Atrybut użytkownika, może być używany tylko z typem zadania CUSTOMER_MATCH_WITH_ATTRIBUTES.
Zapis JSON |
---|
{ "lastPurchaseDateTime": string, "averagePurchaseCount": integer, "averagePurchaseValueMicros": string, "acquisitionDateTime": string, "lifecycleStage": string, "firstPurchaseDateTime": string, "eventAttribute": [ { object ( |
Pola | |
---|---|
lastPurchaseDateTime |
Sygnatura czasowa ostatniego zakupu dokonanego przez użytkownika. Format to RRRR-MM-DD GG:MM:SS[+/-GG:MM], gdzie [+/-GG:MM] to opcjonalne przesunięcie strefy czasowej względem czasu UTC. Jeśli przesunięcie nie będzie podane, interfejs API użyje jako domyślnej strefy czasowej konta. |
averagePurchaseCount |
Zdefiniowana przez reklamodawcę średnia liczba zakupów dokonanych przez użytkownika w ciągu 30 dni. |
averagePurchaseValueMicros |
Reklamodawca zdefiniował średnią wartość zakupu (w mikro) na użytkownika. |
acquisitionDateTime |
Sygnatura czasowa pozyskania użytkownika. Format to RRRR-MM-DD GG:MM:SS[+/-GG:MM], gdzie [+/-GG:MM] to opcjonalne przesunięcie strefy czasowej względem czasu UTC. Jeśli przesunięcie nie będzie podane, interfejs API użyje jako domyślnej strefy czasowej konta. |
lifecycleStage |
Opcjonalnie. Reklamodawca określa etap cyklu życia użytkownika. Akceptowane wartości to „Lead” (Potencjalny klient), „Active” (Aktywny) i „Churned” (Rezygnacja). |
firstPurchaseDateTime |
Opcjonalnie. Sygnatura czasowa pierwszego zakupu dokonanego przez użytkownika. Format to RRRR-MM-DD GG:MM:SS[+/-GG:MM], gdzie [+/-GG:MM] to opcjonalne przesunięcie strefy czasowej względem czasu UTC. Jeśli przesunięcie nie będzie podane, interfejs API użyje jako domyślnej strefy czasowej konta. |
eventAttribute[] |
Opcjonalnie. Zdarzenia zdefiniowane przez reklamodawcę i ich atrybuty. Wszystkie wartości w zagnieżdżonych polach są wymagane. To pole jest obecnie w wersji beta. |
lifetimeValueMicros |
Wartość użytkownika od początku śledzenia określona przez reklamodawcę. |
lifetimeValueBucket |
Określona przez reklamodawcę grupa wartości od początku śledzenia dla użytkownika. Prawidłowy zakres dla zasobnika wartości od początku śledzenia mieści się w zakresie od 1 (niska) do 10 (wysoka), z wyjątkiem operacji usuwania, w których akceptowane są też wartości 0. |
shoppingLoyalty |
Dane związane z programem lojalnościowym w ramach zakupów. Zakupy Google wykorzystują te dane, aby zapewnić użytkownikom lepsze wrażenia. Dostępne tylko dla sprzedawców znajdujących się na liście dozwolonych za zgodą użytkownika. |
ShoppingLoyalty
Dane związane z programem lojalnościowym w ramach zakupów. Zakupy Google wykorzystują te dane, aby zapewnić użytkownikom lepsze wrażenia. Dostępne tylko dla sprzedawców znajdujących się na liście dozwolonych.
Zapis JSON |
---|
{ "loyaltyTier": string } |
Pola | |
---|---|
loyaltyTier |
Poziom wspierania. Jest to dowolny ciąg znaków, ponieważ każdy sprzedawca może mieć własny system lojalnościowy. Może to być na przykład liczba od 1 do 10 lub 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 ( |
Pola | |
---|---|
event |
To pole jest wymagane. Zdarzenie zdefiniowane przez reklamodawcę do remarketingu. Akceptowane wartości to „Obejrzane”, „Koszyk”, „Kupiony” i „Zalecane”. |
eventDateTime |
To pole jest wymagane. Sygnatura czasowa wystąpienia zdarzenia. Format to RRRR-MM-DD GG:MM:SS[+/-GG:MM], gdzie [+/-GG:MM] to opcjonalne przesunięcie strefy czasowej względem czasu UTC. Jeśli przesunięcie nie będzie podane, interfejs API użyje jako domyślnej strefy czasowej konta. |
itemAttribute[] |
To pole jest wymagane. Atrybuty elementu zdarzenia. |
EventItemAttribute
Atrybuty elementu zdarzenia kierowania na listę klientów.
Zapis JSON |
---|
{ "itemId": string } |
Pola | |
---|---|
itemId |
Opcjonalnie. Unikalny identyfikator produktu. Może to być identyfikator produktu w Merchant Center lub numer GTIN (globalny numer jednostki handlowej). |