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:

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 implementacji Menedżera tagów:

Pokaż konfigurację tagu

Konfiguracja tagu:

  • Typ tagu: zdarzenie GA4
  • Nazwa zdarzenia: earn_virtual_currency
  • Parametry zdarzenia (nazwa parametru – wartość):
    • virtual_currency_name – Gemy
    • value - 5
  • Wywoływanie zdarzenia, gdy użytkownik otrzyma wirtualną walutę

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 implementacji Menedżera tagów:

Pokaż konfigurację tagu

Konfiguracja tagu:

  • Typ tagu: zdarzenie GA4
  • Nazwa zdarzenia: join_group
  • Parametry zdarzenia (nazwa parametru – wartość):
    • group_id - G_12345
  • Wywoływanie zdarzenia, gdy użytkownik dołącza do grupy

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

Pokaż konfigurację tagu

Konfiguracja tagu:

  • Typ tagu: zdarzenie GA4
  • Nazwa zdarzenia: login
  • Parametry zdarzenia (nazwa parametru – wartość):
    • method – Google
  • Wywoływane, gdy użytkownik się zaloguje.

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.

Pokaż konfigurację tagu

Konfiguracja tagu:

  • Typ tagu: zdarzenie GA4
  • Nazwa zdarzenia: search
  • Parametry zdarzenia (nazwa parametru – wartość):
    • search_term – t-shirty
  • Wywoływanie, gdy użytkownik przeprowadza wyszukiwanie w Twojej witrynie

Przykład

Poniższy przykład dotyczy implementacji Menedżera tagów:

Pokaż konfigurację tagu

Konfiguracja tagu:

  • Typ tagu: zdarzenie GA4
  • Nazwa zdarzenia: search
  • Parametry zdarzenia (nazwa parametru – wartość):
    • search_term – t-shirty
  • Wywoływanie, gdy użytkownik przeprowadza wyszukiwanie w Twojej witrynie

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 implementacji Menedżera tagów:

Pokaż konfigurację tagu

Konfiguracja tagu:

  • Typ tagu: zdarzenie GA4
  • Nazwa zdarzenia: select_content
  • Parametry zdarzenia (nazwa parametru – wartość):
    • content_type – produkt
    • content_id - C_12345
  • Aktywator: zdarzenie jest równe select_content

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.

Poniższy przykład dotyczy implementacji Menedżera tagów:

Pokaż konfigurację tagu

Konfiguracja tagu:

  • Typ tagu: zdarzenie GA4
  • Nazwa zdarzenia: share
  • Parametry zdarzenia (nazwa parametru – wartość):
    • method – Twitter
    • content_type – obraz
    • item_id - C_12345
  • Wywoływanie, gdy użytkownik udostępni treści

Przykład

Pokaż konfigurację tagu

Konfiguracja tagu:

  • Typ tagu: zdarzenie GA4
  • Nazwa zdarzenia: share
  • Parametry zdarzenia (nazwa parametru – wartość):
    • method – Twitter
    • content_type – obraz
    • item_id - C_12345
  • Wywoływanie, gdy użytkownik udostępni treści

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 implementacji Menedżera tagów:

Pokaż konfigurację tagu

Konfiguracja tagu:

  • Typ tagu: zdarzenie GA4
  • Nazwa zdarzenia: sign_up
  • Parametry zdarzenia (nazwa parametru – wartość):
    • method – Google
  • Wywoływane, gdy użytkownik zarejestruje się na koncie.

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 implementacji Menedżera tagów:

Pokaż konfigurację tagu

Konfiguracja tagu:

  • Typ tagu: zdarzenie GA4
  • Nazwa zdarzenia: spend_virtual_currency
  • Parametry zdarzenia (nazwa parametru – wartość):
    • value - 5
    • virtual_currency_name – Gemy
    • item_name – Starter Boost
  • Wywołuj, gdy ktoś kupi wirtualny produkt

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 implementacji Menedżera tagów:

Pokaż konfigurację tagu

Konfiguracja tagu:

  • Typ tagu: zdarzenie GA4
  • Nazwa zdarzenia: tutorial_begin
  • Uruchamiaj, gdy ktoś rozpoczyna proces wprowadzania

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 implementacji Menedżera tagów:

Pokaż konfigurację tagu

Konfiguracja tagu:

  • Typ tagu: zdarzenie GA4
  • Nazwa zdarzenia: tutorial_complete
  • Wywołuj, gdy ktoś zakończy proces wprowadzający

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 implementacji Menedżera tagów:

Pokaż konfigurację tagu

Konfiguracja tagu:

  • Typ tagu: zdarzenie GA4
  • Nazwa zdarzenia: add_payment_info
  • Zmienne warstwy danych (Nazwa – Nazwa zmiennej warstwy danych):
    • Elementy e-commerce – ecommerce.items
    • Wartość e-commerce – ecommerce.value
    • Waluta e-commerce – ecommerce.currency
    • Kupon e-commerce – ecommerce.coupon
    • Typ płatności e-commerce – ecommerce.payment_type
  • Parametry zdarzenia (nazwa parametru – wartość):
    • items - &lbrace;&lbrace;Produkty e-commerce&rbrace;&rbrace;
    • value - &lbrace;&lbrace;Ecommerce Value&rbrace;&rbrace;
    • currency - &lbrace;&lbrace;Waluta e-commerce&rbrace;&rbrace;
    • coupon - &lbrace;&lbrace;Ecommerce Coupon&rbrace;&rbrace;
    • payment_type - &lbrace;&lbrace;Ecommerce Payment Type&rbrace;&rbrace;
  • Aktywator: zdarzenie jest równe add_payment_info

Konfiguracja reguły:

  • Typ aktywatora: zdarzenie niestandardowe
  • Nazwa zdarzenia: add_payment_info
  • Ta reguła jest uruchamiana w przypadku wszystkich zdarzeń niestandardowych.
 
dataLayer.push({ ecommerce: null });  // Clear the previous ecommerce object.
dataLayer.push({
  event: "add_payment_info",
  ecommerce: {
    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
    }
    ]
  }
});

Jeśli musisz ustawić tablicę items poza tablicą ecommerce, podczas wysyłania danych value (przychodów) ustaw parametr currency na poziomie zdarzenia.

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 implementacji Menedżera tagów:

Pokaż konfigurację tagu

Konfiguracja tagu:

  • Typ tagu: zdarzenie GA4
  • Nazwa zdarzenia: add_shipping_info
  • Zmienne warstwy danych (Nazwa – Nazwa zmiennej warstwy danych):
    • Elementy e-commerce – ecommerce.items
    • Wartość e-commerce – ecommerce.value
    • Waluta e-commerce – ecommerce.currency
    • Kupon e-commerce – ecommerce.coupon
    • Poziom dostawy w e-commerce – ecommerce.shipping_tier
  • Parametry zdarzenia (nazwa parametru – wartość):
    • items - &lbrace;&lbrace;Produkty e-commerce&rbrace;&rbrace;
    • value - &lbrace;&lbrace;Ecommerce Value&rbrace;&rbrace;
    • currency - &lbrace;&lbrace;Waluta e-commerce&rbrace;&rbrace;
    • coupon - &lbrace;&lbrace;Ecommerce Coupon&rbrace;&rbrace;
    • shipping_tier - &lbrace;&lbrace;Ecommerce Shipping Tier&rbrace;&rbrace;
  • Aktywator: zdarzenie jest równe add_shipping_info

Konfiguracja reguły:

  • Typ aktywatora: zdarzenie niestandardowe
  • Nazwa zdarzenia: add_shipping_info
  • Ta reguła jest uruchamiana w przypadku wszystkich zdarzeń niestandardowych.
 
dataLayer.push({ ecommerce: null });  // Clear the previous ecommerce object.
dataLayer.push({
  event: "add_shipping_info",
  ecommerce: {
    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 implementacji Menedżera tagów:

Pokaż konfigurację tagu

Konfiguracja tagu:

  • Typ tagu: zdarzenie GA4
  • Nazwa zdarzenia: add_to_cart
  • Zmienne warstwy danych (Nazwa – Nazwa zmiennej warstwy danych):
    • Elementy e-commerce – ecommerce.items
    • Wartość e-commerce – ecommerce.value
    • Waluta e-commerce – ecommerce.currency
  • Parametry zdarzenia (nazwa parametru – wartość):
    • items - &lbrace;&lbrace;Produkty e-commerce&rbrace;&rbrace;
    • value - &lbrace;&lbrace;Ecommerce Value&rbrace;&rbrace;
    • currency - &lbrace;&lbrace;Waluta e-commerce&rbrace;&rbrace;
  • Aktywator: zdarzenie jest równe add_to_cart

Konfiguracja reguły:

  • Typ aktywatora: zdarzenie niestandardowe
  • Nazwa zdarzenia: add_to_cart
  • Ta reguła jest uruchamiana w przypadku wszystkich zdarzeń niestandardowych.
 
dataLayer.push({ ecommerce: null });  // Clear the previous ecommerce object.
dataLayer.push({
  event: "add_to_cart",
  ecommerce: {
    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 implementacji Menedżera tagów:

Pokaż konfigurację tagu

Konfiguracja tagu:

  • Typ tagu: zdarzenie GA4
  • Nazwa zdarzenia: add_to_wishlist
  • Zmienne warstwy danych (Nazwa – Nazwa zmiennej warstwy danych):
    • Elementy e-commerce – ecommerce.items
    • Wartość e-commerce – ecommerce.value
    • Waluta e-commerce – ecommerce.currency
  • Parametry zdarzenia (nazwa parametru – wartość):
    • items - &lbrace;&lbrace;Produkty e-commerce&rbrace;&rbrace;
    • value - &lbrace;&lbrace;Ecommerce Value&rbrace;&rbrace;
    • currency - &lbrace;&lbrace;Waluta e-commerce&rbrace;&rbrace;
  • Aktywator: zdarzenie jest równe add_to_wishlist

Konfiguracja reguły:

  • Typ aktywatora: zdarzenie niestandardowe
  • Nazwa zdarzenia: add_to_wishlist
  • Ta reguła jest uruchamiana w przypadku wszystkich zdarzeń niestandardowych.
 
dataLayer.push({ ecommerce: null });  // Clear the previous ecommerce object.
dataLayer.push({
  event: "add_to_wishlist",
  ecommerce: {
    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 implementacji Menedżera tagów:

Pokaż konfigurację tagu

Konfiguracja tagu:

  • Typ tagu: zdarzenie GA4
  • Nazwa zdarzenia: begin_checkout
  • Zmienne warstwy danych (Nazwa – Nazwa zmiennej warstwy danych):
    • Elementy e-commerce – ecommerce.items
    • Wartość e-commerce – ecommerce.value
    • Waluta e-commerce – ecommerce.currency
    • Kupon e-commerce – ecommerce.coupon
  • Parametry zdarzenia (nazwa parametru – wartość):
    • items - &lbrace;&lbrace;Produkty e-commerce&rbrace;&rbrace;
    • value - &lbrace;&lbrace;Ecommerce Value&rbrace;&rbrace;
    • currency - &lbrace;&lbrace;Waluta e-commerce&rbrace;&rbrace;
    • coupon - &lbrace;&lbrace;Ecommerce Coupon&rbrace;&rbrace;
  • Aktywator: zdarzenie jest równe begin_checkout

Konfiguracja reguły:

  • Typ aktywatora: zdarzenie niestandardowe
  • Nazwa zdarzenia: begin_checkout
  • Ta reguła jest uruchamiana w przypadku wszystkich zdarzeń niestandardowych.
 
dataLayer.push({ ecommerce: null });  // Clear the previous ecommerce object.
dataLayer.push({
  event: "begin_checkout",
  ecommerce: {
    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 implementacji Menedżera tagów:

Pokaż konfigurację tagu

Konfiguracja tagu:

  • Typ tagu: zdarzenie GA4
  • Nazwa zdarzenia: purchase
    • Elementy e-commerce – ecommerce.items
    • Identyfikator transakcji e-commerce – ecommerce.transaction_id
    • Wartość e-commerce – ecommerce.value
    • Podatek od e-commerce – ecommerce.tax
    • Dostawa w e-commerce – ecommerce.shipping
    • Waluta e-commerce – ecommerce.currency
    • Kupon e-commerce – ecommerce.coupon
  • Parametry zdarzenia (nazwa parametru – wartość):
    • items - &lbrace;&lbrace;Produkty e-commerce&rbrace;&rbrace;
    • transaction_id – &lbrace;&lbrace;Identyfikator transakcji e-commerce&rbrace;&rbrace;
    • value - &lbrace;&lbrace;Ecommerce Value&rbrace;&rbrace;
    • tax - &lbrace;&lbrace;Ecommerce Tax&rbrace;&rbrace;
    • shipping - &lbrace;&lbrace;Dostawa w e-commerce&rbrace;&rbrace;
    • currency - &lbrace;&lbrace;Waluta e-commerce&rbrace;&rbrace;
    • coupon - &lbrace;&lbrace;Ecommerce Coupon&rbrace;&rbrace;
  • Aktywator: zdarzenie jest równe zakupowi

Konfiguracja reguły:

  • Typ aktywatora: zdarzenie niestandardowe
  • Nazwa zdarzenia: purchase
  • Ta reguła jest uruchamiana w przypadku wszystkich zdarzeń niestandardowych.
 
dataLayer.push({ ecommerce: null });  // Clear the previous ecommerce object.
dataLayer.push({
  event: "purchase",
  ecommerce: {
    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,
      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",
      quantity: 2
    }]
  }
});

refund

To zdarzenie oznacza, że użytkownikowi zwrócono środki za 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.
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 implementacji Menedżera tagów:

Pokaż konfigurację tagu

Konfiguracja tagu:

  • Typ tagu: zdarzenie GA4
  • Nazwa zdarzenia: refund
  • Zmienne warstwy danych (Nazwa – Nazwa zmiennej warstwy danych):
    • Elementy e-commerce – ecommerce.items
    • Identyfikator transakcji e-commerce – ecommerce.transaction_id
    • Wartość e-commerce – ecommerce.value
    • Podatek od e-commerce – ecommerce.tax
    • Dostawa w e-commerce – ecommerce.shipping
    • Waluta e-commerce – ecommerce.currency
    • Kupon e-commerce – ecommerce.coupon
  • Parametry zdarzenia (nazwa parametru – wartość):
    • items - &lbrace;&lbrace;Produkty e-commerce&rbrace;&rbrace;
    • transaction_id – &lbrace;&lbrace;Identyfikator transakcji e-commerce&rbrace;&rbrace;
    • value - &lbrace;&lbrace;Ecommerce Value&rbrace;&rbrace;
    • tax - &lbrace;&lbrace;Ecommerce Tax&rbrace;&rbrace;
    • shipping - &lbrace;&lbrace;Dostawa w e-commerce&rbrace;&rbrace;
    • currency - &lbrace;&lbrace;Waluta e-commerce&rbrace;&rbrace;
    • coupon - &lbrace;&lbrace;Ecommerce Coupon&rbrace;&rbrace;
  • Aktywator: zdarzenie jest równe zwrotowi środków

Konfiguracja reguły:

  • Typ aktywatora: zdarzenie niestandardowe
  • Nazwa zdarzenia: refund
  • Ta reguła jest uruchamiana w przypadku wszystkich zdarzeń niestandardowych.
 
dataLayer.push({ ecommerce: null });  // Clear the previous ecommerce object.
dataLayer.push({
  event: "refund",
  ecommerce: {
    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 implementacji Menedżera tagów:

Pokaż konfigurację tagu

Konfiguracja tagu:

  • Typ tagu: zdarzenie GA4
  • Nazwa zdarzenia: remove_from_cart
  • Zmienne warstwy danych (Nazwa – Nazwa zmiennej warstwy danych):
    • Elementy e-commerce – ecommerce.items
    • Wartość e-commerce – ecommerce.value
    • Waluta e-commerce – ecommerce.currency
  • Parametry zdarzenia (nazwa parametru – wartość):
    • items - &lbrace;&lbrace;Produkty e-commerce&rbrace;&rbrace;
    • value - &lbrace;&lbrace;Ecommerce Value&rbrace;&rbrace;
    • currency - &lbrace;&lbrace;Waluta e-commerce&rbrace;&rbrace;
  • Aktywator: zdarzenie jest równe remove_from_cart

Konfiguracja reguły:

  • Typ aktywatora: zdarzenie niestandardowe
  • Nazwa zdarzenia: remove_from_cart
  • Ta reguła jest uruchamiana w przypadku wszystkich zdarzeń niestandardowych.
 
dataLayer.push({ ecommerce: null });  // Clear the previous ecommerce object.
dataLayer.push({
  event: "remove_from_cart",
  ecommerce: {
    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 implementacji Menedżera tagów:

Pokaż konfigurację tagu

Konfiguracja tagu:

  • Typ tagu: zdarzenie GA4
  • Nazwa zdarzenia: select_item
  • Zmienne warstwy danych (Nazwa – Nazwa zmiennej warstwy danych):
    • Elementy e-commerce – ecommerce.items
    • Identyfikator listy produktów e-commerce – ecommerce.item_list_id
    • Nazwa listy produktów e-commerce – ecommerce.item_list_name
  • Parametry zdarzenia (nazwa parametru – wartość):
    • items - &lbrace;&lbrace;Produkty e-commerce&rbrace;&rbrace;
    • item_list_id - &lbrace;&lbrace;Identyfikator listy produktów e-commerce&rbrace;&rbrace;
    • item_list_name - &lbrace;&lbrace;Nazwa listy produktów e-commerce&rbrace;&rbrace;
  • Aktywator: zdarzenie jest równe select_item

Konfiguracja reguły:

  • Typ aktywatora: zdarzenie niestandardowe
  • Nazwa zdarzenia: select_item
  • Ta reguła jest uruchamiana w przypadku wszystkich zdarzeń niestandardowych.
 
dataLayer.push({ ecommerce: null });  // Clear the previous ecommerce object.
dataLayer.push({
  event: "select_item",
  ecommerce: {
    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ą.

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 implementacji Menedżera tagów:

Pokaż konfigurację tagu

Konfiguracja tagu:

  • Typ tagu: zdarzenie GA4
  • Nazwa zdarzenia: select_promotion
  • Zmienne warstwy danych (Nazwa – Nazwa zmiennej warstwy danych):
    • Nazwa kreacji e-commerce – ecommerce.creative_name
    • Miejsce na kreację e-commerce – ecommerce.creative_slot
    • Identyfikator promocji e-commerce – ecommerce.promotion_id
    • Nazwa promocji e-commerce – ecommerce.promotion_name
    • Elementy e-commerce – ecommerce.items
  • Parametry zdarzenia (nazwa parametru – wartość):
    • creative_name - &lbrace;&lbrace;Ecommerce Creative Name&rbrace;&rbrace;
    • creative_slot - &lbrace;&lbrace;Ecommerce Creative Slot&rbrace;&rbrace;
    • promotion_id - &lbrace;&lbrace;Ecommerce Promotion ID&rbrace;&rbrace;
    • promotion_name - &lbrace;&lbrace;Ecommerce Promotion Name&rbrace;&rbrace;
    • items - &lbrace;&lbrace;Produkty e-commerce&rbrace;&rbrace;
  • Aktywator: zdarzenie jest równe select_promotion

Konfiguracja reguły:

  • Typ aktywatora: zdarzenie niestandardowe
  • Nazwa zdarzenia: select_promotion
  • Ta reguła jest uruchamiana w przypadku wszystkich zdarzeń niestandardowych.
 
dataLayer.push({ ecommerce: null });  // Clear the previous ecommerce object.
dataLayer.push({
  event: "select_promotion",
  ecommerce: {
    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 implementacji Menedżera tagów:

Pokaż konfigurację tagu

Konfiguracja tagu:

  • Typ tagu: zdarzenie GA4
  • Nazwa zdarzenia: view_cart
  • Zmienne warstwy danych (Nazwa – Nazwa zmiennej warstwy danych):
    • Elementy e-commerce – ecommerce.items
    • Wartość e-commerce – ecommerce.value
    • Waluta e-commerce – ecommerce.currency
  • Parametry zdarzenia (nazwa parametru – wartość):
    • items - &lbrace;&lbrace;Produkty e-commerce&rbrace;&rbrace;
    • value - &lbrace;&lbrace;Ecommerce Value&rbrace;&rbrace;
    • currency - &lbrace;&lbrace;Waluta e-commerce&rbrace;&rbrace;
  • Aktywator: zdarzenie jest równe view_cart

Konfiguracja reguły:

  • Typ aktywatora: zdarzenie niestandardowe
  • Nazwa zdarzenia: view_cart
  • Ta reguła jest uruchamiana w przypadku wszystkich zdarzeń niestandardowych.
 
dataLayer.push({ ecommerce: null });  // Clear the previous ecommerce object.
dataLayer.push({
  event: "view_cart",
  ecommerce: {
    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 implementacji Menedżera tagów:

Pokaż konfigurację tagu

Konfiguracja tagu:

  • Typ tagu: zdarzenie GA4
  • Nazwa zdarzenia: view_item
  • Zmienne warstwy danych (Nazwa – Nazwa zmiennej warstwy danych):
    • Elementy e-commerce – ecommerce.items
    • Wartość e-commerce – ecommerce.value
    • Waluta e-commerce – ecommerce.currency
  • Parametry zdarzenia (nazwa parametru – wartość):
    • items - &lbrace;&lbrace;Produkty e-commerce&rbrace;&rbrace;
    • value - &lbrace;&lbrace;Ecommerce Value&rbrace;&rbrace;
    • currency - &lbrace;&lbrace;Waluta e-commerce&rbrace;&rbrace;
  • Aktywator: zdarzenie jest równe view_item

Konfiguracja reguły:

  • Typ aktywatora: zdarzenie niestandardowe
  • Nazwa zdarzenia: view_item
  • Ta reguła jest uruchamiana w przypadku wszystkich zdarzeń niestandardowych.
 
dataLayer.push({ ecommerce: null });  // Clear the previous ecommerce object.
dataLayer.push({
  event: "view_item",
  ecommerce: {
    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 implementacji Menedżera tagów:

Pokaż konfigurację tagu

Konfiguracja tagu:

  • Typ tagu: zdarzenie GA4
  • Nazwa zdarzenia: view_item_list
  • Zmienne warstwy danych (Nazwa – Nazwa zmiennej warstwy danych):
    • Elementy e-commerce – ecommerce.items
    • Identyfikator listy produktów e-commerce – ecommerce.item_list_id
    • Nazwa listy produktów e-commerce – ecommerce.item_list_name
  • Parametry zdarzenia (nazwa parametru – wartość):
    • items - &lbrace;&lbrace;Produkty e-commerce&rbrace;&rbrace;
    • item_list_id - &lbrace;&lbrace;Identyfikator listy produktów e-commerce&rbrace;&rbrace;
    • item_list_name - &lbrace;&lbrace;Nazwa listy produktów e-commerce&rbrace;&rbrace;
  • Aktywator: zdarzenie jest równe view_item_list

Konfiguracja reguły:

  • Typ aktywatora: zdarzenie niestandardowe
  • Nazwa zdarzenia: view_item_list
  • Ta reguła jest uruchamiana w przypadku wszystkich zdarzeń niestandardowych.
 
dataLayer.push({ ecommerce: null });  // Clear the previous ecommerce object.
dataLayer.push({
  event: "view_item_list",
  ecommerce: {
    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.03,
      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
    }]
  }
});

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.

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 implementacji Menedżera tagów:

Pokaż konfigurację tagu

Konfiguracja tagu:

  • Typ tagu: zdarzenie GA4
  • Nazwa zdarzenia: view_promotion
  • Zmienne warstwy danych (Nazwa – Nazwa zmiennej warstwy danych):
    • Nazwa kreacji e-commerce – ecommerce.creative_name
    • Miejsce na kreację e-commerce – ecommerce.creative_slot
    • Identyfikator promocji e-commerce – ecommerce.promotion_id
    • Nazwa promocji e-commerce – ecommerce.promotion_name
    • Elementy e-commerce – ecommerce.items
  • Parametry zdarzenia (nazwa parametru – wartość):
    • creative_name - &lbrace;&lbrace;Ecommerce Creative Name&rbrace;&rbrace;
    • creative_slot - &lbrace;&lbrace;Ecommerce Creative Slot&rbrace;&rbrace;
    • promotion_id - &lbrace;&lbrace;Ecommerce Promotion ID&rbrace;&rbrace;
    • promotion_name - &lbrace;&lbrace;Ecommerce Promotion Name&rbrace;&rbrace;
    • items - &lbrace;&lbrace;Produkty e-commerce&rbrace;&rbrace;
  • Aktywator: zdarzenie jest równe view_promotion

Konfiguracja reguły:

  • Typ aktywatora: zdarzenie niestandardowe
  • Nazwa zdarzenia: view_promotion
  • Ta reguła jest uruchamiana w przypadku wszystkich zdarzeń niestandardowych.
 
dataLayer.push({ ecommerce: null });  // Clear the previous ecommerce object.
dataLayer.push({
  event: "view_promotion",
  ecommerce: {
    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 implementacji Menedżera tagów:

Pokaż konfigurację tagu

Konfiguracja tagu:

  • Typ tagu: zdarzenie GA4
  • Nazwa zdarzenia: level_end
  • Parametry zdarzenia (nazwa parametru – wartość):
    • level_name – podróż się zaczyna…
    • success – true
  • Uruchamiaj, gdy gracz dotrze do końca poziomu (np.na stronę z potwierdzeniem poziomu).

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 implementacji Menedżera tagów:

Pokaż konfigurację tagu

Konfiguracja tagu:

  • Typ tagu: zdarzenie GA4
  • Nazwa zdarzenia: level_start
  • Parametry zdarzenia (nazwa parametru – wartość):
    • level_name – podróż się zaczyna…
  • Włącz tę regułę, gdy ktoś rozpoczyna nowy poziom (np.stronę startową poziomu).

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 implementacji Menedżera tagów:

Pokaż konfigurację tagu

Konfiguracja tagu:

  • Typ tagu: zdarzenie GA4
  • Nazwa zdarzenia: level_up
  • Parametry zdarzenia (nazwa parametru – wartość):
    • level - 5
    • character – Gracz 1
  • Wywoływanie, gdy gracz przechodzi na wyższy poziom

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 implementacji Menedżera tagów:

Pokaż konfigurację tagu

Konfiguracja tagu:

  • Typ tagu: zdarzenie GA4
  • Nazwa zdarzenia: post_score
  • Parametry zdarzenia (nazwa parametru – wartość):
    • score - 10000
    • level - 5
    • character – Gracz 1
  • Wywołuj, gdy użytkownik opublikuje wynik

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 implementacji Menedżera tagów:

Pokaż konfigurację tagu

Konfiguracja tagu:

  • Typ tagu: zdarzenie GA4
  • Nazwa zdarzenia: unlock_achievement
  • Parametry zdarzenia (nazwa parametru – wartość):
    • achievement_id - A_12345
  • Wywoływane, gdy użytkownik odblokuje osiągnięcie.

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 implementacji Menedżera tagów:

Pokaż konfigurację tagu

Konfiguracja tagu:

  • Typ tagu: zdarzenie GA4
  • Nazwa zdarzenia: close_convert_lead
  • Parametry zdarzenia (nazwa parametru – wartość):
    • currency - USD
    • value - 30.03
  • Wywołuj zdarzenie, gdy użytkownik stanie się potencjalnym klientem, który dokonał konwersji (czyli klientem).

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 implementacji Menedżera tagów:

Pokaż konfigurację tagu

Konfiguracja tagu:

  • Typ tagu: zdarzenie GA4
  • Nazwa zdarzenia: close_unconvert_lead
  • Parametry zdarzenia (nazwa parametru – wartość):
    • currency - USD
    • value - 30.03
  • Wywołuj zdarzenie, gdy użytkownik zostanie oznaczony jako osoba, która nie stała się potencjalnym klientem, który dokonał konwersji, z jednego z kilku powodów.

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 implementacji Menedżera tagów:

Pokaż konfigurację tagu

Konfiguracja tagu:

  • Typ tagu: zdarzenie GA4
  • Nazwa zdarzenia: disqualify_lead
  • Parametry zdarzenia (nazwa parametru – wartość):
    • currency - USD
    • value - 30.03
    • disqualified_lead_reason – nie chcę kupić
  • Wywołuj zdarzenie, gdy użytkownik zostanie oznaczony jako niekwalifikujący się do zostania potencjalnym klientem z jednego z kilku powodów.

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 implementacji Menedżera tagów:

Pokaż konfigurację tagu

Konfiguracja tagu:

  • Typ tagu: zdarzenie GA4
  • Nazwa zdarzenia: generate_lead
  • Parametry zdarzenia (nazwa parametru – wartość):
    • currency - USD
    • value - 30.03
    • lead_source – targi
  • Wywoływanie zdarzenia po wygenerowaniu potencjalnego klienta

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 implementacji Menedżera tagów:

Pokaż konfigurację tagu

Konfiguracja tagu:

  • Typ tagu: zdarzenie GA4
  • Nazwa zdarzenia: qualify_lead
  • Parametry zdarzenia (nazwa parametru – wartość):
    • currency - USD
    • value - 30.03
  • Wywoływanie zdarzenia, gdy użytkownik zostanie oznaczony jako pasujący do kryteriów kwalifikacji potencjalnych klientów

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 implementacji Menedżera tagów:

Pokaż konfigurację tagu

Konfiguracja tagu:

  • Typ tagu: zdarzenie GA4
  • Nazwa zdarzenia: working_lead
  • Parametry zdarzenia (nazwa parametru – wartość):
    • currency - USD
    • value - 30.03
    • lead_status – rozpoczęte rozmowy
  • Wywołuj zdarzenie, gdy użytkownik skontaktuje się z przedstawicielem lub przedstawiciel skontaktuje się z użytkownikiem.