Zdarzenia te umożliwiają pomiar dodatkowych funkcji i zachowań oraz generowanie bardziej przydatnych raportów w Google Analytics 4. Znaczenie takich zdarzeń wymaga dodatkowego kontekstu, więc nie są one wysyłane automatycznie. W tym dokumencie znajdziesz wymagane i opcjonalne parametry każdego zdarzenia.
add_payment_info
To zdarzenie oznacza, że użytkownik przesłał dane do płatności w ramach procesu płatności e-commerce.
Parametry
Nazwa | Typ | Wymagane | Przykładowa wartość | Opis |
---|---|---|---|---|
currency |
string |
Tak* | USD |
Waluta elementów powiązanych ze zdarzeniem, podana w 3-literowym formacie ISO 4217. * Jeśli skonfigurujesz value , do prawidłowego obliczania danych o przychodach wymagana jest właściwość currency .
|
value |
number |
Tak* | 30,03 | Wartość pieniężna zdarzenia. * Ustaw value na sumę wartości (price * quantity) dla wszystkich elementów w domenie items . Nie używaj wartości shipping ani tax .
* Wartość value jest zwykle wymagana do efektywnego raportowania.
Jeśli oznaczysz zdarzenie jako konwersję, zalecamy ustawienie wartości value .
* Wartość currency jest wymagana, jeśli skonfigurowano value .
|
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 | Elementy związane z wydarzeniem. |
Parametry obiektu item
Nazwa | Typ | Wymagane | Przykładowa wartość | Opis |
---|---|---|---|---|
item_id |
string |
Tak* | SKU_12345 |
Identyfikator elementu.
*Wymagana jest wartość z pola |
item_name |
string |
Tak* | Koszulka ze Stanem i przyjaciółmi |
Nazwa produktu.
*Wymagana jest wartość z pola |
affiliation |
string |
Nie | Google Store |
Przynależność do usługi służąca do wyznaczenia firmy dostarczającej lub sklepu stacjonarnego. Uwaga: atrybut „przynależność” jest dostępny tylko w zakresie elementu. |
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 zasada jest skonfigurowana, element creative_name na poziomie zdarzenia jest ignorowany.
Jeśli zasada jest nieskonfigurowana, używany jest creative_name na poziomie zdarzenia (jeśli jest dostępny). |
creative_slot |
string |
Nie | featured_app_1 | Nazwa boksu kreacji promocyjnej powiązanego z produktem. Jeśli zasada jest skonfigurowana, element creative_slot na poziomie zdarzenia jest ignorowany.
Jeśli zasada jest nieskonfigurowana, używany jest creative_slot na poziomie zdarzenia (jeśli jest dostępny). |
discount |
number |
Nie | 2,22 | Wartość rabatu kwotowego powiązanego z produktem. |
index |
number |
Nie | 5 | Indeks/pozycja elementu na liście. |
item_brand |
string |
Nie | Marka produktu. | |
item_category |
string |
Nie | Odzież | Kategoria produktu. Jeśli używasz ich w ramach hierarchii kategorii lub taksonomii, jest 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ótkie rękawy | 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 zasada jest skonfigurowana, element item_list_id na poziomie zdarzenia jest ignorowany.
Jeśli zasada jest nieskonfigurowana, używany jest item_list_id na poziomie zdarzenia (jeśli jest dostępny).
|
item_list_name |
string |
Nie | Produkty powiązane | Nazwa listy, na której produkt został przedstawiony użytkownikowi. Jeśli zasada jest skonfigurowana, element item_list_name na poziomie zdarzenia jest ignorowany.
Jeśli zasada jest nieskonfigurowana, używany jest item_list_name na poziomie zdarzenia (jeśli jest dostępny).
|
item_variant |
string |
Nie | zielony | Wersja produktu, unikalny kod lub opis dodatkowych szczegółów lub opcji produktu. |
location_id |
string |
Nie | ChIJIQBpAG2ahYAR_6128GcTUEo (identyfikator Miejsc Google dla San Francisco) |
Lokalizacja fizyczna powiązana z produktem (np. lokalizacja sklepu stacjonarnego). Zalecamy użycie identyfikatora miejsca Google powiązanego z powiązanym elementem. Możesz też użyć niestandardowego identyfikatora lokalizacji. Uwaga: „identyfikator lokalizacji” jest dostępny tylko w zakresie elementu. |
price |
number |
Nie | 10,01 |
Pieniężna cena jednostkowa produktu w jednostkach określonego parametru waluty.
Jeśli rabat ma zastosowanie do produktu, ustaw wartość price na obniżoną cenę jednostkowej i podaj rabat za jednostkę w parametrze discount .
|
promotion_id |
string |
Nie | P_12345 |
Identyfikator promocji powiązanej z produktem. Jeśli zasada jest skonfigurowana, element promotion_id na poziomie zdarzenia jest ignorowany.
Jeśli zasada jest nieskonfigurowana, używany jest promotion_id na poziomie zdarzenia (jeśli jest dostępny).
|
promotion_name |
string |
Nie | Letnia wyprzedaż |
Nazwa promocji powiązanej z produktem. Jeśli zasada jest skonfigurowana, element promotion_name na poziomie zdarzenia jest ignorowany.
Jeśli zasada jest nieskonfigurowana, używany jest promotion_name na poziomie zdarzenia (jeśli jest dostępny).
|
quantity |
number |
Nie | 3 |
Liczba sztuk produktu. |
items
możesz umieścić maksymalnie 27 parametrów niestandardowych.
Przykład
Ten przykład dotyczy implementacji za pomocą 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
– {{Elementy e-commerce}}value
– {{Wartość e-commerce}}currency
– {{waluta e-commerce}}coupon
– {{kupon e-commerce}}payment_type
– {{Typ płatności e-commerce}}- Wyzwalacz: zdarzenie równa się add_payment_info
Konfiguracja aktywatora:
- 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 elementów powiązanych ze zdarzeniem, podana w 3-literowym formacie ISO 4217. * Jeśli skonfigurujesz value , do prawidłowego obliczania danych o przychodach wymagana jest właściwość currency .
|
value |
number |
Tak* | 30,03 | Wartość pieniężna zdarzenia. * Ustaw value na sumę wartości (price * quantity) dla wszystkich elementów w domenie items . Nie używaj wartości shipping ani tax .
* Wartość value jest zwykle wymagana do efektywnego raportowania.
Jeśli oznaczysz zdarzenie jako konwersję, zalecamy ustawienie wartości value .
* Wartość currency jest wymagana, jeśli skonfigurowano value .
|
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 | Transport lądowy |
Poziom dostawy (np. Ground , Air , Next-day ) wybrany do dostawy kupionego produktu.
|
items |
Array<Item> |
Tak | Elementy związane z wydarzeniem. |
Parametry obiektu item
Nazwa | Typ | Wymagane | Przykładowa wartość | Opis |
---|---|---|---|---|
item_id |
string |
Tak* | SKU_12345 |
Identyfikator elementu.
*Wymagana jest wartość z pola |
item_name |
string |
Tak* | Koszulka ze Stanem i przyjaciółmi |
Nazwa produktu.
*Wymagana jest wartość z pola |
affiliation |
string |
Nie | Google Store |
Przynależność do usługi służąca do wyznaczenia firmy dostarczającej lub sklepu stacjonarnego. Uwaga: atrybut „przynależność” jest dostępny tylko w zakresie elementu. |
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 zasada jest skonfigurowana, element creative_name na poziomie zdarzenia jest ignorowany.
Jeśli zasada jest nieskonfigurowana, używany jest creative_name na poziomie zdarzenia (jeśli jest dostępny). |
creative_slot |
string |
Nie | featured_app_1 | Nazwa boksu kreacji promocyjnej powiązanego z produktem. Jeśli zasada jest skonfigurowana, element creative_slot na poziomie zdarzenia jest ignorowany.
Jeśli zasada jest nieskonfigurowana, używany jest creative_slot na poziomie zdarzenia (jeśli jest dostępny). |
discount |
number |
Nie | 2,22 | Wartość rabatu kwotowego powiązanego z produktem. |
index |
number |
Nie | 5 | Indeks/pozycja elementu na liście. |
item_brand |
string |
Nie | Marka produktu. | |
item_category |
string |
Nie | Odzież | Kategoria produktu. Jeśli używasz ich w ramach hierarchii kategorii lub taksonomii, jest 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ótkie rękawy | 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 zasada jest skonfigurowana, element item_list_id na poziomie zdarzenia jest ignorowany.
Jeśli zasada jest nieskonfigurowana, używany jest item_list_id na poziomie zdarzenia (jeśli jest dostępny).
|
item_list_name |
string |
Nie | Produkty powiązane | Nazwa listy, na której produkt został przedstawiony użytkownikowi. Jeśli zasada jest skonfigurowana, element item_list_name na poziomie zdarzenia jest ignorowany.
Jeśli zasada jest nieskonfigurowana, używany jest item_list_name na poziomie zdarzenia (jeśli jest dostępny).
|
item_variant |
string |
Nie | zielony | Wersja produktu, unikalny kod lub opis dodatkowych szczegółów lub opcji produktu. |
location_id |
string |
Nie | ChIJIQBpAG2ahYAR_6128GcTUEo (identyfikator Miejsc Google dla San Francisco) |
Lokalizacja fizyczna powiązana z produktem (np. lokalizacja sklepu stacjonarnego). Zalecamy użycie identyfikatora miejsca Google powiązanego z powiązanym elementem. Możesz też użyć niestandardowego identyfikatora lokalizacji. Uwaga: „identyfikator lokalizacji” jest dostępny tylko w zakresie elementu. |
price |
number |
Nie | 10,01 |
Pieniężna cena jednostkowa produktu w jednostkach określonego parametru waluty.
Jeśli rabat ma zastosowanie do produktu, ustaw wartość price na obniżoną cenę jednostkowej i podaj rabat za jednostkę w parametrze discount .
|
promotion_id |
string |
Nie | P_12345 |
Identyfikator promocji powiązanej z produktem. Jeśli zasada jest skonfigurowana, element promotion_id na poziomie zdarzenia jest ignorowany.
Jeśli zasada jest nieskonfigurowana, używany jest promotion_id na poziomie zdarzenia (jeśli jest dostępny).
|
promotion_name |
string |
Nie | Letnia wyprzedaż |
Nazwa promocji powiązanej z produktem. Jeśli zasada jest skonfigurowana, element promotion_name na poziomie zdarzenia jest ignorowany.
Jeśli zasada jest nieskonfigurowana, używany jest promotion_name na poziomie zdarzenia (jeśli jest dostępny).
|
quantity |
number |
Nie | 3 |
Liczba sztuk produktu. |
items
możesz umieścić maksymalnie 27 parametrów niestandardowych.
Przykład
Ten przykład dotyczy implementacji za pomocą 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 e-commerce –
ecommerce.shipping_tier
- Parametry zdarzenia (nazwa parametru – wartość):
items
– {{Elementy e-commerce}}value
– {{Wartość e-commerce}}currency
– {{waluta e-commerce}}coupon
– {{kupon e-commerce}}shipping_tier
– {{Poziom dostawy e-commerce}}- Wyzwalacz: zdarzenie równa się add_shipping_info
Konfiguracja aktywatora:
- 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 elementów powiązanych ze zdarzeniem, podana w 3-literowym formacie ISO 4217. * Jeśli skonfigurujesz value , do prawidłowego obliczania danych o przychodach wymagana jest właściwość currency .
|
value |
number |
Tak* | 30,03 | Wartość pieniężna zdarzenia. * Ustaw value na sumę wartości (price * quantity) dla wszystkich elementów w domenie items . Nie używaj wartości shipping ani tax .
* Wartość value jest zwykle wymagana do efektywnego raportowania.
Jeśli oznaczysz zdarzenie jako konwersję, zalecamy ustawienie wartości value .
* Wartość currency jest wymagana, jeśli skonfigurowano value .
|
items |
Array<Item> |
Tak | Elementy związane z wydarzeniem. |
Parametry obiektu item
Nazwa | Typ | Wymagane | Przykładowa wartość | Opis |
---|---|---|---|---|
item_id |
string |
Tak* | SKU_12345 |
Identyfikator elementu.
*Wymagana jest wartość z pola |
item_name |
string |
Tak* | Koszulka ze Stanem i przyjaciółmi |
Nazwa produktu.
*Wymagana jest wartość z pola |
affiliation |
string |
Nie | Google Store |
Przynależność do usługi służąca do wyznaczenia firmy dostarczającej lub sklepu stacjonarnego. Uwaga: atrybut „przynależność” jest dostępny tylko w zakresie elementu. |
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 zasada jest skonfigurowana, element creative_name na poziomie zdarzenia jest ignorowany.
Jeśli zasada jest nieskonfigurowana, używany jest creative_name na poziomie zdarzenia (jeśli jest dostępny). |
creative_slot |
string |
Nie | featured_app_1 | Nazwa boksu kreacji promocyjnej powiązanego z produktem. Jeśli zasada jest skonfigurowana, element creative_slot na poziomie zdarzenia jest ignorowany.
Jeśli zasada jest nieskonfigurowana, używany jest creative_slot na poziomie zdarzenia (jeśli jest dostępny). |
discount |
number |
Nie | 2,22 | Wartość rabatu kwotowego powiązanego z produktem. |
index |
number |
Nie | 5 | Indeks/pozycja elementu na liście. |
item_brand |
string |
Nie | Marka produktu. | |
item_category |
string |
Nie | Odzież | Kategoria produktu. Jeśli używasz ich w ramach hierarchii kategorii lub taksonomii, jest 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ótkie rękawy | 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 zasada jest skonfigurowana, element item_list_id na poziomie zdarzenia jest ignorowany.
Jeśli zasada jest nieskonfigurowana, używany jest item_list_id na poziomie zdarzenia (jeśli jest dostępny).
|
item_list_name |
string |
Nie | Produkty powiązane | Nazwa listy, na której produkt został przedstawiony użytkownikowi. Jeśli zasada jest skonfigurowana, element item_list_name na poziomie zdarzenia jest ignorowany.
Jeśli zasada jest nieskonfigurowana, używany jest item_list_name na poziomie zdarzenia (jeśli jest dostępny).
|
item_variant |
string |
Nie | zielony | Wersja produktu, unikalny kod lub opis dodatkowych szczegółów lub opcji produktu. |
location_id |
string |
Nie | ChIJIQBpAG2ahYAR_6128GcTUEo (identyfikator Miejsc Google dla San Francisco) |
Lokalizacja fizyczna powiązana z produktem (np. lokalizacja sklepu stacjonarnego). Zalecamy użycie identyfikatora miejsca Google powiązanego z powiązanym elementem. Możesz też użyć niestandardowego identyfikatora lokalizacji. Uwaga: „identyfikator lokalizacji” jest dostępny tylko w zakresie elementu. |
price |
number |
Nie | 10,01 |
Pieniężna cena jednostkowa produktu w jednostkach określonego parametru waluty.
Jeśli rabat ma zastosowanie do produktu, ustaw wartość price na obniżoną cenę jednostkowej i podaj rabat za jednostkę w parametrze discount .
|
promotion_id |
string |
Nie | P_12345 |
Identyfikator promocji powiązanej z produktem. Jeśli zasada jest skonfigurowana, element promotion_id na poziomie zdarzenia jest ignorowany.
Jeśli zasada jest nieskonfigurowana, używany jest promotion_id na poziomie zdarzenia (jeśli jest dostępny).
|
promotion_name |
string |
Nie | Letnia wyprzedaż |
Nazwa promocji powiązanej z produktem. Jeśli zasada jest skonfigurowana, element promotion_name na poziomie zdarzenia jest ignorowany.
Jeśli zasada jest nieskonfigurowana, używany jest promotion_name na poziomie zdarzenia (jeśli jest dostępny).
|
quantity |
number |
Nie | 3 |
Liczba sztuk produktu. |
items
możesz umieścić maksymalnie 27 parametrów niestandardowych.
Przykład
Ten przykład dotyczy implementacji za pomocą 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
– {{Elementy e-commerce}}value
– {{Wartość e-commerce}}currency
– {{waluta e-commerce}}- Wyzwalacz: zdarzenie równa się add_to_cart
Konfiguracja aktywatora:
- 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 dodanie produktu do listy życzeń. Użyj tego zdarzenia, aby zidentyfikować popularne prezenty w swojej aplikacji.
Parametry
Nazwa | Typ | Wymagane | Przykładowa wartość | Opis |
---|---|---|---|---|
currency |
string |
Tak* | USD |
Waluta elementów powiązanych ze zdarzeniem, podana w 3-literowym formacie ISO 4217. * Jeśli skonfigurujesz value , do prawidłowego obliczania danych o przychodach wymagana jest właściwość currency .
|
value |
number |
Tak* | 30,03 | Wartość pieniężna zdarzenia. * Ustaw value na sumę wartości (price * quantity) dla wszystkich elementów w domenie items . Nie używaj wartości shipping ani tax .
* Wartość value jest zwykle wymagana do efektywnego raportowania.
Jeśli oznaczysz zdarzenie jako konwersję, zalecamy ustawienie wartości value .
* Wartość currency jest wymagana, jeśli skonfigurowano value .
|
items |
Array<Item> |
Tak | Elementy związane z wydarzeniem. |
Parametry obiektu item
Nazwa | Typ | Wymagane | Przykładowa wartość | Opis |
---|---|---|---|---|
item_id |
string |
Tak* | SKU_12345 |
Identyfikator elementu.
*Wymagana jest wartość z pola |
item_name |
string |
Tak* | Koszulka ze Stanem i przyjaciółmi |
Nazwa produktu.
*Wymagana jest wartość z pola |
affiliation |
string |
Nie | Google Store |
Przynależność do usługi służąca do wyznaczenia firmy dostarczającej lub sklepu stacjonarnego. Uwaga: atrybut „przynależność” jest dostępny tylko w zakresie elementu. |
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 zasada jest skonfigurowana, element creative_name na poziomie zdarzenia jest ignorowany.
Jeśli zasada jest nieskonfigurowana, używany jest creative_name na poziomie zdarzenia (jeśli jest dostępny). |
creative_slot |
string |
Nie | featured_app_1 | Nazwa boksu kreacji promocyjnej powiązanego z produktem. Jeśli zasada jest skonfigurowana, element creative_slot na poziomie zdarzenia jest ignorowany.
Jeśli zasada jest nieskonfigurowana, używany jest creative_slot na poziomie zdarzenia (jeśli jest dostępny). |
discount |
number |
Nie | 2,22 | Wartość rabatu kwotowego powiązanego z produktem. |
index |
number |
Nie | 5 | Indeks/pozycja elementu na liście. |
item_brand |
string |
Nie | Marka produktu. | |
item_category |
string |
Nie | Odzież | Kategoria produktu. Jeśli używasz ich w ramach hierarchii kategorii lub taksonomii, jest 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ótkie rękawy | 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 zasada jest skonfigurowana, element item_list_id na poziomie zdarzenia jest ignorowany.
Jeśli zasada jest nieskonfigurowana, używany jest item_list_id na poziomie zdarzenia (jeśli jest dostępny).
|
item_list_name |
string |
Nie | Produkty powiązane | Nazwa listy, na której produkt został przedstawiony użytkownikowi. Jeśli zasada jest skonfigurowana, element item_list_name na poziomie zdarzenia jest ignorowany.
Jeśli zasada jest nieskonfigurowana, używany jest item_list_name na poziomie zdarzenia (jeśli jest dostępny).
|
item_variant |
string |
Nie | zielony | Wersja produktu, unikalny kod lub opis dodatkowych szczegółów lub opcji produktu. |
location_id |
string |
Nie | ChIJIQBpAG2ahYAR_6128GcTUEo (identyfikator Miejsc Google dla San Francisco) |
Lokalizacja fizyczna powiązana z produktem (np. lokalizacja sklepu stacjonarnego). Zalecamy użycie identyfikatora miejsca Google powiązanego z powiązanym elementem. Możesz też użyć niestandardowego identyfikatora lokalizacji. Uwaga: „identyfikator lokalizacji” jest dostępny tylko w zakresie elementu. |
price |
number |
Nie | 10,01 |
Pieniężna cena jednostkowa produktu w jednostkach określonego parametru waluty.
Jeśli rabat ma zastosowanie do produktu, ustaw wartość price na obniżoną cenę jednostkowej i podaj rabat za jednostkę w parametrze discount .
|
promotion_id |
string |
Nie | P_12345 |
Identyfikator promocji powiązanej z produktem. Jeśli zasada jest skonfigurowana, element promotion_id na poziomie zdarzenia jest ignorowany.
Jeśli zasada jest nieskonfigurowana, używany jest promotion_id na poziomie zdarzenia (jeśli jest dostępny).
|
promotion_name |
string |
Nie | Letnia wyprzedaż |
Nazwa promocji powiązanej z produktem. Jeśli zasada jest skonfigurowana, element promotion_name na poziomie zdarzenia jest ignorowany.
Jeśli zasada jest nieskonfigurowana, używany jest promotion_name na poziomie zdarzenia (jeśli jest dostępny).
|
quantity |
number |
Nie | 3 |
Liczba sztuk produktu. |
items
możesz umieścić maksymalnie 27 parametrów niestandardowych.
Przykład
Ten przykład dotyczy implementacji za pomocą 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
– {{Elementy e-commerce}}value
– {{Wartość e-commerce}}currency
– {{waluta e-commerce}}- Wyzwalacz: zdarzenie równa się add_to_wishlist
Konfiguracja aktywatora:
- 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 elementów powiązanych ze zdarzeniem, podana w 3-literowym formacie ISO 4217. * Jeśli skonfigurujesz value , do prawidłowego obliczania danych o przychodach wymagana jest właściwość currency .
|
value |
number |
Tak* | 30,03 | Wartość pieniężna zdarzenia. * Ustaw value na sumę wartości (price * quantity) dla wszystkich elementów w domenie items . Nie używaj wartości shipping ani tax .
* Wartość value jest zwykle wymagana do efektywnego raportowania.
Jeśli oznaczysz zdarzenie jako konwersję, zalecamy ustawienie wartości value .
* Wartość currency jest wymagana, jeśli skonfigurowano value .
|
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 | Elementy związane z wydarzeniem. |
Parametry obiektu item
Nazwa | Typ | Wymagane | Przykładowa wartość | Opis |
---|---|---|---|---|
item_id |
string |
Tak* | SKU_12345 |
Identyfikator elementu.
*Wymagana jest wartość z pola |
item_name |
string |
Tak* | Koszulka ze Stanem i przyjaciółmi |
Nazwa produktu.
*Wymagana jest wartość z pola |
affiliation |
string |
Nie | Google Store |
Przynależność do usługi służąca do wyznaczenia firmy dostarczającej lub sklepu stacjonarnego. Uwaga: atrybut „przynależność” jest dostępny tylko w zakresie elementu. |
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 zasada jest skonfigurowana, element creative_name na poziomie zdarzenia jest ignorowany.
Jeśli zasada jest nieskonfigurowana, używany jest creative_name na poziomie zdarzenia (jeśli jest dostępny). |
creative_slot |
string |
Nie | featured_app_1 | Nazwa boksu kreacji promocyjnej powiązanego z produktem. Jeśli zasada jest skonfigurowana, element creative_slot na poziomie zdarzenia jest ignorowany.
Jeśli zasada jest nieskonfigurowana, używany jest creative_slot na poziomie zdarzenia (jeśli jest dostępny). |
discount |
number |
Nie | 2,22 | Wartość rabatu kwotowego powiązanego z produktem. |
index |
number |
Nie | 5 | Indeks/pozycja elementu na liście. |
item_brand |
string |
Nie | Marka produktu. | |
item_category |
string |
Nie | Odzież | Kategoria produktu. Jeśli używasz ich w ramach hierarchii kategorii lub taksonomii, jest 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ótkie rękawy | 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 zasada jest skonfigurowana, element item_list_id na poziomie zdarzenia jest ignorowany.
Jeśli zasada jest nieskonfigurowana, używany jest item_list_id na poziomie zdarzenia (jeśli jest dostępny).
|
item_list_name |
string |
Nie | Produkty powiązane | Nazwa listy, na której produkt został przedstawiony użytkownikowi. Jeśli zasada jest skonfigurowana, element item_list_name na poziomie zdarzenia jest ignorowany.
Jeśli zasada jest nieskonfigurowana, używany jest item_list_name na poziomie zdarzenia (jeśli jest dostępny).
|
item_variant |
string |
Nie | zielony | Wersja produktu, unikalny kod lub opis dodatkowych szczegółów lub opcji produktu. |
location_id |
string |
Nie | ChIJIQBpAG2ahYAR_6128GcTUEo (identyfikator Miejsc Google dla San Francisco) |
Lokalizacja fizyczna powiązana z produktem (np. lokalizacja sklepu stacjonarnego). Zalecamy użycie identyfikatora miejsca Google powiązanego z powiązanym elementem. Możesz też użyć niestandardowego identyfikatora lokalizacji. Uwaga: „identyfikator lokalizacji” jest dostępny tylko w zakresie elementu. |
price |
number |
Nie | 10,01 |
Pieniężna cena jednostkowa produktu w jednostkach określonego parametru waluty.
Jeśli rabat ma zastosowanie do produktu, ustaw wartość price na obniżoną cenę jednostkowej i podaj rabat za jednostkę w parametrze discount .
|
promotion_id |
string |
Nie | P_12345 |
Identyfikator promocji powiązanej z produktem. Jeśli zasada jest skonfigurowana, element promotion_id na poziomie zdarzenia jest ignorowany.
Jeśli zasada jest nieskonfigurowana, używany jest promotion_id na poziomie zdarzenia (jeśli jest dostępny).
|
promotion_name |
string |
Nie | Letnia wyprzedaż |
Nazwa promocji powiązanej z produktem. Jeśli zasada jest skonfigurowana, element promotion_name na poziomie zdarzenia jest ignorowany.
Jeśli zasada jest nieskonfigurowana, używany jest promotion_name na poziomie zdarzenia (jeśli jest dostępny).
|
quantity |
number |
Nie | 3 |
Liczba sztuk produktu. |
items
możesz umieścić maksymalnie 27 parametrów niestandardowych.
Przykład
Ten przykład dotyczy implementacji za pomocą 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
– {{Elementy e-commerce}}value
– {{Wartość e-commerce}}currency
– {{waluta e-commerce}}coupon
– {{kupon e-commerce}}- Wyzwalacz: zdarzenie równa się start_checkout
Konfiguracja aktywatora:
- 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
}
]
}
});
earn_virtual_currency
Jest to zdarzenie polegające na tym, że użytkownik otrzymuje wirtualną walutę w grze. Zapisz go wraz z atrybutem spend_virtual_currency, aby lepiej poznać swoją gospodarkę wirtualną.
Parametry
Nazwa | Typ | Wymagane | Przykładowa wartość | Opis |
---|---|---|---|---|
virtual_currency_name |
string |
Nie | Gemy | Nazwa waluty wirtualnej. |
value |
number |
Nie | 5 | Wartość wirtualnej waluty. |
Przykład
Ten przykład dotyczy implementacji za pomocą 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
– klejnotyvalue
–5- Wywołuj zdarzenie, gdy ktoś otrzymuje wirtualną walutę.
generate_lead
Mierzy ono czas wygenerowania potencjalnego klienta (np. za pomocą formularza). Zapisuj te dane, by poznać skuteczność swoich kampanii marketingowych i liczbę klientów, którzy ponownie weszli w interakcję z Twoją firmą po rozpoczęciu interakcji z reklamą kierowaną do klientów.
Parametry
Nazwa | Typ | Wymagane | Przykładowa wartość | Opis |
---|---|---|---|---|
currency |
string |
Tak* | USD |
Waluta elementów powiązanych ze zdarzeniem, podana w 3-literowym formacie ISO 4217. * Jeśli skonfigurujesz value , do prawidłowego obliczania danych o przychodach wymagana jest właściwość currency .
|
value |
number |
Tak* | 30,03 | Wartość pieniężna zdarzenia. * Ustaw value na sumę wartości (price * quantity) dla wszystkich elementów w domenie items . Nie używaj wartości shipping ani tax .
* Wartość value jest zwykle wymagana do efektywnego raportowania.
Jeśli oznaczysz zdarzenie jako konwersję, zalecamy ustawienie wartości value .
* Wartość currency jest wymagana, jeśli skonfigurowano value .
|
Przykład
Ten przykład dotyczy implementacji za pomocą Menedżera tagów:
Pokaż konfigurację tagu
Konfiguracja tagu:
- Typ tagu: zdarzenie GA4
- Nazwa zdarzenia:
generate_lead
- Parametry zdarzenia (nazwa parametru – wartość):
currency
– USDvalue
–99,99- Wywołuj zdarzenie po wygenerowaniu potencjalnego klienta
join_group
Zarejestruj to wydarzenie, gdy użytkownik dołączy do grupy, takiej jak gildia, zespół lub rodzina. Dzięki temu zdarzeniu możesz analizować popularność określonych grup lub funkcji społecznościowych.
Parametry
Nazwa | Typ | Wymagane | Przykładowa wartość | Opis |
---|---|---|---|---|
group_id |
string |
Nie | G_12345 | Identyfikator grupy. |
Przykład
Ten przykład dotyczy implementacji za pomocą 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łuj zdarzenie, gdy użytkownik dołącza do grupy.
level_end
To zdarzenie oznacza, że gracz ukończył poziom gry.
Parametry
Nazwa | Typ | Wymagane | Przykładowa wartość | Opis |
---|---|---|---|---|
level_name |
string |
Nie | Początek podróży... | Nazwa poziomu. |
success |
boolean |
Nie | prawda | Ustaw jako true , jeśli udało Ci się ukończyć poziom. |
Przykład
Ten przykład dotyczy implementacji za pomocą Menedżera tagów:
Pokaż konfigurację tagu
Konfiguracja tagu:
- Typ tagu: zdarzenie GA4
- Nazwa zdarzenia:
level_end
- Parametry zdarzenia (nazwa parametru – wartość):
level_name
– początek podróży...- sukces – prawda
- Wywołuj je, gdy gracz dotrze do końca poziomu (np.pojawi się 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 | Początek podróży... | Nazwa poziomu. |
Przykład
Ten przykład dotyczy implementacji za pomocą Menedżera tagów:
Pokaż konfigurację tagu
Konfiguracja tagu:
- Typ tagu: zdarzenie GA4
- Nazwa zdarzenia:
level_start
- Parametry zdarzenia (nazwa parametru – wartość):
level_name
– początek podróży...- Wywołuj, gdy ktoś rozpoczyna nowy poziom (np. na stronie startowej poziomu)
level_up
To wydarzenie oznacza, że gracz awansował w grze na kolejny poziom. Za jego pomocą możesz określić rozkład poziomów grupy użytkowników i zidentyfikować poziomy, które są trudne do ukończenia.
Parametry
Nazwa | Typ | Wymagane | Przykładowa wartość | Opis |
---|---|---|---|---|
level |
number |
Nie | 5 | Poziom postaci. |
character |
string |
Nie | Gracz 1 | Postać, która awansowała na wyższy poziom. |
Przykład
Ten przykład dotyczy implementacji za pomocą Menedżera tagów:
Pokaż konfigurację tagu
Konfiguracja tagu:
- Typ tagu: zdarzenie GA4
- Nazwa zdarzenia:
level_up
- Parametry zdarzenia (nazwa parametru – wartość):
level
–5character
– zawodnik 1- Wyzwalacz, gdy gracz awansuje na kolejny poziom.
logowanie
Wysyłaj to zdarzenie, aby informować, że użytkownik zalogował się w Twojej witrynie lub aplikacji.
Parametry
Nazwa | Typ | Wymagane | Przykładowa wartość | Opis |
---|---|---|---|---|
method |
string |
Nie | Metoda używana do logowania. |
Przykład
Pokaż konfigurację tagu
Konfiguracja tagu:
- Typ tagu: zdarzenie GA4
- Nazwa zdarzenia:
login
- Parametry zdarzenia (nazwa parametru – wartość):
method
– Google- Wywołuj, gdy użytkownik się zaloguje
post_score
Wyślij to zdarzenie, gdy użytkownik opublikuje wynik. Dzięki temu zdarzeniu możesz się dowiedzieć, jak użytkownicy radzą sobie w grze, oraz skorelować wysokie wyniki z odbiorcami lub zachowaniami użytkowników.
Parametry
Nazwa | Typ | Wymagane | Przykładowa wartość | Opis |
---|---|---|---|---|
score |
number |
Tak | 10 tys. | Wynik do opublikowania. |
level |
number |
Nie | 5 | Poziom wyniku. |
character |
string |
Nie | Gracz 1 | Postać, która osiągnęła wynik. |
Przykład
Ten przykład dotyczy implementacji za pomocą Menedżera tagów:
Pokaż konfigurację tagu
Konfiguracja tagu:
- Typ tagu: zdarzenie GA4
- Nazwa zdarzenia:
post_score
- Parametry zdarzenia (nazwa parametru – wartość):
score
–10 000level
–5character
– zawodnik 1- Wywołuj, gdy użytkownik opublikuje ocenę
zakup
To zdarzenie sygnalizuje zakup co najmniej jednego produktu przez użytkownika.
Parametry
Nazwa | Typ | Wymagane | Przykładowa wartość | Opis |
---|---|---|---|---|
currency |
string |
Tak* | USD |
Waluta elementów powiązanych ze zdarzeniem, podana w 3-literowym formacie ISO 4217. * Jeśli skonfigurujesz value , do prawidłowego obliczania danych o przychodach wymagana jest właściwość currency .
|
value |
number |
Tak* | 30,03 | Wartość pieniężna zdarzenia. * Ustaw value na sumę wartości (price * quantity) dla wszystkich elementów w domenie items . Nie używaj wartości shipping ani tax .
* Wartość value jest zwykle wymagana do efektywnego raportowania.
Jeśli oznaczysz zdarzenie jako konwersję, zalecamy ustawienie wartości value .
* Wartość currency jest wymagana, jeśli skonfigurowano value .
|
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 | Koszt podatku związany z transakcją. |
items |
Array<Item> |
Tak | Elementy związane z wydarzeniem. |
Parametry obiektu item
Nazwa | Typ | Wymagane | Przykładowa wartość | Opis |
---|---|---|---|---|
item_id |
string |
Tak* | SKU_12345 |
Identyfikator elementu.
*Wymagana jest wartość z pola |
item_name |
string |
Tak* | Koszulka ze Stanem i przyjaciółmi |
Nazwa produktu.
*Wymagana jest wartość z pola |
affiliation |
string |
Nie | Google Store |
Przynależność do usługi służąca do wyznaczenia firmy dostarczającej lub sklepu stacjonarnego. Uwaga: atrybut „przynależność” jest dostępny tylko w zakresie elementu. |
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 zasada jest skonfigurowana, element creative_name na poziomie zdarzenia jest ignorowany.
Jeśli zasada jest nieskonfigurowana, używany jest creative_name na poziomie zdarzenia (jeśli jest dostępny). |
creative_slot |
string |
Nie | featured_app_1 | Nazwa boksu kreacji promocyjnej powiązanego z produktem. Jeśli zasada jest skonfigurowana, element creative_slot na poziomie zdarzenia jest ignorowany.
Jeśli zasada jest nieskonfigurowana, używany jest creative_slot na poziomie zdarzenia (jeśli jest dostępny). |
discount |
number |
Nie | 2,22 | Wartość rabatu kwotowego powiązanego z produktem. |
index |
number |
Nie | 5 | Indeks/pozycja elementu na liście. |
item_brand |
string |
Nie | Marka produktu. | |
item_category |
string |
Nie | Odzież | Kategoria produktu. Jeśli używasz ich w ramach hierarchii kategorii lub taksonomii, jest 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ótkie rękawy | 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 zasada jest skonfigurowana, element item_list_id na poziomie zdarzenia jest ignorowany.
Jeśli zasada jest nieskonfigurowana, używany jest item_list_id na poziomie zdarzenia (jeśli jest dostępny).
|
item_list_name |
string |
Nie | Produkty powiązane | Nazwa listy, na której produkt został przedstawiony użytkownikowi. Jeśli zasada jest skonfigurowana, element item_list_name na poziomie zdarzenia jest ignorowany.
Jeśli zasada jest nieskonfigurowana, używany jest item_list_name na poziomie zdarzenia (jeśli jest dostępny).
|
item_variant |
string |
Nie | zielony | Wersja produktu, unikalny kod lub opis dodatkowych szczegółów lub opcji produktu. |
location_id |
string |
Nie | ChIJIQBpAG2ahYAR_6128GcTUEo (identyfikator Miejsc Google dla San Francisco) |
Lokalizacja fizyczna powiązana z produktem (np. lokalizacja sklepu stacjonarnego). Zalecamy użycie identyfikatora miejsca Google powiązanego z powiązanym elementem. Możesz też użyć niestandardowego identyfikatora lokalizacji. Uwaga: „identyfikator lokalizacji” jest dostępny tylko w zakresie elementu. |
price |
number |
Nie | 10,01 |
Pieniężna cena jednostkowa produktu w jednostkach określonego parametru waluty.
Jeśli rabat ma zastosowanie do produktu, ustaw wartość price na obniżoną cenę jednostkowej i podaj rabat za jednostkę w parametrze discount .
|
promotion_id |
string |
Nie | P_12345 |
Identyfikator promocji powiązanej z produktem. Jeśli zasada jest skonfigurowana, element promotion_id na poziomie zdarzenia jest ignorowany.
Jeśli zasada jest nieskonfigurowana, używany jest promotion_id na poziomie zdarzenia (jeśli jest dostępny).
|
promotion_name |
string |
Nie | Letnia wyprzedaż |
Nazwa promocji powiązanej z produktem. Jeśli zasada jest skonfigurowana, element promotion_name na poziomie zdarzenia jest ignorowany.
Jeśli zasada jest nieskonfigurowana, używany jest promotion_name na poziomie zdarzenia (jeśli jest dostępny).
|
quantity |
number |
Nie | 3 |
Liczba sztuk produktu. |
items
możesz umieścić maksymalnie 27 parametrów niestandardowych.
Przykład
Ten przykład dotyczy implementacji za pomocą Menedżera tagów:
Pokaż konfigurację tagu
Konfiguracja tagu:
- Typ tagu: zdarzenie GA4
- Nazwa zdarzenia:
purchase
- Elementy e-commerce –
ecommerce.items
- Identyfikator transakcji e-commerce –
ecommerce.transaction_id
- Wartość e-commerce –
ecommerce.value
- Podatek od e-commerce –
ecommerce.tax
- Dostawa e-commerce –
ecommerce.shipping
- Waluta e-commerce –
ecommerce.currency
- Kupon e-commerce –
ecommerce.coupon
- Parametry zdarzenia (nazwa parametru – wartość):
items
– {{Elementy e-commerce}}transaction_id
– {{identyfikator transakcji e-commerce}}value
– {{Wartość e-commerce}}tax
– {{Podatek e-commerce;shipping
– {{Wysyłka e-commerce}}currency
– {{waluta e-commerce}}coupon
– {{kupon e-commerce}}- Reguła: zdarzenie równa się zakup
Konfiguracja aktywatora:
- 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
}]
}
});
refund
To zdarzenie sygnalizuje, gdy użytkownik otrzyma zwrot środków za co najmniej 1 produkt.
Parametry
Nazwa | Typ | Wymagane | Przykładowa wartość | Opis |
---|---|---|---|---|
currency |
string |
Tak* | USD |
Waluta elementów powiązanych ze zdarzeniem, podana w 3-literowym formacie ISO 4217. * Jeśli skonfigurujesz value , do prawidłowego obliczania danych o przychodach wymagana jest właściwość currency .
|
transaction_id |
string |
Tak | T_12345 | Unikalny identyfikator transakcji. |
value |
number |
Tak* | 30,03 | Wartość pieniężna zdarzenia. * Ustaw value na sumę wartości (price * quantity) dla wszystkich elementów w domenie items . Nie używaj wartości shipping ani tax .
* Wartość value jest zwykle wymagana do efektywnego raportowania.
Jeśli oznaczysz zdarzenie jako konwersję, zalecamy ustawienie wartości value .
* Wartość currency jest wymagana, jeśli skonfigurowano value .
|
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 | Koszt podatku związany z transakcją. |
items |
Array<Item>
|
Nie* | Elementy związane z wydarzeniem. |
Parametry obiektu item
Nazwa | Typ | Wymagane | Przykładowa wartość | Opis |
---|---|---|---|---|
item_id |
string |
Tak* | SKU_12345 |
Identyfikator elementu.
*Wymagana jest wartość z pola |
item_name |
string |
Tak* | Koszulka ze Stanem i przyjaciółmi |
Nazwa produktu.
*Wymagana jest wartość z pola |
affiliation |
string |
Nie | Google Store |
Przynależność do usługi służąca do wyznaczenia firmy dostarczającej lub sklepu stacjonarnego. Uwaga: atrybut „przynależność” jest dostępny tylko w zakresie elementu. |
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 zasada jest skonfigurowana, element creative_name na poziomie zdarzenia jest ignorowany.
Jeśli zasada jest nieskonfigurowana, używany jest creative_name na poziomie zdarzenia (jeśli jest dostępny). |
creative_slot |
string |
Nie | featured_app_1 | Nazwa boksu kreacji promocyjnej powiązanego z produktem. Jeśli zasada jest skonfigurowana, element creative_slot na poziomie zdarzenia jest ignorowany.
Jeśli zasada jest nieskonfigurowana, używany jest creative_slot na poziomie zdarzenia (jeśli jest dostępny). |
discount |
number |
Nie | 2,22 | Wartość rabatu kwotowego powiązanego z produktem. |
index |
number |
Nie | 5 | Indeks/pozycja elementu na liście. |
item_brand |
string |
Nie | Marka produktu. | |
item_category |
string |
Nie | Odzież | Kategoria produktu. Jeśli używasz ich w ramach hierarchii kategorii lub taksonomii, jest 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ótkie rękawy | 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 zasada jest skonfigurowana, element item_list_id na poziomie zdarzenia jest ignorowany.
Jeśli zasada jest nieskonfigurowana, używany jest item_list_id na poziomie zdarzenia (jeśli jest dostępny).
|
item_list_name |
string |
Nie | Produkty powiązane | Nazwa listy, na której produkt został przedstawiony użytkownikowi. Jeśli zasada jest skonfigurowana, element item_list_name na poziomie zdarzenia jest ignorowany.
Jeśli zasada jest nieskonfigurowana, używany jest item_list_name na poziomie zdarzenia (jeśli jest dostępny).
|
item_variant |
string |
Nie | zielony | Wersja produktu, unikalny kod lub opis dodatkowych szczegółów lub opcji produktu. |
location_id |
string |
Nie | ChIJIQBpAG2ahYAR_6128GcTUEo (identyfikator Miejsc Google dla San Francisco) |
Lokalizacja fizyczna powiązana z produktem (np. lokalizacja sklepu stacjonarnego). Zalecamy użycie identyfikatora miejsca Google powiązanego z powiązanym elementem. Możesz też użyć niestandardowego identyfikatora lokalizacji. Uwaga: „identyfikator lokalizacji” jest dostępny tylko w zakresie elementu. |
price |
number |
Nie | 10,01 |
Pieniężna cena jednostkowa produktu w jednostkach określonego parametru waluty.
Jeśli rabat ma zastosowanie do produktu, ustaw wartość price na obniżoną cenę jednostkowej i podaj rabat za jednostkę w parametrze discount .
|
promotion_id |
string |
Nie | P_12345 |
Identyfikator promocji powiązanej z produktem. Jeśli zasada jest skonfigurowana, element promotion_id na poziomie zdarzenia jest ignorowany.
Jeśli zasada jest nieskonfigurowana, używany jest promotion_id na poziomie zdarzenia (jeśli jest dostępny).
|
promotion_name |
string |
Nie | Letnia wyprzedaż |
Nazwa promocji powiązanej z produktem. Jeśli zasada jest skonfigurowana, element promotion_name na poziomie zdarzenia jest ignorowany.
Jeśli zasada jest nieskonfigurowana, używany jest promotion_name na poziomie zdarzenia (jeśli jest dostępny).
|
quantity |
number |
Nie | 3 |
Liczba sztuk produktu. |
items
możesz umieścić maksymalnie 27 parametrów niestandardowych.
Przykład
Ten przykład dotyczy implementacji za pomocą Menedżera tagów:
Pokaż konfigurację tagu
Konfiguracja tagu:
- Typ tagu: zdarzenie GA4
- Nazwa zdarzenia:
refund
- Zmienne warstwy danych (nazwa – nazwa zmiennej warstwy danych):
- Elementy e-commerce –
ecommerce.items
- Identyfikator transakcji e-commerce –
ecommerce.transaction_id
- Wartość e-commerce –
ecommerce.value
- Podatek od e-commerce –
ecommerce.tax
- Dostawa e-commerce –
ecommerce.shipping
- Waluta e-commerce –
ecommerce.currency
- Kupon e-commerce –
ecommerce.coupon
- Parametry zdarzenia (nazwa parametru – wartość):
items
– {{Elementy e-commerce}}transaction_id
– {{identyfikator transakcji e-commerce}}value
– {{Wartość e-commerce}}tax
– {{Podatek e-commerce;shipping
– {{Wysyłka e-commerce}}currency
– {{waluta e-commerce}}coupon
– {{kupon e-commerce}}- Reguła: zdarzenie równa się zwrot
Konfiguracja aktywatora:
- 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 elementów powiązanych ze zdarzeniem, podana w 3-literowym formacie ISO 4217. * Jeśli skonfigurujesz value , do prawidłowego obliczania danych o przychodach wymagana jest właściwość currency .
|
value |
number |
Tak* | 30,03 | Wartość pieniężna zdarzenia. * Ustaw value na sumę wartości (price * quantity) dla wszystkich elementów w domenie items . Nie używaj wartości shipping ani tax .
* Wartość value jest zwykle wymagana do efektywnego raportowania.
Jeśli oznaczysz zdarzenie jako konwersję, zalecamy ustawienie wartości value .
* Wartość currency jest wymagana, jeśli skonfigurowano value .
|
items |
Array<Item> |
Tak | Elementy związane z wydarzeniem. |
Parametry obiektu item
Nazwa | Typ | Wymagane | Przykładowa wartość | Opis |
---|---|---|---|---|
item_id |
string |
Tak* | SKU_12345 |
Identyfikator elementu.
*Wymagana jest wartość z pola |
item_name |
string |
Tak* | Koszulka ze Stanem i przyjaciółmi |
Nazwa produktu.
*Wymagana jest wartość z pola |
affiliation |
string |
Nie | Google Store |
Przynależność do usługi służąca do wyznaczenia firmy dostarczającej lub sklepu stacjonarnego. Uwaga: atrybut „przynależność” jest dostępny tylko w zakresie elementu. |
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 zasada jest skonfigurowana, element creative_name na poziomie zdarzenia jest ignorowany.
Jeśli zasada jest nieskonfigurowana, używany jest creative_name na poziomie zdarzenia (jeśli jest dostępny). |
creative_slot |
string |
Nie | featured_app_1 | Nazwa boksu kreacji promocyjnej powiązanego z produktem. Jeśli zasada jest skonfigurowana, element creative_slot na poziomie zdarzenia jest ignorowany.
Jeśli zasada jest nieskonfigurowana, używany jest creative_slot na poziomie zdarzenia (jeśli jest dostępny). |
discount |
number |
Nie | 2,22 | Wartość rabatu kwotowego powiązanego z produktem. |
index |
number |
Nie | 5 | Indeks/pozycja elementu na liście. |
item_brand |
string |
Nie | Marka produktu. | |
item_category |
string |
Nie | Odzież | Kategoria produktu. Jeśli używasz ich w ramach hierarchii kategorii lub taksonomii, jest 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ótkie rękawy | 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 zasada jest skonfigurowana, element item_list_id na poziomie zdarzenia jest ignorowany.
Jeśli zasada jest nieskonfigurowana, używany jest item_list_id na poziomie zdarzenia (jeśli jest dostępny).
|
item_list_name |
string |
Nie | Produkty powiązane | Nazwa listy, na której produkt został przedstawiony użytkownikowi. Jeśli zasada jest skonfigurowana, element item_list_name na poziomie zdarzenia jest ignorowany.
Jeśli zasada jest nieskonfigurowana, używany jest item_list_name na poziomie zdarzenia (jeśli jest dostępny).
|
item_variant |
string |
Nie | zielony | Wersja produktu, unikalny kod lub opis dodatkowych szczegółów lub opcji produktu. |
location_id |
string |
Nie | ChIJIQBpAG2ahYAR_6128GcTUEo (identyfikator Miejsc Google dla San Francisco) |
Lokalizacja fizyczna powiązana z produktem (np. lokalizacja sklepu stacjonarnego). Zalecamy użycie identyfikatora miejsca Google powiązanego z powiązanym elementem. Możesz też użyć niestandardowego identyfikatora lokalizacji. Uwaga: „identyfikator lokalizacji” jest dostępny tylko w zakresie elementu. |
price |
number |
Nie | 10,01 |
Pieniężna cena jednostkowa produktu w jednostkach określonego parametru waluty.
Jeśli rabat ma zastosowanie do produktu, ustaw wartość price na obniżoną cenę jednostkowej i podaj rabat za jednostkę w parametrze discount .
|
promotion_id |
string |
Nie | P_12345 |
Identyfikator promocji powiązanej z produktem. Jeśli zasada jest skonfigurowana, element promotion_id na poziomie zdarzenia jest ignorowany.
Jeśli zasada jest nieskonfigurowana, używany jest promotion_id na poziomie zdarzenia (jeśli jest dostępny).
|
promotion_name |
string |
Nie | Letnia wyprzedaż |
Nazwa promocji powiązanej z produktem. Jeśli zasada jest skonfigurowana, element promotion_name na poziomie zdarzenia jest ignorowany.
Jeśli zasada jest nieskonfigurowana, używany jest promotion_name na poziomie zdarzenia (jeśli jest dostępny).
|
quantity |
number |
Nie | 3 |
Liczba sztuk produktu. |
items
możesz umieścić maksymalnie 27 parametrów niestandardowych.
Przykład
Ten przykład dotyczy implementacji za pomocą 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
– {{Elementy e-commerce}}value
– {{Wartość e-commerce}}currency
– {{waluta e-commerce}}- Wyzwalacz: zdarzenie równa się remove_from_cart
Konfiguracja aktywatora:
- 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
}
]
}
});
search
Zarejestruj to zdarzenie, aby wskazać, kiedy użytkownik przeprowadził wyszukiwanie. Korzystając z tego zdarzenia, możesz się dowiedzieć, czego szukają użytkownicy w Twojej witrynie lub aplikacji. Możesz na przykład wysyłać to zdarzenie, gdy użytkownik wyświetli stronę wyników wyszukiwania po przeprowadzeniu wyszukiwania.
Parametry
Nazwa | Typ | Wymagane | Przykładowa wartość | Opis |
---|---|---|---|---|
search_term |
string |
Tak | koszulki | Wyszukiwany produkt. |
Przykład
Ten przykład dotyczy implementacji za pomocą Menedżera tagów:
Pokaż konfigurację tagu
Konfiguracja tagu:
- Typ tagu: zdarzenie GA4
- Nazwa zdarzenia:
search
- Parametry zdarzenia (nazwa parametru – wartość):
search_term
– koszulki- Uruchamiaj, gdy użytkownik wyszukuje w Twojej witrynie
select_content
To zdarzenie oznacza, że użytkownik wybrał treści określonego typu. To zdarzenie pomoże Ci zidentyfikować popularne treści oraz kategorie treści w witrynie lub aplikacji.
Parametry
Nazwa | Typ | Wymagane | Przykładowa wartość | Opis |
---|---|---|---|---|
content_type |
string |
Nie | produkt | Typ wybranej treści. |
content_id |
string |
Nie | C_12345 | Identyfikator wybranej treści. |
Przykład
Ten przykład dotyczy implementacji za pomocą Menedżera tagów:
Pokaż konfigurację tagu
Konfiguracja tagu:
- Typ tagu: zdarzenie GA4
- Nazwa zdarzenia:
select_content
- Parametry zdarzenia (nazwa parametru – wartość):
content_type
– produktcontent_id
– C_12345- Reguła: zdarzenie równa się 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 ustawiono na poziomie produktu. |
item_list_name |
string |
Nie | Produkty powiązane | Nazwa listy, na której produkt został przedstawiony użytkownikowi. Ignorowane, jeśli ustawiono na poziomie produktu. |
items |
Array<Item> |
Tak* | Elementy związane z wydarzeniem. * Tablica items powinna zawierać jeden element, który reprezentuje wybrany element. Jeśli podasz wiele elementów, używany będzie tylko pierwszy z nich items .
|
Parametry obiektu item
Nazwa | Typ | Wymagane | Przykładowa wartość | Opis |
---|---|---|---|---|
item_id |
string |
Tak* | SKU_12345 |
Identyfikator elementu.
*Wymagana jest wartość z pola |
item_name |
string |
Tak* | Koszulka ze Stanem i przyjaciółmi |
Nazwa produktu.
*Wymagana jest wartość z pola |
affiliation |
string |
Nie | Google Store |
Przynależność do usługi służąca do wyznaczenia firmy dostarczającej lub sklepu stacjonarnego. Uwaga: atrybut „przynależność” jest dostępny tylko w zakresie elementu. |
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 zasada jest skonfigurowana, element creative_name na poziomie zdarzenia jest ignorowany.
Jeśli zasada jest nieskonfigurowana, używany jest creative_name na poziomie zdarzenia (jeśli jest dostępny). |
creative_slot |
string |
Nie | featured_app_1 | Nazwa boksu kreacji promocyjnej powiązanego z produktem. Jeśli zasada jest skonfigurowana, element creative_slot na poziomie zdarzenia jest ignorowany.
Jeśli zasada jest nieskonfigurowana, używany jest creative_slot na poziomie zdarzenia (jeśli jest dostępny). |
discount |
number |
Nie | 2,22 | Wartość rabatu kwotowego powiązanego z produktem. |
index |
number |
Nie | 5 | Indeks/pozycja elementu na liście. |
item_brand |
string |
Nie | Marka produktu. | |
item_category |
string |
Nie | Odzież | Kategoria produktu. Jeśli używasz ich w ramach hierarchii kategorii lub taksonomii, jest 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ótkie rękawy | 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 zasada jest skonfigurowana, element item_list_id na poziomie zdarzenia jest ignorowany.
Jeśli zasada jest nieskonfigurowana, używany jest item_list_id na poziomie zdarzenia (jeśli jest dostępny).
|
item_list_name |
string |
Nie | Produkty powiązane | Nazwa listy, na której produkt został przedstawiony użytkownikowi. Jeśli zasada jest skonfigurowana, element item_list_name na poziomie zdarzenia jest ignorowany.
Jeśli zasada jest nieskonfigurowana, używany jest item_list_name na poziomie zdarzenia (jeśli jest dostępny).
|
item_variant |
string |
Nie | zielony | Wersja produktu, unikalny kod lub opis dodatkowych szczegółów lub opcji produktu. |
location_id |
string |
Nie | ChIJIQBpAG2ahYAR_6128GcTUEo (identyfikator Miejsc Google dla San Francisco) |
Lokalizacja fizyczna powiązana z produktem (np. lokalizacja sklepu stacjonarnego). Zalecamy użycie identyfikatora miejsca Google powiązanego z powiązanym elementem. Możesz też użyć niestandardowego identyfikatora lokalizacji. Uwaga: „identyfikator lokalizacji” jest dostępny tylko w zakresie elementu. |
price |
number |
Nie | 10,01 |
Pieniężna cena jednostkowa produktu w jednostkach określonego parametru waluty.
Jeśli rabat ma zastosowanie do produktu, ustaw wartość price na obniżoną cenę jednostkowej i podaj rabat za jednostkę w parametrze discount .
|
promotion_id |
string |
Nie | P_12345 |
Identyfikator promocji powiązanej z produktem. Jeśli zasada jest skonfigurowana, element promotion_id na poziomie zdarzenia jest ignorowany.
Jeśli zasada jest nieskonfigurowana, używany jest promotion_id na poziomie zdarzenia (jeśli jest dostępny).
|
promotion_name |
string |
Nie | Letnia wyprzedaż |
Nazwa promocji powiązanej z produktem. Jeśli zasada jest skonfigurowana, element promotion_name na poziomie zdarzenia jest ignorowany.
Jeśli zasada jest nieskonfigurowana, używany jest promotion_name na poziomie zdarzenia (jeśli jest dostępny).
|
quantity |
number |
Nie | 3 |
Liczba sztuk produktu. |
items
możesz umieścić maksymalnie 27 parametrów niestandardowych.
Przykład
Ten przykład dotyczy implementacji za pomocą Menedżera tagów:
Pokaż konfigurację tagu
Konfiguracja tagu:
- Typ tagu: zdarzenie GA4
- Nazwa zdarzenia:
select_item
- Zmienne warstwy danych (nazwa – nazwa zmiennej warstwy danych):
- Elementy e-commerce –
ecommerce.items
- Identyfikator listy produktów e-commerce –
ecommerce.item_list_id
- Nazwa listy elementów e-commerce –
ecommerce.item_list_name
- Parametry zdarzenia (nazwa parametru – wartość):
items
– {{Elementy e-commerce}}item_list_id
– {{identyfikator listy elementów e-commerce}}item_list_name
– {{nazwa listy elementów e-commerce}}- Reguła: zdarzenie równa się select_item
Konfiguracja aktywatora:
- 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 wydarzenie oznacza, że promocja została wybrana z listy.
Parametry
Nazwa | Typ | Wymagane | Przykładowa wartość | Opis |
---|---|---|---|---|
creative_name |
string |
Nie | summer_banner2 | Nazwa kreacji promocyjnej. Ignorowane, jeśli ustawiono na poziomie produktu. |
creative_slot |
string |
Nie | featured_app_1 | Nazwa boksu kreacji promocyjnej powiązanego ze zdarzeniem. Ignorowane, jeśli ustawiono na poziomie produktu. |
promotion_id |
string |
Nie | P_12345 |
Identyfikator promocji powiązanej ze zdarzeniem. Ignorowane, jeśli ustawiono na poziomie produktu. |
promotion_name |
string |
Nie | Letnia wyprzedaż |
Nazwa promocji powiązanej ze zdarzeniem. Ignorowane, jeśli ustawiono na poziomie produktu. |
items |
Array<Item>
|
Nie | Elementy związane z wydarzeniem. |
Parametry obiektu item
Nazwa | Typ | Wymagane | Przykładowa wartość | Opis |
---|---|---|---|---|
item_id |
string |
Tak* | SKU_12345 |
Identyfikator elementu.
*Wymagana jest wartość z pola |
item_name |
string |
Tak* | Koszulka ze Stanem i przyjaciółmi |
Nazwa produktu.
*Wymagana jest wartość z pola |
affiliation |
string |
Nie | Google Store |
Przynależność do usługi służąca do wyznaczenia firmy dostarczającej lub sklepu stacjonarnego. Uwaga: atrybut „przynależność” jest dostępny tylko w zakresie elementu. |
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 zasada jest skonfigurowana, element creative_name na poziomie zdarzenia jest ignorowany.
Jeśli zasada jest nieskonfigurowana, używany jest creative_name na poziomie zdarzenia (jeśli jest dostępny). |
creative_slot |
string |
Nie | featured_app_1 | Nazwa boksu kreacji promocyjnej powiązanego z produktem. Jeśli zasada jest skonfigurowana, element creative_slot na poziomie zdarzenia jest ignorowany.
Jeśli zasada jest nieskonfigurowana, używany jest creative_slot na poziomie zdarzenia (jeśli jest dostępny). |
discount |
number |
Nie | 2,22 | Wartość rabatu kwotowego powiązanego z produktem. |
index |
number |
Nie | 5 | Indeks/pozycja elementu na liście. |
item_brand |
string |
Nie | Marka produktu. | |
item_category |
string |
Nie | Odzież | Kategoria produktu. Jeśli używasz ich w ramach hierarchii kategorii lub taksonomii, jest 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ótkie rękawy | 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 zasada jest skonfigurowana, element item_list_id na poziomie zdarzenia jest ignorowany.
Jeśli zasada jest nieskonfigurowana, używany jest item_list_id na poziomie zdarzenia (jeśli jest dostępny).
|
item_list_name |
string |
Nie | Produkty powiązane | Nazwa listy, na której produkt został przedstawiony użytkownikowi. Jeśli zasada jest skonfigurowana, element item_list_name na poziomie zdarzenia jest ignorowany.
Jeśli zasada jest nieskonfigurowana, używany jest item_list_name na poziomie zdarzenia (jeśli jest dostępny).
|
item_variant |
string |
Nie | zielony | Wersja produktu, unikalny kod lub opis dodatkowych szczegółów lub opcji produktu. |
location_id |
string |
Nie | ChIJIQBpAG2ahYAR_6128GcTUEo (identyfikator Miejsc Google dla San Francisco) |
Lokalizacja fizyczna powiązana z produktem (np. lokalizacja sklepu stacjonarnego). Zalecamy użycie identyfikatora miejsca Google powiązanego z powiązanym elementem. Możesz też użyć niestandardowego identyfikatora lokalizacji. Uwaga: „identyfikator lokalizacji” jest dostępny tylko w zakresie elementu. |
price |
number |
Nie | 10,01 |
Pieniężna cena jednostkowa produktu w jednostkach określonego parametru waluty.
Jeśli rabat ma zastosowanie do produktu, ustaw wartość price na obniżoną cenę jednostkowej i podaj rabat za jednostkę w parametrze discount .
|
promotion_id |
string |
Nie | P_12345 |
Identyfikator promocji powiązanej z produktem. Jeśli zasada jest skonfigurowana, element promotion_id na poziomie zdarzenia jest ignorowany.
Jeśli zasada jest nieskonfigurowana, używany jest promotion_id na poziomie zdarzenia (jeśli jest dostępny).
|
promotion_name |
string |
Nie | Letnia wyprzedaż |
Nazwa promocji powiązanej z produktem. Jeśli zasada jest skonfigurowana, element promotion_name na poziomie zdarzenia jest ignorowany.
Jeśli zasada jest nieskonfigurowana, używany jest promotion_name na poziomie zdarzenia (jeśli jest dostępny).
|
quantity |
number |
Nie | 3 |
Liczba sztuk produktu. |
items
możesz umieścić maksymalnie 27 parametrów niestandardowych.
Przykład
Ten przykład dotyczy implementacji za pomocą 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
- Boks kreacji e-commerce –
ecommerce.creative_slot
- Identyfikator promocji e-commerce –
ecommerce.promotion_id
- Nazwa promocji e-commerce –
ecommerce.promotion_name
- Elementy e-commerce –
ecommerce.items
- Parametry zdarzenia (nazwa parametru – wartość):
creative_name
– {{Nazwa kreacji e-commerce}}creative_slot
– {{ boks kreacji e-commerce}}promotion_id
– {{identyfikator promocji e-commerce}}promotion_name
– {{Nazwa promocji e-commerce}}items
– {{Elementy e-commerce}}- Typ zmiennej: zmienna warstwy danych – „ecommerce.items”
- Reguła: zdarzenie równa się select_promotion
Konfiguracja aktywatora:
- 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
}
]
}
});
udostępnienie
Użyj tego zdarzenia, gdy użytkownik udostępni treść.
Parametry
Nazwa | Typ | Wymagane | Przykładowa wartość | Opis |
---|---|---|---|---|
method |
string |
Nie | Metoda udostępniania treści. | |
content_type |
string |
Nie | obraz | Typ udostępnianej treści. |
item_id |
string |
Nie | C_12345 | Identyfikator udostępnianej treści. |
Przykład
Pokaż konfigurację tagu
Konfiguracja tagu:
- Typ tagu: zdarzenie GA4
- Nazwa zdarzenia:
share
- Parametry zdarzenia (nazwa parametru – wartość):
method
– Twittercontent_type
– obrazitem_id
– C_12345- Wywołuj, gdy użytkownik udostępni treść
sign_up
To zdarzenie oznacza, że użytkownik założył konto. Dzięki temu zdarzeniu możesz poznawać różne zachowania zalogowanych i niezalogowanych użytkowników.
Parametry
Nazwa | Typ | Wymagane | Przykładowa wartość | Opis |
---|---|---|---|---|
method |
string |
Nie | Metoda użyta do rejestracji. |
Przykład
Ten przykład dotyczy implementacji za pomocą 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łuj, gdy użytkownik założy konto
spend_virtual_currency
Mierzy ono sprzedaż wirtualnych towarów w Twojej aplikacji i pomaga określić, które towary są najpopularniejsze.
Parametry
Nazwa | Typ | Wymagane | Przykładowa wartość | Opis |
---|---|---|---|---|
value |
number |
Tak | 5 | Wartość wirtualnej waluty. |
virtual_currency_name |
string |
Tak | Gemy | Nazwa waluty wirtualnej. |
item_name |
string |
Nie | Wzmocnienie na początek | Nazwa produktu, dla którego używana jest waluta wirtualna. |
Przykład
Ten przykład dotyczy implementacji za pomocą Menedżera tagów:
Pokaż konfigurację tagu
Konfiguracja tagu:
- Typ tagu: zdarzenie GA4
- Nazwa zdarzenia:
spend_virtual_currency
- Parametry zdarzenia (nazwa parametru – wartość):
value
–5virtual_currency_name
– klejnotyitem_name
– bonus startowy- Wywoływane, gdy ktoś kupuje towar wirtualny
tutorial_begin
Oznacza ono rozpoczęcie procesu rejestracji. Użyj go w przypadku ścieżki z parametrem tutorial_complete, na podstawie którego możesz się dowiedzieć, ilu użytkowników ukończyło samouczek.
Parametry
Nie ma parametrów dla tego zdarzenia.
Przykład
Ten przykład dotyczy implementacji za pomocą Menedżera tagów:
Pokaż konfigurację tagu
Konfiguracja tagu:
- Typ tagu: zdarzenie GA4
- Nazwa zdarzenia:
tutorial_begin
- Wywoływane, gdy ktoś rozpocznie proces wdrażania
tutorial_complete
Zdarzenie to sygnalizuje zakończenie procesu rejestracji przez użytkownika. Możesz go wykorzystać w ścieżce z parametrem tutorial_begin, aby dowiedzieć się, ilu użytkowników ukończyło samouczek.
Parametry
Dla tego zdarzenia nie są sugerowane żadne parametry.
Przykład
Ten przykład dotyczy implementacji za pomocą Menedżera tagów:
Pokaż konfigurację tagu
Konfiguracja tagu:
- Typ tagu: zdarzenie GA4
- Nazwa zdarzenia:
tutorial_complete
- Wywoływane, gdy ktoś ukończy proces wprowadzenia
unlock_achievement
Zarejestruj to zdarzenie, gdy użytkownik odblokuje osiągnięcie. Dzięki temu dowiesz się, jak użytkownicy odbierają Twoją grę.
Parametry
Nazwa | Typ | Wymagane | Przykładowa wartość | Opis |
---|---|---|---|---|
achievement_id |
string |
Tak | A_12345 | Identyfikator odblokowanego osiągnięcia. |
Przykład
Ten przykład dotyczy implementacji za pomocą 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łuj, gdy użytkownik odblokował osiągnięcie
view_cart
To zdarzenie oznacza, że użytkownik wyświetlił swój koszyk.
Parametry
Nazwa | Typ | Wymagane | Przykładowa wartość | Opis |
---|---|---|---|---|
currency |
string |
Tak* | USD |
Waluta elementów powiązanych ze zdarzeniem, podana w 3-literowym formacie ISO 4217. * Jeśli skonfigurujesz value , do prawidłowego obliczania danych o przychodach wymagana jest właściwość currency .
|
value |
number |
Tak* | 30,03 | Wartość pieniężna zdarzenia. * Ustaw value na sumę wartości (price * quantity) dla wszystkich elementów w domenie items . Nie używaj wartości shipping ani tax .
* Wartość value jest zwykle wymagana do efektywnego raportowania.
Jeśli oznaczysz zdarzenie jako konwersję, zalecamy ustawienie wartości value .
* Wartość currency jest wymagana, jeśli skonfigurowano value .
|
items |
Array<Item> |
Tak | Elementy związane z wydarzeniem. |
Parametry obiektu item
Nazwa | Typ | Wymagane | Przykładowa wartość | Opis |
---|---|---|---|---|
item_id |
string |
Tak* | SKU_12345 |
Identyfikator elementu.
*Wymagana jest wartość z pola |
item_name |
string |
Tak* | Koszulka ze Stanem i przyjaciółmi |
Nazwa produktu.
*Wymagana jest wartość z pola |
affiliation |
string |
Nie | Google Store |
Przynależność do usługi służąca do wyznaczenia firmy dostarczającej lub sklepu stacjonarnego. Uwaga: atrybut „przynależność” jest dostępny tylko w zakresie elementu. |
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 zasada jest skonfigurowana, element creative_name na poziomie zdarzenia jest ignorowany.
Jeśli zasada jest nieskonfigurowana, używany jest creative_name na poziomie zdarzenia (jeśli jest dostępny). |
creative_slot |
string |
Nie | featured_app_1 | Nazwa boksu kreacji promocyjnej powiązanego z produktem. Jeśli zasada jest skonfigurowana, element creative_slot na poziomie zdarzenia jest ignorowany.
Jeśli zasada jest nieskonfigurowana, używany jest creative_slot na poziomie zdarzenia (jeśli jest dostępny). |
discount |
number |
Nie | 2,22 | Wartość rabatu kwotowego powiązanego z produktem. |
index |
number |
Nie | 5 | Indeks/pozycja elementu na liście. |
item_brand |
string |
Nie | Marka produktu. | |
item_category |
string |
Nie | Odzież | Kategoria produktu. Jeśli używasz ich w ramach hierarchii kategorii lub taksonomii, jest 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ótkie rękawy | 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 zasada jest skonfigurowana, element item_list_id na poziomie zdarzenia jest ignorowany.
Jeśli zasada jest nieskonfigurowana, używany jest item_list_id na poziomie zdarzenia (jeśli jest dostępny).
|
item_list_name |
string |
Nie | Produkty powiązane | Nazwa listy, na której produkt został przedstawiony użytkownikowi. Jeśli zasada jest skonfigurowana, element item_list_name na poziomie zdarzenia jest ignorowany.
Jeśli zasada jest nieskonfigurowana, używany jest item_list_name na poziomie zdarzenia (jeśli jest dostępny).
|
item_variant |
string |
Nie | zielony | Wersja produktu, unikalny kod lub opis dodatkowych szczegółów lub opcji produktu. |
location_id |
string |
Nie | ChIJIQBpAG2ahYAR_6128GcTUEo (identyfikator Miejsc Google dla San Francisco) |
Lokalizacja fizyczna powiązana z produktem (np. lokalizacja sklepu stacjonarnego). Zalecamy użycie identyfikatora miejsca Google powiązanego z powiązanym elementem. Możesz też użyć niestandardowego identyfikatora lokalizacji. Uwaga: „identyfikator lokalizacji” jest dostępny tylko w zakresie elementu. |
price |
number |
Nie | 10,01 |
Pieniężna cena jednostkowa produktu w jednostkach określonego parametru waluty.
Jeśli rabat ma zastosowanie do produktu, ustaw wartość price na obniżoną cenę jednostkowej i podaj rabat za jednostkę w parametrze discount .
|
promotion_id |
string |
Nie | P_12345 |
Identyfikator promocji powiązanej z produktem. Jeśli zasada jest skonfigurowana, element promotion_id na poziomie zdarzenia jest ignorowany.
Jeśli zasada jest nieskonfigurowana, używany jest promotion_id na poziomie zdarzenia (jeśli jest dostępny).
|
promotion_name |
string |
Nie | Letnia wyprzedaż |
Nazwa promocji powiązanej z produktem. Jeśli zasada jest skonfigurowana, element promotion_name na poziomie zdarzenia jest ignorowany.
Jeśli zasada jest nieskonfigurowana, używany jest promotion_name na poziomie zdarzenia (jeśli jest dostępny).
|
quantity |
number |
Nie | 3 |
Liczba sztuk produktu. |
items
możesz umieścić maksymalnie 27 parametrów niestandardowych.
Przykład
Ten przykład dotyczy implementacji za pomocą 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
– {{Elementy e-commerce}}value
– {{Wartość e-commerce}}currency
– {{waluta e-commerce}}- Reguła: zdarzenie równa się view_cart
Konfiguracja aktywatora:
- 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żytkownik wyświetlił pewne treści. Skorzystaj z tego zdarzenia, aby dowiedzieć się, które produkty są najpopularniejsze.
Parametry
Nazwa | Typ | Wymagane | Przykładowa wartość | Opis |
---|---|---|---|---|
currency |
string |
Tak* | USD |
Waluta elementów powiązanych ze zdarzeniem, podana w 3-literowym formacie ISO 4217. * Jeśli skonfigurujesz value , do prawidłowego obliczania danych o przychodach wymagana jest właściwość currency .
|
value |
number |
Tak* | 30,03 | Wartość pieniężna zdarzenia. * Ustaw value na sumę wartości (price * quantity) dla wszystkich elementów w domenie items . Nie używaj wartości shipping ani tax .
* Wartość value jest zwykle wymagana do efektywnego raportowania.
Jeśli oznaczysz zdarzenie jako konwersję, zalecamy ustawienie wartości value .
* Wartość currency jest wymagana, jeśli skonfigurowano value .
|
items |
Array<Item> |
Tak | Elementy związane z wydarzeniem. |
Parametry obiektu item
Nazwa | Typ | Wymagane | Przykładowa wartość | Opis |
---|---|---|---|---|
item_id |
string |
Tak* | SKU_12345 |
Identyfikator elementu.
*Wymagana jest wartość z pola |
item_name |
string |
Tak* | Koszulka ze Stanem i przyjaciółmi |
Nazwa produktu.
*Wymagana jest wartość z pola |
affiliation |
string |
Nie | Google Store |
Przynależność do usługi służąca do wyznaczenia firmy dostarczającej lub sklepu stacjonarnego. Uwaga: atrybut „przynależność” jest dostępny tylko w zakresie elementu. |
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 zasada jest skonfigurowana, element creative_name na poziomie zdarzenia jest ignorowany.
Jeśli zasada jest nieskonfigurowana, używany jest creative_name na poziomie zdarzenia (jeśli jest dostępny). |
creative_slot |
string |
Nie | featured_app_1 | Nazwa boksu kreacji promocyjnej powiązanego z produktem. Jeśli zasada jest skonfigurowana, element creative_slot na poziomie zdarzenia jest ignorowany.
Jeśli zasada jest nieskonfigurowana, używany jest creative_slot na poziomie zdarzenia (jeśli jest dostępny). |
discount |
number |
Nie | 2,22 | Wartość rabatu kwotowego powiązanego z produktem. |
index |
number |
Nie | 5 | Indeks/pozycja elementu na liście. |
item_brand |
string |
Nie | Marka produktu. | |
item_category |
string |
Nie | Odzież | Kategoria produktu. Jeśli używasz ich w ramach hierarchii kategorii lub taksonomii, jest 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ótkie rękawy | 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 zasada jest skonfigurowana, element item_list_id na poziomie zdarzenia jest ignorowany.
Jeśli zasada jest nieskonfigurowana, używany jest item_list_id na poziomie zdarzenia (jeśli jest dostępny).
|
item_list_name |
string |
Nie | Produkty powiązane | Nazwa listy, na której produkt został przedstawiony użytkownikowi. Jeśli zasada jest skonfigurowana, element item_list_name na poziomie zdarzenia jest ignorowany.
Jeśli zasada jest nieskonfigurowana, używany jest item_list_name na poziomie zdarzenia (jeśli jest dostępny).
|
item_variant |
string |
Nie | zielony | Wersja produktu, unikalny kod lub opis dodatkowych szczegółów lub opcji produktu. |
location_id |
string |
Nie | ChIJIQBpAG2ahYAR_6128GcTUEo (identyfikator Miejsc Google dla San Francisco) |
Lokalizacja fizyczna powiązana z produktem (np. lokalizacja sklepu stacjonarnego). Zalecamy użycie identyfikatora miejsca Google powiązanego z powiązanym elementem. Możesz też użyć niestandardowego identyfikatora lokalizacji. Uwaga: „identyfikator lokalizacji” jest dostępny tylko w zakresie elementu. |
price |
number |
Nie | 10,01 |
Pieniężna cena jednostkowa produktu w jednostkach określonego parametru waluty.
Jeśli rabat ma zastosowanie do produktu, ustaw wartość price na obniżoną cenę jednostkowej i podaj rabat za jednostkę w parametrze discount .
|
promotion_id |
string |
Nie | P_12345 |
Identyfikator promocji powiązanej z produktem. Jeśli zasada jest skonfigurowana, element promotion_id na poziomie zdarzenia jest ignorowany.
Jeśli zasada jest nieskonfigurowana, używany jest promotion_id na poziomie zdarzenia (jeśli jest dostępny).
|
promotion_name |
string |
Nie | Letnia wyprzedaż |
Nazwa promocji powiązanej z produktem. Jeśli zasada jest skonfigurowana, element promotion_name na poziomie zdarzenia jest ignorowany.
Jeśli zasada jest nieskonfigurowana, używany jest promotion_name na poziomie zdarzenia (jeśli jest dostępny).
|
quantity |
number |
Nie | 3 |
Liczba sztuk produktu. |
items
możesz umieścić maksymalnie 27 parametrów niestandardowych.
Przykład
Ten przykład dotyczy implementacji za pomocą 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
– {{Elementy e-commerce}}value
– {{Wartość e-commerce}}currency
– {{waluta e-commerce}}- Reguła: zdarzenie równa się view_item
Konfiguracja aktywatora:
- 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żytkownikowi zostanie wyświetlona lista elementów z określonej kategorii.
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 ustawiono na poziomie produktu. |
item_list_name |
string |
Nie | Produkty powiązane | Nazwa listy, na której produkt został przedstawiony użytkownikowi. Ignorowane, jeśli ustawiono na poziomie produktu. |
items |
Array<Item> |
Tak | Elementy związane z wydarzeniem. |
Parametry obiektu item
Nazwa | Typ | Wymagane | Przykładowa wartość | Opis |
---|---|---|---|---|
item_id |
string |
Tak* | SKU_12345 |
Identyfikator elementu.
*Wymagana jest wartość z pola |
item_name |
string |
Tak* | Koszulka ze Stanem i przyjaciółmi |
Nazwa produktu.
*Wymagana jest wartość z pola |
affiliation |
string |
Nie | Google Store |
Przynależność do usługi służąca do wyznaczenia firmy dostarczającej lub sklepu stacjonarnego. Uwaga: atrybut „przynależność” jest dostępny tylko w zakresie elementu. |
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 zasada jest skonfigurowana, element creative_name na poziomie zdarzenia jest ignorowany.
Jeśli zasada jest nieskonfigurowana, używany jest creative_name na poziomie zdarzenia (jeśli jest dostępny). |
creative_slot |
string |
Nie | featured_app_1 | Nazwa boksu kreacji promocyjnej powiązanego z produktem. Jeśli zasada jest skonfigurowana, element creative_slot na poziomie zdarzenia jest ignorowany.
Jeśli zasada jest nieskonfigurowana, używany jest creative_slot na poziomie zdarzenia (jeśli jest dostępny). |
discount |
number |
Nie | 2,22 | Wartość rabatu kwotowego powiązanego z produktem. |
index |
number |
Nie | 5 | Indeks/pozycja elementu na liście. |
item_brand |
string |
Nie | Marka produktu. | |
item_category |
string |
Nie | Odzież | Kategoria produktu. Jeśli używasz ich w ramach hierarchii kategorii lub taksonomii, jest 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ótkie rękawy | 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 zasada jest skonfigurowana, element item_list_id na poziomie zdarzenia jest ignorowany.
Jeśli zasada jest nieskonfigurowana, używany jest item_list_id na poziomie zdarzenia (jeśli jest dostępny).
|
item_list_name |
string |
Nie | Produkty powiązane | Nazwa listy, na której produkt został przedstawiony użytkownikowi. Jeśli zasada jest skonfigurowana, element item_list_name na poziomie zdarzenia jest ignorowany.
Jeśli zasada jest nieskonfigurowana, używany jest item_list_name na poziomie zdarzenia (jeśli jest dostępny).
|
item_variant |
string |
Nie | zielony | Wersja produktu, unikalny kod lub opis dodatkowych szczegółów lub opcji produktu. |
location_id |
string |
Nie | ChIJIQBpAG2ahYAR_6128GcTUEo (identyfikator Miejsc Google dla San Francisco) |
Lokalizacja fizyczna powiązana z produktem (np. lokalizacja sklepu stacjonarnego). Zalecamy użycie identyfikatora miejsca Google powiązanego z powiązanym elementem. Możesz też użyć niestandardowego identyfikatora lokalizacji. Uwaga: „identyfikator lokalizacji” jest dostępny tylko w zakresie elementu. |
price |
number |
Nie | 10,01 |
Pieniężna cena jednostkowa produktu w jednostkach określonego parametru waluty.
Jeśli rabat ma zastosowanie do produktu, ustaw wartość price na obniżoną cenę jednostkowej i podaj rabat za jednostkę w parametrze discount .
|
promotion_id |
string |
Nie | P_12345 |
Identyfikator promocji powiązanej z produktem. Jeśli zasada jest skonfigurowana, element promotion_id na poziomie zdarzenia jest ignorowany.
Jeśli zasada jest nieskonfigurowana, używany jest promotion_id na poziomie zdarzenia (jeśli jest dostępny).
|
promotion_name |
string |
Nie | Letnia wyprzedaż |
Nazwa promocji powiązanej z produktem. Jeśli zasada jest skonfigurowana, element promotion_name na poziomie zdarzenia jest ignorowany.
Jeśli zasada jest nieskonfigurowana, używany jest promotion_name na poziomie zdarzenia (jeśli jest dostępny).
|
quantity |
number |
Nie | 3 |
Liczba sztuk produktu. |
items
możesz umieścić maksymalnie 27 parametrów niestandardowych.
Przykład
Ten przykład dotyczy implementacji za pomocą Menedżera tagów:
Pokaż konfigurację tagu
Konfiguracja tagu:
- Typ tagu: zdarzenie GA4
- Nazwa zdarzenia:
view_item_list
- Zmienne warstwy danych (nazwa – nazwa zmiennej warstwy danych):
- Elementy e-commerce –
ecommerce.items
- Identyfikator listy produktów e-commerce –
ecommerce.item_list_id
- Nazwa listy elementów e-commerce –
ecommerce.item_list_name
- Parametry zdarzenia (nazwa parametru – wartość):
items
– {{Elementy e-commerce}}item_list_id
– {{identyfikator listy elementów e-commerce}}item_list_name
– {{nazwa listy elementów e-commerce}}- Reguła: zdarzenie równa się view_item_list
Konfiguracja aktywatora:
- 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 wydarzenie oznacza, że promocja została wyświetlona z listy.
Parametry
Nazwa | Typ | Wymagane | Przykładowa wartość | Opis |
---|---|---|---|---|
creative_name |
string |
Nie | summer_banner2 | Nazwa kreacji promocyjnej. Ignorowane, jeśli ustawiono na poziomie produktu. |
creative_slot |
string |
Nie | featured_app_1 | Nazwa boksu kreacji promocyjnej powiązanego ze zdarzeniem. Ignorowane, jeśli ustawiono na poziomie produktu. |
promotion_id |
string |
Nie | P_12345 |
Identyfikator promocji powiązanej ze zdarzeniem. Ignorowane, jeśli ustawiono na poziomie produktu. |
promotion_name |
string |
Nie | Letnia wyprzedaż |
Nazwa promocji powiązanej ze zdarzeniem. Ignorowane, jeśli ustawiono na poziomie produktu. |
items |
Array<Item> |
Tak* | Elementy związane z wydarzeniem. * Tablica items powinna zawierać jeden element, który reprezentuje element powiązany z promocją. Jeśli podasz wiele elementów, używany będzie tylko pierwszy z nich items .
|
Parametry obiektu item
Nazwa | Typ | Wymagane | Przykładowa wartość | Opis |
---|---|---|---|---|
item_id |
string |
Tak* | SKU_12345 |
Identyfikator elementu.
*Wymagana jest wartość z pola |
item_name |
string |
Tak* | Koszulka ze Stanem i przyjaciółmi |
Nazwa produktu.
*Wymagana jest wartość z pola |
affiliation |
string |
Nie | Google Store |
Przynależność do usługi służąca do wyznaczenia firmy dostarczającej lub sklepu stacjonarnego. Uwaga: atrybut „przynależność” jest dostępny tylko w zakresie elementu. |
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 zasada jest skonfigurowana, element creative_name na poziomie zdarzenia jest ignorowany.
Jeśli zasada jest nieskonfigurowana, używany jest creative_name na poziomie zdarzenia (jeśli jest dostępny). |
creative_slot |
string |
Nie | featured_app_1 | Nazwa boksu kreacji promocyjnej powiązanego z produktem. Jeśli zasada jest skonfigurowana, element creative_slot na poziomie zdarzenia jest ignorowany.
Jeśli zasada jest nieskonfigurowana, używany jest creative_slot na poziomie zdarzenia (jeśli jest dostępny). |
discount |
number |
Nie | 2,22 | Wartość rabatu kwotowego powiązanego z produktem. |
index |
number |
Nie | 5 | Indeks/pozycja elementu na liście. |
item_brand |
string |
Nie | Marka produktu. | |
item_category |
string |
Nie | Odzież | Kategoria produktu. Jeśli używasz ich w ramach hierarchii kategorii lub taksonomii, jest 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ótkie rękawy | 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 zasada jest skonfigurowana, element item_list_id na poziomie zdarzenia jest ignorowany.
Jeśli zasada jest nieskonfigurowana, używany jest item_list_id na poziomie zdarzenia (jeśli jest dostępny).
|
item_list_name |
string |
Nie | Produkty powiązane | Nazwa listy, na której produkt został przedstawiony użytkownikowi. Jeśli zasada jest skonfigurowana, element item_list_name na poziomie zdarzenia jest ignorowany.
Jeśli zasada jest nieskonfigurowana, używany jest item_list_name na poziomie zdarzenia (jeśli jest dostępny).
|
item_variant |
string |
Nie | zielony | Wersja produktu, unikalny kod lub opis dodatkowych szczegółów lub opcji produktu. |
location_id |
string |
Nie | ChIJIQBpAG2ahYAR_6128GcTUEo (identyfikator Miejsc Google dla San Francisco) |
Lokalizacja fizyczna powiązana z produktem (np. lokalizacja sklepu stacjonarnego). Zalecamy użycie identyfikatora miejsca Google powiązanego z powiązanym elementem. Możesz też użyć niestandardowego identyfikatora lokalizacji. Uwaga: „identyfikator lokalizacji” jest dostępny tylko w zakresie elementu. |
price |
number |
Nie | 10,01 |
Pieniężna cena jednostkowa produktu w jednostkach określonego parametru waluty.
Jeśli rabat ma zastosowanie do produktu, ustaw wartość price na obniżoną cenę jednostkowej i podaj rabat za jednostkę w parametrze discount .
|
promotion_id |
string |
Nie | P_12345 |
Identyfikator promocji powiązanej z produktem. Jeśli zasada jest skonfigurowana, element promotion_id na poziomie zdarzenia jest ignorowany.
Jeśli zasada jest nieskonfigurowana, używany jest promotion_id na poziomie zdarzenia (jeśli jest dostępny).
|
promotion_name |
string |
Nie | Letnia wyprzedaż |
Nazwa promocji powiązanej z produktem. Jeśli zasada jest skonfigurowana, element promotion_name na poziomie zdarzenia jest ignorowany.
Jeśli zasada jest nieskonfigurowana, używany jest promotion_name na poziomie zdarzenia (jeśli jest dostępny).
|
quantity |
number |
Nie | 3 |
Liczba sztuk produktu. |
items
możesz umieścić maksymalnie 27 parametrów niestandardowych.
Przykład
Ten przykład dotyczy implementacji za pomocą 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
- Boks kreacji e-commerce –
ecommerce.creative_slot
- Identyfikator promocji e-commerce –
ecommerce.promotion_id
- Nazwa promocji e-commerce –
ecommerce.promotion_name
- Elementy e-commerce –
ecommerce.items
- Parametry zdarzenia (nazwa parametru – wartość):
creative_name
– {{Nazwa kreacji e-commerce}}creative_slot
– {{ boks kreacji e-commerce}}promotion_id
– {{identyfikator promocji e-commerce}}promotion_name
– {{Nazwa promocji e-commerce}}items
– {{Elementy e-commerce}}- Reguła: zdarzenie równa się view_promotion
Konfiguracja aktywatora:
- 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
}
]
}
});