Zalecane zdarzenia

Google Analytics automatycznie wysyła niektóre typy zdarzeń. Na tej stronie znajdziesz opis opcjonalnych zdarzeń dodatkowych, które możesz skonfigurować, aby mierzyć więcej zachowań i generować przydatniejsze raporty dla swojej firmy. Skonfigurowanie tych dodatkowych zdarzeń wymaga więcej wysiłku, zanim będzie można ich używać, więc Google Analytics nie może ich wysyłać automatycznie. Szczegółowe instrukcje konfigurowania zdarzeń zalecanych i niestandardowych w witrynie lub aplikacji znajdziesz w artykule Konfigurowanie zdarzeń.

Aby wyświetlić szczegóły każdego zdarzenia, którego możesz użyć, wybierz platformę do zarządzania tagami:

gtag.js Menedżer tagów Firebase

Wszystkie usługi

earn_virtual_currency

Mierzy zdarzenia, kiedy użytkownik otrzymuje wirtualną walutę w grze. Rejestruj to zdarzenie wraz ze zdarzeniem spend_virtual_currency, aby lepiej poznać swoje wirtualne finanse.

Parametry

Nazwa	Typ	Wymagane	Przykładowa wartość	Opis
virtual_currency_name	string	Nie	Klejnoty	Nazwa waluty wirtualnej.
value	number	Nie	5	Wartość waluty wirtualnej.

Przykład

Poniższy przykład dotyczy wdrożeń tagu gtag.js:

gtag("event", "earn_virtual_currency", {
  virtual_currency_name: "Gems",
  value: 5
});

join_group

Rejestruj to zdarzenie, gdy użytkownik dołącza do grupy, np. do gildii, zespołu lub rodziny. Dzięki temu zdarzeniu dowiesz się, jak popularne są określone grupy lub funkcje społecznościowe.

Parametry

Nazwa	Typ	Wymagane	Przykładowa wartość	Opis
group_id	string	Nie	G_12345	Identyfikator grupy.

Przykład

Poniższy przykład dotyczy wdrożeń tagu gtag.js:

gtag("event", "join_group", {
  group_id: "G_12345"
});

login

Wysyłaj to zdarzenie, aby sygnalizować, że użytkownik zalogował się w Twojej witrynie lub aplikacji.

Parametry

Nazwa	Typ	Wymagane	Przykładowa wartość	Opis
method	string	Nie	Google	Metoda użyta do logowania.

Przykład

Poniższy przykład dotyczy wdrożeń tagu gtag.js:

gtag("event", "login", {
  method: "Google"
});

search

Rejestruj to zdarzenie, aby wskazywać, kiedy użytkownik przeprowadził wyszukiwanie. Możesz używać tego zdarzenia do określania, czego użytkownicy szukają w Twojej witrynie lub aplikacji. Możesz na przykład wysyłać to zdarzenie, gdy użytkownik wyświetli stronę wyników wyszukiwania po przeprowadzeniu wyszukiwania.

Parametry

Nazwa	Typ	Wymagane	Przykładowa wartość	Opis
search_term	string	Tak	t-shirty,	Wyszukiwany produkt.

Przykład

Poniższy przykład dotyczy wdrożeń tagu gtag.js:

gtag("event", "search", {
  search_term: "t-shirts"
});

select_content

To zdarzenie oznacza, że użytkownik wybrał treści określonego typu. To zdarzenie może pomóc Ci określić popularne treści i kategorie treści w Twojej witrynie lub aplikacji.

Parametry

Nazwa	Typ	Wymagane	Przykładowa wartość	Opis
content_type	string	Nie	produkt	Typ wybranej treści.
content_id	string	Nie	C_12345	Identyfikator wybranych treści. Wartość musi zawierać co najmniej 1 znak inny niż cyfra.

Przykład

Poniższy przykład dotyczy wdrożeń tagu gtag.js:

gtag("event", "select_content", {
  content_type: "product",
  content_id: "C_12345"
});

share

Używaj tego zdarzenia, gdy użytkownik udostępni treść.

Parametry

Nazwa	Typ	Wymagane	Przykładowa wartość	Opis
method	string	Nie	Twitter	Metoda udostępniania treści.
content_type	string	Nie	obraz	Typ udostępnionych treści.
item_id	string	Nie	C_12345	Identyfikator udostępnionych treści.

Przykład

Poniższy przykład dotyczy wdrożeń tagu gtag.js:

gtag("event", "share", {
  method: "Twitter",
  content_type: "image",
  item_id: "C_12345",
});

sign_up

To zdarzenie wskazuje, że użytkownik zarejestrował konto. Dzięki temu zdarzeniu możesz poznać różne zachowania zalogowanych i niezalogowanych użytkowników.

Parametry

Nazwa	Typ	Wymagane	Przykładowa wartość	Opis
method	string	Nie	Google	Metoda użyta do rejestracji.

Przykład

Poniższy przykład dotyczy wdrożeń tagu gtag.js:

gtag("event", "sign_up", {
  method: "Google"
});

spend_virtual_currency

To zdarzenie mierzy sprzedaż wirtualnych produktów w aplikacji i pomaga określić, które z nich są najpopularniejsze.

Parametry

Nazwa	Typ	Wymagane	Przykładowa wartość	Opis
value	number	Tak	5	Wartość waluty wirtualnej.
virtual_currency_name	string	Tak	Klejnoty	Nazwa waluty wirtualnej.
item_name	string	Nie	Starter Boost	Nazwa produktu, do którego używana jest waluta wirtualna.

Przykład

Poniższy przykład dotyczy wdrożeń tagu gtag.js:

gtag("event", "spend_virtual_currency", {
  value: 5,
  virtual_currency_name: "Gems",
  item_name: "Starter Boost"
});

tutorial_begin

To zdarzenie oznacza rozpoczęcie procesu wprowadzania. Używaj go w ścieżce z tutorial_complete, aby sprawdzić, ilu użytkowników ukończyło samouczek.

Parametry

To zdarzenie nie ma parametrów.

Przykład

Poniższy przykład dotyczy wdrożeń tagu gtag.js:

gtag("event", "tutorial_begin");

tutorial_complete

To zdarzenie oznacza, że użytkownik zakończył proces wprowadzania. Użyj tego parametru na ścieżce z parametrem tutorial_begin, aby dowiedzieć się, ilu użytkowników ukończyło samouczek.

Parametry

Dla tego zdarzenia nie są sugerowane żadne parametry.

Przykład

Poniższy przykład dotyczy wdrożeń tagu gtag.js:

gtag("event", "tutorial_complete");

Sprzedaż online

add_payment_info

To zdarzenie oznacza, że użytkownik przesłał informacje o płatności w procesie płatności w e-commerce.

Parametry

Nazwa	Typ	Wymagane	Przykładowa wartość	Opis
currency	string	Tak*	USD	Waluta produktów powiązanych ze zdarzeniem podana w 3-literowym formacie ISO 4217. * Dane o wartości zdarzenia view_item nie przyczyniają się do przychodów. * Jeśli określisz parametr value, do prawidłowego obliczania danych o przychodach niezbędne jest podanie parametru currency.
value	number	Tak*	30.03	Wartość pieniężna zdarzenia. * Ustaw value na sumę (price * quantity) dla wszystkich elementów w items. Nie uwzględniaj shipping ani tax. * value jest zwykle wymagany do uzyskania przydatnych raportów. Jeśli oznaczysz zdarzenie jako kluczowe zdarzenie, zalecamy ustawienie value. * currency jest wymagany, jeśli ustawisz value.
coupon	string	Nie	SUMMER_FUN	Nazwa lub kod kuponu powiązanego ze zdarzeniem. Parametry na poziomie zdarzenia i produktu są niezależne od siebie.coupon
payment_type	string	Nie	Karta kredytowa	Wybrana forma płatności.
items	Array<Item>	Tak		Produkty powiązane ze zdarzeniem.

Parametry produktu

Nazwa	Typ	Wymagane	Przykładowa wartość	Opis
item_id	string	Tak*	SKU_12345	Identyfikator elementu. *Wymagana jest jedna z tych wartości: item_id lub item_name.
item_name	string	Tak*	koszulka „Stan and Friends”,	Nazwa elementu. *Wymagana jest jedna z tych wartości: item_id lub item_name.
affiliation	string	Nie	Google Store	Powiązanie produktu umożliwiające wskazanie jego dostawcy lub lokalizacji sklepu stacjonarnego. Uwaga: affiliation jest dostępny tylko w zakresie elementu.
coupon	string	Nie	SUMMER_FUN	Nazwa lub kod kuponu powiązanego z produktem. Parametry na poziomie zdarzenia i produktu są niezależne od siebie. coupon
discount	number	Nie	2.22	Wartość rabatu kwotowego powiązanego z produktem.
index	number	Nie	5	Indeks lub pozycja produktu na liście.
item_brand	string	Nie	Google	Marka produktu.
item_category	string	Nie	Odzież	Kategoria produktu. Jeśli jest używana w hierarchii kategorii lub taksonomii, będzie to pierwsza kategoria.
item_category2	string	Nie	Dorosły	Druga hierarchia kategorii lub dodatkowa mapa kategorii dla produktu.
item_category3	string	Nie	Koszule	Trzecia hierarchia kategorii lub dodatkowa mapa kategorii dla elementu.
item_category4	string	Nie	Ekipa	Czwarta hierarchia kategorii lub dodatkowa mapa kategorii dla elementu.
item_category5	string	Nie	Krótki rękaw	Piąta hierarchia kategorii lub dodatkowa mapa kategorii dla elementu.
item_list_id	string	Nie	related_products	Identyfikator listy, na której produkt został przedstawiony użytkownikowi. Jeśli ten parametr jest ustawiony, parametr item_list_id na poziomie zdarzenia jest ignorowany. Jeśli nie jest ustawiona, używana jest wartość item_list_id na poziomie zdarzenia, o ile jest dostępna.
item_list_name	string	Nie	Produkty powiązane	Nazwa listy, na której produkt został przedstawiony użytkownikowi. Jeśli ten parametr jest ustawiony, parametr item_list_name na poziomie zdarzenia jest ignorowany. Jeśli nie jest ustawiona, używana jest wartość item_list_name na poziomie zdarzenia, o ile jest dostępna.
item_variant	string	Nie	zielony	Wersja produktu, czyli niepowtarzalny kod lub opis, które pozwalają wybrać dodatkowe szczegóły lub opcje produktu.
location_id	string	Nie	ChIJIQBpAG2ahYAR_6128GcTUEo (identyfikator miejsca w Google dla San Francisco)	Lokalizacja fizyczna powiązana z produktem (np. lokalizacja sklepu stacjonarnego). Zalecamy używanie identyfikatora miejsca w Google, który odpowiada powiązanemu produktowi. Możesz też użyć niestandardowego identyfikatora lokalizacji. Uwaga: location_id jest dostępny tylko w zakresie elementu.
price	number	Nie	10.01	Cena jednostkowa produktu w jednostkach określonej waluty. Jeśli produkt jest objęty rabatem, ustaw wartość price na obniżoną cenę jednostkową i określ rabat ceny jednostkowej w parametrze discount.
quantity	number	Nie	3	Liczba produktów. Jeśli nie zostanie ustawiona, wartość quantity wyniesie 1.

Oprócz określonych parametrów możesz uwzględnić w tablicy items do 27 parametrów niestandardowych.

Przykład

Poniższy przykład dotyczy wdrożeń tagu gtag.js:

gtag("event", "add_payment_info", {
  currency: "USD",
  value: 30.03,
  coupon: "SUMMER_FUN",
  payment_type: "Credit Card",
  items: [
    {
      item_id: "SKU_12345",
      item_name: "Stan and Friends Tee",
      affiliation: "Google Merchandise Store",
      coupon: "SUMMER_FUN",
      discount: 2.22,
      index: 0,
      item_brand: "Google",
      item_category: "Apparel",
      item_category2: "Adult",
      item_category3: "Shirts",
      item_category4: "Crew",
      item_category5: "Short sleeve",
      item_list_id: "related_products",
      item_list_name: "Related Products",
      item_variant: "green",
      location_id: "ChIJIQBpAG2ahYAR_6128GcTUEo",
      price: 10.01,
      google_business_vertical: "retail",
      quantity: 3
    }
  ]
});

add_shipping_info

To zdarzenie oznacza, że użytkownik przesłał informacje o dostawie w procesie płatności w e-commerce.

Parametry

Nazwa	Typ	Wymagane	Przykładowa wartość	Opis
currency	string	Tak*	USD	Waluta produktów powiązanych ze zdarzeniem podana w 3-literowym formacie ISO 4217. * Dane o wartości zdarzenia view_item nie przyczyniają się do przychodów. * Jeśli określisz parametr value, do prawidłowego obliczania danych o przychodach niezbędne jest podanie parametru currency.
value	number	Tak*	30.03	Wartość pieniężna zdarzenia. * Ustaw value na sumę (price * quantity) dla wszystkich elementów w items. Nie uwzględniaj shipping ani tax. * value jest zwykle wymagany do uzyskania przydatnych raportów. Jeśli oznaczysz zdarzenie jako kluczowe zdarzenie, zalecamy ustawienie value. * currency jest wymagany, jeśli ustawisz value.
coupon	string	Nie	SUMMER_FUN	Nazwa lub kod kuponu powiązanego ze zdarzeniem. Parametry na poziomie zdarzenia i produktu są niezależne od siebie.coupon
shipping_tier	string	Nie	Ziemia	Poziom dostawy (np. Ground, Air, Next-day) wybrany w przypadku zakupionego produktu.
items	Array<Item>	Tak		Produkty powiązane ze zdarzeniem.

Parametry produktu

Nazwa	Typ	Wymagane	Przykładowa wartość	Opis
item_id	string	Tak*	SKU_12345	Identyfikator elementu. *Wymagana jest jedna z tych wartości: item_id lub item_name.
item_name	string	Tak*	koszulka „Stan and Friends”,	Nazwa elementu. *Wymagana jest jedna z tych wartości: item_id lub item_name.
affiliation	string	Nie	Google Store	Powiązanie produktu umożliwiające wskazanie jego dostawcy lub lokalizacji sklepu stacjonarnego. Uwaga: affiliation jest dostępny tylko w zakresie elementu.
coupon	string	Nie	SUMMER_FUN	Nazwa lub kod kuponu powiązanego z produktem. Parametry na poziomie zdarzenia i produktu są niezależne od siebie. coupon
discount	number	Nie	2.22	Wartość rabatu kwotowego powiązanego z produktem.
index	number	Nie	5	Indeks lub pozycja produktu na liście.
item_brand	string	Nie	Google	Marka produktu.
item_category	string	Nie	Odzież	Kategoria produktu. Jeśli jest używana w hierarchii kategorii lub taksonomii, będzie to pierwsza kategoria.
item_category2	string	Nie	Dorosły	Druga hierarchia kategorii lub dodatkowa mapa kategorii dla produktu.
item_category3	string	Nie	Koszule	Trzecia hierarchia kategorii lub dodatkowa mapa kategorii dla elementu.
item_category4	string	Nie	Ekipa	Czwarta hierarchia kategorii lub dodatkowa mapa kategorii dla elementu.
item_category5	string	Nie	Krótki rękaw	Piąta hierarchia kategorii lub dodatkowa mapa kategorii dla elementu.
item_list_id	string	Nie	related_products	Identyfikator listy, na której produkt został przedstawiony użytkownikowi. Jeśli ten parametr jest ustawiony, parametr item_list_id na poziomie zdarzenia jest ignorowany. Jeśli nie jest ustawiona, używana jest wartość item_list_id na poziomie zdarzenia, o ile jest dostępna.
item_list_name	string	Nie	Produkty powiązane	Nazwa listy, na której produkt został przedstawiony użytkownikowi. Jeśli ten parametr jest ustawiony, parametr item_list_name na poziomie zdarzenia jest ignorowany. Jeśli nie jest ustawiona, używana jest wartość item_list_name na poziomie zdarzenia, o ile jest dostępna.
item_variant	string	Nie	zielony	Wersja produktu, czyli niepowtarzalny kod lub opis, które pozwalają wybrać dodatkowe szczegóły lub opcje produktu.
location_id	string	Nie	ChIJIQBpAG2ahYAR_6128GcTUEo (identyfikator miejsca w Google dla San Francisco)	Lokalizacja fizyczna powiązana z produktem (np. lokalizacja sklepu stacjonarnego). Zalecamy używanie identyfikatora miejsca w Google, który odpowiada powiązanemu produktowi. Możesz też użyć niestandardowego identyfikatora lokalizacji. Uwaga: location_id jest dostępny tylko w zakresie elementu.
price	number	Nie	10.01	Cena jednostkowa produktu w jednostkach określonej waluty. Jeśli produkt jest objęty rabatem, ustaw wartość price na obniżoną cenę jednostkową i określ rabat ceny jednostkowej w parametrze discount.
quantity	number	Nie	3	Liczba produktów. Jeśli nie zostanie ustawiona, wartość quantity wyniesie 1.

Oprócz określonych parametrów możesz uwzględnić w tablicy items do 27 parametrów niestandardowych.

Przykład

Poniższy przykład dotyczy wdrożeń tagu gtag.js:

gtag("event", "add_shipping_info", {
  currency: "USD",
  value: 30.03,
  coupon: "SUMMER_FUN",
  shipping_tier: "Ground",
  items: [
    {
      item_id: "SKU_12345",
      item_name: "Stan and Friends Tee",
      affiliation: "Google Merchandise Store",
      coupon: "SUMMER_FUN",
      discount: 2.22,
      index: 0,
      item_brand: "Google",
      item_category: "Apparel",
      item_category2: "Adult",
      item_category3: "Shirts",
      item_category4: "Crew",
      item_category5: "Short sleeve",
      item_list_id: "related_products",
      item_list_name: "Related Products",
      item_variant: "green",
      location_id: "ChIJIQBpAG2ahYAR_6128GcTUEo",
      price: 10.01,
      google_business_vertical: "retail",
      quantity: 3
    }
  ]
});

add_to_cart

To zdarzenie oznacza, że produkt został dodany do koszyka w celu zakupu.

Parametry

Nazwa	Typ	Wymagane	Przykładowa wartość	Opis
currency	string	Tak*	USD	Waluta produktów powiązanych ze zdarzeniem podana w 3-literowym formacie ISO 4217. * Dane o wartości zdarzenia view_item nie przyczyniają się do przychodów. * Jeśli określisz parametr value, do prawidłowego obliczania danych o przychodach niezbędne jest podanie parametru currency.
value	number	Tak*	30.03	Wartość pieniężna zdarzenia. * Ustaw value na sumę (price * quantity) dla wszystkich elementów w items. Nie uwzględniaj shipping ani tax. * value jest zwykle wymagany do uzyskania przydatnych raportów. Jeśli oznaczysz zdarzenie jako kluczowe zdarzenie, zalecamy ustawienie value. * currency jest wymagany, jeśli ustawisz value.
items	Array<Item>	Tak		Produkty powiązane ze zdarzeniem.

Parametry produktu

Nazwa	Typ	Wymagane	Przykładowa wartość	Opis
item_id	string	Tak*	SKU_12345	Identyfikator elementu. *Wymagana jest jedna z tych wartości: item_id lub item_name.
item_name	string	Tak*	koszulka „Stan and Friends”,	Nazwa elementu. *Wymagana jest jedna z tych wartości: item_id lub item_name.
affiliation	string	Nie	Google Store	Powiązanie produktu umożliwiające wskazanie jego dostawcy lub lokalizacji sklepu stacjonarnego. Uwaga: affiliation jest dostępny tylko w zakresie elementu.
coupon	string	Nie	SUMMER_FUN	Nazwa lub kod kuponu powiązanego z produktem. Parametry na poziomie zdarzenia i produktu są niezależne od siebie. coupon
discount	number	Nie	2.22	Wartość rabatu kwotowego powiązanego z produktem.
index	number	Nie	5	Indeks lub pozycja produktu na liście.
item_brand	string	Nie	Google	Marka produktu.
item_category	string	Nie	Odzież	Kategoria produktu. Jeśli jest używana w hierarchii kategorii lub taksonomii, będzie to pierwsza kategoria.
item_category2	string	Nie	Dorosły	Druga hierarchia kategorii lub dodatkowa mapa kategorii dla produktu.
item_category3	string	Nie	Koszule	Trzecia hierarchia kategorii lub dodatkowa mapa kategorii dla elementu.
item_category4	string	Nie	Ekipa	Czwarta hierarchia kategorii lub dodatkowa mapa kategorii dla elementu.
item_category5	string	Nie	Krótki rękaw	Piąta hierarchia kategorii lub dodatkowa mapa kategorii dla elementu.
item_list_id	string	Nie	related_products	Identyfikator listy, na której produkt został przedstawiony użytkownikowi. Jeśli ten parametr jest ustawiony, parametr item_list_id na poziomie zdarzenia jest ignorowany. Jeśli nie jest ustawiona, używana jest wartość item_list_id na poziomie zdarzenia, o ile jest dostępna.
item_list_name	string	Nie	Produkty powiązane	Nazwa listy, na której produkt został przedstawiony użytkownikowi. Jeśli ten parametr jest ustawiony, parametr item_list_name na poziomie zdarzenia jest ignorowany. Jeśli nie jest ustawiona, używana jest wartość item_list_name na poziomie zdarzenia, o ile jest dostępna.
item_variant	string	Nie	zielony	Wersja produktu, czyli niepowtarzalny kod lub opis, które pozwalają wybrać dodatkowe szczegóły lub opcje produktu.
location_id	string	Nie	ChIJIQBpAG2ahYAR_6128GcTUEo (identyfikator miejsca w Google dla San Francisco)	Lokalizacja fizyczna powiązana z produktem (np. lokalizacja sklepu stacjonarnego). Zalecamy używanie identyfikatora miejsca w Google, który odpowiada powiązanemu produktowi. Możesz też użyć niestandardowego identyfikatora lokalizacji. Uwaga: location_id jest dostępny tylko w zakresie elementu.
price	number	Nie	10.01	Cena jednostkowa produktu w jednostkach określonej waluty. Jeśli produkt jest objęty rabatem, ustaw wartość price na obniżoną cenę jednostkową i określ rabat ceny jednostkowej w parametrze discount.
quantity	number	Nie	3	Liczba produktów. Jeśli nie zostanie ustawiona, wartość quantity wyniesie 1.

Oprócz określonych parametrów możesz uwzględnić w tablicy items do 27 parametrów niestandardowych.

Przykład

Poniższy przykład dotyczy wdrożeń tagu gtag.js:

gtag("event", "add_to_cart", {
  currency: "USD",
  value: 30.03,
  items: [
    {
      item_id: "SKU_12345",
      item_name: "Stan and Friends Tee",
      affiliation: "Google Merchandise Store",
      coupon: "SUMMER_FUN",
      discount: 2.22,
      index: 0,
      item_brand: "Google",
      item_category: "Apparel",
      item_category2: "Adult",
      item_category3: "Shirts",
      item_category4: "Crew",
      item_category5: "Short sleeve",
      item_list_id: "related_products",
      item_list_name: "Related Products",
      item_variant: "green",
      location_id: "ChIJIQBpAG2ahYAR_6128GcTUEo",
      price: 10.01,
      google_business_vertical: "retail",
      quantity: 3
    }
  ]
});

add_to_wishlist

Zdarzenie to oznacza, że produkt został dodany do listy życzeń. Używaj tego zdarzenia do identyfikowania popularnych prezentów w aplikacji.

Parametry

Nazwa	Typ	Wymagane	Przykładowa wartość	Opis
currency	string	Tak*	USD	Waluta produktów powiązanych ze zdarzeniem podana w 3-literowym formacie ISO 4217. * Dane o wartości zdarzenia view_item nie przyczyniają się do przychodów. * Jeśli określisz parametr value, do prawidłowego obliczania danych o przychodach niezbędne jest podanie parametru currency.
value	number	Tak*	30.03	Wartość pieniężna zdarzenia. * Ustaw value na sumę (price * quantity) dla wszystkich elementów w items. Nie uwzględniaj shipping ani tax. * value jest zwykle wymagany do uzyskania przydatnych raportów. Jeśli oznaczysz zdarzenie jako kluczowe zdarzenie, zalecamy ustawienie value. * currency jest wymagany, jeśli ustawisz value.
items	Array<Item>	Tak		Produkty powiązane ze zdarzeniem.

Parametry produktu

Nazwa	Typ	Wymagane	Przykładowa wartość	Opis
item_id	string	Tak*	SKU_12345	Identyfikator elementu. *Wymagana jest jedna z tych wartości: item_id lub item_name.
item_name	string	Tak*	koszulka „Stan and Friends”,	Nazwa elementu. *Wymagana jest jedna z tych wartości: item_id lub item_name.
affiliation	string	Nie	Google Store	Powiązanie produktu umożliwiające wskazanie jego dostawcy lub lokalizacji sklepu stacjonarnego. Uwaga: affiliation jest dostępny tylko w zakresie elementu.
coupon	string	Nie	SUMMER_FUN	Nazwa lub kod kuponu powiązanego z produktem. Parametry na poziomie zdarzenia i produktu są niezależne od siebie. coupon
discount	number	Nie	2.22	Wartość rabatu kwotowego powiązanego z produktem.
index	number	Nie	5	Indeks lub pozycja produktu na liście.
item_brand	string	Nie	Google	Marka produktu.
item_category	string	Nie	Odzież	Kategoria produktu. Jeśli jest używana w hierarchii kategorii lub taksonomii, będzie to pierwsza kategoria.
item_category2	string	Nie	Dorosły	Druga hierarchia kategorii lub dodatkowa mapa kategorii dla produktu.
item_category3	string	Nie	Koszule	Trzecia hierarchia kategorii lub dodatkowa mapa kategorii dla elementu.
item_category4	string	Nie	Ekipa	Czwarta hierarchia kategorii lub dodatkowa mapa kategorii dla elementu.
item_category5	string	Nie	Krótki rękaw	Piąta hierarchia kategorii lub dodatkowa mapa kategorii dla elementu.
item_list_id	string	Nie	related_products	Identyfikator listy, na której produkt został przedstawiony użytkownikowi. Jeśli ten parametr jest ustawiony, parametr item_list_id na poziomie zdarzenia jest ignorowany. Jeśli nie jest ustawiona, używana jest wartość item_list_id na poziomie zdarzenia, o ile jest dostępna.
item_list_name	string	Nie	Produkty powiązane	Nazwa listy, na której produkt został przedstawiony użytkownikowi. Jeśli ten parametr jest ustawiony, parametr item_list_name na poziomie zdarzenia jest ignorowany. Jeśli nie jest ustawiona, używana jest wartość item_list_name na poziomie zdarzenia, o ile jest dostępna.
item_variant	string	Nie	zielony	Wersja produktu, czyli niepowtarzalny kod lub opis, które pozwalają wybrać dodatkowe szczegóły lub opcje produktu.
location_id	string	Nie	ChIJIQBpAG2ahYAR_6128GcTUEo (identyfikator miejsca w Google dla San Francisco)	Lokalizacja fizyczna powiązana z produktem (np. lokalizacja sklepu stacjonarnego). Zalecamy używanie identyfikatora miejsca w Google, który odpowiada powiązanemu produktowi. Możesz też użyć niestandardowego identyfikatora lokalizacji. Uwaga: location_id jest dostępny tylko w zakresie elementu.
price	number	Nie	10.01	Cena jednostkowa produktu w jednostkach określonej waluty. Jeśli produkt jest objęty rabatem, ustaw wartość price na obniżoną cenę jednostkową i określ rabat ceny jednostkowej w parametrze discount.
quantity	number	Nie	3	Liczba produktów. Jeśli nie zostanie ustawiona, wartość quantity wyniesie 1.

Oprócz określonych parametrów możesz uwzględnić w tablicy items do 27 parametrów niestandardowych.

Przykład

Poniższy przykład dotyczy wdrożeń tagu gtag.js:

gtag("event", "add_to_wishlist", {
  currency: "USD",
  value: 30.03,
  items: [
    {
      item_id: "SKU_12345",
      item_name: "Stan and Friends Tee",
      affiliation: "Google Merchandise Store",
      coupon: "SUMMER_FUN",
      discount: 2.22,
      index: 0,
      item_brand: "Google",
      item_category: "Apparel",
      item_category2: "Adult",
      item_category3: "Shirts",
      item_category4: "Crew",
      item_category5: "Short sleeve",
      item_list_id: "related_products",
      item_list_name: "Related Products",
      item_variant: "green",
      location_id: "ChIJIQBpAG2ahYAR_6128GcTUEo",
      price: 10.01,
      google_business_vertical: "retail",
      quantity: 3
    }
  ],
});

begin_checkout

To zdarzenie oznacza, że użytkownik rozpoczął proces płatności.

Parametry

Nazwa	Typ	Wymagane	Przykładowa wartość	Opis
currency	string	Tak*	USD	Waluta produktów powiązanych ze zdarzeniem podana w 3-literowym formacie ISO 4217. * Dane o wartości zdarzenia view_item nie przyczyniają się do przychodów. * Jeśli określisz parametr value, do prawidłowego obliczania danych o przychodach niezbędne jest podanie parametru currency.
value	number	Tak*	30.03	Wartość pieniężna zdarzenia. * Ustaw value na sumę (price * quantity) dla wszystkich elementów w items. Nie uwzględniaj shipping ani tax. * value jest zwykle wymagany do uzyskania przydatnych raportów. Jeśli oznaczysz zdarzenie jako kluczowe zdarzenie, zalecamy ustawienie value. * currency jest wymagany, jeśli ustawisz value.
coupon	string	Nie	SUMMER_FUN	Nazwa lub kod kuponu powiązanego ze zdarzeniem. Parametry na poziomie zdarzenia i produktu są niezależne od siebie.coupon
items	Array<Item>	Tak		Produkty powiązane ze zdarzeniem.

Parametry produktu

Nazwa	Typ	Wymagane	Przykładowa wartość	Opis
item_id	string	Tak*	SKU_12345	Identyfikator elementu. *Wymagana jest jedna z tych wartości: item_id lub item_name.
item_name	string	Tak*	koszulka „Stan and Friends”,	Nazwa elementu. *Wymagana jest jedna z tych wartości: item_id lub item_name.
affiliation	string	Nie	Google Store	Powiązanie produktu umożliwiające wskazanie jego dostawcy lub lokalizacji sklepu stacjonarnego. Uwaga: affiliation jest dostępny tylko w zakresie elementu.
coupon	string	Nie	SUMMER_FUN	Nazwa lub kod kuponu powiązanego z produktem. Parametry na poziomie zdarzenia i produktu są niezależne od siebie. coupon
discount	number	Nie	2.22	Wartość rabatu kwotowego powiązanego z produktem.
index	number	Nie	5	Indeks lub pozycja produktu na liście.
item_brand	string	Nie	Google	Marka produktu.
item_category	string	Nie	Odzież	Kategoria produktu. Jeśli jest używana w hierarchii kategorii lub taksonomii, będzie to pierwsza kategoria.
item_category2	string	Nie	Dorosły	Druga hierarchia kategorii lub dodatkowa mapa kategorii dla produktu.
item_category3	string	Nie	Koszule	Trzecia hierarchia kategorii lub dodatkowa mapa kategorii dla elementu.
item_category4	string	Nie	Ekipa	Czwarta hierarchia kategorii lub dodatkowa mapa kategorii dla elementu.
item_category5	string	Nie	Krótki rękaw	Piąta hierarchia kategorii lub dodatkowa mapa kategorii dla elementu.
item_list_id	string	Nie	related_products	Identyfikator listy, na której produkt został przedstawiony użytkownikowi. Jeśli ten parametr jest ustawiony, parametr item_list_id na poziomie zdarzenia jest ignorowany. Jeśli nie jest ustawiona, używana jest wartość item_list_id na poziomie zdarzenia, o ile jest dostępna.
item_list_name	string	Nie	Produkty powiązane	Nazwa listy, na której produkt został przedstawiony użytkownikowi. Jeśli ten parametr jest ustawiony, parametr item_list_name na poziomie zdarzenia jest ignorowany. Jeśli nie jest ustawiona, używana jest wartość item_list_name na poziomie zdarzenia, o ile jest dostępna.
item_variant	string	Nie	zielony	Wersja produktu, czyli niepowtarzalny kod lub opis, które pozwalają wybrać dodatkowe szczegóły lub opcje produktu.
location_id	string	Nie	ChIJIQBpAG2ahYAR_6128GcTUEo (identyfikator miejsca w Google dla San Francisco)	Lokalizacja fizyczna powiązana z produktem (np. lokalizacja sklepu stacjonarnego). Zalecamy używanie identyfikatora miejsca w Google, który odpowiada powiązanemu produktowi. Możesz też użyć niestandardowego identyfikatora lokalizacji. Uwaga: location_id jest dostępny tylko w zakresie elementu.
price	number	Nie	10.01	Cena jednostkowa produktu w jednostkach określonej waluty. Jeśli produkt jest objęty rabatem, ustaw wartość price na obniżoną cenę jednostkową i określ rabat ceny jednostkowej w parametrze discount.
quantity	number	Nie	3	Liczba produktów. Jeśli nie zostanie ustawiona, wartość quantity wyniesie 1.

Oprócz określonych parametrów możesz uwzględnić w tablicy items do 27 parametrów niestandardowych.

Przykład

Poniższy przykład dotyczy wdrożeń tagu gtag.js:

gtag("event", "begin_checkout", {
  currency: "USD",
  value: 30.03,
  coupon: "SUMMER_FUN",
  items: [
    {
      item_id: "SKU_12345",
      item_name: "Stan and Friends Tee",
      affiliation: "Google Merchandise Store",
      coupon: "SUMMER_FUN",
      discount: 2.22,
      index: 0,
      item_brand: "Google",
      item_category: "Apparel",
      item_category2: "Adult",
      item_category3: "Shirts",
      item_category4: "Crew",
      item_category5: "Short sleeve",
      item_list_id: "related_products",
      item_list_name: "Related Products",
      item_variant: "green",
      location_id: "ChIJIQBpAG2ahYAR_6128GcTUEo",
      price: 10.01,
      google_business_vertical: "retail",
      quantity: 3
    }
  ]
});

purchase

To zdarzenie oznacza, że użytkownik kupił co najmniej 1 produkt.

Parametry

Nazwa	Typ	Wymagane	Przykładowa wartość	Opis
currency	string	Tak*	USD	Waluta produktów powiązanych ze zdarzeniem podana w 3-literowym formacie ISO 4217. * Dane o wartości zdarzenia view_item nie przyczyniają się do przychodów. * Jeśli określisz parametr value, do prawidłowego obliczania danych o przychodach niezbędne jest podanie parametru currency.
value	number	Tak*	30.03	Wartość pieniężna zdarzenia. * Ustaw value na sumę (price * quantity) dla wszystkich elementów w items. Nie uwzględniaj shipping ani tax. * value jest zwykle wymagany do uzyskania przydatnych raportów. Jeśli oznaczysz zdarzenie jako kluczowe zdarzenie, zalecamy ustawienie value. * currency jest wymagany, jeśli ustawisz value.
customer_type	string (new / returning)	Nie	nowy	Czy konwersja pochodzi od nowego czy powracającego klienta? new: nowy klient, który nie dokonał zakupu w wybranym przedziale czasu (zalecane, ale niewymagane ustawienie domyślne to 540 dni). returning: powracający klient, który dokonał zakupu w danym przedziale czasu. Nie podawaj wartości, jeśli masz wątpliwości (np. użytkownik skorzystał z funkcji „Zapłać bez logowania”).
transaction_id	string	Tak	T_12345	Unikalny identyfikator transakcji. Parametr transaction_id pomaga uniknąć otrzymywania zduplikowanych zdarzeń zakupu.
coupon	string	Nie	SUMMER_FUN	Nazwa lub kod kuponu powiązanego ze zdarzeniem. Parametry na poziomie zdarzenia i produktu są niezależne od siebie.coupon
shipping	number	Nie	3,33	Koszt dostawy powiązany z transakcją.
tax	number	Nie	1.11	Koszty podatkowe powiązane z transakcją.
items	Array<Item>	Tak		Produkty powiązane ze zdarzeniem.

Parametry produktu

Nazwa	Typ	Wymagane	Przykładowa wartość	Opis
item_id	string	Tak*	SKU_12345	Identyfikator elementu. *Wymagana jest jedna z tych wartości: item_id lub item_name.
item_name	string	Tak*	koszulka „Stan and Friends”,	Nazwa elementu. *Wymagana jest jedna z tych wartości: item_id lub item_name.
affiliation	string	Nie	Google Store	Powiązanie produktu umożliwiające wskazanie jego dostawcy lub lokalizacji sklepu stacjonarnego. Uwaga: affiliation jest dostępny tylko w zakresie elementu.
coupon	string	Nie	SUMMER_FUN	Nazwa lub kod kuponu powiązanego z produktem. Parametry na poziomie zdarzenia i produktu są niezależne od siebie. coupon
discount	number	Nie	2.22	Wartość rabatu kwotowego powiązanego z produktem.
index	number	Nie	5	Indeks lub pozycja produktu na liście.
item_brand	string	Nie	Google	Marka produktu.
item_category	string	Nie	Odzież	Kategoria produktu. Jeśli jest używana w hierarchii kategorii lub taksonomii, będzie to pierwsza kategoria.
item_category2	string	Nie	Dorosły	Druga hierarchia kategorii lub dodatkowa mapa kategorii dla produktu.
item_category3	string	Nie	Koszule	Trzecia hierarchia kategorii lub dodatkowa mapa kategorii dla elementu.
item_category4	string	Nie	Ekipa	Czwarta hierarchia kategorii lub dodatkowa mapa kategorii dla elementu.
item_category5	string	Nie	Krótki rękaw	Piąta hierarchia kategorii lub dodatkowa mapa kategorii dla elementu.
item_list_id	string	Nie	related_products	Identyfikator listy, na której produkt został przedstawiony użytkownikowi. Jeśli ten parametr jest ustawiony, parametr item_list_id na poziomie zdarzenia jest ignorowany. Jeśli nie jest ustawiona, używana jest wartość item_list_id na poziomie zdarzenia, o ile jest dostępna.
item_list_name	string	Nie	Produkty powiązane	Nazwa listy, na której produkt został przedstawiony użytkownikowi. Jeśli ten parametr jest ustawiony, parametr item_list_name na poziomie zdarzenia jest ignorowany. Jeśli nie jest ustawiona, używana jest wartość item_list_name na poziomie zdarzenia, o ile jest dostępna.
item_variant	string	Nie	zielony	Wersja produktu, czyli niepowtarzalny kod lub opis, które pozwalają wybrać dodatkowe szczegóły lub opcje produktu.
location_id	string	Nie	ChIJIQBpAG2ahYAR_6128GcTUEo (identyfikator miejsca w Google dla San Francisco)	Lokalizacja fizyczna powiązana z produktem (np. lokalizacja sklepu stacjonarnego). Zalecamy używanie identyfikatora miejsca w Google, który odpowiada powiązanemu produktowi. Możesz też użyć niestandardowego identyfikatora lokalizacji. Uwaga: location_id jest dostępny tylko w zakresie elementu.
price	number	Nie	10.01	Cena jednostkowa produktu w jednostkach określonej waluty. Jeśli produkt jest objęty rabatem, ustaw wartość price na obniżoną cenę jednostkową i określ rabat ceny jednostkowej w parametrze discount.
quantity	number	Nie	3	Liczba produktów. Jeśli nie zostanie ustawiona, wartość quantity wyniesie 1.

Oprócz określonych parametrów możesz uwzględnić w tablicy items do 27 parametrów niestandardowych.

Przykład

Poniższy przykład dotyczy wdrożeń tagu gtag.js:

gtag("event", "purchase", {
    transaction_id: "T_12345",
    // Sum of (price * quantity) for all items.
    value: 72.05,
    tax: 3.60,
    shipping: 5.99,
    currency: "USD",
    coupon: "SUMMER_SALE",
    customer_type: "new",
    items: [
     {
      item_id: "SKU_12345",
      item_name: "Stan and Friends Tee",
      affiliation: "Google Merchandise Store",
      coupon: "SUMMER_FUN",
      discount: 2.22,
      index: 0,
      item_brand: "Google",
      item_category: "Apparel",
      item_category2: "Adult",
      item_category3: "Shirts",
      item_category4: "Crew",
      item_category5: "Short sleeve",
      item_list_id: "related_products",
      item_list_name: "Related Products",
      item_variant: "green",
      location_id: "ChIJIQBpAG2ahYAR_6128GcTUEo",
      price: 10.01,
      google_business_vertical: "retail",
      quantity: 3
    },
    {
      item_id: "SKU_12346",
      item_name: "Google Grey Women's Tee",
      affiliation: "Google Merchandise Store",
      coupon: "SUMMER_FUN",
      discount: 3.33,
      index: 1,
      item_brand: "Google",
      item_category: "Apparel",
      item_category2: "Adult",
      item_category3: "Shirts",
      item_category4: "Crew",
      item_category5: "Short sleeve",
      item_list_id: "related_products",
      item_list_name: "Related Products",
      item_variant: "gray",
      location_id: "ChIJIQBpAG2ahYAR_6128GcTUEo",
      price: 21.01,
      promotion_id: "P_12345",
      promotion_name: "Summer Sale",
      google_business_vertical: "retail",
      quantity: 2
    }]
});

refund

To zdarzenie oznacza, że użytkownikowi zwrócono środki za co najmniej 1 produkt.

Uwaga: zalecamy uwzględnienie informacji o produkcie w zdarzeniu refund, aby w Analytics wyświetlać dane o zwrotach na poziomie produktu.

Parametry

Nazwa	Typ	Wymagane	Przykładowa wartość	Opis
currency	string	Tak*	USD	Waluta produktów powiązanych ze zdarzeniem podana w 3-literowym formacie ISO 4217. * Dane o wartości zdarzenia view_item nie przyczyniają się do przychodów. * Jeśli określisz parametr value, do prawidłowego obliczania danych o przychodach niezbędne jest podanie parametru currency.
transaction_id	string	Tak	T_12345	Unikalny identyfikator transakcji.
value	number	Tak*	30.03	Wartość pieniężna zdarzenia. * Ustaw value na sumę (price * quantity) dla wszystkich elementów w items. Nie uwzględniaj shipping ani tax. * value jest zwykle wymagany do uzyskania przydatnych raportów. Jeśli oznaczysz zdarzenie jako kluczowe zdarzenie, zalecamy ustawienie value. * currency jest wymagany, jeśli ustawisz value.
coupon	string	Nie	SUMMER_FUN	Nazwa lub kod kuponu powiązanego ze zdarzeniem. Parametry na poziomie zdarzenia i produktu są niezależne od siebie.coupon
shipping	number	Nie	3,33	Koszt dostawy powiązany z transakcją.
tax	number	Nie	1.11	Koszty podatkowe powiązane z transakcją.
items	Array<Item>	Nie*		Produkty powiązane ze zdarzeniem.

Parametry produktu

Nazwa	Typ	Wymagane	Przykładowa wartość	Opis
item_id	string	Tak*	SKU_12345	Identyfikator elementu. *Wymagana jest jedna z tych wartości: item_id lub item_name.
item_name	string	Tak*	koszulka „Stan and Friends”,	Nazwa elementu. *Wymagana jest jedna z tych wartości: item_id lub item_name.
affiliation	string	Nie	Google Store	Powiązanie produktu umożliwiające wskazanie jego dostawcy lub lokalizacji sklepu stacjonarnego. Uwaga: affiliation jest dostępny tylko w zakresie elementu.
coupon	string	Nie	SUMMER_FUN	Nazwa lub kod kuponu powiązanego z produktem. Parametry na poziomie zdarzenia i produktu są niezależne od siebie. coupon
discount	number	Nie	2.22	Wartość rabatu kwotowego powiązanego z produktem.
index	number	Nie	5	Indeks lub pozycja produktu na liście.
item_brand	string	Nie	Google	Marka produktu.
item_category	string	Nie	Odzież	Kategoria produktu. Jeśli jest używana w hierarchii kategorii lub taksonomii, będzie to pierwsza kategoria.
item_category2	string	Nie	Dorosły	Druga hierarchia kategorii lub dodatkowa mapa kategorii dla produktu.
item_category3	string	Nie	Koszule	Trzecia hierarchia kategorii lub dodatkowa mapa kategorii dla elementu.
item_category4	string	Nie	Ekipa	Czwarta hierarchia kategorii lub dodatkowa mapa kategorii dla elementu.
item_category5	string	Nie	Krótki rękaw	Piąta hierarchia kategorii lub dodatkowa mapa kategorii dla elementu.
item_list_id	string	Nie	related_products	Identyfikator listy, na której produkt został przedstawiony użytkownikowi. Jeśli ten parametr jest ustawiony, parametr item_list_id na poziomie zdarzenia jest ignorowany. Jeśli nie jest ustawiona, używana jest wartość item_list_id na poziomie zdarzenia, o ile jest dostępna.
item_list_name	string	Nie	Produkty powiązane	Nazwa listy, na której produkt został przedstawiony użytkownikowi. Jeśli ten parametr jest ustawiony, parametr item_list_name na poziomie zdarzenia jest ignorowany. Jeśli nie jest ustawiona, używana jest wartość item_list_name na poziomie zdarzenia, o ile jest dostępna.
item_variant	string	Nie	zielony	Wersja produktu, czyli niepowtarzalny kod lub opis, które pozwalają wybrać dodatkowe szczegóły lub opcje produktu.
location_id	string	Nie	ChIJIQBpAG2ahYAR_6128GcTUEo (identyfikator miejsca w Google dla San Francisco)	Lokalizacja fizyczna powiązana z produktem (np. lokalizacja sklepu stacjonarnego). Zalecamy używanie identyfikatora miejsca w Google, który odpowiada powiązanemu produktowi. Możesz też użyć niestandardowego identyfikatora lokalizacji. Uwaga: location_id jest dostępny tylko w zakresie elementu.
price	number	Nie	10.01	Cena jednostkowa produktu w jednostkach określonej waluty. Jeśli produkt jest objęty rabatem, ustaw wartość price na obniżoną cenę jednostkową i określ rabat ceny jednostkowej w parametrze discount.
quantity	number	Nie	3	Liczba produktów. Jeśli nie zostanie ustawiona, wartość quantity wyniesie 1.

Oprócz określonych parametrów możesz uwzględnić w tablicy items do 27 parametrów niestandardowych.

Przykład

Poniższy przykład dotyczy wdrożeń tagu gtag.js:

gtag("event", "refund", {
  currency: "USD",
  transaction_id: "T_12345", // Transaction ID. Required for purchases and refunds.
  value: 30.03,
  coupon: "SUMMER_FUN",
  shipping: 3.33,
  tax: 1.11,
  items: [
    {
      item_id: "SKU_12345",
      item_name: "Stan and Friends Tee",
      affiliation: "Google Merchandise Store",
      coupon: "SUMMER_FUN",
      discount: 2.22,
      index: 0,
      item_brand: "Google",
      item_category: "Apparel",
      item_category2: "Adult",
      item_category3: "Shirts",
      item_category4: "Crew",
      item_category5: "Short sleeve",
      item_list_id: "related_products",
      item_list_name: "Related Products",
      item_variant: "green",
      location_id: "ChIJIQBpAG2ahYAR_6128GcTUEo",
      price: 10.01,
      google_business_vertical: "retail",
      quantity: 3
    }
  ]
});

remove_from_cart

To zdarzenie oznacza, że produkt został usunięty z koszyka.

Parametry

Nazwa	Typ	Wymagane	Przykładowa wartość	Opis
currency	string	Tak*	USD	Waluta produktów powiązanych ze zdarzeniem podana w 3-literowym formacie ISO 4217. * Dane o wartości zdarzenia view_item nie przyczyniają się do przychodów. * Jeśli określisz parametr value, do prawidłowego obliczania danych o przychodach niezbędne jest podanie parametru currency.
value	number	Tak*	30.03	Wartość pieniężna zdarzenia. * Ustaw value na sumę (price * quantity) dla wszystkich elementów w items. Nie uwzględniaj shipping ani tax. * value jest zwykle wymagany do uzyskania przydatnych raportów. Jeśli oznaczysz zdarzenie jako kluczowe zdarzenie, zalecamy ustawienie value. * currency jest wymagany, jeśli ustawisz value.
items	Array<Item>	Tak		Produkty powiązane ze zdarzeniem.

Parametry produktu

Nazwa	Typ	Wymagane	Przykładowa wartość	Opis
item_id	string	Tak*	SKU_12345	Identyfikator elementu. *Wymagana jest jedna z tych wartości: item_id lub item_name.
item_name	string	Tak*	koszulka „Stan and Friends”,	Nazwa elementu. *Wymagana jest jedna z tych wartości: item_id lub item_name.
affiliation	string	Nie	Google Store	Powiązanie produktu umożliwiające wskazanie jego dostawcy lub lokalizacji sklepu stacjonarnego. Uwaga: affiliation jest dostępny tylko w zakresie elementu.
coupon	string	Nie	SUMMER_FUN	Nazwa lub kod kuponu powiązanego z produktem. Parametry na poziomie zdarzenia i produktu są niezależne od siebie. coupon
discount	number	Nie	2.22	Wartość rabatu kwotowego powiązanego z produktem.
index	number	Nie	5	Indeks lub pozycja produktu na liście.
item_brand	string	Nie	Google	Marka produktu.
item_category	string	Nie	Odzież	Kategoria produktu. Jeśli jest używana w hierarchii kategorii lub taksonomii, będzie to pierwsza kategoria.
item_category2	string	Nie	Dorosły	Druga hierarchia kategorii lub dodatkowa mapa kategorii dla produktu.
item_category3	string	Nie	Koszule	Trzecia hierarchia kategorii lub dodatkowa mapa kategorii dla elementu.
item_category4	string	Nie	Ekipa	Czwarta hierarchia kategorii lub dodatkowa mapa kategorii dla elementu.
item_category5	string	Nie	Krótki rękaw	Piąta hierarchia kategorii lub dodatkowa mapa kategorii dla elementu.
item_list_id	string	Nie	related_products	Identyfikator listy, na której produkt został przedstawiony użytkownikowi. Jeśli ten parametr jest ustawiony, parametr item_list_id na poziomie zdarzenia jest ignorowany. Jeśli nie jest ustawiona, używana jest wartość item_list_id na poziomie zdarzenia, o ile jest dostępna.
item_list_name	string	Nie	Produkty powiązane	Nazwa listy, na której produkt został przedstawiony użytkownikowi. Jeśli ten parametr jest ustawiony, parametr item_list_name na poziomie zdarzenia jest ignorowany. Jeśli nie jest ustawiona, używana jest wartość item_list_name na poziomie zdarzenia, o ile jest dostępna.
item_variant	string	Nie	zielony	Wersja produktu, czyli niepowtarzalny kod lub opis, które pozwalają wybrać dodatkowe szczegóły lub opcje produktu.
location_id	string	Nie	ChIJIQBpAG2ahYAR_6128GcTUEo (identyfikator miejsca w Google dla San Francisco)	Lokalizacja fizyczna powiązana z produktem (np. lokalizacja sklepu stacjonarnego). Zalecamy używanie identyfikatora miejsca w Google, który odpowiada powiązanemu produktowi. Możesz też użyć niestandardowego identyfikatora lokalizacji. Uwaga: location_id jest dostępny tylko w zakresie elementu.
price	number	Nie	10.01	Cena jednostkowa produktu w jednostkach określonej waluty. Jeśli produkt jest objęty rabatem, ustaw wartość price na obniżoną cenę jednostkową i określ rabat ceny jednostkowej w parametrze discount.
quantity	number	Nie	3	Liczba produktów. Jeśli nie zostanie ustawiona, wartość quantity wyniesie 1.

Oprócz określonych parametrów możesz uwzględnić w tablicy items do 27 parametrów niestandardowych.

Przykład

Poniższy przykład dotyczy wdrożeń tagu gtag.js:

gtag("event", "remove_from_cart", {
  currency: "USD",
  value: 30.03,
  items: [
    {
      item_id: "SKU_12345",
      item_name: "Stan and Friends Tee",
      affiliation: "Google Merchandise Store",
      coupon: "SUMMER_FUN",
      discount: 2.22,
      index: 0,
      item_brand: "Google",
      item_category: "Apparel",
      item_category2: "Adult",
      item_category3: "Shirts",
      item_category4: "Crew",
      item_category5: "Short sleeve",
      item_list_id: "related_products",
      item_list_name: "Related Products",
      item_variant: "green",
      location_id: "ChIJIQBpAG2ahYAR_6128GcTUEo",
      price: 10.01,
      google_business_vertical: "retail",
      quantity: 3
    }
  ]
});

select_item

To wydarzenie oznacza, że element został wybrany z listy.

Parametry

Nazwa	Typ	Wymagane	Przykładowa wartość	Opis
item_list_id	string	Nie	related_products	Identyfikator listy, na której produkt został przedstawiony użytkownikowi. Ignorowany, jeśli jest ustawiony na poziomie produktu.
item_list_name	string	Nie	Produkty powiązane	Nazwa listy, na której produkt został przedstawiony użytkownikowi. Ignorowany, jeśli jest ustawiony na poziomie produktu.
items	Array<Item>	Tak		Produkty powiązane ze zdarzeniem.

Parametry produktu

Nazwa	Typ	Wymagane	Przykładowa wartość	Opis
item_id	string	Tak*	SKU_12345	Identyfikator elementu. *Wymagana jest jedna z tych wartości: item_id lub item_name.
item_name	string	Tak*	koszulka „Stan and Friends”,	Nazwa elementu. *Wymagana jest jedna z tych wartości: item_id lub item_name.
affiliation	string	Nie	Google Store	Powiązanie produktu umożliwiające wskazanie jego dostawcy lub lokalizacji sklepu stacjonarnego. Uwaga: affiliation jest dostępny tylko w zakresie elementu.
coupon	string	Nie	SUMMER_FUN	Nazwa lub kod kuponu powiązanego z produktem. Parametry na poziomie zdarzenia i produktu są niezależne od siebie. coupon
discount	number	Nie	2.22	Wartość rabatu kwotowego powiązanego z produktem.
index	number	Nie	5	Indeks lub pozycja produktu na liście.
item_brand	string	Nie	Google	Marka produktu.
item_category	string	Nie	Odzież	Kategoria produktu. Jeśli jest używana w hierarchii kategorii lub taksonomii, będzie to pierwsza kategoria.
item_category2	string	Nie	Dorosły	Druga hierarchia kategorii lub dodatkowa mapa kategorii dla produktu.
item_category3	string	Nie	Koszule	Trzecia hierarchia kategorii lub dodatkowa mapa kategorii dla elementu.
item_category4	string	Nie	Ekipa	Czwarta hierarchia kategorii lub dodatkowa mapa kategorii dla elementu.
item_category5	string	Nie	Krótki rękaw	Piąta hierarchia kategorii lub dodatkowa mapa kategorii dla elementu.
item_list_id	string	Nie	related_products	Identyfikator listy, na której produkt został przedstawiony użytkownikowi. Jeśli ten parametr jest ustawiony, parametr item_list_id na poziomie zdarzenia jest ignorowany. Jeśli nie jest ustawiona, używana jest wartość item_list_id na poziomie zdarzenia, o ile jest dostępna.
item_list_name	string	Nie	Produkty powiązane	Nazwa listy, na której produkt został przedstawiony użytkownikowi. Jeśli ten parametr jest ustawiony, parametr item_list_name na poziomie zdarzenia jest ignorowany. Jeśli nie jest ustawiona, używana jest wartość item_list_name na poziomie zdarzenia, o ile jest dostępna.
item_variant	string	Nie	zielony	Wersja produktu, czyli niepowtarzalny kod lub opis, które pozwalają wybrać dodatkowe szczegóły lub opcje produktu.
location_id	string	Nie	ChIJIQBpAG2ahYAR_6128GcTUEo (identyfikator miejsca w Google dla San Francisco)	Lokalizacja fizyczna powiązana z produktem (np. lokalizacja sklepu stacjonarnego). Zalecamy używanie identyfikatora miejsca w Google, który odpowiada powiązanemu produktowi. Możesz też użyć niestandardowego identyfikatora lokalizacji. Uwaga: location_id jest dostępny tylko w zakresie elementu.
price	number	Nie	10.01	Cena jednostkowa produktu w jednostkach określonej waluty. Jeśli produkt jest objęty rabatem, ustaw wartość price na obniżoną cenę jednostkową i określ rabat ceny jednostkowej w parametrze discount.
quantity	number	Nie	3	Liczba produktów. Jeśli nie zostanie ustawiona, wartość quantity wyniesie 1.

Oprócz określonych parametrów możesz uwzględnić w tablicy items do 27 parametrów niestandardowych.

Przykład

Poniższy przykład dotyczy wdrożeń tagu gtag.js:

gtag("event", "select_item", {
  item_list_id: "related_products",
  item_list_name: "Related products",
  items: [
    {
      item_id: "SKU_12345",
      item_name: "Stan and Friends Tee",
      affiliation: "Google Merchandise Store",
      coupon: "SUMMER_FUN",
      discount: 2.22,
      index: 0,
      item_brand: "Google",
      item_category: "Apparel",
      item_category2: "Adult",
      item_category3: "Shirts",
      item_category4: "Crew",
      item_category5: "Short sleeve",
      item_list_id: "related_products",
      item_list_name: "Related Products",
      item_variant: "green",
      location_id: "ChIJIQBpAG2ahYAR_6128GcTUEo",
      price: 10.01,
      google_business_vertical: "retail",
      quantity: 3
    }
  ]
});

select_promotion

To wydarzenie oznacza, że promocja została wybrana z listy.

Parametry

Nazwa	Typ	Wymagane	Przykładowa wartość	Opis
creative_name	string	Nie	summer_banner2	Nazwa kreacji promocyjnej.
creative_slot	string	Nie	featured_app_1	Nazwa boksu kreacji promocyjnej powiązanego ze zdarzeniem.
promotion_id	string	Nie	P_12345	Identyfikator promocji powiązanej ze zdarzeniem.
promotion_name	string	Nie	Letnia wyprzedaż	Nazwa promocji powiązanej ze zdarzeniem.
items	Array<Item>	Nie*		Produkty powiązane ze zdarzeniem. * Jeśli tablica items nie jest uwzględniona, niektóre raporty, np. raport Promocje, i rodzaje danych nie będą uwzględniać tego zdarzenia związanego z promocją.

Aby wypełnić w raportach Google Analytics wymiary promocji ograniczone do produktu, takie jak „Identyfikator promocji produktu” lub „Nazwa promocji produktu”, usługa Google Analytics najpierw wyszukuje odpowiednie parametry promocji (promotion_id, promotion_name, creative_name i creative_slot) w każdym konkretnym obiekcie w tablicy items zdarzeń e-commerce. Jeśli w obiekcie elementu nie znajdzie się parametr, Google Analytics użyje wartości z parametru na poziomie zdarzenia, jeśli taki parametr zostanie podany. Wymiar promocji ograniczony do produktu w przypadku konkretnego produktu będzie raportowany jako „(not set)” tylko wtedy, gdy odpowiedni parametr nie występuje *ani* w obiekcie produktu, *ani* w parametrach na poziomie zdarzenia. Parametry na poziomie produktu mają zawsze pierwszeństwo przed parametrami na poziomie zdarzenia.

Parametry produktu

Nazwa	Typ	Wymagane	Przykładowa wartość	Opis
item_id	string	Tak*	SKU_12345	Identyfikator elementu. *Wymagana jest jedna z tych wartości: item_id lub item_name.
item_name	string	Tak*	koszulka „Stan and Friends”,	Nazwa elementu. *Wymagana jest jedna z tych wartości: item_id lub item_name.
affiliation	string	Nie	Google Store	Powiązanie produktu umożliwiające wskazanie jego dostawcy lub lokalizacji sklepu stacjonarnego. Uwaga: affiliation jest dostępny tylko w zakresie elementu.
coupon	string	Nie	SUMMER_FUN	Nazwa lub kod kuponu powiązanego z produktem. Parametry na poziomie zdarzenia i produktu są niezależne od siebie. coupon
creative_name	string	Nie	summer_banner2	Nazwa kreacji promocyjnej. Jeśli nie zostanie ustawiony, domyślnie przyjmuje wartość creative_name na poziomie wydarzenia.
creative_slot	string	Nie	featured_app_1	Nazwa boksu kreacji promocyjnej powiązanego z produktem. Jeśli nie zostanie ustawiony, domyślnie przyjmuje wartość creative_slot na poziomie wydarzenia.
discount	number	Nie	2.22	Wartość rabatu kwotowego powiązanego z produktem.
index	number	Nie	5	Indeks lub pozycja produktu na liście.
item_brand	string	Nie	Google	Marka produktu.
item_category	string	Nie	Odzież	Kategoria produktu. Jeśli jest używana w hierarchii kategorii lub taksonomii, będzie to pierwsza kategoria.
item_category2	string	Nie	Dorosły	Druga hierarchia kategorii lub dodatkowa mapa kategorii dla produktu.
item_category3	string	Nie	Koszule	Trzecia hierarchia kategorii lub dodatkowa mapa kategorii dla elementu.
item_category4	string	Nie	Ekipa	Czwarta hierarchia kategorii lub dodatkowa mapa kategorii dla elementu.
item_category5	string	Nie	Krótki rękaw	Piąta hierarchia kategorii lub dodatkowa mapa kategorii dla elementu.
item_list_id	string	Nie	related_products	Identyfikator listy, na której produkt został przedstawiony użytkownikowi. Jeśli ten parametr jest ustawiony, parametr item_list_id na poziomie zdarzenia jest ignorowany. Jeśli nie jest ustawiona, używana jest wartość item_list_id na poziomie zdarzenia, o ile jest dostępna.
item_list_name	string	Nie	Produkty powiązane	Nazwa listy, na której produkt został przedstawiony użytkownikowi. Jeśli ten parametr jest ustawiony, parametr item_list_name na poziomie zdarzenia jest ignorowany. Jeśli nie jest ustawiona, używana jest wartość item_list_name na poziomie zdarzenia, o ile jest dostępna.
item_variant	string	Nie	zielony	Wersja produktu, czyli niepowtarzalny kod lub opis, które pozwalają wybrać dodatkowe szczegóły lub opcje produktu.
location_id	string	Nie	ChIJIQBpAG2ahYAR_6128GcTUEo (identyfikator miejsca w Google dla San Francisco)	Lokalizacja fizyczna powiązana z produktem (np. lokalizacja sklepu stacjonarnego). Zalecamy używanie identyfikatora miejsca w Google, który odpowiada powiązanemu produktowi. Możesz też użyć niestandardowego identyfikatora lokalizacji. Uwaga: location_id jest dostępny tylko w zakresie elementu.
price	number	Nie	10.01	Cena jednostkowa produktu w jednostkach określonej waluty. Jeśli produkt jest objęty rabatem, ustaw wartość price na obniżoną cenę jednostkową i określ rabat ceny jednostkowej w parametrze discount.
promotion_id	string	Nie	P_12345	Identyfikator promocji powiązanej z produktem. Jeśli nie zostanie ustawiony, domyślnie przyjmuje wartość promotion_id na poziomie wydarzenia.
promotion_name	string	Nie	Letnia wyprzedaż	Nazwa promocji powiązanej z produktem. Jeśli nie zostanie ustawiony, domyślnie przyjmuje wartość promotion_name na poziomie wydarzenia.
quantity	number	Nie	3	Liczba produktów. Jeśli nie zostanie ustawiona, wartość quantity wyniesie 1.

Oprócz określonych parametrów możesz uwzględnić w tablicy items do 27 parametrów niestandardowych.

Przykład

Poniższy przykład dotyczy wdrożeń tagu gtag.js:

gtag("event", "select_promotion", {
  creative_name: "Summer Banner",
  creative_slot: "featured_app_1",
  promotion_id: "P_12345",
  promotion_name: "Summer Sale",
  items: [
    {
      item_id: "SKU_12345",
      item_name: "Stan and Friends Tee",
      affiliation: "Google Merchandise Store",
      coupon: "SUMMER_FUN",
      creative_name: "summer_banner2",
      creative_slot: "featured_app_1",
      discount: 2.22,
      index: 0,
      item_brand: "Google",
      item_category: "Apparel",
      item_category2: "Adult",
      item_category3: "Shirts",
      item_category4: "Crew",
      item_category5: "Short sleeve",
      item_list_id: "related_products",
      item_list_name: "Related Products",
      item_variant: "green",
      location_id: "ChIJIQBpAG2ahYAR_6128GcTUEo",
      price: 10.01,
      promotion_id: "P_12345",
      promotion_name: "Summer Sale",
      google_business_vertical: "retail",
      quantity: 3
    }
  ],
});

view_cart

To zdarzenie oznacza, że użytkownik wyświetlił zawartość koszyka.

Parametry

Nazwa	Typ	Wymagane	Przykładowa wartość	Opis
currency	string	Tak*	USD	Waluta produktów powiązanych ze zdarzeniem podana w 3-literowym formacie ISO 4217. * Dane o wartości zdarzenia view_item nie przyczyniają się do przychodów. * Jeśli określisz parametr value, do prawidłowego obliczania danych o przychodach niezbędne jest podanie parametru currency.
value	number	Tak*	30.03	Wartość pieniężna zdarzenia. * Ustaw value na sumę (price * quantity) dla wszystkich elementów w items. Nie uwzględniaj shipping ani tax. * value jest zwykle wymagany do uzyskania przydatnych raportów. Jeśli oznaczysz zdarzenie jako kluczowe zdarzenie, zalecamy ustawienie value. * currency jest wymagany, jeśli ustawisz value.
items	Array<Item>	Tak		Produkty powiązane ze zdarzeniem.

Parametry produktu

Nazwa	Typ	Wymagane	Przykładowa wartość	Opis
item_id	string	Tak*	SKU_12345	Identyfikator elementu. *Wymagana jest jedna z tych wartości: item_id lub item_name.
item_name	string	Tak*	koszulka „Stan and Friends”,	Nazwa elementu. *Wymagana jest jedna z tych wartości: item_id lub item_name.
affiliation	string	Nie	Google Store	Powiązanie produktu umożliwiające wskazanie jego dostawcy lub lokalizacji sklepu stacjonarnego. Uwaga: affiliation jest dostępny tylko w zakresie elementu.
coupon	string	Nie	SUMMER_FUN	Nazwa lub kod kuponu powiązanego z produktem. Parametry na poziomie zdarzenia i produktu są niezależne od siebie. coupon
discount	number	Nie	2.22	Wartość rabatu kwotowego powiązanego z produktem.
index	number	Nie	5	Indeks lub pozycja produktu na liście.
item_brand	string	Nie	Google	Marka produktu.
item_category	string	Nie	Odzież	Kategoria produktu. Jeśli jest używana w hierarchii kategorii lub taksonomii, będzie to pierwsza kategoria.
item_category2	string	Nie	Dorosły	Druga hierarchia kategorii lub dodatkowa mapa kategorii dla produktu.
item_category3	string	Nie	Koszule	Trzecia hierarchia kategorii lub dodatkowa mapa kategorii dla elementu.
item_category4	string	Nie	Ekipa	Czwarta hierarchia kategorii lub dodatkowa mapa kategorii dla elementu.
item_category5	string	Nie	Krótki rękaw	Piąta hierarchia kategorii lub dodatkowa mapa kategorii dla elementu.
item_list_id	string	Nie	related_products	Identyfikator listy, na której produkt został przedstawiony użytkownikowi. Jeśli ten parametr jest ustawiony, parametr item_list_id na poziomie zdarzenia jest ignorowany. Jeśli nie jest ustawiona, używana jest wartość item_list_id na poziomie zdarzenia, o ile jest dostępna.
item_list_name	string	Nie	Produkty powiązane	Nazwa listy, na której produkt został przedstawiony użytkownikowi. Jeśli ten parametr jest ustawiony, parametr item_list_name na poziomie zdarzenia jest ignorowany. Jeśli nie jest ustawiona, używana jest wartość item_list_name na poziomie zdarzenia, o ile jest dostępna.
item_variant	string	Nie	zielony	Wersja produktu, czyli niepowtarzalny kod lub opis, które pozwalają wybrać dodatkowe szczegóły lub opcje produktu.
location_id	string	Nie	ChIJIQBpAG2ahYAR_6128GcTUEo (identyfikator miejsca w Google dla San Francisco)	Lokalizacja fizyczna powiązana z produktem (np. lokalizacja sklepu stacjonarnego). Zalecamy używanie identyfikatora miejsca w Google, który odpowiada powiązanemu produktowi. Możesz też użyć niestandardowego identyfikatora lokalizacji. Uwaga: location_id jest dostępny tylko w zakresie elementu.
price	number	Nie	10.01	Cena jednostkowa produktu w jednostkach określonej waluty. Jeśli produkt jest objęty rabatem, ustaw wartość price na obniżoną cenę jednostkową i określ rabat ceny jednostkowej w parametrze discount.
quantity	number	Nie	3	Liczba produktów. Jeśli nie zostanie ustawiona, wartość quantity wyniesie 1.

Oprócz określonych parametrów możesz uwzględnić w tablicy items do 27 parametrów niestandardowych.

Przykład

Poniższy przykład dotyczy wdrożeń tagu gtag.js:

gtag("event", "view_cart", {
  currency: "USD",
  value: 30.03,
  items: [
    {
      item_id: "SKU_12345",
      item_name: "Stan and Friends Tee",
      affiliation: "Google Merchandise Store",
      coupon: "SUMMER_FUN",
      discount: 2.22,
      index: 0,
      item_brand: "Google",
      item_category: "Apparel",
      item_category2: "Adult",
      item_category3: "Shirts",
      item_category4: "Crew",
      item_category5: "Short sleeve",
      item_list_id: "related_products",
      item_list_name: "Related Products",
      item_variant: "green",
      location_id: "ChIJIQBpAG2ahYAR_6128GcTUEo",
      price: 10.01,
      google_business_vertical: "retail",
      quantity: 3
    }
  ]
});

view_item

To zdarzenie oznacza, że użytkownikowi wyświetlono pewne treści. Użyj tego zdarzenia, aby odkryć najpopularniejsze wyświetlane produkty.

Parametry

Nazwa	Typ	Wymagane	Przykładowa wartość	Opis
currency	string	Tak*	USD	Waluta produktów powiązanych ze zdarzeniem podana w 3-literowym formacie ISO 4217. * Dane o wartości zdarzenia view_item nie przyczyniają się do przychodów. * Jeśli określisz parametr value, do prawidłowego obliczania danych o przychodach niezbędne jest podanie parametru currency.
value	number	Tak*	30.03	Wartość pieniężna zdarzenia. * Ustaw value na sumę (price * quantity) dla wszystkich elementów w items. Nie uwzględniaj shipping ani tax. * value jest zwykle wymagany do uzyskania przydatnych raportów. Jeśli oznaczysz zdarzenie jako kluczowe zdarzenie, zalecamy ustawienie value. * currency jest wymagany, jeśli ustawisz value.
items	Array<Item>	Tak		Produkty powiązane ze zdarzeniem.

Parametry produktu

Nazwa	Typ	Wymagane	Przykładowa wartość	Opis
item_id	string	Tak*	SKU_12345	Identyfikator elementu. *Wymagana jest jedna z tych wartości: item_id lub item_name.
item_name	string	Tak*	koszulka „Stan and Friends”,	Nazwa elementu. *Wymagana jest jedna z tych wartości: item_id lub item_name.
affiliation	string	Nie	Google Store	Powiązanie produktu umożliwiające wskazanie jego dostawcy lub lokalizacji sklepu stacjonarnego. Uwaga: affiliation jest dostępny tylko w zakresie elementu.
coupon	string	Nie	SUMMER_FUN	Nazwa lub kod kuponu powiązanego z produktem. Parametry na poziomie zdarzenia i produktu są niezależne od siebie. coupon
discount	number	Nie	2.22	Wartość rabatu kwotowego powiązanego z produktem.
index	number	Nie	5	Indeks lub pozycja produktu na liście.
item_brand	string	Nie	Google	Marka produktu.
item_category	string	Nie	Odzież	Kategoria produktu. Jeśli jest używana w hierarchii kategorii lub taksonomii, będzie to pierwsza kategoria.
item_category2	string	Nie	Dorosły	Druga hierarchia kategorii lub dodatkowa mapa kategorii dla produktu.
item_category3	string	Nie	Koszule	Trzecia hierarchia kategorii lub dodatkowa mapa kategorii dla elementu.
item_category4	string	Nie	Ekipa	Czwarta hierarchia kategorii lub dodatkowa mapa kategorii dla elementu.
item_category5	string	Nie	Krótki rękaw	Piąta hierarchia kategorii lub dodatkowa mapa kategorii dla elementu.
item_list_id	string	Nie	related_products	Identyfikator listy, na której produkt został przedstawiony użytkownikowi. Jeśli ten parametr jest ustawiony, parametr item_list_id na poziomie zdarzenia jest ignorowany. Jeśli nie jest ustawiona, używana jest wartość item_list_id na poziomie zdarzenia, o ile jest dostępna.
item_list_name	string	Nie	Produkty powiązane	Nazwa listy, na której produkt został przedstawiony użytkownikowi. Jeśli ten parametr jest ustawiony, parametr item_list_name na poziomie zdarzenia jest ignorowany. Jeśli nie jest ustawiona, używana jest wartość item_list_name na poziomie zdarzenia, o ile jest dostępna.
item_variant	string	Nie	zielony	Wersja produktu, czyli niepowtarzalny kod lub opis, które pozwalają wybrać dodatkowe szczegóły lub opcje produktu.
location_id	string	Nie	ChIJIQBpAG2ahYAR_6128GcTUEo (identyfikator miejsca w Google dla San Francisco)	Lokalizacja fizyczna powiązana z produktem (np. lokalizacja sklepu stacjonarnego). Zalecamy używanie identyfikatora miejsca w Google, który odpowiada powiązanemu produktowi. Możesz też użyć niestandardowego identyfikatora lokalizacji. Uwaga: location_id jest dostępny tylko w zakresie elementu.
price	number	Nie	10.01	Cena jednostkowa produktu w jednostkach określonej waluty. Jeśli produkt jest objęty rabatem, ustaw wartość price na obniżoną cenę jednostkową i określ rabat ceny jednostkowej w parametrze discount.
quantity	number	Nie	3	Liczba produktów. Jeśli nie zostanie ustawiona, wartość quantity wyniesie 1.

Oprócz określonych parametrów możesz uwzględnić w tablicy items do 27 parametrów niestandardowych.

Przykład

Poniższy przykład dotyczy wdrożeń tagu gtag.js:

gtag("event", "view_item", {
  currency: "USD",
  value: 30.03,
  items: [
    {
      item_id: "SKU_12345",
      item_name: "Stan and Friends Tee",
      affiliation: "Google Merchandise Store",
      coupon: "SUMMER_FUN",
      discount: 2.22,
      index: 0,
      item_brand: "Google",
      item_category: "Apparel",
      item_category2: "Adult",
      item_category3: "Shirts",
      item_category4: "Crew",
      item_category5: "Short sleeve",
      item_list_id: "related_products",
      item_list_name: "Related Products",
      item_variant: "green",
      location_id: "ChIJIQBpAG2ahYAR_6128GcTUEo",
      price: 10.01,
      google_business_vertical: "retail",
      quantity: 3
    }
  ]
});

view_item_list

Rejestruj to zdarzenie, gdy użytkownikowi zostanie wyświetlona lista produktów z określonej kategorii.

Parametry

Nazwa	Typ	Wymagane	Przykładowa wartość	Opis
currency	string	Tak*	USD	Waluta produktów powiązanych ze zdarzeniem podana w 3-literowym formacie ISO 4217. Dane o wartości w zdarzeniu view_item nie przyczyniają się do przychodów * Jeśli określisz parametr value, do prawidłowego obliczania danych o przychodach niezbędne jest podanie parametru currency.
item_list_id	string	Nie	related_products	Identyfikator listy, na której produkt został przedstawiony użytkownikowi. Ignorowany, jeśli jest ustawiony na poziomie produktu.
item_list_name	string	Nie	Produkty powiązane	Nazwa listy, na której produkt został przedstawiony użytkownikowi. Ignorowany, jeśli jest ustawiony na poziomie produktu.
items	Array<Item>	Tak		Produkty powiązane ze zdarzeniem.

Parametry produktu

Nazwa	Typ	Wymagane	Przykładowa wartość	Opis
item_id	string	Tak*	SKU_12345	Identyfikator elementu. *Wymagana jest jedna z tych wartości: item_id lub item_name.
item_name	string	Tak*	koszulka „Stan and Friends”,	Nazwa elementu. *Wymagana jest jedna z tych wartości: item_id lub item_name.
affiliation	string	Nie	Google Store	Powiązanie produktu umożliwiające wskazanie jego dostawcy lub lokalizacji sklepu stacjonarnego. Uwaga: affiliation jest dostępny tylko w zakresie elementu.
coupon	string	Nie	SUMMER_FUN	Nazwa lub kod kuponu powiązanego z produktem. Parametry na poziomie zdarzenia i produktu są niezależne od siebie. coupon
discount	number	Nie	2.22	Wartość rabatu kwotowego powiązanego z produktem.
index	number	Nie	5	Indeks lub pozycja produktu na liście.
item_brand	string	Nie	Google	Marka produktu.
item_category	string	Nie	Odzież	Kategoria produktu. Jeśli jest używana w hierarchii kategorii lub taksonomii, będzie to pierwsza kategoria.
item_category2	string	Nie	Dorosły	Druga hierarchia kategorii lub dodatkowa mapa kategorii dla produktu.
item_category3	string	Nie	Koszule	Trzecia hierarchia kategorii lub dodatkowa mapa kategorii dla elementu.
item_category4	string	Nie	Ekipa	Czwarta hierarchia kategorii lub dodatkowa mapa kategorii dla elementu.
item_category5	string	Nie	Krótki rękaw	Piąta hierarchia kategorii lub dodatkowa mapa kategorii dla elementu.
item_list_id	string	Nie	related_products	Identyfikator listy, na której produkt został przedstawiony użytkownikowi. Jeśli ten parametr jest ustawiony, parametr item_list_id na poziomie zdarzenia jest ignorowany. Jeśli nie jest ustawiona, używana jest wartość item_list_id na poziomie zdarzenia, o ile jest dostępna.
item_list_name	string	Nie	Produkty powiązane	Nazwa listy, na której produkt został przedstawiony użytkownikowi. Jeśli ten parametr jest ustawiony, parametr item_list_name na poziomie zdarzenia jest ignorowany. Jeśli nie jest ustawiona, używana jest wartość item_list_name na poziomie zdarzenia, o ile jest dostępna.
item_variant	string	Nie	zielony	Wersja produktu, czyli niepowtarzalny kod lub opis, które pozwalają wybrać dodatkowe szczegóły lub opcje produktu.
location_id	string	Nie	ChIJIQBpAG2ahYAR_6128GcTUEo (identyfikator miejsca w Google dla San Francisco)	Lokalizacja fizyczna powiązana z produktem (np. lokalizacja sklepu stacjonarnego). Zalecamy używanie identyfikatora miejsca w Google, który odpowiada powiązanemu produktowi. Możesz też użyć niestandardowego identyfikatora lokalizacji. Uwaga: location_id jest dostępny tylko w zakresie elementu.
price	number	Nie	10.01	Cena jednostkowa produktu w jednostkach określonej waluty. Jeśli produkt jest objęty rabatem, ustaw wartość price na obniżoną cenę jednostkową i określ rabat ceny jednostkowej w parametrze discount.
quantity	number	Nie	3	Liczba produktów. Jeśli nie zostanie ustawiona, wartość quantity wyniesie 1.

Oprócz określonych parametrów możesz uwzględnić w tablicy items do 27 parametrów niestandardowych.

Przykład

Poniższy przykład dotyczy wdrożeń tagu gtag.js:

gtag("event", "view_item_list", {
  item_list_id: "related_products",
  item_list_name: "Related products",
  items: [
    {
      item_id: "SKU_12345",
      item_name: "Stan and Friends Tee",
      affiliation: "Google Merchandise Store",
      coupon: "SUMMER_FUN",
      discount: 2.22,
      index: 0,
      item_brand: "Google",
      item_category: "Apparel",
      item_category2: "Adult",
      item_category3: "Shirts",
      item_category4: "Crew",
      item_category5: "Short sleeve",
      item_list_id: "related_products",
      item_list_name: "Related Products",
      item_variant: "green",
      location_id: "ChIJIQBpAG2ahYAR_6128GcTUEo",
      price: 10.01,
      google_business_vertical: "retail",
      quantity: 3
    }
  ]
});

view_promotion

To wydarzenie oznacza, że promocja została wyświetlona na liście.

Parametry

Nazwa	Typ	Wymagane	Przykładowa wartość	Opis
creative_name	string	Nie	summer_banner2	Nazwa kreacji promocyjnej.
creative_slot	string	Nie	featured_app_1	Nazwa boksu kreacji promocyjnej powiązanego ze zdarzeniem.
promotion_id	string	Nie	P_12345	Identyfikator promocji powiązanej ze zdarzeniem.
promotion_name	string	Nie	Letnia wyprzedaż	Nazwa promocji powiązanej ze zdarzeniem.
items	Array<Item>	Tak		Produkty powiązane ze zdarzeniem.

Aby wypełnić w raportach Google Analytics wymiary promocji ograniczone do produktu, takie jak „Identyfikator promocji produktu” lub „Nazwa promocji produktu”, usługa Google Analytics najpierw wyszukuje odpowiednie parametry promocji (promotion_id, promotion_name, creative_name i creative_slot) w każdym konkretnym obiekcie w tablicy items zdarzeń e-commerce. Jeśli w obiekcie elementu nie znajdzie się parametr, Google Analytics użyje wartości z parametru na poziomie zdarzenia, jeśli taki parametr zostanie podany. Wymiary promocji ograniczone do produktu w przypadku konkretnego produktu będą raportowane jako „(not set)” tylko wtedy, gdy odpowiedni parametr będzie brakować zarówno w obiekcie produktu, jak i w parametrach na poziomie zdarzenia. Parametry na poziomie produktu mają zawsze pierwszeństwo przed parametrami na poziomie zdarzenia.

Parametry produktu

Nazwa	Typ	Wymagane	Przykładowa wartość	Opis
item_id	string	Tak*	SKU_12345	Identyfikator elementu. *Wymagana jest jedna z tych wartości: item_id lub item_name.
item_name	string	Tak*	koszulka „Stan and Friends”,	Nazwa elementu. *Wymagana jest jedna z tych wartości: item_id lub item_name.
affiliation	string	Nie	Google Store	Powiązanie produktu umożliwiające wskazanie jego dostawcy lub lokalizacji sklepu stacjonarnego. Uwaga: affiliation jest dostępny tylko w zakresie elementu.
coupon	string	Nie	SUMMER_FUN	Nazwa lub kod kuponu powiązanego z produktem. Parametry na poziomie zdarzenia i produktu są niezależne od siebie. coupon
creative_name	string	Nie	summer_banner2	Nazwa kreacji promocyjnej. Jeśli nie zostanie ustawiony, domyślnie przyjmuje wartość creative_name na poziomie wydarzenia.
creative_slot	string	Nie	featured_app_1	Nazwa boksu kreacji promocyjnej powiązanego z produktem. Jeśli nie zostanie ustawiony, domyślnie przyjmuje wartość creative_slot na poziomie wydarzenia.
discount	number	Nie	2.22	Wartość rabatu kwotowego powiązanego z produktem.
index	number	Nie	5	Indeks lub pozycja produktu na liście.
item_brand	string	Nie	Google	Marka produktu.
item_category	string	Nie	Odzież	Kategoria produktu. Jeśli jest używana w hierarchii kategorii lub taksonomii, będzie to pierwsza kategoria.
item_category2	string	Nie	Dorosły	Druga hierarchia kategorii lub dodatkowa mapa kategorii dla produktu.
item_category3	string	Nie	Koszule	Trzecia hierarchia kategorii lub dodatkowa mapa kategorii dla elementu.
item_category4	string	Nie	Ekipa	Czwarta hierarchia kategorii lub dodatkowa mapa kategorii dla elementu.
item_category5	string	Nie	Krótki rękaw	Piąta hierarchia kategorii lub dodatkowa mapa kategorii dla elementu.
item_list_id	string	Nie	related_products	Identyfikator listy, na której produkt został przedstawiony użytkownikowi. Jeśli ten parametr jest ustawiony, parametr item_list_id na poziomie zdarzenia jest ignorowany. Jeśli nie jest ustawiona, używana jest wartość item_list_id na poziomie zdarzenia, o ile jest dostępna.
item_list_name	string	Nie	Produkty powiązane	Nazwa listy, na której produkt został przedstawiony użytkownikowi. Jeśli ten parametr jest ustawiony, parametr item_list_name na poziomie zdarzenia jest ignorowany. Jeśli nie jest ustawiona, używana jest wartość item_list_name na poziomie zdarzenia, o ile jest dostępna.
item_variant	string	Nie	zielony	Wersja produktu, czyli niepowtarzalny kod lub opis, które pozwalają wybrać dodatkowe szczegóły lub opcje produktu.
location_id	string	Nie	ChIJIQBpAG2ahYAR_6128GcTUEo (identyfikator miejsca w Google dla San Francisco)	Lokalizacja fizyczna powiązana z produktem (np. lokalizacja sklepu stacjonarnego). Zalecamy używanie identyfikatora miejsca w Google, który odpowiada powiązanemu produktowi. Możesz też użyć niestandardowego identyfikatora lokalizacji. Uwaga: location_id jest dostępny tylko w zakresie elementu.
price	number	Nie	10.01	Cena jednostkowa produktu w jednostkach określonej waluty. Jeśli produkt jest objęty rabatem, ustaw wartość price na obniżoną cenę jednostkową i określ rabat ceny jednostkowej w parametrze discount.
promotion_id	string	Nie	P_12345	Identyfikator promocji powiązanej z produktem. Jeśli nie zostanie ustawiony, domyślnie przyjmuje wartość promotion_id na poziomie wydarzenia.
promotion_name	string	Nie	Letnia wyprzedaż	Nazwa promocji powiązanej z produktem. Jeśli nie zostanie ustawiony, domyślnie przyjmuje wartość promotion_name na poziomie wydarzenia.
quantity	number	Nie	3	Liczba produktów. Jeśli nie zostanie ustawiona, wartość quantity wyniesie 1.

Oprócz określonych parametrów możesz uwzględnić w tablicy items do 27 parametrów niestandardowych.

Przykład

Poniższy przykład dotyczy wdrożeń tagu gtag.js:

gtag("event", "view_promotion", {
  creative_name: "Summer Banner",
  creative_slot: "featured_app_1",
  promotion_id: "P_12345",
  promotion_name: "Summer Sale",
  items: [
    {
      item_id: "SKU_12345",
      item_name: "Stan and Friends Tee",
      affiliation: "Google Merchandise Store",
      coupon: "SUMMER_FUN",
      creative_name: "summer_banner2",
      creative_slot: "featured_app_1",
      discount: 2.22,
      index: 0,
      item_brand: "Google",
      item_category: "Apparel",
      item_category2: "Adult",
      item_category3: "Shirts",
      item_category4: "Crew",
      item_category5: "Short sleeve",
      item_list_id: "related_products",
      item_list_name: "Related Products",
      item_variant: "green",
      location_id: "ChIJIQBpAG2ahYAR_6128GcTUEo",
      price: 10.01,
      promotion_id: "P_12345",
      promotion_name: "Summer Sale",
      google_business_vertical: "retail",
      quantity: 3
    }
  ]
});

Gry

level_end

To zdarzenie oznacza, że gracz ukończył poziom w grze.

Parametry

Nazwa	Typ	Wymagane	Przykładowa wartość	Opis
level_name	string	Nie	Podróż się zaczyna…	Nazwa poziomu.
success	boolean	Nie	prawda	Ustaw wartość true, jeśli poziom został ukończony.

Przykład

Poniższy przykład dotyczy wdrożeń tagu gtag.js:

gtag("event", "level_end", {
  level_name: "The journey begins...",
  success: true
});

level_start

To zdarzenie oznacza, że gracz rozpoczął poziom w grze.

Parametry

Nazwa	Typ	Wymagane	Przykładowa wartość	Opis
level_name	string	Nie	Podróż się zaczyna…	Nazwa poziomu.

Przykład

Poniższy przykład dotyczy wdrożeń tagu gtag.js:

gtag("event", "level_start", {
  level_name: "The journey begins..."
});

level_up

To zdarzenie oznacza, że gracz przeszedł w grze na wyższy poziom. Możesz dzięki temu ocenić rozkład poziomów wśród użytkowników i określić, które z nich są trudne do ukończenia.

Parametry

Nazwa	Typ	Wymagane	Przykładowa wartość	Opis
level	number	Nie	5	Poziom postaci.
character	string	Nie	Gracz 1	Postać, która awansowała.

Przykład

Poniższy przykład dotyczy wdrożeń tagu gtag.js:

gtag("event", "level_up", {
  level: 5,
  character: "Player 1"
});

post_score

Wysyłaj to zdarzenie, gdy użytkownik opublikuje wynik. To zdarzenie pozwala dowiedzieć się, jak użytkownicy radzą sobie w Twojej grze, i powiązać wysokie wyniki z odbiorcami lub zachowaniami.

Parametry

Nazwa	Typ	Wymagane	Przykładowa wartość	Opis
score	number	Tak	10000	Wynik do opublikowania.
level	number	Nie	5	Poziom wyniku.
character	string	Nie	Gracz 1	Postać, która osiągnęła wynik.

Przykład

Poniższy przykład dotyczy wdrożeń tagu gtag.js:

gtag("event", "post_score", {
  score: 10000,
  level: 5,
  character: "Player 1"
});

unlock_achievement

Rejestruj to zdarzenie, gdy użytkownik odblokuje osiągnięcie. To zdarzenie może pomóc Ci zrozumieć, jak użytkownicy odbierają Twoją grę.

Parametry

Nazwa	Typ	Wymagane	Przykładowa wartość	Opis
achievement_id	string	Tak	A_12345	Identyfikator odblokowanego osiągnięcia.

Przykład

Poniższy przykład dotyczy wdrożeń tagu gtag.js:

gtag("event", "unlock_achievement", {
  achievement_id: "A_12345"
});

Zwiększanie liczby potencjalnych klientów

close_convert_lead

Rejestruj to zdarzenie, gdy zakwalifikowany potencjalny klient zostanie przekształcony w klienta. Zwykle oznacza to koniec procesu pozyskiwania potencjalnych klientów, np. podpisanie umowy, rozpoczęcie płatnej subskrypcji lub sfinalizowanie sprzedaży.

• Uwaga: aby śledzić początkowe zdobywanie potencjalnych klientów, np. przesyłanie formularzy, rejestrację w newsletterze lub prośby o wersję demonstracyjną, użyj zdarzenia generate_lead.

Parametry

Nazwa	Typ	Wymagane	Przykładowa wartość	Opis
currency	string	Nie	USD	Waluta wartości powiązanej z konwersją (np. wartości umowy) w 3-literowym formacie ISO 4217. Wymagany, jeśli ustawiono value.
value	number	Nie	2500	Wartość pieniężna konwersji, np. kwota pierwszej płatności lub wartość umowy. Wymagany, jeśli ustawiono currency.

Przykład

Poniższy przykład dotyczy wdrożeń tagu gtag.js:

gtag("event", "close_convert_lead", {
  currency: "USD",
  value: 30.03
});

close_unconvert_lead

Mierzy zdarzenia, kiedy użytkownik jest oznaczany jako osoba, która nie stała się potencjalnym klientem po konwersji, wraz z podaniem przyczyny.

Parametry

Nazwa	Typ	Wymagane	Przykładowa wartość	Opis
currency	string	Tak*	USD	Waluta value zdarzenia podana w 3-literowym formacie ISO 4217. * Jeśli określisz parametr value, do prawidłowego obliczania danych o przychodach niezbędne jest podanie parametru currency.
value	number	Tak*	30.03	Wartość pieniężna zdarzenia. * value jest zwykle wymagany do uzyskania przydatnych raportów. Jeśli oznaczysz zdarzenie jako kluczowe zdarzenie, zalecamy ustawienie parametru value. * currency jest wymagany, jeśli ustawisz parametr value.
unconvert_lead_reason	string	Nie	Nigdy nie odpowiedział	Przyczyna, dla której potencjalny klient nie dokonał konwersji.

Przykład

Poniższy przykład dotyczy wdrożeń tagu gtag.js:

gtag("event", "close_unconvert_lead", {
  currency: "USD",
  value: 30.03,
  unconvert_lead_reason: "Never responded"
});

disqualify_lead

Mierzy zdarzenia, kiedy użytkownik zostaje oznaczony jako niezakwalifikowany do zostania potencjalnym klientem, wraz z przyczyną dyskwalifikacji.

Parametry

Nazwa	Typ	Wymagane	Przykładowa wartość	Opis
currency	string	Tak*	USD	Waluta value zdarzenia podana w 3-literowym formacie ISO 4217. * Jeśli określisz parametr value, do prawidłowego obliczania danych o przychodach niezbędne jest podanie parametru currency.
value	number	Tak*	30.03	Wartość pieniężna zdarzenia. * value jest zwykle wymagany do uzyskania przydatnych raportów. Jeśli oznaczysz zdarzenie jako kluczowe zdarzenie, zalecamy ustawienie parametru value. * currency jest wymagany, jeśli ustawisz parametr value.
disqualified_lead_reason	string	Nie	Nie planuję zakupu	Przyczyna oznaczenia potencjalnego klienta jako niezakwalifikowanego.

Przykład

Poniższy przykład dotyczy wdrożeń tagu gtag.js:

gtag("event", "disqualify_lead", {
  currency: "USD",
  value: 30.03,
  disqualified_lead_reason: "Not looking to buy"
});

generate_lead

To zdarzenie mierzy, kiedy został wygenerowany potencjalny klient (np. za pomocą formularza). Rejestruj to zdarzenie, aby sprawdzać skuteczność kampanii marketingowych i liczbę klientów, którzy ponownie wchodzą w interakcję z Twoją firmą po zastosowaniu remarketingu.

Parametry

Nazwa	Typ	Wymagane	Przykładowa wartość	Opis
currency	string	Tak*	USD	Waluta value zdarzenia podana w 3-literowym formacie ISO 4217. * Jeśli określisz parametr value, do prawidłowego obliczania danych o przychodach niezbędne jest podanie parametru currency.
value	number	Tak*	30.03	Wartość pieniężna zdarzenia. * value jest zwykle wymagany do uzyskania przydatnych raportów. Jeśli oznaczysz zdarzenie jako kluczowe zdarzenie, zalecamy ustawienie parametru value. * currency jest wymagany, jeśli ustawisz parametr value.
lead_source	string	Nie	Targi	Źródło potencjalnego klienta.

Przykład

Poniższy przykład dotyczy wdrożeń tagu gtag.js:

gtag("event", "generate_lead", {
  currency: "USD",
  value: 30.03,
  lead_source: "Trade show"
});

qualify_lead

Mierzy zdarzenia, kiedy użytkownik zostaje oznaczony jako spełniający kryteria kwalifikacji potencjalnych klientów.

Parametry

Nazwa	Typ	Wymagane	Przykładowa wartość	Opis
currency	string	Tak*	USD	Waluta value zdarzenia podana w 3-literowym formacie ISO 4217. * Jeśli określisz parametr value, do prawidłowego obliczania danych o przychodach niezbędne jest podanie parametru currency.
value	number	Tak*	30.03	Wartość pieniężna zdarzenia. * value jest zwykle wymagany do uzyskania przydatnych raportów. Jeśli oznaczysz zdarzenie jako kluczowe zdarzenie, zalecamy ustawienie parametru value. * currency jest wymagany, jeśli ustawisz parametr value.

Przykład

Poniższy przykład dotyczy wdrożeń tagu gtag.js:

gtag("event", "qualify_lead", {
  currency: "USD",
  value: 30.03
});

working_lead

Mierzy zdarzenia, kiedy użytkownik skontaktuje się z przedstawicielem lub przedstawiciel skontaktuje się z użytkownikiem.

Parametry

Nazwa	Typ	Wymagane	Przykładowa wartość	Opis
currency	string	Tak*	USD	Waluta value zdarzenia podana w 3-literowym formacie ISO 4217. * Jeśli określisz parametr value, do prawidłowego obliczania danych o przychodach niezbędne jest podanie parametru currency.
value	number	Tak*	30.03	Wartość pieniężna zdarzenia. * value jest zwykle wymagany do uzyskania przydatnych raportów. Jeśli oznaczysz zdarzenie jako kluczowe zdarzenie, zalecamy ustawienie parametru value. * currency jest wymagany, jeśli ustawisz parametr value.
lead_status	string	Nie	Rozpoczęte rozmowy	Stan potencjalnego klienta.

Przykład

Poniższy przykład dotyczy wdrożeń tagu gtag.js:

gtag("event", "working_lead", {
  currency: "USD",
  value: 30.03,
  lead_status: "Started conversations"
});