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 4 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:

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 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.
value number Tak* 30.03 Wartość pieniężna zdarzenia.

* Ustaw wartość value na sumę wartości (price * quantity) dla wszystkich elementów w items. Nie podawaj wartości shipping ani tax.
* W przypadku efektywnego raportowania zwykle wymagany jest parametr value. Jeśli oznaczysz zdarzenie jako kluczowe, zalecamy ustawienievalue.
* Jeśli skonfigurujesz parametr value, musisz też skonfigurować parametr currency.
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: parametr „affiliation” jest dostępny tylko w zakresie elementu.
coupon string Nie SUMMER_FUN Nazwa lub kod kuponu powiązane 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 ramach 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, jeśli 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, jeśli 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: identyfikator lokalizacji jest dostępny tylko w zakresie elementu.
price number Nie 10.01 Cena jednostkowa produktu w jednostkach waluty określonej w parametrze currency.
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 sztuk produktu.

Jeśli nie jest ustawiona, wartość quantity jest ustawiona na 1.
Oprócz określonych parametrów możesz w tablicy items umieścić 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 wydarzenia: 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;Ecommerce Items&rbrace;&rbrace;
    • value - &lbrace;&lbrace;Wartość e-commerce&rbrace;&rbrace;
    • currency - &lbrace;&lbrace;Ecommerce Currency&rbrace;&rbrace;
    • coupon - &lbrace;&lbrace;Kupon e-commerce&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 uruchamia się, gdy jest spełniony ten warunek: Wszystkie zdarzenia niestandardowe
 
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, ustaw parametr currency na poziomie zdarzenia podczas wysyłania danych value (przychód).

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 wartość value na sumę wartości (price * quantity) dla wszystkich elementów w items. Nie podawaj wartości shipping ani tax.
* W przypadku efektywnego raportowania zwykle wymagany jest parametr value. Jeśli oznaczysz zdarzenie jako kluczowe, zalecamy ustawienievalue.
* Jeśli skonfigurujesz parametr value, musisz też skonfigurować parametr currency.
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: parametr „affiliation” jest dostępny tylko w zakresie elementu.
coupon string Nie SUMMER_FUN Nazwa lub kod kuponu powiązane 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 ramach 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, jeśli 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, jeśli 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: identyfikator lokalizacji jest dostępny tylko w zakresie elementu.
price number Nie 10.01 Cena jednostkowa produktu w jednostkach waluty określonej w parametrze currency.
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 sztuk produktu.

Jeśli nie jest ustawiona, wartość quantity jest ustawiona na 1.
Oprócz określonych parametrów możesz w tablicy items umieścić 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 wydarzenia: 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;Ecommerce Items&rbrace;&rbrace;
    • value - &lbrace;&lbrace;Wartość e-commerce&rbrace;&rbrace;
    • currency - &lbrace;&lbrace;Ecommerce Currency&rbrace;&rbrace;
    • coupon - &lbrace;&lbrace;Kupon e-commerce&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 wydarzenia: add_shipping_info
  • Ta reguła uruchamia się, gdy jest spełniony ten warunek: Wszystkie zdarzenia niestandardowe
 
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 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.
value number Tak* 30.03 Wartość pieniężna zdarzenia.

* Ustaw wartość value na sumę wartości (price * quantity) dla wszystkich elementów w items. Nie podawaj wartości shipping ani tax.
* W przypadku efektywnego raportowania zwykle wymagany jest parametr value. Jeśli oznaczysz zdarzenie jako kluczowe, zalecamy ustawienievalue.
* Jeśli skonfigurujesz parametr value, musisz też skonfigurować parametr currency.
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: parametr „affiliation” jest dostępny tylko w zakresie elementu.
coupon string Nie SUMMER_FUN Nazwa lub kod kuponu powiązane 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 ramach 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, jeśli 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, jeśli 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) Fizyczna lokalizacja 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: identyfikator lokalizacji jest dostępny tylko w zakresie elementu.
price number Nie 10.01 Cena jednostkowa produktu w jednostkach waluty określonej w parametrze currency.
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 sztuk produktu.

Jeśli nie jest ustawiona, wartość quantity jest ustawiona na 1.
Oprócz określonych parametrów możesz w tablicy items umieścić 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;Ecommerce Items&rbrace;&rbrace;
    • value - &lbrace;&lbrace;Wartość e-commerce&rbrace;&rbrace;
    • currency - &lbrace;&lbrace;Ecommerce Currency&rbrace;&rbrace;
  • Aktywator: zdarzenie jest równe add_to_cart

Konfiguracja reguły:

  • Typ aktywatora: zdarzenie niestandardowe
  • Nazwa wydarzenia: add_to_cart
  • Ta reguła uruchamia się, gdy jest spełniony ten warunek: Wszystkie zdarzenia niestandardowe
 
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 oznacza, że produkt został dodany do listy życzeń. Używaj tego zdarzenia, aby identyfikować popularne prezenty 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 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.
value number Tak* 30.03 Wartość pieniężna zdarzenia.

* Ustaw wartość value na sumę wartości (price * quantity) dla wszystkich elementów w items. Nie podawaj wartości shipping ani tax.
* W przypadku efektywnego raportowania zwykle wymagany jest parametr value. Jeśli oznaczysz zdarzenie jako kluczowe, zalecamy ustawienievalue.
* Jeśli skonfigurujesz parametr value, musisz też skonfigurować parametr currency.
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: parametr „affiliation” jest dostępny tylko w zakresie elementu.
coupon string Nie SUMMER_FUN Nazwa lub kod kuponu powiązane 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 ramach 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, jeśli 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, jeśli 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: identyfikator lokalizacji jest dostępny tylko w zakresie elementu.
price number Nie 10.01 Cena jednostkowa produktu w jednostkach waluty określonej w parametrze currency.
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 sztuk produktu.

Jeśli nie jest ustawiona, wartość quantity jest ustawiona na 1.
Oprócz określonych parametrów możesz w tablicy items umieścić 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 wydarzenia: 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;Ecommerce Items&rbrace;&rbrace;
    • value - &lbrace;&lbrace;Wartość e-commerce&rbrace;&rbrace;
    • currency - &lbrace;&lbrace;Ecommerce Currency&rbrace;&rbrace;
  • Aktywator: zdarzenie jest równe add_to_wishlist

Konfiguracja reguły:

  • Typ aktywatora: zdarzenie niestandardowe
  • Nazwa wydarzenia: add_to_wishlist
  • Ta reguła uruchamia się, gdy jest spełniony ten warunek: Wszystkie zdarzenia niestandardowe
 
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 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.
value number Tak* 30.03 Wartość pieniężna zdarzenia.

* Ustaw wartość value na sumę wartości (price * quantity) dla wszystkich elementów w items. Nie podawaj wartości shipping ani tax.
* W przypadku efektywnego raportowania zwykle wymagany jest parametr value. Jeśli oznaczysz zdarzenie jako kluczowe, zalecamy ustawienievalue.
* Jeśli skonfigurujesz parametr value, musisz też skonfigurować parametr currency.
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: parametr „affiliation” jest dostępny tylko w zakresie elementu.
coupon string Nie SUMMER_FUN Nazwa lub kod kuponu powiązane 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 ramach 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, jeśli 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, jeśli 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: identyfikator lokalizacji jest dostępny tylko w zakresie elementu.
price number Nie 10.01 Cena jednostkowa produktu w jednostkach waluty określonej w parametrze currency.
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 sztuk produktu.

Jeśli nie jest ustawiona, wartość quantity jest ustawiona na 1.
Oprócz określonych parametrów możesz w tablicy items umieścić 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 wydarzenia: 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;Ecommerce Items&rbrace;&rbrace;
    • value - &lbrace;&lbrace;Wartość e-commerce&rbrace;&rbrace;
    • currency - &lbrace;&lbrace;Ecommerce Currency&rbrace;&rbrace;
    • coupon - &lbrace;&lbrace;Kupon e-commerce&rbrace;&rbrace;
  • Aktywator: zdarzenie jest równe begin_checkout

Konfiguracja reguły:

  • Typ aktywatora: zdarzenie niestandardowe
  • Nazwa wydarzenia: begin_checkout
  • Ta reguła uruchamia się, gdy jest spełniony ten warunek: Wszystkie zdarzenia niestandardowe
 
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
    }
    ]
  }
});

close_convert_lead

Mierzy zdarzenia, kiedy potencjalny klient został przekształcony w klienta i zakończył proces (np. poprzez zakup).

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 efektywnego raportowania. Jeśli oznaczysz zdarzenie jako kluczowe, zalecamy ustawienie wartości value.
* Jeśli skonfigurujesz parametr value, musisz też skonfigurować parametr currency.

Przykład

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

Pokaż konfigurację tagu

Konfiguracja tagu:

  • Typ tagu: zdarzenie GA4
  • Nazwa wydarzenia: 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 efektywnego raportowania. Jeśli oznaczysz zdarzenie jako kluczowe, zalecamy ustawienievalue.
* Parametr currency jest wymagany, jeśli skonfigurujesz 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 wydarzenia: 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 efektywnego raportowania. Jeśli oznaczysz zdarzenie jako kluczowe, zalecamy ustawienievalue.
* Jeśli skonfigurujesz parametr value, musisz też skonfigurować parametr currency.
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 wydarzenia: 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.

earn_virtual_currency

Mierzy zdarzenia, kiedy użytkownik otrzymuje wirtualną walutę w grze. Rejestruj to zdarzenie wraz z parametrem 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 wydarzenia: earn_virtual_currency
  • Parametry zdarzenia (nazwa parametru – wartość):
    • virtual_currency_name – Gemy
    • value - 5
  • Wywoływanie zdarzenia, gdy użytkownik otrzyma wirtualną walutę

generate_lead

Mierzy zdarzenia, kiedy został wygenerowany potencjalny klient (np. za pomocą formularza). Rejestruj te dane, aby sprawdzać skuteczność kampanii marketingowych i liczbę klientów, którzy ponownie angażują się w 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 efektywnego raportowania. Jeśli oznaczysz zdarzenie jako kluczowe, zalecamy ustawienievalue.
* Jeśli skonfigurujesz parametr value, musisz też skonfigurować parametr currency.
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 wydarzenia: generate_lead
  • Parametry zdarzenia (nazwa parametru – wartość):
    • currency - USD
    • value - 30.03
    • lead_source – targi
  • Wywołuj zdarzenie, gdy zostanie wygenerowany potencjalny klient

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 wydarzenia: join_group
  • Parametry zdarzenia (nazwa parametru – wartość):
    • group_id - G_12345
  • Wywoływanie zdarzenia, gdy użytkownik dołącza do grupy

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 wydarzenia: 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ę potwierdzenia 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 wydarzenia: level_start
  • Parametry zdarzenia (nazwa parametru – wartość):
    • level_name – Podróż się zaczyna…
  • Włącz tę regułę, gdy ktoś rozpoczyna nowy poziom (np.stronę rozpoczęcia poziomu).

level_up

To zdarzenie oznacza, że gracz przeszedł w grze na wyższy poziom. Możesz go używać do oceny rozkładu poziomów wśród użytkowników i wykrywania poziomów, które 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 wydarzenia: level_up
  • Parametry zdarzenia (nazwa parametru – wartość):
    • level - 5
    • character – Gracz 1
  • Wywoływanie, gdy gracz przechodzi na wyższy poziom

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 wydarzenia: login
  • Parametry zdarzenia (nazwa parametru – wartość):
    • method – Google
  • Wywoływane, gdy użytkownik się zaloguje.

post_score

Wysyłaj to zdarzenie, gdy użytkownik opublikuje wynik. Dzięki temu zdarzeniu możesz 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 uzyskała wynik.

Przykład

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

Pokaż konfigurację tagu

Konfiguracja tagu:

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

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 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.
value number Tak* 30.03 Wartość pieniężna zdarzenia.

* Ustaw wartość value na sumę wartości (price * quantity) dla wszystkich elementów w items. Nie podawaj wartości shipping ani tax.
* W przypadku efektywnego raportowania zwykle wymagany jest parametr value. Jeśli oznaczysz zdarzenie jako kluczowe, zalecamy ustawienievalue.
* Jeśli skonfigurujesz parametr value, musisz też skonfigurować parametr currency.
customer_type string (new / returning) Nie nowość 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: parametr „affiliation” jest dostępny tylko w zakresie elementu.
coupon string Nie SUMMER_FUN Nazwa lub kod kuponu powiązane 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 ramach 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, jeśli 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, jeśli 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: identyfikator lokalizacji jest dostępny tylko w zakresie elementu.
price number Nie 10.01 Cena jednostkowa produktu w jednostkach waluty określonej w parametrze currency.
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 sztuk produktu.

Jeśli nie jest ustawiona, wartość quantity jest ustawiona na 1.
Oprócz określonych parametrów możesz w tablicy items umieścić 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 wydarzenia: 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;Ecommerce Items&rbrace;&rbrace;
    • transaction_id - &lbrace;&lbrace;Identyfikator transakcji e-commerce&rbrace;&rbrace;
    • value - &lbrace;&lbrace;Wartość e-commerce&rbrace;&rbrace;
    • tax - &lbrace;&lbrace;Ecommerce Tax&rbrace;&rbrace;
    • shipping - &lbrace;&lbrace;Ecommerce Shipping&rbrace;&rbrace;
    • currency - &lbrace;&lbrace;Ecommerce Currency&rbrace;&rbrace;
    • coupon - &lbrace;&lbrace;Kupon e-commerce&rbrace;&rbrace;
  • Aktywator: zdarzenie równa się zakup

Konfiguracja reguły:

  • Typ aktywatora: zdarzenie niestandardowe
  • Nazwa wydarzenia: purchase
  • Ta reguła uruchamia się, gdy jest spełniony ten warunek: Wszystkie zdarzenia niestandardowe
 
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
    }]
  }
});

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 efektywnego raportowania. Jeśli oznaczysz zdarzenie jako kluczowe, zalecamy ustawienievalue.
* Parametr currency jest wymagany, jeśli skonfigurujesz parametr value.

Przykład

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

Pokaż konfigurację tagu

Konfiguracja tagu:

  • Typ tagu: zdarzenie GA4
  • Nazwa wydarzenia: 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

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 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.
transaction_id string Tak T_12345 Unikalny identyfikator transakcji.
value number Tak* 30.03 Wartość pieniężna zdarzenia.

* Ustaw wartość value na sumę wartości (price * quantity) dla wszystkich elementów w items. Nie podawaj wartości shipping ani tax.
* W przypadku efektywnego raportowania zwykle wymagany jest parametr value. Jeśli oznaczysz zdarzenie jako kluczowe, zalecamy ustawienievalue.
* Jeśli skonfigurujesz parametr value, musisz też skonfigurować parametr currency.
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: parametr „affiliation” jest dostępny tylko w zakresie elementu.
coupon string Nie SUMMER_FUN Nazwa lub kod kuponu powiązane 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 ramach 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, jeśli 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, jeśli 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: identyfikator lokalizacji jest dostępny tylko w zakresie elementu.
price number Nie 10.01 Cena jednostkowa produktu w jednostkach waluty określonej w parametrze currency.
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 sztuk produktu.

Jeśli nie jest ustawiona, wartość quantity jest ustawiona na 1.
Oprócz określonych parametrów możesz w tablicy items umieścić 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 wydarzenia: 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;Ecommerce Items&rbrace;&rbrace;
    • transaction_id - &lbrace;&lbrace;Identyfikator transakcji e-commerce&rbrace;&rbrace;
    • value - &lbrace;&lbrace;Wartość e-commerce&rbrace;&rbrace;
    • tax - &lbrace;&lbrace;Ecommerce Tax&rbrace;&rbrace;
    • shipping - &lbrace;&lbrace;Ecommerce Shipping&rbrace;&rbrace;
    • currency - &lbrace;&lbrace;Ecommerce Currency&rbrace;&rbrace;
    • coupon - &lbrace;&lbrace;Kupon e-commerce&rbrace;&rbrace;
  • Aktywator: zdarzenie jest równe zwrotowi środków

Konfiguracja reguły:

  • Typ aktywatora: zdarzenie niestandardowe
  • Nazwa wydarzenia: refund
  • Ta reguła uruchamia się, gdy jest spełniony ten warunek: Wszystkie zdarzenia niestandardowe
 
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 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.
value number Tak* 30.03 Wartość pieniężna zdarzenia.

* Ustaw wartość value na sumę wartości (price * quantity) dla wszystkich elementów w items. Nie podawaj wartości shipping ani tax.
* W przypadku efektywnego raportowania zwykle wymagany jest parametr value. Jeśli oznaczysz zdarzenie jako kluczowe, zalecamy ustawienievalue.
* Jeśli skonfigurujesz parametr value, musisz też skonfigurować parametr currency.
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: parametr „affiliation” jest dostępny tylko w zakresie elementu.
coupon string Nie SUMMER_FUN Nazwa lub kod kuponu powiązane 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 ramach 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, jeśli 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, jeśli 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: identyfikator lokalizacji jest dostępny tylko w zakresie elementu.
price number Nie 10.01 Cena jednostkowa produktu w jednostkach waluty określonej w parametrze currency.
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 sztuk produktu.

Jeśli nie jest ustawiona, wartość quantity jest ustawiona na 1.
Oprócz określonych parametrów możesz w tablicy items umieścić 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 wydarzenia: 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;Ecommerce Items&rbrace;&rbrace;
    • value - &lbrace;&lbrace;Wartość e-commerce&rbrace;&rbrace;
    • currency - &lbrace;&lbrace;Ecommerce Currency&rbrace;&rbrace;
  • Reguła: zdarzenie jest równe remove_from_cart

Konfiguracja reguły:

  • Typ aktywatora: zdarzenie niestandardowe
  • Nazwa wydarzenia: remove_from_cart
  • Ta reguła uruchamia się, gdy jest spełniony ten warunek: Wszystkie zdarzenia niestandardowe
 
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
    }
    ]
  }
});

Rejestruj to zdarzenie, aby wskazać, kiedy użytkownik przeprowadził wyszukiwanie. Możesz używać tego zdarzenia, aby określać, czego użytkownicy szukają w Twojej witrynie lub aplikacji. Możesz np. 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 wydarzenia: 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 wydarzenia: 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.

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

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.

* Oczekuje się, że tablica items będzie zawierać jeden element reprezentujący wybrany produkt. Jeśli podasz kilka elementów, użyty zostanie tylko pierwszy element w items.

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: parametr „affiliation” jest dostępny tylko w zakresie elementu.
coupon string Nie SUMMER_FUN Nazwa lub kod kuponu powiązane 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 ramach 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, jeśli 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, jeśli 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: identyfikator lokalizacji jest dostępny tylko w zakresie elementu.
price number Nie 10.01 Cena jednostkowa produktu w jednostkach waluty określonej w parametrze currency.
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 sztuk produktu.

Jeśli nie jest ustawiona, wartość quantity jest ustawiona na 1.
Oprócz określonych parametrów możesz w tablicy items umieścić 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 wydarzenia: 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;Ecommerce Items&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 wydarzenia: select_item
  • Ta reguła uruchamia się, gdy jest spełniony ten warunek: Wszystkie zdarzenia niestandardowe
 
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.

Ignorowany, jeśli jest ustawiony na poziomie produktu.
creative_slot string Nie featured_app_1 Nazwa boksu kreacji promocyjnej powiązanego ze zdarzeniem.

Ignorowany, jeśli jest ustawiony na poziomie produktu.
promotion_id string Nie P_12345 Identyfikator promocji powiązanej ze zdarzeniem.

Ignorowany, jeśli jest ustawiony na poziomie produktu.
promotion_name string Nie Letnia wyprzedaż Nazwa promocji powiązanej ze zdarzeniem.

Ignorowany, jeśli jest ustawiony na poziomie produktu.
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: parametr „affiliation” jest dostępny tylko w zakresie elementu.
coupon string Nie SUMMER_FUN Nazwa lub kod kuponu powiązane 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 ten parametr jest ustawiony, parametr creative_name na poziomie zdarzenia jest ignorowany.
Jeśli nie jest ustawiona, używana jest wartość creative_name na poziomie zdarzenia, jeśli jest dostępna.
creative_slot string Nie featured_app_1 Nazwa boksu kreacji promocyjnej powiązanego z produktem.

Jeśli ten parametr jest ustawiony, parametr creative_slot na poziomie zdarzenia jest ignorowany.
Jeśli nie jest ustawiona, używana jest wartość creative_slot na poziomie zdarzenia, o ile jest dostępna.
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 ramach 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, jeśli 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, jeśli 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: identyfikator lokalizacji jest dostępny tylko w zakresie elementu.
price number Nie 10.01 Cena jednostkowa produktu w jednostkach waluty określonej w parametrze currency.
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 ten parametr jest ustawiony, parametr promotion_id na poziomie zdarzenia jest ignorowany.
Jeśli nie jest ustawiona, używana jest wartość promotion_id na poziomie zdarzenia, jeśli jest dostępna.
promotion_name string Nie Letnia wyprzedaż Nazwa promocji powiązanej z produktem.

Jeśli ten parametr jest ustawiony, parametr promotion_name na poziomie zdarzenia jest ignorowany.
Jeśli nie jest ustawiona, używana jest wartość promotion_name na poziomie zdarzenia, jeśli jest dostępna.
quantity number Nie 3

Liczba sztuk produktu.

Jeśli nie jest ustawiona, wartość quantity jest ustawiona na 1.
Oprócz określonych parametrów możesz w tablicy items umieścić 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
  • 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;Ecommerce Items&rbrace;&rbrace;
  • Typ zmiennej: zmienna warstwy danych – „ecommerce.items”
  • Aktywator: zdarzenie jest równe select_promotion

Konfiguracja reguły:

  • Typ aktywatora: zdarzenie niestandardowe
  • Nazwa wydarzenia: select_promotion
  • Ta reguła uruchamia się, gdy jest spełniony ten warunek: Wszystkie zdarzenia niestandardowe
 
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",
      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
    }
    ]
  }
});

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 wydarzenia: 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 wydarzenia: 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 oznacza, ż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 zakupu 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żyj tego zdarzenia w ścieżce z parametrem tutorial_complete, aby dowiedzieć się, 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 wprowadzający. Użyj tego zdarzenia 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 wydarzenia: tutorial_complete
  • Wywołuj, gdy ktoś zakończy proces wprowadzający

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 wydarzenia: unlock_achievement
  • Parametry zdarzenia (nazwa parametru – wartość):
    • achievement_id - A_12345
  • Wywoływane, gdy użytkownik odblokuje osiągnięcie.

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 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.
value number Tak* 30.03 Wartość pieniężna zdarzenia.

* Ustaw wartość value na sumę wartości (price * quantity) dla wszystkich elementów w items. Nie podawaj wartości shipping ani tax.
* W przypadku efektywnego raportowania zwykle wymagany jest parametr value. Jeśli oznaczysz zdarzenie jako kluczowe, zalecamy ustawienie wartości value.
* Jeśli skonfigurujesz parametr value, musisz też skonfigurować parametr currency.
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: parametr „affiliation” jest dostępny tylko w zakresie elementu.
coupon string Nie SUMMER_FUN Nazwa lub kod kuponu powiązane 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 ramach 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, jeśli 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, jeśli 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: identyfikator lokalizacji jest dostępny tylko w zakresie elementu.
price number Nie 10.01 Cena jednostkowa produktu w jednostkach waluty określonej w parametrze currency.
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 sztuk produktu.

Jeśli nie jest ustawiona, wartość quantity jest ustawiona na 1.
Oprócz określonych parametrów możesz w tablicy items umieścić 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 wydarzenia: 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;Ecommerce Items&rbrace;&rbrace;
    • value - &lbrace;&lbrace;Wartość e-commerce&rbrace;&rbrace;
    • currency - &lbrace;&lbrace;Ecommerce Currency&rbrace;&rbrace;
  • Aktywator: zdarzenie jest równe view_cart

Konfiguracja reguły:

  • Typ aktywatora: zdarzenie niestandardowe
  • Nazwa wydarzenia: view_cart
  • Ta reguła uruchamia się, gdy jest spełniony ten warunek: Wszystkie zdarzenia niestandardowe
 
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 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.
value number Tak* 30.03 Wartość pieniężna zdarzenia.

* Ustaw wartość value na sumę wartości (price * quantity) dla wszystkich elementów w items. Nie podawaj wartości shipping ani tax.
* W przypadku efektywnego raportowania zwykle wymagany jest parametr value. Jeśli oznaczysz zdarzenie jako kluczowe, zalecamy ustawienievalue.
* Parametr currency jest wymagany, jeśli skonfigurujesz parametr 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: parametr „affiliation” jest dostępny tylko w zakresie elementu.
coupon string Nie SUMMER_FUN Nazwa lub kod kuponu powiązane 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 ramach 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, jeśli 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, jeśli 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) Fizyczna lokalizacja 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: identyfikator lokalizacji jest dostępny tylko w zakresie elementu.
price number Nie 10.01 Cena jednostkowa produktu w jednostkach waluty określonej w parametrze currency.
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 sztuk produktu.

Jeśli nie jest ustawiona, wartość quantity jest ustawiona na 1.
Oprócz określonych parametrów możesz w tablicy items umieścić 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 wydarzenia: 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;Ecommerce Items&rbrace;&rbrace;
    • value - &lbrace;&lbrace;Wartość e-commerce&rbrace;&rbrace;
    • currency - &lbrace;&lbrace;Ecommerce Currency&rbrace;&rbrace;
  • Aktywator: zdarzenie jest równe view_item

Konfiguracja reguły:

  • Typ aktywatora: zdarzenie niestandardowe
  • Nazwa wydarzenia: view_item
  • Ta reguła uruchamia się, gdy jest spełniony ten warunek: Wszystkie zdarzenia niestandardowe
 
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 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.
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: parametr „affiliation” jest dostępny tylko w zakresie elementu.
coupon string Nie SUMMER_FUN Nazwa lub kod kuponu powiązane 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 ramach 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, jeśli 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, jeśli 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: identyfikator lokalizacji jest dostępny tylko w zakresie elementu.
price number Nie 10.01 Cena jednostkowa produktu w jednostkach waluty określonej w parametrze currency.
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 sztuk produktu.

Jeśli nie jest ustawiona, wartość quantity jest ustawiona na 1.
Oprócz określonych parametrów możesz w tablicy items umieścić 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 wydarzenia: 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;Ecommerce Items&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 wydarzenia: view_item_list
  • Ta reguła uruchamia się, gdy jest spełniony ten warunek: Wszystkie zdarzenia niestandardowe
 
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.

Ignorowany, jeśli jest ustawiony na poziomie produktu.
creative_slot string Nie featured_app_1 Nazwa boksu kreacji promocyjnej powiązanego ze zdarzeniem.

Ignorowany, jeśli jest ustawiony na poziomie produktu.
promotion_id string Nie P_12345 Identyfikator promocji powiązanej ze zdarzeniem.

Ignorowany, jeśli jest ustawiony na poziomie produktu.
promotion_name string Nie Letnia wyprzedaż Nazwa promocji powiązanej ze zdarzeniem.

Ignorowany, jeśli jest ustawiony na poziomie produktu.
items Array<Item> Tak* Produkty powiązane ze zdarzeniem.

* Oczekuje się, że tablica items będzie zawierać jeden element reprezentujący produkt powiązany z promocją. Jeśli podasz kilka elementów, użyty zostanie tylko pierwszy element w items.

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: parametr „affiliation” jest dostępny tylko w zakresie elementu.
coupon string Nie SUMMER_FUN Nazwa lub kod kuponu powiązane 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 ten parametr jest ustawiony, parametr creative_name na poziomie zdarzenia jest ignorowany.
Jeśli nie jest ustawiona, używana jest wartość creative_name na poziomie zdarzenia, jeśli jest dostępna.
creative_slot string Nie featured_app_1 Nazwa boksu kreacji promocyjnej powiązanego z produktem.

Jeśli ten parametr jest ustawiony, parametr creative_slot na poziomie zdarzenia jest ignorowany.
Jeśli nie jest ustawiona, używana jest wartość creative_slot na poziomie zdarzenia, o ile jest dostępna.
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 ramach 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, jeśli 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, jeśli 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: identyfikator lokalizacji jest dostępny tylko w zakresie elementu.
price number Nie 10.01 Cena jednostkowa produktu w jednostkach waluty określonej w parametrze currency.
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 ten parametr jest ustawiony, parametr promotion_id na poziomie zdarzenia jest ignorowany.
Jeśli nie jest ustawiona, używana jest wartość promotion_id na poziomie zdarzenia, jeśli jest dostępna.
promotion_name string Nie Letnia wyprzedaż Nazwa promocji powiązanej z produktem.

Jeśli ten parametr jest ustawiony, parametr promotion_name na poziomie zdarzenia jest ignorowany.
Jeśli nie jest ustawiona, używana jest wartość promotion_name na poziomie zdarzenia, jeśli jest dostępna.
quantity number Nie 3

Liczba sztuk produktu.

Jeśli nie jest ustawiona, wartość quantity jest ustawiona na 1.
Oprócz określonych parametrów możesz w tablicy items umieścić 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 wydarzenia: 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;Ecommerce Items&rbrace;&rbrace;
  • Aktywator: zdarzenie jest równe view_promotion

Konfiguracja reguły:

  • Typ aktywatora: zdarzenie niestandardowe
  • Nazwa wydarzenia: view_promotion
  • Ta reguła uruchamia się, gdy jest spełniony ten warunek: Wszystkie zdarzenia niestandardowe
 
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",
      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
    }
    ]
  }
});

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 efektywnego raportowania. Jeśli oznaczysz zdarzenie jako kluczowe, zalecamy ustawienievalue.
* Jeśli skonfigurujesz parametr value, musisz też skonfigurować parametr currency.
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 wydarzenia: 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.