Zalecane zdarzenia

Google Analytics wysyła niektóre typy zdarzeń automatycznie. Na tej stronie opisujemy dodatkowe zdarzenia opcjonalne, które możesz skonfigurować, aby mierzyć więcej zachowań i generować bardziej przydatne raporty dla swojej firmy. Konfiguracja tych dodatkowych zdarzeń wymaga więcej pracy, dlatego Google Analytics 4 nie może wysyłać ich 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żywać, wybierz platformę do zarządzania tagami:

add_payment_info

To zdarzenie oznacza, że użytkownik przesłał informacje o płatności w ramach procesu płatności 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ściach w zdarzeniu view_item nie wpływają na przychody

* Jeśli ustawisz parametr value, do prawidłowego obliczania danych o przychodach niezbędny jest parametr currency.
value number Tak* 30,03 Wartość pieniężna zdarzenia.

* Ustaw wartość parametru value na sumę wartości parametru (price * quantity) dla wszystkich elementów w pliku items. Nie używaj shipping ani tax.
* value jest zwykle wymagany do efektywnego raportowania. Jeśli oznaczysz zdarzenie jako kluczowe, zalecamy ustawienie wartości value.
* Jeśli skonfigurujesz parametr value, parametr currency jest wymagany.
coupon string Nie SUMMER_FUN Nazwa lub kod kuponu powiązanego ze zdarzeniem.

Parametry coupon na poziomie zdarzenia i produktu są niezależne od siebie.
payment_type string Nie Karta kredytowa Wybrana forma płatności.
items Array<Item> Tak Produkty związane z wydarzeniem.

Parametry obiektu item

Nazwa Typ Wymagane Przykładowa wartość Opis
item_id string Tak* SKU_12345

Identyfikator elementu.

*Wymagana jest usługa item_id lub item_name.

item_name string Tak* Koszulka „Stan and Friends”

Nazwa elementu.

*Wymagana jest usługa item_id lub item_name.

affiliation string Nie Google Store Powiązanie produktu umożliwiające wskazanie jego dostawcy lub lokalizacji sklepu stacjonarnego.
Uwaga: atrybut `affiliation` jest dostępny tylko w zakresie produktu.
coupon string Nie SUMMER_FUN Nazwa lub kod kuponu powiązanego z produktem.

Parametry coupon na poziomie zdarzenia i produktu są niezależne od siebie.
discount number Nie 2,22 Wartość jednostkowa rabatu kwotowego powiązanego z produktem.
index number Nie 5 Indeks/pozycja elementu na liście.
item_brand string Nie Google Marka produktu.
item_category string Nie Odzież Kategoria produktu. Jeśli jest używany w ramach hierarchii kategorii lub mapy kategorii, będzie to pierwsza kategoria.
item_category2 string Nie Dorosły Druga hierarchia kategorii lub dodatkowa mapa kategorii dla elementu.
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 jest ustawiony, parametr item_list_id na poziomie zdarzenia jest ignorowany.
Jeśli nie jest skonfigurowana, używana jest wartość na poziomie zdarzenia item_list_id (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 jest ustawiony, parametr item_list_name na poziomie zdarzenia jest ignorowany.
Jeśli nie jest skonfigurowana, używana jest wartość na poziomie zdarzenia item_list_name (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. fizyczna lokalizacja sklepu). Zalecamy użycie identyfikatora miejsca w Google odpowiadającego powiązanemu produktowi. Możesz też użyć niestandardowego identyfikatora lokalizacji.
Uwaga: identyfikator lokalizacji jest dostępny tylko w zakresie produktu.
price number Nie 10,01 Cena produktu w walucie określonej w parametrze currency.
Jeśli produkt objęty jest rabatem, ustaw parametr price na obniżoną cenę jednostkową i określ rabat na cenę jednostkową w parametrze discount.
quantity number Nie 3

Liczba sztuk produktu.

Jeśli nie zostanie ustawiony, quantity przyjmuje wartość 1.
Oprócz parametrów przewidzianych w ramach zaleceń możesz uwzględnić w tablicy items do 27 parametrów niestandardowych.

Przykład

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

Pokaż konfigurację tagu

Konfiguracja tagu:

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

Konfiguracja reguły:

  • Typ reguły: 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,
      quantity: 3
    }
    ]
  }
});

add_shipping_info

To zdarzenie oznacza, że użytkownik przesłał informacje o dostawie w ramach procesu płatności 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ściach w zdarzeniu view_item nie wpływają na przychody

* Jeśli ustawisz parametr value, do prawidłowego obliczania danych o przychodach niezbędny jest parametr currency.
value number Tak* 30,03 Wartość pieniężna zdarzenia.

* Ustaw wartość parametru value na sumę wartości parametru (price * quantity) dla wszystkich elementów w pliku items. Nie używaj shipping ani tax.
* value jest zwykle wymagany do efektywnego raportowania. Jeśli oznaczysz zdarzenie jako kluczowe, zalecamy ustawienie wartości value.
* Jeśli skonfigurujesz parametr value, parametr currency jest wymagany.
coupon string Nie SUMMER_FUN Nazwa lub kod kuponu powiązanego ze zdarzeniem.

Parametry coupon na poziomie zdarzenia i produktu są niezależne od siebie.
shipping_tier string Nie Ziemia Poziom dostawy (np. Ground, Air, Next-day) wybrany w przypadku zakupionego produktu.
items Array<Item> Tak Produkty związane z wydarzeniem.

Parametry obiektu item

Nazwa Typ Wymagane Przykładowa wartość Opis
item_id string Tak* SKU_12345

Identyfikator elementu.

*Wymagana jest usługa item_id lub item_name.

item_name string Tak* Koszulka „Stan and Friends”

Nazwa elementu.

*Wymagana jest usługa item_id lub item_name.

affiliation string Nie Google Store Powiązanie produktu umożliwiające wskazanie jego dostawcy lub lokalizacji sklepu stacjonarnego.
Uwaga: atrybut `affiliation` jest dostępny tylko w zakresie produktu.
coupon string Nie SUMMER_FUN Nazwa lub kod kuponu powiązanego z produktem.

Parametry coupon na poziomie zdarzenia i produktu są niezależne od siebie.
discount number Nie 2,22 Wartość jednostkowa rabatu kwotowego powiązanego z produktem.
index number Nie 5 Indeks/pozycja elementu na liście.
item_brand string Nie Google Marka produktu.
item_category string Nie Odzież Kategoria produktu. Jeśli jest używany w ramach hierarchii kategorii lub mapy kategorii, będzie to pierwsza kategoria.
item_category2 string Nie Dorosły Druga hierarchia kategorii lub dodatkowa mapa kategorii dla elementu.
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 jest ustawiony, parametr item_list_id na poziomie zdarzenia jest ignorowany.
Jeśli nie jest skonfigurowana, używana jest wartość na poziomie zdarzenia item_list_id (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 jest ustawiony, parametr item_list_name na poziomie zdarzenia jest ignorowany.
Jeśli nie jest skonfigurowana, używana jest wartość na poziomie zdarzenia item_list_name (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. fizyczna lokalizacja sklepu). Zalecamy użycie identyfikatora miejsca w Google odpowiadającego powiązanemu produktowi. Możesz też użyć niestandardowego identyfikatora lokalizacji.
Uwaga: identyfikator lokalizacji jest dostępny tylko w zakresie produktu.
price number Nie 10,01 Cena produktu w walucie określonej w parametrze currency.
Jeśli produkt objęty jest rabatem, ustaw parametr price na obniżoną cenę jednostkową i określ rabat na cenę jednostkową w parametrze discount.
quantity number Nie 3

Liczba sztuk produktu.

Jeśli nie zostanie ustawiony, quantity przyjmuje wartość 1.
Oprócz parametrów przewidzianych w ramach zaleceń możesz uwzględnić w tablicy items do 27 parametrów niestandardowych.

Przykład

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

Pokaż konfigurację tagu

Konfiguracja tagu:

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

Konfiguracja reguły:

  • Typ reguły: zdarzenie niestandardowe
  • Nazwa zdarzenia: 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,
      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ściach w zdarzeniu view_item nie wpływają na przychody

* Jeśli ustawisz parametr value, do prawidłowego obliczania danych o przychodach niezbędny jest parametr currency.
value number Tak* 30,03 Wartość pieniężna zdarzenia.

* Ustaw wartość parametru value na sumę wartości parametru (price * quantity) dla wszystkich elementów w pliku items. Nie używaj shipping ani tax.
* value jest zwykle wymagany do efektywnego raportowania. Jeśli oznaczysz zdarzenie jako kluczowe, zalecamy ustawienie wartości value.
* Jeśli skonfigurujesz parametr value, parametr currency jest wymagany.
items Array<Item> Tak Produkty związane z wydarzeniem.

Parametry obiektu item

Nazwa Typ Wymagane Przykładowa wartość Opis
item_id string Tak* SKU_12345

Identyfikator elementu.

*Wymagana jest usługa item_id lub item_name.

item_name string Tak* Koszulka „Stan and Friends”

Nazwa elementu.

*Wymagana jest usługa item_id lub item_name.

affiliation string Nie Google Store Powiązanie produktu umożliwiające wskazanie jego dostawcy lub lokalizacji sklepu stacjonarnego.
Uwaga: atrybut `affiliation` jest dostępny tylko w zakresie produktu.
coupon string Nie SUMMER_FUN Nazwa lub kod kuponu powiązanego z produktem.

Parametry coupon na poziomie zdarzenia i produktu są niezależne od siebie.
discount number Nie 2,22 Wartość jednostkowa rabatu kwotowego powiązanego z produktem.
index number Nie 5 Indeks/pozycja elementu na liście.
item_brand string Nie Google Marka produktu.
item_category string Nie Odzież Kategoria produktu. Jeśli jest używany w ramach hierarchii kategorii lub mapy kategorii, będzie to pierwsza kategoria.
item_category2 string Nie Dorosły Druga hierarchia kategorii lub dodatkowa mapa kategorii dla elementu.
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 jest ustawiony, parametr item_list_id na poziomie zdarzenia jest ignorowany.
Jeśli nie jest skonfigurowana, używana jest wartość na poziomie zdarzenia item_list_id (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 jest ustawiony, parametr item_list_name na poziomie zdarzenia jest ignorowany.
Jeśli nie jest skonfigurowana, używana jest wartość na poziomie zdarzenia item_list_name (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. fizyczna lokalizacja sklepu). Zalecamy użycie identyfikatora miejsca w Google odpowiadającego powiązanemu produktowi. Możesz też użyć niestandardowego identyfikatora lokalizacji.
Uwaga: identyfikator lokalizacji jest dostępny tylko w zakresie produktu.
price number Nie 10,01 Cena produktu w walucie określonej w parametrze currency.
Jeśli produkt objęty jest rabatem, ustaw parametr price na obniżoną cenę jednostkową i określ rabat na cenę jednostkową w parametrze discount.
quantity number Nie 3

Liczba sztuk produktu.

Jeśli nie zostanie ustawiony, quantity przyjmuje wartość 1.
Oprócz parametrów przewidzianych w ramach zaleceń możesz uwzględnić w tablicy items do 27 parametrów niestandardowych.

Przykład

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

Pokaż konfigurację tagu

Konfiguracja tagu:

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

Konfiguracja reguły:

  • Typ reguły: zdarzenie niestandardowe
  • Nazwa zdarzenia: 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,
      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ściach w zdarzeniu view_item nie wpływają na przychody

* Jeśli ustawisz parametr value, do prawidłowego obliczania danych o przychodach niezbędny jest parametr currency.
value number Tak* 30,03 Wartość pieniężna zdarzenia.

* Ustaw wartość parametru value na sumę wartości parametru (price * quantity) dla wszystkich elementów w pliku items. Nie używaj shipping ani tax.
* value jest zwykle wymagany do efektywnego raportowania. Jeśli oznaczysz zdarzenie jako kluczowe, zalecamy ustawienie wartości value.
* Jeśli skonfigurujesz parametr value, parametr currency jest wymagany.
items Array<Item> Tak Produkty związane z wydarzeniem.

Parametry obiektu item

Nazwa Typ Wymagane Przykładowa wartość Opis
item_id string Tak* SKU_12345

Identyfikator elementu.

*Wymagana jest usługa item_id lub item_name.

item_name string Tak* Koszulka „Stan and Friends”

Nazwa elementu.

*Wymagana jest usługa item_id lub item_name.

affiliation string Nie Google Store Powiązanie produktu umożliwiające wskazanie jego dostawcy lub lokalizacji sklepu stacjonarnego.
Uwaga: atrybut `affiliation` jest dostępny tylko w zakresie produktu.
coupon string Nie SUMMER_FUN Nazwa lub kod kuponu powiązanego z produktem.

Parametry coupon na poziomie zdarzenia i produktu są niezależne od siebie.
discount number Nie 2,22 Wartość jednostkowa rabatu kwotowego powiązanego z produktem.
index number Nie 5 Indeks/pozycja elementu na liście.
item_brand string Nie Google Marka produktu.
item_category string Nie Odzież Kategoria produktu. Jeśli jest używany w ramach hierarchii kategorii lub mapy kategorii, będzie to pierwsza kategoria.
item_category2 string Nie Dorosły Druga hierarchia kategorii lub dodatkowa mapa kategorii dla elementu.
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 jest ustawiony, parametr item_list_id na poziomie zdarzenia jest ignorowany.
Jeśli nie jest skonfigurowana, używana jest wartość na poziomie zdarzenia item_list_id (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 jest ustawiony, parametr item_list_name na poziomie zdarzenia jest ignorowany.
Jeśli nie jest skonfigurowana, używana jest wartość na poziomie zdarzenia item_list_name (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. fizyczna lokalizacja sklepu). Zalecamy użycie identyfikatora miejsca w Google odpowiadającego powiązanemu produktowi. Możesz też użyć niestandardowego identyfikatora lokalizacji.
Uwaga: identyfikator lokalizacji jest dostępny tylko w zakresie produktu.
price number Nie 10,01 Cena produktu w walucie określonej w parametrze currency.
Jeśli produkt objęty jest rabatem, ustaw parametr price na obniżoną cenę jednostkową i określ rabat na cenę jednostkową w parametrze discount.
quantity number Nie 3

Liczba sztuk produktu.

Jeśli nie zostanie ustawiony, quantity przyjmuje wartość 1.
Oprócz parametrów przewidzianych w ramach zaleceń możesz uwzględnić w tablicy items do 27 parametrów niestandardowych.

Przykład

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

Pokaż konfigurację tagu

Konfiguracja tagu:

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

Konfiguracja reguły:

  • Typ reguły: zdarzenie niestandardowe
  • Nazwa zdarzenia: 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,
      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ściach w zdarzeniu view_item nie wpływają na przychody

* Jeśli ustawisz parametr value, do prawidłowego obliczania danych o przychodach niezbędny jest parametr currency.
value number Tak* 30,03 Wartość pieniężna zdarzenia.

* Ustaw wartość parametru value na sumę wartości parametru (price * quantity) dla wszystkich elementów w pliku items. Nie używaj shipping ani tax.
* value jest zwykle wymagany do efektywnego raportowania. Jeśli oznaczysz zdarzenie jako kluczowe, zalecamy ustawienie wartości value.
* Jeśli skonfigurujesz parametr value, parametr currency jest wymagany.
coupon string Nie SUMMER_FUN Nazwa lub kod kuponu powiązanego ze zdarzeniem.

Parametry coupon na poziomie zdarzenia i produktu są niezależne od siebie.
items Array<Item> Tak Produkty związane z wydarzeniem.

Parametry obiektu item

Nazwa Typ Wymagane Przykładowa wartość Opis
item_id string Tak* SKU_12345

Identyfikator elementu.

*Wymagana jest usługa item_id lub item_name.

item_name string Tak* Koszulka „Stan and Friends”

Nazwa elementu.

*Wymagana jest usługa item_id lub item_name.

affiliation string Nie Google Store Powiązanie produktu umożliwiające wskazanie jego dostawcy lub lokalizacji sklepu stacjonarnego.
Uwaga: atrybut `affiliation` jest dostępny tylko w zakresie produktu.
coupon string Nie SUMMER_FUN Nazwa lub kod kuponu powiązanego z produktem.

Parametry coupon na poziomie zdarzenia i produktu są niezależne od siebie.
discount number Nie 2,22 Wartość jednostkowa rabatu kwotowego powiązanego z produktem.
index number Nie 5 Indeks/pozycja elementu na liście.
item_brand string Nie Google Marka produktu.
item_category string Nie Odzież Kategoria produktu. Jeśli jest używany w ramach hierarchii kategorii lub mapy kategorii, będzie to pierwsza kategoria.
item_category2 string Nie Dorosły Druga hierarchia kategorii lub dodatkowa mapa kategorii dla elementu.
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 jest ustawiony, parametr item_list_id na poziomie zdarzenia jest ignorowany.
Jeśli nie jest skonfigurowana, używana jest wartość na poziomie zdarzenia item_list_id (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 jest ustawiony, parametr item_list_name na poziomie zdarzenia jest ignorowany.
Jeśli nie jest skonfigurowana, używana jest wartość na poziomie zdarzenia item_list_name (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. fizyczna lokalizacja sklepu). Zalecamy użycie identyfikatora miejsca w Google odpowiadającego powiązanemu produktowi. Możesz też użyć niestandardowego identyfikatora lokalizacji.
Uwaga: identyfikator lokalizacji jest dostępny tylko w zakresie produktu.
price number Nie 10,01 Cena produktu w walucie określonej w parametrze currency.
Jeśli produkt objęty jest rabatem, ustaw parametr price na obniżoną cenę jednostkową i określ rabat na cenę jednostkową w parametrze discount.
quantity number Nie 3

Liczba sztuk produktu.

Jeśli nie zostanie ustawiony, quantity przyjmuje wartość 1.
Oprócz parametrów przewidzianych w ramach zaleceń możesz uwzględnić w tablicy items do 27 parametrów niestandardowych.

Przykład

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

Pokaż konfigurację tagu

Konfiguracja tagu:

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

Konfiguracja reguły:

  • Typ reguły: zdarzenie niestandardowe
  • Nazwa zdarzenia: 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,
      quantity: 3
    }
    ]
  }
});

close_convert_lead

To zdarzenie mierzy, kiedy potencjalny klient został przekształcony w klienta (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, parametr currency jest wymagany.

Przykład

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

Pokaż konfigurację tagu

Konfiguracja tagu:

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

close_unconvert_lead

To zdarzenie mierzy, kiedy użytkownik jest oznaczany jako potencjalny klient, który nie doprowadził do konwersji, wraz z odpowiednim powodem.

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, parametr currency jest wymagany.
unconvert_lead_reason string Nie Nigdy nie odpowiada Powód, dla którego kontakt do potencjalnego klienta nie został przekształcony.

Przykład

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

Pokaż konfigurację tagu

Konfiguracja tagu:

  • Typ tagu: zdarzenie GA4
  • Nazwa zdarzenia: close_unconvert_lead
  • Parametry zdarzenia (nazwa parametru – wartość):
    • currency – USD
    • value - 30.03
  • Zdarzenie to jest wywoływane, gdy użytkownik zostanie oznaczony jako potencjalny klient, który nie doprowadził do konwersji z jednego z kilku powodów

disqualify_lead

To zdarzenie mierzy, kiedy użytkownik zostaje oznaczony jako wykluczony z możliwości zostania potencjalnym klientem, wraz z powodem wykluczenia.

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, parametr currency jest wymagany.
disqualified_lead_reason string Nie Nie szukam do kupienia Powodem może być zakwalifikowanie potencjalnego klienta jako niespełniającego kryteriów.

Przykład

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

Pokaż konfigurację tagu

Konfiguracja tagu:

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

earn_virtual_currency

To zdarzenie mierzy, kiedy użytkownik otrzymuje wirtualną walutę w grze. Aby lepiej poznać swoje wirtualne finanse, używaj tego zdarzenia z parametrem spend_virtual_currency.

Parametry

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

Przykład

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

Pokaż konfigurację tagu

Konfiguracja tagu:

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

generate_lead

To zdarzenie mierzy, kiedy potencjalny klient został utworzony (np. za pomocą platformy). Zapisuj te dane, aby poznać skuteczność kampanii marketingowych i sprawdzić, ilu klientów ponownie nawiązuje kontakt z Twoją firmą po skorzystaniach z 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 ustawienie wartości value.
* Jeśli skonfigurujesz parametr value, parametr currency jest wymagany.
lead_source string Nie Targi Źródło potencjalnego klienta.

Przykład

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

Pokaż konfigurację tagu

Konfiguracja tagu:

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

join_group

Zarejestruj 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

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

Pokaż konfigurację tagu

Konfiguracja tagu:

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

level_end

To zdarzenie oznacza, że gracz doszedł do końca poziomu w grze.

Parametry

Nazwa Typ Wymagane Przykładowa wartość Opis
level_name string Nie Podróż się rozpoczyna... Nazwa poziomu.
success boolean Nie prawda Ustaw na true, jeśli udało się ukończyć poziom.

Przykład

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

Pokaż konfigurację tagu

Konfiguracja tagu:

  • Typ tagu: zdarzenie GA4
  • Nazwa zdarzenia: level_end
  • Parametry zdarzenia (nazwa parametru – wartość):
    • level_name – Zaczyna się podróż…
    • success - true
  • Wywoływanie po zakończeniu przez gracza poziomu (np. strona 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ę rozpoczyna... Nazwa poziomu.

Przykład

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

Pokaż konfigurację tagu

Konfiguracja tagu:

  • Typ tagu: zdarzenie GA4
  • Nazwa zdarzenia: level_start
  • Parametry zdarzenia (nazwa parametru – wartość):
    • level_name – Zaczyna się podróż…
  • Aktywuj, gdy ktoś rozpoczyna nowy poziom (np.stronę rozpoczęcia poziomu).

level_up

To zdarzenie oznacza, że gracz awansował w grze. Możesz go używać do pomiaru rozkładu poziomów wśród użytkowników i identyfikowania 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 osiągnęła wyższy poziom.

Przykład

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

Pokaż konfigurację tagu

Konfiguracja tagu:

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

login

Wyślij to zdarzenie, aby wskazać, że użytkownik zalogował się w Twojej witrynie lub aplikacji.

Parametry

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

Przykład

Pokaż konfigurację tagu

Konfiguracja tagu:

  • Typ tagu: zdarzenie GA4
  • Nazwa zdarzenia: login
  • Parametry zdarzenia (nazwa parametru – wartość):
    • method – Google
  • Wywoływanie reguły po zalogowaniu się użytkownika

post_score

Wyślij to zdarzenie, gdy użytkownik wprowadzi wynik. Za pomocą tego zdarzenia możesz się dowiedzieć, jak użytkownicy radzą sobie w Twojej grze, i zwią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

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

Pokaż konfigurację tagu

Konfiguracja tagu:

  • Typ tagu: zdarzenie GA4
  • Nazwa zdarzenia: post_score
  • Parametry zdarzenia (nazwa parametru – wartość):
    • score – 10 000
    • 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ściach w zdarzeniu view_item nie wpływają na przychody

* Jeśli ustawisz parametr value, do prawidłowego obliczania danych o przychodach niezbędny jest parametr currency.
value number Tak* 30,03 Wartość pieniężna zdarzenia.

* Ustaw wartość parametru value na sumę wartości parametru (price * quantity) dla wszystkich elementów w pliku items. Nie używaj shipping ani tax.
* value jest zwykle wymagany do efektywnego raportowania. Jeśli oznaczysz zdarzenie jako kluczowe, zalecamy ustawienie wartości value.
* Jeśli skonfigurujesz parametr value, parametr currency jest wymagany.
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 coupon na poziomie zdarzenia i produktu są niezależne od siebie.
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 związane z wydarzeniem.

Parametry obiektu item

Nazwa Typ Wymagane Przykładowa wartość Opis
item_id string Tak* SKU_12345

Identyfikator elementu.

*Wymagana jest usługa item_id lub item_name.

item_name string Tak* Koszulka „Stan and Friends”

Nazwa elementu.

*Wymagana jest usługa item_id lub item_name.

affiliation string Nie Google Store Powiązanie produktu umożliwiające wskazanie jego dostawcy lub lokalizacji sklepu stacjonarnego.
Uwaga: atrybut `affiliation` jest dostępny tylko w zakresie produktu.
coupon string Nie SUMMER_FUN Nazwa lub kod kuponu powiązanego z produktem.

Parametry coupon na poziomie zdarzenia i produktu są niezależne od siebie.
discount number Nie 2,22 Wartość jednostkowa rabatu kwotowego powiązanego z produktem.
index number Nie 5 Indeks/pozycja elementu na liście.
item_brand string Nie Google Marka produktu.
item_category string Nie Odzież Kategoria produktu. Jeśli jest używany w ramach hierarchii kategorii lub mapy kategorii, będzie to pierwsza kategoria.
item_category2 string Nie Dorosły Druga hierarchia kategorii lub dodatkowa mapa kategorii dla elementu.
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 jest ustawiony, parametr item_list_id na poziomie zdarzenia jest ignorowany.
Jeśli nie jest skonfigurowana, używana jest wartość na poziomie zdarzenia item_list_id (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 jest ustawiony, parametr item_list_name na poziomie zdarzenia jest ignorowany.
Jeśli nie jest skonfigurowana, używana jest wartość na poziomie zdarzenia item_list_name (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. fizyczna lokalizacja sklepu). Zalecamy użycie identyfikatora miejsca w Google odpowiadającego powiązanemu produktowi. Możesz też użyć niestandardowego identyfikatora lokalizacji.
Uwaga: identyfikator lokalizacji jest dostępny tylko w zakresie produktu.
price number Nie 10,01 Cena produktu w walucie określonej w parametrze currency.
Jeśli produkt objęty jest rabatem, ustaw parametr price na obniżoną cenę jednostkową i określ rabat na cenę jednostkową w parametrze discount.
quantity number Nie 3

Liczba sztuk produktu.

Jeśli nie zostanie ustawiony, quantity przyjmuje wartość 1.
Oprócz parametrów przewidzianych w ramach zaleceń możesz uwzględnić w tablicy items do 27 parametrów niestandardowych.

Przykład

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

Pokaż konfigurację tagu

Konfiguracja tagu:

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

Konfiguracja reguły:

  • Typ reguły: zdarzenie niestandardowe
  • Nazwa zdarzenia: 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",
    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

To zdarzenie mierzy, kiedy użytkownik zostaje oznaczony jako potencjalny klient spełniający kryteria.

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, parametr currency jest wymagany.

Przykład

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

Pokaż konfigurację tagu

Konfiguracja tagu:

  • Typ tagu: zdarzenie GA4
  • Nazwa zdarzenia: qualify_lead
  • Parametry zdarzenia (nazwa parametru – wartość):
    • currency – USD
    • value - 30.03
  • Zdarzenie jest wywoływane, gdy użytkownik zostanie oznaczony jako potencjalny klient spełniający kryteria

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ściach w zdarzeniu view_item nie wpływają na przychody

* Jeśli ustawisz parametr value, do prawidłowego obliczania danych o przychodach niezbędny jest parametr currency.
transaction_id string Tak T_12345 Unikalny identyfikator transakcji.
value number Tak* 30,03 Wartość pieniężna zdarzenia.

* Ustaw wartość parametru value na sumę wartości parametru (price * quantity) dla wszystkich elementów w pliku items. Nie używaj shipping ani tax.
* value jest zwykle wymagany do efektywnego raportowania. Jeśli oznaczysz zdarzenie jako kluczowe, zalecamy ustawienie wartości value.
* Jeśli skonfigurujesz parametr value, parametr currency jest wymagany.
coupon string Nie SUMMER_FUN Nazwa lub kod kuponu powiązanego ze zdarzeniem.

Parametry coupon na poziomie zdarzenia i produktu są niezależne od siebie.
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 związane z wydarzeniem.

Parametry obiektu item

Nazwa Typ Wymagane Przykładowa wartość Opis
item_id string Tak* SKU_12345

Identyfikator elementu.

*Wymagana jest usługa item_id lub item_name.

item_name string Tak* Koszulka „Stan and Friends”

Nazwa elementu.

*Wymagana jest usługa item_id lub item_name.

affiliation string Nie Google Store Powiązanie produktu umożliwiające wskazanie jego dostawcy lub lokalizacji sklepu stacjonarnego.
Uwaga: atrybut `affiliation` jest dostępny tylko w zakresie produktu.
coupon string Nie SUMMER_FUN Nazwa lub kod kuponu powiązanego z produktem.

Parametry coupon na poziomie zdarzenia i produktu są niezależne od siebie.
discount number Nie 2,22 Wartość jednostkowa rabatu kwotowego powiązanego z produktem.
index number Nie 5 Indeks/pozycja elementu na liście.
item_brand string Nie Google Marka produktu.
item_category string Nie Odzież Kategoria produktu. Jeśli jest używany w ramach hierarchii kategorii lub mapy kategorii, będzie to pierwsza kategoria.
item_category2 string Nie Dorosły Druga hierarchia kategorii lub dodatkowa mapa kategorii dla elementu.
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 jest ustawiony, parametr item_list_id na poziomie zdarzenia jest ignorowany.
Jeśli nie jest skonfigurowana, używana jest wartość na poziomie zdarzenia item_list_id (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 jest ustawiony, parametr item_list_name na poziomie zdarzenia jest ignorowany.
Jeśli nie jest skonfigurowana, używana jest wartość na poziomie zdarzenia item_list_name (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. fizyczna lokalizacja sklepu). Zalecamy użycie identyfikatora miejsca w Google odpowiadającego powiązanemu produktowi. Możesz też użyć niestandardowego identyfikatora lokalizacji.
Uwaga: identyfikator lokalizacji jest dostępny tylko w zakresie produktu.
price number Nie 10,01 Cena produktu w walucie określonej w parametrze currency.
Jeśli produkt objęty jest rabatem, ustaw parametr price na obniżoną cenę jednostkową i określ rabat na cenę jednostkową w parametrze discount.
quantity number Nie 3

Liczba sztuk produktu.

Jeśli nie zostanie ustawiony, quantity przyjmuje wartość 1.
Oprócz parametrów przewidzianych w ramach zaleceń możesz uwzględnić w tablicy items do 27 parametrów niestandardowych.

Przykład

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

Pokaż konfigurację tagu

Konfiguracja tagu:

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

Konfiguracja reguły:

  • Typ reguły: zdarzenie niestandardowe
  • Nazwa zdarzenia: 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,
      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ściach w zdarzeniu view_item nie wpływają na przychody

* Jeśli ustawisz parametr value, do prawidłowego obliczania danych o przychodach niezbędny jest parametr currency.
value number Tak* 30,03 Wartość pieniężna zdarzenia.

* Ustaw wartość parametru value na sumę wartości parametru (price * quantity) dla wszystkich elementów w pliku items. Nie używaj shipping ani tax.
* value jest zwykle wymagany do efektywnego raportowania. Jeśli oznaczysz zdarzenie jako kluczowe, zalecamy ustawienie wartości value.
* Jeśli skonfigurujesz parametr value, parametr currency jest wymagany.
items Array<Item> Tak Produkty związane z wydarzeniem.

Parametry obiektu item

Nazwa Typ Wymagane Przykładowa wartość Opis
item_id string Tak* SKU_12345

Identyfikator elementu.

*Wymagana jest usługa item_id lub item_name.

item_name string Tak* Koszulka „Stan and Friends”

Nazwa elementu.

*Wymagana jest usługa item_id lub item_name.

affiliation string Nie Google Store Powiązanie produktu umożliwiające wskazanie jego dostawcy lub lokalizacji sklepu stacjonarnego.
Uwaga: atrybut `affiliation` jest dostępny tylko w zakresie produktu.
coupon string Nie SUMMER_FUN Nazwa lub kod kuponu powiązanego z produktem.

Parametry coupon na poziomie zdarzenia i produktu są niezależne od siebie.
discount number Nie 2,22 Wartość jednostkowa rabatu kwotowego powiązanego z produktem.
index number Nie 5 Indeks/pozycja elementu na liście.
item_brand string Nie Google Marka produktu.
item_category string Nie Odzież Kategoria produktu. Jeśli jest używany w ramach hierarchii kategorii lub mapy kategorii, będzie to pierwsza kategoria.
item_category2 string Nie Dorosły Druga hierarchia kategorii lub dodatkowa mapa kategorii dla elementu.
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 jest ustawiony, parametr item_list_id na poziomie zdarzenia jest ignorowany.
Jeśli nie jest skonfigurowana, używana jest wartość na poziomie zdarzenia item_list_id (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 jest ustawiony, parametr item_list_name na poziomie zdarzenia jest ignorowany.
Jeśli nie jest skonfigurowana, używana jest wartość na poziomie zdarzenia item_list_name (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. fizyczna lokalizacja sklepu). Zalecamy użycie identyfikatora miejsca w Google odpowiadającego powiązanemu produktowi. Możesz też użyć niestandardowego identyfikatora lokalizacji.
Uwaga: identyfikator lokalizacji jest dostępny tylko w zakresie produktu.
price number Nie 10,01 Cena produktu w walucie określonej w parametrze currency.
Jeśli produkt objęty jest rabatem, ustaw parametr price na obniżoną cenę jednostkową i określ rabat na cenę jednostkową w parametrze discount.
quantity number Nie 3

Liczba sztuk produktu.

Jeśli nie zostanie ustawiony, quantity przyjmuje wartość 1.
Oprócz parametrów przewidzianych w ramach zaleceń możesz uwzględnić w tablicy items do 27 parametrów niestandardowych.

Przykład

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

Pokaż konfigurację tagu

Konfiguracja tagu:

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

Konfiguracja reguły:

  • Typ reguły: zdarzenie niestandardowe
  • Nazwa zdarzenia: 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,
      quantity: 3
    }
    ]
  }
});

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

Parametry

Nazwa Typ Wymagane Przykładowa wartość Opis
search_term string Tak koszulki Wyszukiwany produkt.

Pokaż konfigurację tagu

Konfiguracja tagu:

  • Typ tagu: zdarzenie GA4
  • Nazwa zdarzenia: search
  • Parametry zdarzenia (nazwa parametru – wartość):
    • search_term – koszulki
  • Aktywator, który działa, gdy użytkownik wyszukuje w Twojej witrynie

Przykład

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

Pokaż konfigurację tagu

Konfiguracja tagu:

  • Typ tagu: zdarzenie GA4
  • Nazwa zdarzenia: search
  • Parametry zdarzenia (nazwa parametru – wartość):
    • search_term – koszulki
  • Aktywator, który działa, gdy użytkownik wyszukuje w Twojej witrynie

select_content

To zdarzenie oznacza, że użytkownik wybrał treści określonego typu. To zdarzenie może Ci pomóc 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 wybranych treści.
content_id string Nie C_12345 Identyfikator wybranych treści.

Przykład

Ten 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 równe select_content

select_item

To zdarzenie 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.

Ignorowane, jeśli ustawione na poziomie produktu.
item_list_name string Nie Produkty powiązane Nazwa listy, na której produkt został przedstawiony użytkownikowi.

Ignorowane, jeśli ustawione na poziomie produktu.
items Array<Item> Tak* Produkty związane z wydarzeniem.

* Tablica items powinna zawierać jeden element reprezentujący wybrany element. Jeśli podasz kilka elementów, użyty zostanie tylko pierwszy element w sekcji items.

Parametry obiektu item

Nazwa Typ Wymagane Przykładowa wartość Opis
item_id string Tak* SKU_12345

Identyfikator elementu.

*Wymagana jest usługa item_id lub item_name.

item_name string Tak* Koszulka „Stan and Friends”

Nazwa elementu.

*Wymagana jest usługa item_id lub item_name.

affiliation string Nie Google Store Powiązanie produktu umożliwiające wskazanie jego dostawcy lub lokalizacji sklepu stacjonarnego.
Uwaga: atrybut `affiliation` jest dostępny tylko w zakresie produktu.
coupon string Nie SUMMER_FUN Nazwa lub kod kuponu powiązanego z produktem.

Parametry coupon na poziomie zdarzenia i produktu są niezależne od siebie.
discount number Nie 2,22 Wartość jednostkowa rabatu kwotowego powiązanego z produktem.
index number Nie 5 Indeks/pozycja elementu na liście.
item_brand string Nie Google Marka produktu.
item_category string Nie Odzież Kategoria produktu. Jeśli jest używany w ramach hierarchii kategorii lub mapy kategorii, będzie to pierwsza kategoria.
item_category2 string Nie Dorosły Druga hierarchia kategorii lub dodatkowa mapa kategorii dla elementu.
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 jest ustawiony, parametr item_list_id na poziomie zdarzenia jest ignorowany.
Jeśli nie jest skonfigurowana, używana jest wartość na poziomie zdarzenia item_list_id (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 jest ustawiony, parametr item_list_name na poziomie zdarzenia jest ignorowany.
Jeśli nie jest skonfigurowana, używana jest wartość na poziomie zdarzenia item_list_name (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. fizyczna lokalizacja sklepu). Zalecamy użycie identyfikatora miejsca w Google odpowiadającego powiązanemu produktowi. Możesz też użyć niestandardowego identyfikatora lokalizacji.
Uwaga: identyfikator lokalizacji jest dostępny tylko w zakresie produktu.
price number Nie 10,01 Cena produktu w walucie określonej w parametrze currency.
Jeśli produkt objęty jest rabatem, ustaw parametr price na obniżoną cenę jednostkową i określ rabat na cenę jednostkową w parametrze discount.
quantity number Nie 3

Liczba sztuk produktu.

Jeśli nie zostanie ustawiony, quantity przyjmuje wartość 1.
Oprócz parametrów przewidzianych w ramach zaleceń możesz uwzględnić w tablicy items do 27 parametrów niestandardowych.

Przykład

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

Pokaż konfigurację tagu

Konfiguracja tagu:

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

Konfiguracja reguły:

  • Typ reguły: zdarzenie niestandardowe
  • Nazwa zdarzenia: 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,
      quantity: 3
    }
    ]
  }
});

select_promotion

To zdarzenie 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.

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

Ignorowane, jeśli ustawione na poziomie produktu.
promotion_id string Nie P_12345 Identyfikator promocji powiązanej ze zdarzeniem.

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

Ignorowane, jeśli ustawione na poziomie produktu.
items Array<Item> Nie Produkty związane z wydarzeniem.

Parametry obiektu item

Nazwa Typ Wymagane Przykładowa wartość Opis
item_id string Tak* SKU_12345

Identyfikator elementu.

*Wymagana jest usługa item_id lub item_name.

item_name string Tak* Koszulka „Stan and Friends”

Nazwa elementu.

*Wymagana jest usługa item_id lub item_name.

affiliation string Nie Google Store Powiązanie produktu umożliwiające wskazanie jego dostawcy lub lokalizacji sklepu stacjonarnego.
Uwaga: atrybut `affiliation` jest dostępny tylko w zakresie produktu.
coupon string Nie SUMMER_FUN Nazwa lub kod kuponu powiązanego z produktem.

Parametry coupon na poziomie zdarzenia i produktu są niezależne od siebie.
creative_name string Nie summer_banner2 Nazwa kreacji promocyjnej.

Jeśli jest ustawiony, parametr creative_name na poziomie zdarzenia jest ignorowany.
Jeśli nie jest skonfigurowana, używana jest wartość na poziomie zdarzenia creative_name (jeśli jest dostępna).
creative_slot string Nie featured_app_1 Nazwa boksu kreacji promocyjnej powiązanego z produktami.

Jeśli jest ustawiony, parametr creative_slot na poziomie zdarzenia jest ignorowany.
Jeśli nie jest skonfigurowana, używana jest wartość na poziomie zdarzenia creative_slot (jeśli jest dostępna).
discount number Nie 2,22 Wartość jednostkowa rabatu kwotowego powiązanego z produktem.
index number Nie 5 Indeks/pozycja elementu na liście.
item_brand string Nie Google Marka produktu.
item_category string Nie Odzież Kategoria produktu. Jeśli jest używany w ramach hierarchii kategorii lub mapy kategorii, będzie to pierwsza kategoria.
item_category2 string Nie Dorosły Druga hierarchia kategorii lub dodatkowa mapa kategorii dla elementu.
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 jest ustawiony, parametr item_list_id na poziomie zdarzenia jest ignorowany.
Jeśli nie jest skonfigurowana, używana jest wartość na poziomie zdarzenia item_list_id (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 jest ustawiony, parametr item_list_name na poziomie zdarzenia jest ignorowany.
Jeśli nie jest skonfigurowana, używana jest wartość na poziomie zdarzenia item_list_name (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. fizyczna lokalizacja sklepu). Zalecamy użycie identyfikatora miejsca w Google odpowiadającego powiązanemu produktowi. Możesz też użyć niestandardowego identyfikatora lokalizacji.
Uwaga: identyfikator lokalizacji jest dostępny tylko w zakresie produktu.
price number Nie 10,01 Cena produktu w walucie określonej w parametrze currency.
Jeśli produkt objęty jest rabatem, ustaw parametr price na obniżoną cenę jednostkową i określ rabat na cenę jednostkową w parametrze discount.
promotion_id string Nie P_12345 Identyfikator promocji powiązanej z produktem.

Jeśli jest ustawiony, parametr promotion_id na poziomie zdarzenia jest ignorowany.
Jeśli nie jest skonfigurowana, używana jest wartość na poziomie zdarzenia promotion_id (jeśli jest dostępna).
promotion_name string Nie Letnia wyprzedaż Nazwa promocji powiązanej z produktem.

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

Liczba sztuk produktu.

Jeśli nie zostanie ustawiony, quantity przyjmuje wartość 1.
Oprócz parametrów przewidzianych w ramach zaleceń możesz uwzględnić w tablicy items do 27 parametrów niestandardowych.

Przykład

Ten 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
    • E-commerce Creative Slot – 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;Nazwa kreacji w e-commerce&rbrace;&rbrace;
    • creative_slot – &lbrace;&lbrace;Kreacja dla handlu elektronicznego&rbrace;&rbrace;
    • promotion_id – &lbrace;&lbrace;Identyfikator promocji w e-commerce&rbrace;&rbrace;
    • promotion_name - &lbrace;&lbrace;Nazwa promocji e-commerce&rbrace;&rbrace;
    • items - &lbrace;&lbrace;Produkty e-commerce&rbrace;&rbrace;
  • Typ zmiennej: zmienna warstwy danych – „ecommerce.items”.
  • Aktywator: zdarzenie równe select_promotion

Konfiguracja reguły:

  • Typ reguły: zdarzenie niestandardowe
  • Nazwa zdarzenia: 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,
      quantity: 3
    }
    ]
  }
});

share

Użyj tego zdarzenia, gdy użytkownik udostępni treści.

Parametry

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

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

Pokaż konfigurację tagu

Konfiguracja tagu:

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

Przykład

Pokaż konfigurację tagu

Konfiguracja tagu:

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

sign_up

To zdarzenie wskazuje, że użytkownik utworzył 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 rejestracji.

Ten 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 konto

Przykład

Ten 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 konto

spend_virtual_currency

To zdarzenie mierzy sprzedaż wirtualnych towaró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 Gemy Nazwa waluty wirtualnej.
item_name string Nie Starter Boost Nazwa elementu, w którym używana jest waluta wirtualna.

Przykład

Ten 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 towar wirtualny

tutorial_begin

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

Parametry

To zdarzenie nie ma parametrów.

Przykład

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

Pokaż konfigurację tagu

Konfiguracja tagu:

  • Typ tagu: zdarzenie GA4
  • Nazwa zdarzenia: tutorial_begin
  • Wywoływanie reguły, gdy ktoś rozpoczyna proces rejestracji

tutorial_complete

To zdarzenie oznacza, że użytkownik ukończył proces rejestracji. Używaj go w ścieżce z parametrem tutorial_begin, aby dowiedzieć się, ilu użytkowników ukończyło samouczek.

Parametry

Nie zalecamy żadnych parametrów dla tego zdarzenia.

Przykład

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

Pokaż konfigurację tagu

Konfiguracja tagu:

  • Typ tagu: zdarzenie GA4
  • Nazwa zdarzenia: tutorial_complete
  • Wywoływanie, gdy ktoś ukończy proces rejestracji

unlock_achievement

Zarejestruj to zdarzenie, gdy użytkownik odblokuje osiągnięcie. To zdarzenie może Ci pomóc zrozumieć, jak użytkownicy korzystają z Twojej gry.

Parametry

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

Przykład

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

Pokaż konfigurację tagu

Konfiguracja tagu:

  • Typ tagu: zdarzenie GA4
  • Nazwa zdarzenia: unlock_achievement
  • Parametry zdarzenia (nazwa parametru – wartość):
    • achievement_id – A_12345
  • Wywoływanie, 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ściach w zdarzeniu view_item nie wpływają na przychody

* Jeśli ustawisz parametr value, do prawidłowego obliczania danych o przychodach niezbędny jest parametr currency.
value number Tak* 30,03 Wartość pieniężna zdarzenia.

* Ustaw wartość parametru value na sumę wartości parametru (price * quantity) dla wszystkich elementów w pliku items. Nie używaj shipping ani tax.
* value jest zwykle wymagany do efektywnego raportowania. Jeśli oznaczysz zdarzenie jako kluczowe, zalecamy ustawienie wartości value.
* Jeśli skonfigurujesz parametr value, parametr currency jest wymagany.
items Array<Item> Tak Produkty związane z wydarzeniem.

Parametry obiektu item

Nazwa Typ Wymagane Przykładowa wartość Opis
item_id string Tak* SKU_12345

Identyfikator elementu.

*Wymagana jest usługa item_id lub item_name.

item_name string Tak* Koszulka „Stan and Friends”

Nazwa elementu.

*Wymagana jest usługa item_id lub item_name.

affiliation string Nie Google Store Powiązanie produktu umożliwiające wskazanie jego dostawcy lub lokalizacji sklepu stacjonarnego.
Uwaga: atrybut `affiliation` jest dostępny tylko w zakresie produktu.
coupon string Nie SUMMER_FUN Nazwa lub kod kuponu powiązanego z produktem.

Parametry coupon na poziomie zdarzenia i produktu są niezależne od siebie.
discount number Nie 2,22 Wartość jednostkowa rabatu kwotowego powiązanego z produktem.
index number Nie 5 Indeks/pozycja elementu na liście.
item_brand string Nie Google Marka produktu.
item_category string Nie Odzież Kategoria produktu. Jeśli jest używany w ramach hierarchii kategorii lub mapy kategorii, będzie to pierwsza kategoria.
item_category2 string Nie Dorosły Druga hierarchia kategorii lub dodatkowa mapa kategorii dla elementu.
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 jest ustawiony, parametr item_list_id na poziomie zdarzenia jest ignorowany.
Jeśli nie jest skonfigurowana, używana jest wartość na poziomie zdarzenia item_list_id (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 jest ustawiony, parametr item_list_name na poziomie zdarzenia jest ignorowany.
Jeśli nie jest skonfigurowana, używana jest wartość na poziomie zdarzenia item_list_name (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. fizyczna lokalizacja sklepu). Zalecamy użycie identyfikatora miejsca w Google odpowiadającego powiązanemu produktowi. Możesz też użyć niestandardowego identyfikatora lokalizacji.
Uwaga: identyfikator lokalizacji jest dostępny tylko w zakresie produktu.
price number Nie 10,01 Cena produktu w walucie określonej w parametrze currency.
Jeśli produkt objęty jest rabatem, ustaw parametr price na obniżoną cenę jednostkową i określ rabat na cenę jednostkową w parametrze discount.
quantity number Nie 3

Liczba sztuk produktu.

Jeśli nie zostanie ustawiony, quantity przyjmuje wartość 1.
Oprócz parametrów przewidzianych w ramach zaleceń możesz uwzględnić w tablicy items do 27 parametrów niestandardowych.

Przykład

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

Pokaż konfigurację tagu

Konfiguracja tagu:

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

Konfiguracja reguły:

  • Typ reguły: zdarzenie niestandardowe
  • Nazwa zdarzenia: 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,
      quantity: 3
    }
    ]
  }
});

view_item

To zdarzenie oznacza, że użytkownikowi wyświetlono określone treści. Dzięki temu zdarzeniu możesz dowiedzieć się, które produkty były najczęściej oglądane.

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ściach w zdarzeniu view_item nie wpływają na przychody

* Jeśli ustawisz parametr value, do prawidłowego obliczania danych o przychodach niezbędny jest parametr currency.
value number Tak* 30,03 Wartość pieniężna zdarzenia.

* Ustaw wartość parametru value na sumę wartości parametru (price * quantity) dla wszystkich elementów w pliku items. Nie używaj shipping ani tax.
* value jest zwykle wymagany do efektywnego raportowania. Jeśli oznaczysz zdarzenie jako kluczowe, zalecamy ustawienie wartości value.
* Jeśli skonfigurujesz parametr value, parametr currency jest wymagany.
items Array<Item> Tak Produkty związane z wydarzeniem.

Parametry obiektu item

Nazwa Typ Wymagane Przykładowa wartość Opis
item_id string Tak* SKU_12345

Identyfikator elementu.

*Wymagana jest usługa item_id lub item_name.

item_name string Tak* Koszulka „Stan and Friends”

Nazwa elementu.

*Wymagana jest usługa item_id lub item_name.

affiliation string Nie Google Store Powiązanie produktu umożliwiające wskazanie jego dostawcy lub lokalizacji sklepu stacjonarnego.
Uwaga: atrybut `affiliation` jest dostępny tylko w zakresie produktu.
coupon string Nie SUMMER_FUN Nazwa lub kod kuponu powiązanego z produktem.

Parametry coupon na poziomie zdarzenia i produktu są niezależne od siebie.
discount number Nie 2,22 Wartość jednostkowa rabatu kwotowego powiązanego z produktem.
index number Nie 5 Indeks/pozycja elementu na liście.
item_brand string Nie Google Marka produktu.
item_category string Nie Odzież Kategoria produktu. Jeśli jest używany w ramach hierarchii kategorii lub mapy kategorii, będzie to pierwsza kategoria.
item_category2 string Nie Dorosły Druga hierarchia kategorii lub dodatkowa mapa kategorii dla elementu.
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 jest ustawiony, parametr item_list_id na poziomie zdarzenia jest ignorowany.
Jeśli nie jest skonfigurowana, używana jest wartość na poziomie zdarzenia item_list_id (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 jest ustawiony, parametr item_list_name na poziomie zdarzenia jest ignorowany.
Jeśli nie jest skonfigurowana, używana jest wartość na poziomie zdarzenia item_list_name (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. fizyczna lokalizacja sklepu). Zalecamy użycie identyfikatora miejsca w Google odpowiadającego powiązanemu produktowi. Możesz też użyć niestandardowego identyfikatora lokalizacji.
Uwaga: identyfikator lokalizacji jest dostępny tylko w zakresie produktu.
price number Nie 10,01 Cena produktu w walucie określonej w parametrze currency.
Jeśli produkt objęty jest rabatem, ustaw parametr price na obniżoną cenę jednostkową i określ rabat na cenę jednostkową w parametrze discount.
quantity number Nie 3

Liczba sztuk produktu.

Jeśli nie zostanie ustawiony, quantity przyjmuje wartość 1.
Oprócz parametrów przewidzianych w ramach zaleceń możesz uwzględnić w tablicy items do 27 parametrów niestandardowych.

Przykład

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

Pokaż konfigurację tagu

Konfiguracja tagu:

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

Konfiguracja reguły:

  • Typ reguły: zdarzenie niestandardowe
  • Nazwa zdarzenia: 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,
      quantity: 3
    }
    ]
  }
});

view_item_list

Zarejestruj to zdarzenie, gdy użytkownik zobaczy listę 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ściach w zdarzeniu view_item nie wpływają na przychody

* Jeśli ustawisz parametr value, do prawidłowego obliczania danych o przychodach niezbędny jest parametr currency.
item_list_id string Nie related_products Identyfikator listy, na której produkt został przedstawiony użytkownikowi.

Ignorowane, jeśli ustawione na poziomie produktu.
item_list_name string Nie Produkty powiązane Nazwa listy, na której produkt został przedstawiony użytkownikowi.

Ignorowane, jeśli ustawione na poziomie produktu.
items Array<Item> Tak Produkty związane z wydarzeniem.

Parametry obiektu item

Nazwa Typ Wymagane Przykładowa wartość Opis
item_id string Tak* SKU_12345

Identyfikator elementu.

*Wymagana jest usługa item_id lub item_name.

item_name string Tak* Koszulka „Stan and Friends”

Nazwa elementu.

*Wymagana jest usługa item_id lub item_name.

affiliation string Nie Google Store Powiązanie produktu umożliwiające wskazanie jego dostawcy lub lokalizacji sklepu stacjonarnego.
Uwaga: atrybut `affiliation` jest dostępny tylko w zakresie produktu.
coupon string Nie SUMMER_FUN Nazwa lub kod kuponu powiązanego z produktem.

Parametry coupon na poziomie zdarzenia i produktu są niezależne od siebie.
discount number Nie 2,22 Wartość jednostkowa rabatu kwotowego powiązanego z produktem.
index number Nie 5 Indeks/pozycja elementu na liście.
item_brand string Nie Google Marka produktu.
item_category string Nie Odzież Kategoria produktu. Jeśli jest używany w ramach hierarchii kategorii lub mapy kategorii, będzie to pierwsza kategoria.
item_category2 string Nie Dorosły Druga hierarchia kategorii lub dodatkowa mapa kategorii dla elementu.
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 jest ustawiony, parametr item_list_id na poziomie zdarzenia jest ignorowany.
Jeśli nie jest skonfigurowana, używana jest wartość na poziomie zdarzenia item_list_id (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 jest ustawiony, parametr item_list_name na poziomie zdarzenia jest ignorowany.
Jeśli nie jest skonfigurowana, używana jest wartość na poziomie zdarzenia item_list_name (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. fizyczna lokalizacja sklepu). Zalecamy użycie identyfikatora miejsca w Google odpowiadającego powiązanemu produktowi. Możesz też użyć niestandardowego identyfikatora lokalizacji.
Uwaga: identyfikator lokalizacji jest dostępny tylko w zakresie produktu.
price number Nie 10,01 Cena produktu w walucie określonej w parametrze currency.
Jeśli produkt objęty jest rabatem, ustaw parametr price na obniżoną cenę jednostkową i określ rabat na cenę jednostkową w parametrze discount.
quantity number Nie 3

Liczba sztuk produktu.

Jeśli nie zostanie ustawiony, quantity przyjmuje wartość 1.
Oprócz parametrów przewidzianych w ramach zaleceń możesz uwzględnić w tablicy items do 27 parametrów niestandardowych.

Przykład

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

Pokaż konfigurację tagu

Konfiguracja tagu:

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

Konfiguracja reguły:

  • Typ reguły: zdarzenie niestandardowe
  • Nazwa zdarzenia: 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,
      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
    }]
  }
});

view_promotion

To zdarzenie 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.

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

Ignorowane, jeśli ustawione na poziomie produktu.
promotion_id string Nie P_12345 Identyfikator promocji powiązanej ze zdarzeniem.

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

Ignorowane, jeśli ustawione na poziomie produktu.
items Array<Item> Tak* Produkty związane z wydarzeniem.

* Tablica items powinna zawierać 1 element reprezentujący produkt powiązany z promocją. Jeśli podasz więcej elementów, użyty zostanie tylko pierwszy element w elementach items.

Parametry obiektu item

Nazwa Typ Wymagane Przykładowa wartość Opis
item_id string Tak* SKU_12345

Identyfikator elementu.

*Wymagana jest usługa item_id lub item_name.

item_name string Tak* Koszulka „Stan and Friends”

Nazwa elementu.

*Wymagana jest usługa item_id lub item_name.

affiliation string Nie Google Store Powiązanie produktu umożliwiające wskazanie jego dostawcy lub lokalizacji sklepu stacjonarnego.
Uwaga: atrybut `affiliation` jest dostępny tylko w zakresie produktu.
coupon string Nie SUMMER_FUN Nazwa lub kod kuponu powiązanego z produktem.

Parametry coupon na poziomie zdarzenia i produktu są niezależne od siebie.
creative_name string Nie summer_banner2 Nazwa kreacji promocyjnej.

Jeśli jest ustawiony, parametr creative_name na poziomie zdarzenia jest ignorowany.
Jeśli nie jest skonfigurowana, używana jest wartość na poziomie zdarzenia creative_name (jeśli jest dostępna).
creative_slot string Nie featured_app_1 Nazwa boksu kreacji promocyjnej powiązanego z produktami.

Jeśli jest ustawiony, parametr creative_slot na poziomie zdarzenia jest ignorowany.
Jeśli nie jest skonfigurowana, używana jest wartość na poziomie zdarzenia creative_slot (jeśli jest dostępna).
discount number Nie 2,22 Wartość jednostkowa rabatu kwotowego powiązanego z produktem.
index number Nie 5 Indeks/pozycja elementu na liście.
item_brand string Nie Google Marka produktu.
item_category string Nie Odzież Kategoria produktu. Jeśli jest używany w ramach hierarchii kategorii lub mapy kategorii, będzie to pierwsza kategoria.
item_category2 string Nie Dorosły Druga hierarchia kategorii lub dodatkowa mapa kategorii dla elementu.
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 jest ustawiony, parametr item_list_id na poziomie zdarzenia jest ignorowany.
Jeśli nie jest skonfigurowana, używana jest wartość na poziomie zdarzenia item_list_id (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 jest ustawiony, parametr item_list_name na poziomie zdarzenia jest ignorowany.
Jeśli nie jest skonfigurowana, używana jest wartość na poziomie zdarzenia item_list_name (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. fizyczna lokalizacja sklepu). Zalecamy użycie identyfikatora miejsca w Google odpowiadającego powiązanemu produktowi. Możesz też użyć niestandardowego identyfikatora lokalizacji.
Uwaga: identyfikator lokalizacji jest dostępny tylko w zakresie produktu.
price number Nie 10,01 Cena produktu w walucie określonej w parametrze currency.
Jeśli produkt objęty jest rabatem, ustaw parametr price na obniżoną cenę jednostkową i określ rabat na cenę jednostkową w parametrze discount.
promotion_id string Nie P_12345 Identyfikator promocji powiązanej z produktem.

Jeśli jest ustawiony, parametr promotion_id na poziomie zdarzenia jest ignorowany.
Jeśli nie jest skonfigurowana, używana jest wartość na poziomie zdarzenia promotion_id (jeśli jest dostępna).
promotion_name string Nie Letnia wyprzedaż Nazwa promocji powiązanej z produktem.

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

Liczba sztuk produktu.

Jeśli nie zostanie ustawiony, quantity przyjmuje wartość 1.
Oprócz parametrów przewidzianych w ramach zaleceń możesz uwzględnić w tablicy items do 27 parametrów niestandardowych.

Przykład

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

Pokaż konfigurację tagu

Konfiguracja tagu:

  • Typ tagu: zdarzenie GA4
  • Nazwa zdarzenia: view_promotion
  • Zmienne warstwy danych (nazwa – nazwa zmiennej warstwy danych):
    • Nazwa kreacji e-commerce – ecommerce.creative_name
    • E-commerce Creative Slot – 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;Nazwa kreacji w e-commerce&rbrace;&rbrace;
    • creative_slot – &lbrace;&lbrace;Kreacja dla handlu elektronicznego&rbrace;&rbrace;
    • promotion_id – &lbrace;&lbrace;Identyfikator promocji w e-commerce&rbrace;&rbrace;
    • promotion_name - &lbrace;&lbrace;Nazwa promocji e-commerce&rbrace;&rbrace;
    • items - &lbrace;&lbrace;Produkty e-commerce&rbrace;&rbrace;
  • Wyzwalacz: zdarzenie równa się view_promotion

Konfiguracja reguły:

  • Typ reguły: zdarzenie niestandardowe
  • Nazwa zdarzenia: 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,
      quantity: 3
    }
    ]
  }
});

working_lead

To zdarzenie mierzy, kiedy użytkownik kontaktuje się z przedstawicielem lub gdy przedstawiciel kontaktuje 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 ustawienie wartości value.
* Jeśli skonfigurujesz parametr value, parametr currency jest wymagany.
lead_status string Nie Rozpoczęte rozmowy Stan potencjalnego klienta.

Przykład

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

Pokaż konfigurację tagu

Konfiguracja tagu:

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