Google Analytics wysyła niektóre typy zdarzeń . Ta strona opisuje opcjonalne, dodatkowe zdarzenia, które możesz skonfigurować, aby mierzyć więcej zdarzeń. zachowaniach użytkowników i generować raporty przydatniejsze dla Twojej firmy. Te dodatkowe aby można było korzystać z zdarzeń, ich skonfigurowanie wymaga więcej wysiłku, dlatego Google Analytics 4 nie może ich wysyłać automatycznie. Szczegółowe instrukcje, jak to zrobić do konfigurowania zalecanych i niestandardowych zdarzeń dla witryny lub aplikacji znajdziesz w artykule Konfigurowanie wydarzenia.
Aby wyświetlić szczegóły każdego zdarzenia, którego możesz użyć, wybierz platformę zarządzania tagami:
add_payment_info
To zdarzenie oznacza, że użytkownik przesłał swoje dane do płatności w 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 (w języku angielskim)
3-literowy
w formacie ISO 4217. * Jeśli ustawisz value , wartość currency jest wymagana
pozwala na precyzyjne obliczanie danych o przychodach.
|
value |
number |
Tak* | 30.03 | Wartość pieniężna zdarzenia. * Ustaw value na sumę wartości (price * quantity) dla wszystkich elementów w:
items Nie podawaj parametrów shipping ani tax .
* Pole value jest zwykle wymagane do przydatnego raportowania.
Jeśli zaznaczysz
jako konwersję, zalecamy
value
* Pole currency jest wymagane, jeśli masz ustawioną wartość value .
|
coupon |
string |
Nie | SUMMER_FUN | Nazwa lub kod kuponu powiązanego ze zdarzeniem. Parametry coupon na poziomie zdarzenia i produktu są:
niezależnego.
|
payment_type |
string |
Nie | Karta kredytowa | Wybrana forma płatności. |
items |
Array<Item> |
Tak | Elementy zdarzenia. |
Parametry obiektu item
Nazwa | Typ | Wymagane | Przykładowa wartość | Opis |
---|---|---|---|---|
item_id |
string |
Tak* | SKU_12345 |
Identyfikator elementu.
*Wymagana jest wartość |
item_name |
string |
Tak* | Koszulka „Stan and Friends” |
Nazwa elementu.
*Wymagana jest wartość |
affiliation |
string |
Nie | Google Store |
przynależność produktu do wyznaczenia firmy dostawcy lub sklepu stacjonarnego,
adresu sklepu stacjonarnego. Uwaga: atrybut „przynależność” jest dostępny tylko dla zakresu produktu. |
coupon |
string |
Nie | SUMMER_FUN | Nazwa lub kod kuponu powiązanego z produktem. Parametry coupon na poziomie zdarzenia i produktu są:
niezależnego.
|
discount |
number |
Nie | 2,22 | Wartość jednostkowego rabatu kwotowego powiązanego z produktem. |
index |
number |
Nie | 5 | Indeks lub pozycja elementu na liście. |
item_brand |
string |
Nie | Marka produktu. | |
item_category |
string |
Nie | Odzież | Kategoria produktu. jeśli są częścią hierarchii kategorii lub taksonomia, będzie to pierwsza kategoria. |
item_category2 |
string |
Nie | Dorosły | Druga hierarchia kategorii lub dodatkowa taksonomia 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 taksonomia elementu. |
item_category5 |
string |
Nie | Krótkie rękawy | Piąta hierarchia kategorii lub dodatkowa taksonomia elementu. |
item_list_id |
string |
Nie | related_products | Identyfikator listy, na której produkt został przedstawiony użytkownikowi. Jeśli jest ustawione, parametr item_list_id na poziomie zdarzenia jest ignorowany.
Jeśli zasada jest nieskonfigurowana, używana jest wartość item_list_id na poziomie zdarzenia (jeśli nie jest skonfigurowana)
obecnie.
|
item_list_name |
string |
Nie | Produkty powiązane | Nazwa listy, na której produkt został przedstawiony użytkownikowi. Jeśli jest ustawione, parametr item_list_name na poziomie zdarzenia jest ignorowany.
Jeśli zasada jest nieskonfigurowana, używana jest wartość item_list_name na poziomie zdarzenia (jeśli nie jest skonfigurowana)
obecnie.
|
item_variant |
string |
Nie | zielony | Wersja produktu, czyli niepowtarzalny kod lub opis dodatkowego produktu. szczegóły/opcje. |
location_id |
string |
Nie | ChIJIQBpAG2ahYAR_6128GcTUEo (identyfikator Miejsc Google dla San Francisco) |
Fizyczna lokalizacja związana z produktem (np.
lokalizacja sklepu). Zalecamy używanie metody
Google
Identyfikator miejsca, który odpowiada powiązanemu produktowi. Lokalizacja niestandardowa
Możesz też użyć identyfikatora. Uwaga: pole „identyfikator lokalizacji” jest dostępne tylko w zakresie produktu. |
price |
number |
Nie | 10.01 |
Cena jednostkowa produktu w określonej walucie.
.
Jeśli rabat ma zastosowanie do produktu, ustaw price na obniżoną cenę za jednostkę i
określ zniżkę za jednostkę w parametrze discount .
|
quantity |
number |
Nie | 3 |
Liczba sztuk produktu. |
items
.
Przykład
Poniższy 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):
- Produkty 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 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 (w języku angielskim)
3-literowy
w formacie ISO 4217. * Jeśli ustawisz value , wartość currency jest wymagana
pozwala na precyzyjne obliczanie danych o przychodach.
|
value |
number |
Tak* | 30.03 | Wartość pieniężna zdarzenia. * Ustaw value na sumę wartości (price * quantity) dla wszystkich elementów w:
items Nie podawaj parametrów shipping ani tax .
* Pole value jest zwykle wymagane do przydatnego raportowania.
Jeśli zaznaczysz
jako konwersję, zalecamy
value
* Pole currency jest wymagane, jeśli masz ustawioną wartość value .
|
coupon |
string |
Nie | SUMMER_FUN | Nazwa lub kod kuponu powiązanego ze zdarzeniem. Parametry coupon na poziomie zdarzenia i produktu są:
niezależnego.
|
shipping_tier |
string |
Nie | Ziemia |
Poziom dostawy (np. Ground , Air ,
Next-day ) wybrano do dostawy zakupionego produktu.
|
items |
Array<Item> |
Tak | Elementy zdarzenia. |
Parametry obiektu item
Nazwa | Typ | Wymagane | Przykładowa wartość | Opis |
---|---|---|---|---|
item_id |
string |
Tak* | SKU_12345 |
Identyfikator elementu.
*Wymagana jest wartość |
item_name |
string |
Tak* | Koszulka „Stan and Friends” |
Nazwa elementu.
*Wymagana jest wartość |
affiliation |
string |
Nie | Google Store |
przynależność produktu do wyznaczenia firmy dostawcy lub sklepu stacjonarnego,
adresu sklepu stacjonarnego. Uwaga: atrybut „przynależność” jest dostępny tylko dla zakresu produktu. |
coupon |
string |
Nie | SUMMER_FUN | Nazwa lub kod kuponu powiązanego z produktem. Parametry coupon na poziomie zdarzenia i produktu są:
niezależnego.
|
discount |
number |
Nie | 2,22 | Wartość jednostkowego rabatu kwotowego powiązanego z produktem. |
index |
number |
Nie | 5 | Indeks lub pozycja elementu na liście. |
item_brand |
string |
Nie | Marka produktu. | |
item_category |
string |
Nie | Odzież | Kategoria produktu. jeśli są częścią hierarchii kategorii lub taksonomia, będzie to pierwsza kategoria. |
item_category2 |
string |
Nie | Dorosły | Druga hierarchia kategorii lub dodatkowa taksonomia 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 taksonomia elementu. |
item_category5 |
string |
Nie | Krótkie rękawy | Piąta hierarchia kategorii lub dodatkowa taksonomia elementu. |
item_list_id |
string |
Nie | related_products | Identyfikator listy, na której produkt został przedstawiony użytkownikowi. Jeśli jest ustawione, parametr item_list_id na poziomie zdarzenia jest ignorowany.
Jeśli zasada jest nieskonfigurowana, używana jest wartość item_list_id na poziomie zdarzenia (jeśli nie jest skonfigurowana)
obecnie.
|
item_list_name |
string |
Nie | Produkty powiązane | Nazwa listy, na której produkt został przedstawiony użytkownikowi. Jeśli jest ustawione, parametr item_list_name na poziomie zdarzenia jest ignorowany.
Jeśli zasada jest nieskonfigurowana, używana jest wartość item_list_name na poziomie zdarzenia (jeśli nie jest skonfigurowana)
obecnie.
|
item_variant |
string |
Nie | zielony | Wersja produktu, czyli niepowtarzalny kod lub opis dodatkowego produktu. szczegóły/opcje. |
location_id |
string |
Nie | ChIJIQBpAG2ahYAR_6128GcTUEo (identyfikator Miejsc Google dla San Francisco) |
Fizyczna lokalizacja związana z produktem (np.
lokalizacja sklepu). Zalecamy używanie metody
Google
Identyfikator miejsca, który odpowiada powiązanemu produktowi. Lokalizacja niestandardowa
Możesz też użyć identyfikatora. Uwaga: pole „identyfikator lokalizacji” jest dostępne tylko w zakresie produktu. |
price |
number |
Nie | 10.01 |
Cena jednostkowa produktu w określonej walucie.
.
Jeśli rabat ma zastosowanie do produktu, ustaw price na obniżoną cenę za jednostkę i
określ zniżkę za jednostkę w parametrze discount .
|
quantity |
number |
Nie | 3 |
Liczba sztuk produktu. |
items
.
Przykład
Poniższy 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):
- Produkty 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}}- Aktywator: 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 (w języku angielskim)
3-literowy
w formacie ISO 4217. * Jeśli ustawisz value , wartość currency jest wymagana
pozwala na precyzyjne obliczanie danych o przychodach.
|
value |
number |
Tak* | 30.03 | Wartość pieniężna zdarzenia. * Ustaw value na sumę wartości (price * quantity) dla wszystkich elementów w:
items Nie podawaj parametrów shipping ani tax .
* Pole value jest zwykle wymagane do przydatnego raportowania.
Jeśli zaznaczysz
jako konwersję, zalecamy
value
* Pole currency jest wymagane, jeśli masz ustawioną wartość value .
|
items |
Array<Item> |
Tak | Elementy zdarzenia. |
Parametry obiektu item
Nazwa | Typ | Wymagane | Przykładowa wartość | Opis |
---|---|---|---|---|
item_id |
string |
Tak* | SKU_12345 |
Identyfikator elementu.
*Wymagana jest wartość |
item_name |
string |
Tak* | Koszulka „Stan and Friends” |
Nazwa elementu.
*Wymagana jest wartość |
affiliation |
string |
Nie | Google Store |
przynależność produktu do wyznaczenia firmy dostawcy lub sklepu stacjonarnego,
adresu sklepu stacjonarnego. Uwaga: atrybut „przynależność” jest dostępny tylko dla zakresu produktu. |
coupon |
string |
Nie | SUMMER_FUN | Nazwa lub kod kuponu powiązanego z produktem. Parametry coupon na poziomie zdarzenia i produktu są:
niezależnego.
|
discount |
number |
Nie | 2,22 | Wartość jednostkowego rabatu kwotowego powiązanego z produktem. |
index |
number |
Nie | 5 | Indeks lub pozycja elementu na liście. |
item_brand |
string |
Nie | Marka produktu. | |
item_category |
string |
Nie | Odzież | Kategoria produktu. jeśli są częścią hierarchii kategorii lub taksonomia, będzie to pierwsza kategoria. |
item_category2 |
string |
Nie | Dorosły | Druga hierarchia kategorii lub dodatkowa taksonomia 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 taksonomia elementu. |
item_category5 |
string |
Nie | Krótkie rękawy | Piąta hierarchia kategorii lub dodatkowa taksonomia elementu. |
item_list_id |
string |
Nie | related_products | Identyfikator listy, na której produkt został przedstawiony użytkownikowi. Jeśli jest ustawione, parametr item_list_id na poziomie zdarzenia jest ignorowany.
Jeśli zasada jest nieskonfigurowana, używana jest wartość item_list_id na poziomie zdarzenia (jeśli nie jest skonfigurowana)
obecnie.
|
item_list_name |
string |
Nie | Produkty powiązane | Nazwa listy, na której produkt został przedstawiony użytkownikowi. Jeśli jest ustawione, parametr item_list_name na poziomie zdarzenia jest ignorowany.
Jeśli zasada jest nieskonfigurowana, używana jest wartość item_list_name na poziomie zdarzenia (jeśli nie jest skonfigurowana)
obecnie.
|
item_variant |
string |
Nie | zielony | Wersja produktu, czyli niepowtarzalny kod lub opis dodatkowego produktu. szczegóły/opcje. |
location_id |
string |
Nie | ChIJIQBpAG2ahYAR_6128GcTUEo (identyfikator Miejsc Google dla San Francisco) |
Fizyczna lokalizacja związana z produktem (np.
lokalizacja sklepu). Zalecamy używanie metody
Google
Identyfikator miejsca, który odpowiada powiązanemu produktowi. Lokalizacja niestandardowa
Możesz też użyć identyfikatora. Uwaga: pole „identyfikator lokalizacji” jest dostępne tylko w zakresie produktu. |
price |
number |
Nie | 10.01 |
Cena jednostkowa produktu w określonej walucie.
.
Jeśli rabat ma zastosowanie do produktu, ustaw price na obniżoną cenę za jednostkę i
określ zniżkę za jednostkę w parametrze discount .
|
quantity |
number |
Nie | 3 |
Liczba sztuk produktu. |
items
.
Przykład
Poniższy 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):
- Produkty 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}}- Aktywator: 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, że produkt został dodany do listy życzeń. Użyj tego zdarzenia, aby: identyfikować popularne prezenty w aplikacji.
Parametry
Nazwa | Typ | Wymagane | Przykładowa wartość | Opis |
---|---|---|---|---|
currency |
string |
Tak* | USD |
Waluta elementów powiązanych ze zdarzeniem (w języku angielskim)
3-literowy
w formacie ISO 4217. * Jeśli ustawisz value , wartość currency jest wymagana
pozwala na precyzyjne obliczanie danych o przychodach.
|
value |
number |
Tak* | 30.03 | Wartość pieniężna zdarzenia. * Ustaw value na sumę wartości (price * quantity) dla wszystkich elementów w:
items Nie podawaj parametrów shipping ani tax .
* Pole value jest zwykle wymagane do przydatnego raportowania.
Jeśli zaznaczysz
jako konwersję, zalecamy
value
* Pole currency jest wymagane, jeśli masz ustawioną wartość value .
|
items |
Array<Item> |
Tak | Elementy zdarzenia. |
Parametry obiektu item
Nazwa | Typ | Wymagane | Przykładowa wartość | Opis |
---|---|---|---|---|
item_id |
string |
Tak* | SKU_12345 |
Identyfikator elementu.
*Wymagana jest wartość |
item_name |
string |
Tak* | Koszulka „Stan and Friends” |
Nazwa elementu.
*Wymagana jest wartość |
affiliation |
string |
Nie | Google Store |
przynależność produktu do wyznaczenia firmy dostawcy lub sklepu stacjonarnego,
adresu sklepu stacjonarnego. Uwaga: atrybut „przynależność” jest dostępny tylko dla zakresu produktu. |
coupon |
string |
Nie | SUMMER_FUN | Nazwa lub kod kuponu powiązanego z produktem. Parametry coupon na poziomie zdarzenia i produktu są:
niezależnego.
|
discount |
number |
Nie | 2,22 | Wartość jednostkowego rabatu kwotowego powiązanego z produktem. |
index |
number |
Nie | 5 | Indeks lub pozycja elementu na liście. |
item_brand |
string |
Nie | Marka produktu. | |
item_category |
string |
Nie | Odzież | Kategoria produktu. jeśli są częścią hierarchii kategorii lub taksonomia, będzie to pierwsza kategoria. |
item_category2 |
string |
Nie | Dorosły | Druga hierarchia kategorii lub dodatkowa taksonomia 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 taksonomia elementu. |
item_category5 |
string |
Nie | Krótkie rękawy | Piąta hierarchia kategorii lub dodatkowa taksonomia elementu. |
item_list_id |
string |
Nie | related_products | Identyfikator listy, na której produkt został przedstawiony użytkownikowi. Jeśli jest ustawione, parametr item_list_id na poziomie zdarzenia jest ignorowany.
Jeśli zasada jest nieskonfigurowana, używana jest wartość item_list_id na poziomie zdarzenia (jeśli nie jest skonfigurowana)
obecnie.
|
item_list_name |
string |
Nie | Produkty powiązane | Nazwa listy, na której produkt został przedstawiony użytkownikowi. Jeśli jest ustawione, parametr item_list_name na poziomie zdarzenia jest ignorowany.
Jeśli zasada jest nieskonfigurowana, używana jest wartość item_list_name na poziomie zdarzenia (jeśli nie jest skonfigurowana)
obecnie.
|
item_variant |
string |
Nie | zielony | Wersja produktu, czyli niepowtarzalny kod lub opis dodatkowego produktu. szczegóły/opcje. |
location_id |
string |
Nie | ChIJIQBpAG2ahYAR_6128GcTUEo (identyfikator Miejsc Google dla San Francisco) |
Fizyczna lokalizacja związana z produktem (np.
lokalizacja sklepu). Zalecamy używanie metody
Google
Identyfikator miejsca, który odpowiada powiązanemu produktowi. Lokalizacja niestandardowa
Możesz też użyć identyfikatora. Uwaga: pole „identyfikator lokalizacji” jest dostępne tylko w zakresie produktu. |
price |
number |
Nie | 10.01 |
Cena jednostkowa produktu w określonej walucie.
.
Jeśli rabat ma zastosowanie do produktu, ustaw price na obniżoną cenę za jednostkę i
określ zniżkę za jednostkę w parametrze discount .
|
quantity |
number |
Nie | 3 |
Liczba sztuk produktu. |
items
.
Przykład
Poniższy 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):
- Produkty 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 (w języku angielskim)
3-literowy
w formacie ISO 4217. * Jeśli ustawisz value , wartość currency jest wymagana
pozwala na precyzyjne obliczanie danych o przychodach.
|
value |
number |
Tak* | 30.03 | Wartość pieniężna zdarzenia. * Ustaw value na sumę wartości (price * quantity) dla wszystkich elementów w:
items Nie podawaj parametrów shipping ani tax .
* Pole value jest zwykle wymagane do przydatnego raportowania.
Jeśli zaznaczysz
jako konwersję, zalecamy
value
* Pole currency jest wymagane, jeśli masz ustawioną wartość value .
|
coupon |
string |
Nie | SUMMER_FUN | Nazwa lub kod kuponu powiązanego ze zdarzeniem. Parametry coupon na poziomie zdarzenia i produktu są:
niezależnego.
|
items |
Array<Item> |
Tak | Elementy zdarzenia. |
Parametry obiektu item
Nazwa | Typ | Wymagane | Przykładowa wartość | Opis |
---|---|---|---|---|
item_id |
string |
Tak* | SKU_12345 |
Identyfikator elementu.
*Wymagana jest wartość |
item_name |
string |
Tak* | Koszulka „Stan and Friends” |
Nazwa elementu.
*Wymagana jest wartość |
affiliation |
string |
Nie | Google Store |
przynależność produktu do wyznaczenia firmy dostawcy lub sklepu stacjonarnego,
adresu sklepu stacjonarnego. Uwaga: atrybut „przynależność” jest dostępny tylko dla zakresu produktu. |
coupon |
string |
Nie | SUMMER_FUN | Nazwa lub kod kuponu powiązanego z produktem. Parametry coupon na poziomie zdarzenia i produktu są:
niezależnego.
|
discount |
number |
Nie | 2,22 | Wartość jednostkowego rabatu kwotowego powiązanego z produktem. |
index |
number |
Nie | 5 | Indeks lub pozycja elementu na liście. |
item_brand |
string |
Nie | Marka produktu. | |
item_category |
string |
Nie | Odzież | Kategoria produktu. jeśli są częścią hierarchii kategorii lub taksonomia, będzie to pierwsza kategoria. |
item_category2 |
string |
Nie | Dorosły | Druga hierarchia kategorii lub dodatkowa taksonomia 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 taksonomia elementu. |
item_category5 |
string |
Nie | Krótkie rękawy | Piąta hierarchia kategorii lub dodatkowa taksonomia elementu. |
item_list_id |
string |
Nie | related_products | Identyfikator listy, na której produkt został przedstawiony użytkownikowi. Jeśli jest ustawione, parametr item_list_id na poziomie zdarzenia jest ignorowany.
Jeśli zasada jest nieskonfigurowana, używana jest wartość item_list_id na poziomie zdarzenia (jeśli nie jest skonfigurowana)
obecnie.
|
item_list_name |
string |
Nie | Produkty powiązane | Nazwa listy, na której produkt został przedstawiony użytkownikowi. Jeśli jest ustawione, parametr item_list_name na poziomie zdarzenia jest ignorowany.
Jeśli zasada jest nieskonfigurowana, używana jest wartość item_list_name na poziomie zdarzenia (jeśli nie jest skonfigurowana)
obecnie.
|
item_variant |
string |
Nie | zielony | Wersja produktu, czyli niepowtarzalny kod lub opis dodatkowego produktu. szczegóły/opcje. |
location_id |
string |
Nie | ChIJIQBpAG2ahYAR_6128GcTUEo (identyfikator Miejsc Google dla San Francisco) |
Fizyczna lokalizacja związana z produktem (np.
lokalizacja sklepu). Zalecamy używanie metody
Google
Identyfikator miejsca, który odpowiada powiązanemu produktowi. Lokalizacja niestandardowa
Możesz też użyć identyfikatora. Uwaga: pole „identyfikator lokalizacji” jest dostępne tylko w zakresie produktu. |
price |
number |
Nie | 10.01 |
Cena jednostkowa produktu w określonej walucie.
.
Jeśli rabat ma zastosowanie do produktu, ustaw price na obniżoną cenę za jednostkę i
określ zniżkę za jednostkę w parametrze discount .
|
quantity |
number |
Nie | 3 |
Liczba sztuk produktu. |
items
.
Przykład
Poniższy 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):
- Produkty 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ę rozpoczęciu_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
}
]
}
});
close_convert_lead
Mierzy ono konwersje i zamknięcie potencjalnego klienta (np. przez zakup).
Parametry
Nazwa | Typ | Wymagane | Przykładowa wartość | Opis |
---|---|---|---|---|
currency |
string |
Tak* | USD |
Waluta elementów powiązanych ze zdarzeniem (w języku angielskim)
3-literowy
w formacie ISO 4217. * Jeśli ustawisz value , wartość currency jest wymagana
pozwala na precyzyjne obliczanie danych o przychodach.
|
value |
number |
Tak* | 30.03 | Wartość pieniężna zdarzenia. * Ustaw value na sumę wartości (price * quantity) dla wszystkich elementów w:
items Nie podawaj parametrów shipping ani tax .
* Pole value jest zwykle wymagane do przydatnego raportowania.
Jeśli zaznaczysz
jako konwersję, zalecamy
value
* Pole currency jest wymagane, jeśli masz ustawioną wartość value .
|
items |
Array<Item>
|
Nie | Elementy zdarzenia. |
Parametry obiektu item
Nazwa | Typ | Wymagane | Przykładowa wartość | Opis |
---|---|---|---|---|
item_id |
string |
Tak* | SKU_12345 |
Identyfikator elementu.
*Wymagana jest wartość |
item_name |
string |
Tak* | Koszulka „Stan and Friends” |
Nazwa elementu.
*Wymagana jest wartość |
affiliation |
string |
Nie | Google Store |
przynależność produktu do wyznaczenia firmy dostawcy lub sklepu stacjonarnego,
adresu sklepu stacjonarnego. Uwaga: atrybut „przynależność” jest dostępny tylko dla zakresu produktu. |
coupon |
string |
Nie | SUMMER_FUN | Nazwa lub kod kuponu powiązanego z produktem. Parametry coupon na poziomie zdarzenia i produktu są:
niezależnego.
|
discount |
number |
Nie | 2,22 | Wartość jednostkowego rabatu kwotowego powiązanego z produktem. |
index |
number |
Nie | 5 | Indeks lub pozycja elementu na liście. |
item_brand |
string |
Nie | Marka produktu. | |
item_category |
string |
Nie | Odzież | Kategoria produktu. jeśli są częścią hierarchii kategorii lub taksonomia, będzie to pierwsza kategoria. |
item_category2 |
string |
Nie | Dorosły | Druga hierarchia kategorii lub dodatkowa taksonomia 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 taksonomia elementu. |
item_category5 |
string |
Nie | Krótkie rękawy | Piąta hierarchia kategorii lub dodatkowa taksonomia elementu. |
item_list_id |
string |
Nie | related_products | Identyfikator listy, na której produkt został przedstawiony użytkownikowi. Jeśli jest ustawione, parametr item_list_id na poziomie zdarzenia jest ignorowany.
Jeśli zasada jest nieskonfigurowana, używana jest wartość item_list_id na poziomie zdarzenia (jeśli nie jest skonfigurowana)
obecnie.
|
item_list_name |
string |
Nie | Produkty powiązane | Nazwa listy, na której produkt został przedstawiony użytkownikowi. Jeśli jest ustawione, parametr item_list_name na poziomie zdarzenia jest ignorowany.
Jeśli zasada jest nieskonfigurowana, używana jest wartość item_list_name na poziomie zdarzenia (jeśli nie jest skonfigurowana)
obecnie.
|
item_variant |
string |
Nie | zielony | Wersja produktu, czyli niepowtarzalny kod lub opis dodatkowego produktu. szczegóły/opcje. |
location_id |
string |
Nie | ChIJIQBpAG2ahYAR_6128GcTUEo (identyfikator Miejsc Google dla San Francisco) |
Fizyczna lokalizacja związana z produktem (np.
lokalizacja sklepu). Zalecamy używanie metody
Google
Identyfikator miejsca, który odpowiada powiązanemu produktowi. Lokalizacja niestandardowa
Możesz też użyć identyfikatora. Uwaga: pole „identyfikator lokalizacji” jest dostępne tylko w zakresie produktu. |
price |
number |
Nie | 10.01 |
Cena jednostkowa produktu w określonej walucie.
.
Jeśli rabat ma zastosowanie do produktu, ustaw price na obniżoną cenę za jednostkę i
określ zniżkę za jednostkę w parametrze discount .
|
quantity |
number |
Nie | 3 |
Liczba sztuk produktu. |
items
.
Przykład
Poniższy przykład dotyczy implementacji za pomocą Menedżera tagów:
Pokaż konfigurację tagu
Konfiguracja tagu:
- Typ tagu: zdarzenie GA4
- Nazwa zdarzenia:
close_convert_lead
- Parametry zdarzenia (nazwa parametru – wartość):
currency
– USDvalue
- 30.03items
– {{Elementy e-commerce}}- Wywołuj zdarzenie, gdy użytkownik stanie się potencjalnym klientem, który dokonał konwersji (klientem)
close_unconvert_lead
Mierzy to przypadki, gdy użytkownik zostanie oznaczony jako niebędący potencjalnym klientem, który dokonał konwersji. wraz z przyczyną.
Parametry
Nazwa | Typ | Wymagane | Przykładowa wartość | Opis |
---|---|---|---|---|
currency |
string |
Tak* | USD |
Waluta elementów powiązanych ze zdarzeniem (w języku angielskim)
3-literowy
w formacie ISO 4217. * Jeśli ustawisz value , wartość currency jest wymagana
pozwala na precyzyjne obliczanie danych o przychodach.
|
value |
number |
Tak* | 30.03 | Wartość pieniężna zdarzenia. * Ustaw value na sumę wartości (price * quantity) dla wszystkich elementów w:
items Nie podawaj parametrów shipping ani tax .
* Pole value jest zwykle wymagane do przydatnego raportowania.
Jeśli zaznaczysz
jako konwersję, zalecamy
value
* Pole currency jest wymagane, jeśli masz ustawioną wartość value .
|
unconvert_lead_reason |
string |
Nie | Brak odpowiedzi | Powód cofnięcia konwersji potencjalnego klienta. |
items |
Array<Item>
|
Nie | Elementy zdarzenia. |
Parametry obiektu item
Nazwa | Typ | Wymagane | Przykładowa wartość | Opis |
---|---|---|---|---|
item_id |
string |
Tak* | SKU_12345 |
Identyfikator elementu.
*Wymagana jest wartość |
item_name |
string |
Tak* | Koszulka „Stan and Friends” |
Nazwa elementu.
*Wymagana jest wartość |
affiliation |
string |
Nie | Google Store |
przynależność produktu do wyznaczenia firmy dostawcy lub sklepu stacjonarnego,
adresu sklepu stacjonarnego. Uwaga: atrybut „przynależność” jest dostępny tylko dla zakresu produktu. |
coupon |
string |
Nie | SUMMER_FUN | Nazwa lub kod kuponu powiązanego z produktem. Parametry coupon na poziomie zdarzenia i produktu są:
niezależnego.
|
discount |
number |
Nie | 2,22 | Wartość jednostkowego rabatu kwotowego powiązanego z produktem. |
index |
number |
Nie | 5 | Indeks lub pozycja elementu na liście. |
item_brand |
string |
Nie | Marka produktu. | |
item_category |
string |
Nie | Odzież | Kategoria produktu. jeśli są częścią hierarchii kategorii lub taksonomia, będzie to pierwsza kategoria. |
item_category2 |
string |
Nie | Dorosły | Druga hierarchia kategorii lub dodatkowa taksonomia 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 taksonomia elementu. |
item_category5 |
string |
Nie | Krótkie rękawy | Piąta hierarchia kategorii lub dodatkowa taksonomia elementu. |
item_list_id |
string |
Nie | related_products | Identyfikator listy, na której produkt został przedstawiony użytkownikowi. Jeśli jest ustawione, parametr item_list_id na poziomie zdarzenia jest ignorowany.
Jeśli zasada jest nieskonfigurowana, używana jest wartość item_list_id na poziomie zdarzenia (jeśli nie jest skonfigurowana)
obecnie.
|
item_list_name |
string |
Nie | Produkty powiązane | Nazwa listy, na której produkt został przedstawiony użytkownikowi. Jeśli jest ustawione, parametr item_list_name na poziomie zdarzenia jest ignorowany.
Jeśli zasada jest nieskonfigurowana, używana jest wartość item_list_name na poziomie zdarzenia (jeśli nie jest skonfigurowana)
obecnie.
|
item_variant |
string |
Nie | zielony | Wersja produktu, czyli niepowtarzalny kod lub opis dodatkowego produktu. szczegóły/opcje. |
location_id |
string |
Nie | ChIJIQBpAG2ahYAR_6128GcTUEo (identyfikator Miejsc Google dla San Francisco) |
Fizyczna lokalizacja związana z produktem (np.
lokalizacja sklepu). Zalecamy używanie metody
Google
Identyfikator miejsca, który odpowiada powiązanemu produktowi. Lokalizacja niestandardowa
Możesz też użyć identyfikatora. Uwaga: pole „identyfikator lokalizacji” jest dostępne tylko w zakresie produktu. |
price |
number |
Nie | 10.01 |
Cena jednostkowa produktu w określonej walucie.
.
Jeśli rabat ma zastosowanie do produktu, ustaw price na obniżoną cenę za jednostkę i
określ zniżkę za jednostkę w parametrze discount .
|
quantity |
number |
Nie | 3 |
Liczba sztuk produktu. |
items
.
Przykład
Poniższy przykład dotyczy implementacji za pomocą Menedżera tagów:
Pokaż konfigurację tagu
Konfiguracja tagu:
- Typ tagu: zdarzenie GA4
- Nazwa zdarzenia:
close_unconvert_lead
- Parametry zdarzenia (nazwa parametru – wartość):
currency
– USDvalue
- 30.03items
– {{Elementy e-commerce}}- Wywołuj zdarzenie, gdy użytkownik zostanie oznaczony jako niebędący potencjalnym klientem, który dokonał konwersji z jednego z kilku powodów
disqualify_lead
Mierzy to przypadki, gdy użytkownik zostanie zdyskwalifikowany, aby zostać potencjalnym klientem. oraz powód dyskwalifikacji.
Parametry
Nazwa | Typ | Wymagane | Przykładowa wartość | Opis |
---|---|---|---|---|
currency |
string |
Tak* | USD |
Waluta elementów powiązanych ze zdarzeniem (w języku angielskim)
3-literowy
w formacie ISO 4217. * Jeśli ustawisz value , wartość currency jest wymagana
pozwala na precyzyjne obliczanie danych o przychodach.
|
value |
number |
Tak* | 30.03 | Wartość pieniężna zdarzenia. * Ustaw value na sumę wartości (price * quantity) dla wszystkich elementów w:
items Nie podawaj parametrów shipping ani tax .
* Pole value jest zwykle wymagane do przydatnego raportowania.
Jeśli zaznaczysz
jako konwersję, zalecamy
value
* Pole currency jest wymagane, jeśli masz ustawioną wartość value .
|
disqualified_lead_reason |
string |
Nie | Nie planuję zakupu | Powód oznaczenia potencjalnego klienta jako zdyskwalifikowany. |
items |
Array<Item>
|
Nie | Elementy zdarzenia. |
Parametry obiektu item
Nazwa | Typ | Wymagane | Przykładowa wartość | Opis |
---|---|---|---|---|
item_id |
string |
Tak* | SKU_12345 |
Identyfikator elementu.
*Wymagana jest wartość |
item_name |
string |
Tak* | Koszulka „Stan and Friends” |
Nazwa elementu.
*Wymagana jest wartość |
affiliation |
string |
Nie | Google Store |
przynależność produktu do wyznaczenia firmy dostawcy lub sklepu stacjonarnego,
adresu sklepu stacjonarnego. Uwaga: atrybut „przynależność” jest dostępny tylko dla zakresu produktu. |
coupon |
string |
Nie | SUMMER_FUN | Nazwa lub kod kuponu powiązanego z produktem. Parametry coupon na poziomie zdarzenia i produktu są:
niezależnego.
|
discount |
number |
Nie | 2,22 | Wartość jednostkowego rabatu kwotowego powiązanego z produktem. |
index |
number |
Nie | 5 | Indeks lub pozycja elementu na liście. |
item_brand |
string |
Nie | Marka produktu. | |
item_category |
string |
Nie | Odzież | Kategoria produktu. jeśli są częścią hierarchii kategorii lub taksonomia, będzie to pierwsza kategoria. |
item_category2 |
string |
Nie | Dorosły | Druga hierarchia kategorii lub dodatkowa taksonomia 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 taksonomia elementu. |
item_category5 |
string |
Nie | Krótkie rękawy | Piąta hierarchia kategorii lub dodatkowa taksonomia elementu. |
item_list_id |
string |
Nie | related_products | Identyfikator listy, na której produkt został przedstawiony użytkownikowi. Jeśli jest ustawione, parametr item_list_id na poziomie zdarzenia jest ignorowany.
Jeśli zasada jest nieskonfigurowana, używana jest wartość item_list_id na poziomie zdarzenia (jeśli nie jest skonfigurowana)
obecnie.
|
item_list_name |
string |
Nie | Produkty powiązane | Nazwa listy, na której produkt został przedstawiony użytkownikowi. Jeśli jest ustawione, parametr item_list_name na poziomie zdarzenia jest ignorowany.
Jeśli zasada jest nieskonfigurowana, używana jest wartość item_list_name na poziomie zdarzenia (jeśli nie jest skonfigurowana)
obecnie.
|
item_variant |
string |
Nie | zielony | Wersja produktu, czyli niepowtarzalny kod lub opis dodatkowego produktu. szczegóły/opcje. |
location_id |
string |
Nie | ChIJIQBpAG2ahYAR_6128GcTUEo (identyfikator Miejsc Google dla San Francisco) |
Fizyczna lokalizacja związana z produktem (np.
lokalizacja sklepu). Zalecamy używanie metody
Google
Identyfikator miejsca, który odpowiada powiązanemu produktowi. Lokalizacja niestandardowa
Możesz też użyć identyfikatora. Uwaga: pole „identyfikator lokalizacji” jest dostępne tylko w zakresie produktu. |
price |
number |
Nie | 10.01 |
Cena jednostkowa produktu w określonej walucie.
.
Jeśli rabat ma zastosowanie do produktu, ustaw price na obniżoną cenę za jednostkę i
określ zniżkę za jednostkę w parametrze discount .
|
quantity |
number |
Nie | 3 |
Liczba sztuk produktu. |
items
.
Przykład
Poniższy przykład dotyczy implementacji za pomocą Menedżera tagów:
Pokaż konfigurację tagu
Konfiguracja tagu:
- Typ tagu: zdarzenie GA4
- Nazwa zdarzenia:
disqualify_lead
- Parametry zdarzenia (nazwa parametru – wartość):
currency
– USDvalue
- 30.03disqualified_lead_reason
– nie chcę kupowaćitems
– {{Elementy e-commerce}}- Wywołuj zdarzenie, gdy użytkownik zostanie oznaczony jako zdyskwalifikowany jako potencjalny klient z jednego z kilku powodów
earn_virtual_currency
To zdarzenie mierzy, kiedy użytkownik otrzymuje wirtualną walutę w grze. Zarejestruj te dane razem z parametrem spend_virtual_currency, aby lepiej poznać gospodarki wirtualnej.
Parametry
Nazwa | Typ | Wymagane | Przykładowa wartość | Opis |
---|---|---|---|---|
virtual_currency_name |
string |
Nie | Gemy | Nazwa waluty wirtualnej. |
value |
number |
Nie | 5 | Wartość waluty wirtualnej. |
Przykład
Poniższy 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ływanie zdarzenia, gdy użytkownik otrzymuje wirtualną walutę
generate_lead
To zdarzenie mierzy, kiedy potencjalny klient został wygenerowany (np. przez ). Zapisuj te dane, aby oceniać skuteczność kampanii marketingowych ilu klientów ponownie wchodzi w interakcję z Twoją firmą po remarketingu klientów.
Parametry
Nazwa | Typ | Wymagane | Przykładowa wartość | Opis |
---|---|---|---|---|
currency |
string |
Tak* | USD |
Waluta elementów powiązanych ze zdarzeniem (w języku angielskim)
3-literowy
w formacie ISO 4217. * Jeśli ustawisz value , wartość currency jest wymagana
pozwala na precyzyjne obliczanie danych o przychodach.
|
value |
number |
Tak* | 30.03 | Wartość pieniężna zdarzenia. * Ustaw value na sumę wartości (price * quantity) dla wszystkich elementów w:
items Nie podawaj parametrów shipping ani tax .
* Pole value jest zwykle wymagane do przydatnego raportowania.
Jeśli zaznaczysz
jako konwersję, zalecamy
value
* Pole currency jest wymagane, jeśli masz ustawioną wartość value .
|
lead_source |
string |
Nie | Targi | Źródło potencjalnego klienta. |
items |
Array<Item>
|
Nie | Elementy zdarzenia. |
Parametry obiektu item
Nazwa | Typ | Wymagane | Przykładowa wartość | Opis |
---|---|---|---|---|
item_id |
string |
Tak* | SKU_12345 |
Identyfikator elementu.
*Wymagana jest wartość |
item_name |
string |
Tak* | Koszulka „Stan and Friends” |
Nazwa elementu.
*Wymagana jest wartość |
affiliation |
string |
Nie | Google Store |
przynależność produktu do wyznaczenia firmy dostawcy lub sklepu stacjonarnego,
adresu sklepu stacjonarnego. Uwaga: atrybut „przynależność” jest dostępny tylko dla zakresu produktu. |
coupon |
string |
Nie | SUMMER_FUN | Nazwa lub kod kuponu powiązanego z produktem. Parametry coupon na poziomie zdarzenia i produktu są:
niezależnego.
|
discount |
number |
Nie | 2,22 | Wartość jednostkowego rabatu kwotowego powiązanego z produktem. |
index |
number |
Nie | 5 | Indeks lub pozycja elementu na liście. |
item_brand |
string |
Nie | Marka produktu. | |
item_category |
string |
Nie | Odzież | Kategoria produktu. jeśli są częścią hierarchii kategorii lub taksonomia, będzie to pierwsza kategoria. |
item_category2 |
string |
Nie | Dorosły | Druga hierarchia kategorii lub dodatkowa taksonomia 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 taksonomia elementu. |
item_category5 |
string |
Nie | Krótkie rękawy | Piąta hierarchia kategorii lub dodatkowa taksonomia elementu. |
item_list_id |
string |
Nie | related_products | Identyfikator listy, na której produkt został przedstawiony użytkownikowi. Jeśli jest ustawione, parametr item_list_id na poziomie zdarzenia jest ignorowany.
Jeśli zasada jest nieskonfigurowana, używana jest wartość item_list_id na poziomie zdarzenia (jeśli nie jest skonfigurowana)
obecnie.
|
item_list_name |
string |
Nie | Produkty powiązane | Nazwa listy, na której produkt został przedstawiony użytkownikowi. Jeśli jest ustawione, parametr item_list_name na poziomie zdarzenia jest ignorowany.
Jeśli zasada jest nieskonfigurowana, używana jest wartość item_list_name na poziomie zdarzenia (jeśli nie jest skonfigurowana)
obecnie.
|
item_variant |
string |
Nie | zielony | Wersja produktu, czyli niepowtarzalny kod lub opis dodatkowego produktu. szczegóły/opcje. |
location_id |
string |
Nie | ChIJIQBpAG2ahYAR_6128GcTUEo (identyfikator Miejsc Google dla San Francisco) |
Fizyczna lokalizacja związana z produktem (np.
lokalizacja sklepu). Zalecamy używanie metody
Google
Identyfikator miejsca, który odpowiada powiązanemu produktowi. Lokalizacja niestandardowa
Możesz też użyć identyfikatora. Uwaga: pole „identyfikator lokalizacji” jest dostępne tylko w zakresie produktu. |
price |
number |
Nie | 10.01 |
Cena jednostkowa produktu w określonej walucie.
.
Jeśli rabat ma zastosowanie do produktu, ustaw price na obniżoną cenę za jednostkę i
określ zniżkę za jednostkę w parametrze discount .
|
quantity |
number |
Nie | 3 |
Liczba sztuk produktu. |
items
.
Przykład
Poniższy 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
- 30.03lead_source
– targiitems
– {{Elementy e-commerce}}- Wywołaj zdarzenie po wygenerowaniu potencjalnego klienta
join_group
Zarejestruj to zdarzenie, gdy użytkownik dołącza do grupy, np. do gildii, zespołu czy rodziny. Używaj to zdarzenie, aby przeanalizować 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
Poniższy 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ływanie zdarzenia, gdy użytkownik dołącza do grupy
level_end
To zdarzenie oznacza, że gracz osiągnął koniec poziomu w grze.
Parametry
Nazwa | Typ | Wymagane | Przykładowa wartość | Opis |
---|---|---|---|---|
level_name |
string |
Nie | Zaczynamy podróż... | Nazwa poziomu. |
success |
boolean |
Nie | prawda | Jeśli ukończono poziom, ustaw wartość true . |
Przykład
Poniższy 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
– rozpoczyna się podróż...- sukces – true
- Wywołuj, gdy gracz osiągnie koniec poziomu (np.wejdzie na stronę potwierdzenia poziomu).
level_start
To zdarzenie informuje, że gracz rozpoczął poziom w grze.
Parametry
Nazwa | Typ | Wymagane | Przykładowa wartość | Opis |
---|---|---|---|---|
level_name |
string |
Nie | Zaczynamy podróż... | Nazwa poziomu. |
Przykład
Poniższy 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
– rozpoczyna się podróż...- Wywołuj, gdy ktoś rozpocznie nowy poziom (np. na stronie początkowej poziomu)
level_up
To zdarzenie oznacza, że gracz przechodzi na wyższy poziom w grze. Umożliwia zmierzenie rozłożenie w grupie użytkowników i zidentyfikowanie poziomów, które są trudne do wykonania gotowe.
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
Poniższy 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
– gracz 1- Włącz, gdy gracz awansuje na nowy poziom
logowanie
Wyślij to zdarzenie, aby poinformować, że użytkownik zalogował się w Twojej witrynie lub aplikacji.
Parametry
Nazwa | Typ | Wymagane | Przykładowa wartość | Opis |
---|---|---|---|---|
method |
string |
Nie | Metoda użyta do logowania. |
Przykład
Pokaż konfigurację tagu
Konfiguracja tagu:
- Typ tagu: zdarzenie GA4
- Nazwa zdarzenia:
login
- Parametry zdarzenia (nazwa parametru – wartość):
method
– Google- Wywołuj, gdy użytkownik się zaloguje
post_score
Wyślij to zdarzenie, gdy użytkownik opublikuje wynik. Dzięki temu zdarzeniu dowiesz się, jak użytkowników w grze i skorelować wyniki z odbiorcami lub zachowań.
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 zdobyła wynik. |
Przykład
Poniższy 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
– gracz 1- Wywołuj, gdy użytkownik opublikuje wynik
zakup
Zdarzenie to odnosi się do zakupu 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 (w języku angielskim)
3-literowy
w formacie ISO 4217. * Jeśli ustawisz value , wartość currency jest wymagana
pozwala na precyzyjne obliczanie danych o przychodach.
|
value |
number |
Tak* | 30.03 | Wartość pieniężna zdarzenia. * Ustaw value na sumę wartości (price * quantity) dla wszystkich elementów w:
items Nie podawaj parametrów shipping ani tax .
* Pole value jest zwykle wymagane do przydatnego raportowania.
Jeśli zaznaczysz
jako konwersję, zalecamy
value
* Pole currency jest wymagane, jeśli masz ustawioną wartość 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żnego.
|
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 zdarzenia. |
Parametry obiektu item
Nazwa | Typ | Wymagane | Przykładowa wartość | Opis |
---|---|---|---|---|
item_id |
string |
Tak* | SKU_12345 |
Identyfikator elementu.
*Wymagana jest wartość |
item_name |
string |
Tak* | Koszulka „Stan and Friends” |
Nazwa elementu.
*Wymagana jest wartość |
affiliation |
string |
Nie | Google Store |
przynależność produktu do wyznaczenia firmy dostawcy lub sklepu stacjonarnego,
adresu sklepu stacjonarnego. Uwaga: atrybut „przynależność” jest dostępny tylko dla zakresu produktu. |
coupon |
string |
Nie | SUMMER_FUN | Nazwa lub kod kuponu powiązanego z produktem. Parametry coupon na poziomie zdarzenia i produktu są:
niezależnego.
|
discount |
number |
Nie | 2,22 | Wartość jednostkowego rabatu kwotowego powiązanego z produktem. |
index |
number |
Nie | 5 | Indeks lub pozycja elementu na liście. |
item_brand |
string |
Nie | Marka produktu. | |
item_category |
string |
Nie | Odzież | Kategoria produktu. jeśli są częścią hierarchii kategorii lub taksonomia, będzie to pierwsza kategoria. |
item_category2 |
string |
Nie | Dorosły | Druga hierarchia kategorii lub dodatkowa taksonomia 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 taksonomia elementu. |
item_category5 |
string |
Nie | Krótkie rękawy | Piąta hierarchia kategorii lub dodatkowa taksonomia elementu. |
item_list_id |
string |
Nie | related_products | Identyfikator listy, na której produkt został przedstawiony użytkownikowi. Jeśli jest ustawione, parametr item_list_id na poziomie zdarzenia jest ignorowany.
Jeśli zasada jest nieskonfigurowana, używana jest wartość item_list_id na poziomie zdarzenia (jeśli nie jest skonfigurowana)
obecnie.
|
item_list_name |
string |
Nie | Produkty powiązane | Nazwa listy, na której produkt został przedstawiony użytkownikowi. Jeśli jest ustawione, parametr item_list_name na poziomie zdarzenia jest ignorowany.
Jeśli zasada jest nieskonfigurowana, używana jest wartość item_list_name na poziomie zdarzenia (jeśli nie jest skonfigurowana)
obecnie.
|
item_variant |
string |
Nie | zielony | Wersja produktu, czyli niepowtarzalny kod lub opis dodatkowego produktu. szczegóły/opcje. |
location_id |
string |
Nie | ChIJIQBpAG2ahYAR_6128GcTUEo (identyfikator Miejsc Google dla San Francisco) |
Fizyczna lokalizacja związana z produktem (np.
lokalizacja sklepu). Zalecamy używanie metody
Google
Identyfikator miejsca, który odpowiada powiązanemu produktowi. Lokalizacja niestandardowa
Możesz też użyć identyfikatora. Uwaga: pole „identyfikator lokalizacji” jest dostępne tylko w zakresie produktu. |
price |
number |
Nie | 10.01 |
Cena jednostkowa produktu w określonej walucie.
.
Jeśli rabat ma zastosowanie do produktu, ustaw price na obniżoną cenę za jednostkę i
określ zniżkę za jednostkę w parametrze discount .
|
quantity |
number |
Nie | 3 |
Liczba sztuk produktu. |
items
.
Przykład
Poniższy przykład dotyczy implementacji za pomocą Menedżera tagów:
Pokaż konfigurację tagu
Konfiguracja tagu:
- Typ tagu: zdarzenie GA4
- Nazwa zdarzenia:
purchase
- Produkty e-commerce –
ecommerce.items
- Identyfikator transakcji e-commerce –
ecommerce.transaction_id
- Wartość e-commerce –
ecommerce.value
- Podatek 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
– {{Dostawa e-commerce}}currency
– {{Waluta e-commerce}}coupon
– {{Kupon e-commerce}- Wyzwalacz: 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
}]
}
});
qualify_lead
To zdarzenie mierzy, kiedy użytkownik został oznaczony jako spełniający kryteria wymagane do zostania zakwalifikowanego potencjalnego klienta.
Parametry
Nazwa | Typ | Wymagane | Przykładowa wartość | Opis |
---|---|---|---|---|
currency |
string |
Tak* | USD |
Waluta elementów powiązanych ze zdarzeniem (w języku angielskim)
3-literowy
w formacie ISO 4217. * Jeśli ustawisz value , wartość currency jest wymagana
pozwala na precyzyjne obliczanie danych o przychodach.
|
value |
number |
Tak* | 30.03 | Wartość pieniężna zdarzenia. * Ustaw value na sumę wartości (price * quantity) dla wszystkich elementów w:
items Nie podawaj parametrów shipping ani tax .
* Pole value jest zwykle wymagane do przydatnego raportowania.
Jeśli zaznaczysz
jako konwersję, zalecamy
value
* Pole currency jest wymagane, jeśli masz ustawioną wartość value .
|
items |
Array<Item>
|
Nie | Elementy zdarzenia. |
Parametry obiektu item
Nazwa | Typ | Wymagane | Przykładowa wartość | Opis |
---|---|---|---|---|
item_id |
string |
Tak* | SKU_12345 |
Identyfikator elementu.
*Wymagana jest wartość |
item_name |
string |
Tak* | Koszulka „Stan and Friends” |
Nazwa elementu.
*Wymagana jest wartość |
affiliation |
string |
Nie | Google Store |
przynależność produktu do wyznaczenia firmy dostawcy lub sklepu stacjonarnego,
adresu sklepu stacjonarnego. Uwaga: atrybut „przynależność” jest dostępny tylko dla zakresu produktu. |
coupon |
string |
Nie | SUMMER_FUN | Nazwa lub kod kuponu powiązanego z produktem. Parametry coupon na poziomie zdarzenia i produktu są:
niezależnego.
|
discount |
number |
Nie | 2,22 | Wartość jednostkowego rabatu kwotowego powiązanego z produktem. |
index |
number |
Nie | 5 | Indeks lub pozycja elementu na liście. |
item_brand |
string |
Nie | Marka produktu. | |
item_category |
string |
Nie | Odzież | Kategoria produktu. jeśli są częścią hierarchii kategorii lub taksonomia, będzie to pierwsza kategoria. |
item_category2 |
string |
Nie | Dorosły | Druga hierarchia kategorii lub dodatkowa taksonomia 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 taksonomia elementu. |
item_category5 |
string |
Nie | Krótkie rękawy | Piąta hierarchia kategorii lub dodatkowa taksonomia elementu. |
item_list_id |
string |
Nie | related_products | Identyfikator listy, na której produkt został przedstawiony użytkownikowi. Jeśli jest ustawione, parametr item_list_id na poziomie zdarzenia jest ignorowany.
Jeśli zasada jest nieskonfigurowana, używana jest wartość item_list_id na poziomie zdarzenia (jeśli nie jest skonfigurowana)
obecnie.
|
item_list_name |
string |
Nie | Produkty powiązane | Nazwa listy, na której produkt został przedstawiony użytkownikowi. Jeśli jest ustawione, parametr item_list_name na poziomie zdarzenia jest ignorowany.
Jeśli zasada jest nieskonfigurowana, używana jest wartość item_list_name na poziomie zdarzenia (jeśli nie jest skonfigurowana)
obecnie.
|
item_variant |
string |
Nie | zielony | Wersja produktu, czyli niepowtarzalny kod lub opis dodatkowego produktu. szczegóły/opcje. |
location_id |
string |
Nie | ChIJIQBpAG2ahYAR_6128GcTUEo (identyfikator Miejsc Google dla San Francisco) |
Fizyczna lokalizacja związana z produktem (np.
lokalizacja sklepu). Zalecamy używanie metody
Google
Identyfikator miejsca, który odpowiada powiązanemu produktowi. Lokalizacja niestandardowa
Możesz też użyć identyfikatora. Uwaga: pole „identyfikator lokalizacji” jest dostępne tylko w zakresie produktu. |
price |
number |
Nie | 10.01 |
Cena jednostkowa produktu w określonej walucie.
.
Jeśli rabat ma zastosowanie do produktu, ustaw price na obniżoną cenę za jednostkę i
określ zniżkę za jednostkę w parametrze discount .
|
quantity |
number |
Nie | 3 |
Liczba sztuk produktu. |
items
.
Przykład
Poniższy przykład dotyczy implementacji za pomocą Menedżera tagów:
Pokaż konfigurację tagu
Konfiguracja tagu:
- Typ tagu: zdarzenie GA4
- Nazwa zdarzenia:
qualify_lead
- Parametry zdarzenia (nazwa parametru – wartość):
currency
– USDvalue
- 30.03items
– {{Elementy e-commerce}}- Wywołuj zdarzenie, gdy użytkownik zostanie oznaczony jako spełniający kryteria warunkujące uzyskanie statusu zakwalifikowanego potencjalnego klienta
refund
Informuje ono o tym, że użytkownikowi przysługuje 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 (w języku angielskim)
3-literowy
w formacie ISO 4217. * Jeśli ustawisz value , wartość currency jest wymagana
pozwala na precyzyjne obliczanie danych o przychodach.
|
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:
items Nie podawaj parametrów shipping ani tax .
* Pole value jest zwykle wymagane do przydatnego raportowania.
Jeśli zaznaczysz
jako konwersję, zalecamy
value
* Pole currency jest wymagane, jeśli masz ustawioną wartość value .
|
coupon |
string |
Nie | SUMMER_FUN | Nazwa lub kod kuponu powiązanego ze zdarzeniem. Parametry coupon na poziomie zdarzenia i produktu są:
niezależnego.
|
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 zdarzenia. |
Parametry obiektu item
Nazwa | Typ | Wymagane | Przykładowa wartość | Opis |
---|---|---|---|---|
item_id |
string |
Tak* | SKU_12345 |
Identyfikator elementu.
*Wymagana jest wartość |
item_name |
string |
Tak* | Koszulka „Stan and Friends” |
Nazwa elementu.
*Wymagana jest wartość |
affiliation |
string |
Nie | Google Store |
przynależność produktu do wyznaczenia firmy dostawcy lub sklepu stacjonarnego,
adresu sklepu stacjonarnego. Uwaga: atrybut „przynależność” jest dostępny tylko dla zakresu produktu. |
coupon |
string |
Nie | SUMMER_FUN | Nazwa lub kod kuponu powiązanego z produktem. Parametry coupon na poziomie zdarzenia i produktu są:
niezależnego.
|
discount |
number |
Nie | 2,22 | Wartość jednostkowego rabatu kwotowego powiązanego z produktem. |
index |
number |
Nie | 5 | Indeks lub pozycja elementu na liście. |
item_brand |
string |
Nie | Marka produktu. | |
item_category |
string |
Nie | Odzież | Kategoria produktu. jeśli są częścią hierarchii kategorii lub taksonomia, będzie to pierwsza kategoria. |
item_category2 |
string |
Nie | Dorosły | Druga hierarchia kategorii lub dodatkowa taksonomia 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 taksonomia elementu. |
item_category5 |
string |
Nie | Krótkie rękawy | Piąta hierarchia kategorii lub dodatkowa taksonomia elementu. |
item_list_id |
string |
Nie | related_products | Identyfikator listy, na której produkt został przedstawiony użytkownikowi. Jeśli jest ustawione, parametr item_list_id na poziomie zdarzenia jest ignorowany.
Jeśli zasada jest nieskonfigurowana, używana jest wartość item_list_id na poziomie zdarzenia (jeśli nie jest skonfigurowana)
obecnie.
|
item_list_name |
string |
Nie | Produkty powiązane | Nazwa listy, na której produkt został przedstawiony użytkownikowi. Jeśli jest ustawione, parametr item_list_name na poziomie zdarzenia jest ignorowany.
Jeśli zasada jest nieskonfigurowana, używana jest wartość item_list_name na poziomie zdarzenia (jeśli nie jest skonfigurowana)
obecnie.
|
item_variant |
string |
Nie | zielony | Wersja produktu, czyli niepowtarzalny kod lub opis dodatkowego produktu. szczegóły/opcje. |
location_id |
string |
Nie | ChIJIQBpAG2ahYAR_6128GcTUEo (identyfikator Miejsc Google dla San Francisco) |
Fizyczna lokalizacja związana z produktem (np.
lokalizacja sklepu). Zalecamy używanie metody
Google
Identyfikator miejsca, który odpowiada powiązanemu produktowi. Lokalizacja niestandardowa
Możesz też użyć identyfikatora. Uwaga: pole „identyfikator lokalizacji” jest dostępne tylko w zakresie produktu. |
price |
number |
Nie | 10.01 |
Cena jednostkowa produktu w określonej walucie.
.
Jeśli rabat ma zastosowanie do produktu, ustaw price na obniżoną cenę za jednostkę i
określ zniżkę za jednostkę w parametrze discount .
|
quantity |
number |
Nie | 3 |
Liczba sztuk produktu. |
items
.
Przykład
Poniższy 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):
- Produkty e-commerce –
ecommerce.items
- Identyfikator transakcji e-commerce –
ecommerce.transaction_id
- Wartość e-commerce –
ecommerce.value
- Podatek 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
– {{Dostawa e-commerce}}currency
– {{Waluta e-commerce}}coupon
– {{Kupon e-commerce}- Wyzwalacz: zdarzenie równa się zwrotowi środków
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 (w języku angielskim)
3-literowy
w formacie ISO 4217. * Jeśli ustawisz value , wartość currency jest wymagana
pozwala na precyzyjne obliczanie danych o przychodach.
|
value |
number |
Tak* | 30.03 | Wartość pieniężna zdarzenia. * Ustaw value na sumę wartości (price * quantity) dla wszystkich elementów w:
items Nie podawaj parametrów shipping ani tax .
* Pole value jest zwykle wymagane do przydatnego raportowania.
Jeśli zaznaczysz
jako konwersję, zalecamy
value
* Pole currency jest wymagane, jeśli masz ustawioną wartość value .
|
items |
Array<Item> |
Tak | Elementy zdarzenia. |
Parametry obiektu item
Nazwa | Typ | Wymagane | Przykładowa wartość | Opis |
---|---|---|---|---|
item_id |
string |
Tak* | SKU_12345 |
Identyfikator elementu.
*Wymagana jest wartość |
item_name |
string |
Tak* | Koszulka „Stan and Friends” |
Nazwa elementu.
*Wymagana jest wartość |
affiliation |
string |
Nie | Google Store |
przynależność produktu do wyznaczenia firmy dostawcy lub sklepu stacjonarnego,
adresu sklepu stacjonarnego. Uwaga: atrybut „przynależność” jest dostępny tylko dla zakresu produktu. |
coupon |
string |
Nie | SUMMER_FUN | Nazwa lub kod kuponu powiązanego z produktem. Parametry coupon na poziomie zdarzenia i produktu są:
niezależnego.
|
discount |
number |
Nie | 2,22 | Wartość jednostkowego rabatu kwotowego powiązanego z produktem. |
index |
number |
Nie | 5 | Indeks lub pozycja elementu na liście. |
item_brand |
string |
Nie | Marka produktu. | |
item_category |
string |
Nie | Odzież | Kategoria produktu. jeśli są częścią hierarchii kategorii lub taksonomia, będzie to pierwsza kategoria. |
item_category2 |
string |
Nie | Dorosły | Druga hierarchia kategorii lub dodatkowa taksonomia 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 taksonomia elementu. |
item_category5 |
string |
Nie | Krótkie rękawy | Piąta hierarchia kategorii lub dodatkowa taksonomia elementu. |
item_list_id |
string |
Nie | related_products | Identyfikator listy, na której produkt został przedstawiony użytkownikowi. Jeśli jest ustawione, parametr item_list_id na poziomie zdarzenia jest ignorowany.
Jeśli zasada jest nieskonfigurowana, używana jest wartość item_list_id na poziomie zdarzenia (jeśli nie jest skonfigurowana)
obecnie.
|
item_list_name |
string |
Nie | Produkty powiązane | Nazwa listy, na której produkt został przedstawiony użytkownikowi. Jeśli jest ustawione, parametr item_list_name na poziomie zdarzenia jest ignorowany.
Jeśli zasada jest nieskonfigurowana, używana jest wartość item_list_name na poziomie zdarzenia (jeśli nie jest skonfigurowana)
obecnie.
|
item_variant |
string |
Nie | zielony | Wersja produktu, czyli niepowtarzalny kod lub opis dodatkowego produktu. szczegóły/opcje. |
location_id |
string |
Nie | ChIJIQBpAG2ahYAR_6128GcTUEo (identyfikator Miejsc Google dla San Francisco) |
Fizyczna lokalizacja związana z produktem (np.
lokalizacja sklepu). Zalecamy używanie metody
Google
Identyfikator miejsca, który odpowiada powiązanemu produktowi. Lokalizacja niestandardowa
Możesz też użyć identyfikatora. Uwaga: pole „identyfikator lokalizacji” jest dostępne tylko w zakresie produktu. |
price |
number |
Nie | 10.01 |
Cena jednostkowa produktu w określonej walucie.
.
Jeśli rabat ma zastosowanie do produktu, ustaw price na obniżoną cenę za jednostkę i
określ zniżkę za jednostkę w parametrze discount .
|
quantity |
number |
Nie | 3 |
Liczba sztuk produktu. |
items
.
Przykład
Poniższy 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):
- Produkty 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}}- Aktywator: 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
}
]
}
});
szukaj
Zarejestruj to zdarzenie, aby wskazać, kiedy użytkownik przeprowadził wyszukiwanie. Za pomocą aby dowiedzieć się, czego szukają użytkownicy w Twojej witrynie lub aplikacji. Dla: Zdarzenie to możesz wysłać wtedy, gdy użytkownik wyświetli stronę wyników wyszukiwania po podczas wyszukiwania.
Parametry
Nazwa | Typ | Wymagane | Przykładowa wartość | Opis |
---|---|---|---|---|
search_term |
string |
Tak | koszulki | Wyszukiwany produkt. |
Przykład
Poniższy 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- Wywołuj, gdy użytkownik wyszukuje informacje w Twojej witrynie
select_content
To zdarzenie oznacza, że użytkownik wybrał treści określonego typu. To zdarzenie pomoże Ci w identyfikacji popularnych treści oraz kategorii treści w do witryny 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
Poniższy 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- Wyzwalacz: 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 na poziomie produktu. |
item_list_name |
string |
Nie | Produkty powiązane | Nazwa listy, na której produkt został przedstawiony użytkownikowi. Ignorowane na poziomie produktu. |
items |
Array<Item> |
Tak* | Elementy zdarzenia. * Tablica items powinna mieć jeden
reprezentujący wybrany element. Jeśli wiele elementów jest
zostanie użyty, tylko pierwszy element w kolumnie items .
|
Parametry obiektu item
Nazwa | Typ | Wymagane | Przykładowa wartość | Opis |
---|---|---|---|---|
item_id |
string |
Tak* | SKU_12345 |
Identyfikator elementu.
*Wymagana jest wartość |
item_name |
string |
Tak* | Koszulka „Stan and Friends” |
Nazwa elementu.
*Wymagana jest wartość |
affiliation |
string |
Nie | Google Store |
przynależność produktu do wyznaczenia firmy dostawcy lub sklepu stacjonarnego,
adresu sklepu stacjonarnego. Uwaga: atrybut „przynależność” jest dostępny tylko dla zakresu produktu. |
coupon |
string |
Nie | SUMMER_FUN | Nazwa lub kod kuponu powiązanego z produktem. Parametry coupon na poziomie zdarzenia i produktu są:
niezależnego.
|
discount |
number |
Nie | 2,22 | Wartość jednostkowego rabatu kwotowego powiązanego z produktem. |
index |
number |
Nie | 5 | Indeks lub pozycja elementu na liście. |
item_brand |
string |
Nie | Marka produktu. | |
item_category |
string |
Nie | Odzież | Kategoria produktu. jeśli są częścią hierarchii kategorii lub taksonomia, będzie to pierwsza kategoria. |
item_category2 |
string |
Nie | Dorosły | Druga hierarchia kategorii lub dodatkowa taksonomia 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 taksonomia elementu. |
item_category5 |
string |
Nie | Krótkie rękawy | Piąta hierarchia kategorii lub dodatkowa taksonomia elementu. |
item_list_id |
string |
Nie | related_products | Identyfikator listy, na której produkt został przedstawiony użytkownikowi. Jeśli jest ustawione, parametr item_list_id na poziomie zdarzenia jest ignorowany.
Jeśli zasada jest nieskonfigurowana, używana jest wartość item_list_id na poziomie zdarzenia (jeśli nie jest skonfigurowana)
obecnie.
|
item_list_name |
string |
Nie | Produkty powiązane | Nazwa listy, na której produkt został przedstawiony użytkownikowi. Jeśli jest ustawione, parametr item_list_name na poziomie zdarzenia jest ignorowany.
Jeśli zasada jest nieskonfigurowana, używana jest wartość item_list_name na poziomie zdarzenia (jeśli nie jest skonfigurowana)
obecnie.
|
item_variant |
string |
Nie | zielony | Wersja produktu, czyli niepowtarzalny kod lub opis dodatkowego produktu. szczegóły/opcje. |
location_id |
string |
Nie | ChIJIQBpAG2ahYAR_6128GcTUEo (identyfikator Miejsc Google dla San Francisco) |
Fizyczna lokalizacja związana z produktem (np.
lokalizacja sklepu). Zalecamy używanie metody
Google
Identyfikator miejsca, który odpowiada powiązanemu produktowi. Lokalizacja niestandardowa
Możesz też użyć identyfikatora. Uwaga: pole „identyfikator lokalizacji” jest dostępne tylko w zakresie produktu. |
price |
number |
Nie | 10.01 |
Cena jednostkowa produktu w określonej walucie.
.
Jeśli rabat ma zastosowanie do produktu, ustaw price na obniżoną cenę za jednostkę i
określ zniżkę za jednostkę w parametrze discount .
|
quantity |
number |
Nie | 3 |
Liczba sztuk produktu. |
items
.
Przykład
Poniższy 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):
- Produkty 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 produktów e-commerce}}item_list_name
– {{nazwa listy produktó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 zdarzenie oznacza, że promocja została wybrana z listy.
Parametry
Nazwa | Typ | Wymagane | Przykładowa wartość | Opis |
---|---|---|---|---|
creative_name |
string |
Nie | summer_banner2 | Nazwa kreacji promocyjnej. Ignorowane na poziomie produktu. |
creative_slot |
string |
Nie | featured_app_1 | Nazwa boksu kreacji promocyjnej powiązanego z
. Ignorowane na poziomie produktu. |
promotion_id |
string |
Nie | P_12345 |
Identyfikator promocji powiązanej ze zdarzeniem. Ignorowane na poziomie produktu. |
promotion_name |
string |
Nie | Letnia wyprzedaż |
Nazwa promocji powiązanej ze zdarzeniem. Ignorowane na poziomie produktu. |
items |
Array<Item>
|
Nie | Elementy zdarzenia. |
Parametry obiektu item
Nazwa | Typ | Wymagane | Przykładowa wartość | Opis |
---|---|---|---|---|
item_id |
string |
Tak* | SKU_12345 |
Identyfikator elementu.
*Wymagana jest wartość |
item_name |
string |
Tak* | Koszulka „Stan and Friends” |
Nazwa elementu.
*Wymagana jest wartość |
affiliation |
string |
Nie | Google Store |
przynależność produktu do wyznaczenia firmy dostawcy lub sklepu stacjonarnego,
adresu sklepu stacjonarnego. Uwaga: atrybut „przynależność” jest dostępny tylko dla zakresu produktu. |
coupon |
string |
Nie | SUMMER_FUN | Nazwa lub kod kuponu powiązanego z produktem. Parametry coupon na poziomie zdarzenia i produktu są:
niezależnego.
|
creative_name |
string |
Nie | summer_banner2 | Nazwa kreacji promocyjnej. Jeśli jest ustawione, parametr creative_name na poziomie zdarzenia jest ignorowany.
Jeśli zasada jest nieskonfigurowana, używana jest wartość creative_name na poziomie zdarzenia (jeśli nie jest skonfigurowana)
obecnie. |
creative_slot |
string |
Nie | featured_app_1 | Nazwa boksu kreacji promocyjnej powiązanego z
elementu. Jeśli jest ustawione, parametr creative_slot na poziomie zdarzenia jest ignorowany.
Jeśli zasada jest nieskonfigurowana, używana jest wartość creative_slot na poziomie zdarzenia (jeśli nie jest skonfigurowana)
obecnie. |
discount |
number |
Nie | 2,22 | Wartość jednostkowego rabatu kwotowego powiązanego z produktem. |
index |
number |
Nie | 5 | Indeks lub pozycja elementu na liście. |
item_brand |
string |
Nie | Marka produktu. | |
item_category |
string |
Nie | Odzież | Kategoria produktu. jeśli są częścią hierarchii kategorii lub taksonomia, będzie to pierwsza kategoria. |
item_category2 |
string |
Nie | Dorosły | Druga hierarchia kategorii lub dodatkowa taksonomia 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 taksonomia elementu. |
item_category5 |
string |
Nie | Krótkie rękawy | Piąta hierarchia kategorii lub dodatkowa taksonomia elementu. |
item_list_id |
string |
Nie | related_products | Identyfikator listy, na której produkt został przedstawiony użytkownikowi. Jeśli jest ustawione, parametr item_list_id na poziomie zdarzenia jest ignorowany.
Jeśli zasada jest nieskonfigurowana, używana jest wartość item_list_id na poziomie zdarzenia (jeśli nie jest skonfigurowana)
obecnie.
|
item_list_name |
string |
Nie | Produkty powiązane | Nazwa listy, na której produkt został przedstawiony użytkownikowi. Jeśli jest ustawione, parametr item_list_name na poziomie zdarzenia jest ignorowany.
Jeśli zasada jest nieskonfigurowana, używana jest wartość item_list_name na poziomie zdarzenia (jeśli nie jest skonfigurowana)
obecnie.
|
item_variant |
string |
Nie | zielony | Wersja produktu, czyli niepowtarzalny kod lub opis dodatkowego produktu. szczegóły/opcje. |
location_id |
string |
Nie | ChIJIQBpAG2ahYAR_6128GcTUEo (identyfikator Miejsc Google dla San Francisco) |
Fizyczna lokalizacja związana z produktem (np.
lokalizacja sklepu). Zalecamy używanie metody
Google
Identyfikator miejsca, który odpowiada powiązanemu produktowi. Lokalizacja niestandardowa
Możesz też użyć identyfikatora. Uwaga: pole „identyfikator lokalizacji” jest dostępne tylko w zakresie produktu. |
price |
number |
Nie | 10.01 |
Cena jednostkowa produktu w określonej walucie.
.
Jeśli rabat ma zastosowanie do produktu, ustaw price na obniżoną cenę za jednostkę i
określ zniżkę za jednostkę w parametrze discount .
|
promotion_id |
string |
Nie | P_12345 |
Identyfikator promocji powiązanej z produktem. Jeśli jest ustawione, parametr promotion_id na poziomie zdarzenia jest ignorowany.
Jeśli zasada jest nieskonfigurowana, używana jest wartość promotion_id na poziomie zdarzenia (jeśli nie jest skonfigurowana)
obecnie.
|
promotion_name |
string |
Nie | Letnia wyprzedaż |
Nazwa promocji powiązanej z produktem. Jeśli jest ustawione, parametr promotion_name na poziomie zdarzenia jest ignorowany.
Jeśli zasada jest nieskonfigurowana, używana jest wartość promotion_name na poziomie zdarzenia (jeśli nie jest skonfigurowana)
obecnie.
|
quantity |
number |
Nie | 3 |
Liczba sztuk produktu. |
items
.
Przykład
Poniższy 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
- Produkty 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ępnianie
Użyj tego zdarzenia, gdy użytkownik udostępni treści.
Parametry
Nazwa | Typ | Wymagane | Przykładowa wartość | Opis |
---|---|---|---|---|
method |
string |
Nie | Metoda udostępniania treści. | |
content_type |
string |
Nie | obraz | Typ udostępnianych 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ści
sign_up
To zdarzenie wskazuje, że użytkownik zarejestrował konto. Użyj tego zdarzenia, aby: zrozumieć różne zachowania zalogowanych i niezalogowanych użytkowników.
Parametry
Nazwa | Typ | Wymagane | Przykładowa wartość | Opis |
---|---|---|---|---|
method |
string |
Nie | Metoda rejestracji. |
Przykład
Poniższy 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 zarejestruje konto
spend_virtual_currency
To zdarzenie mierzy sprzedaż wirtualnych towarów w Twojej aplikacji i pomaga określić, które wirtualne towary są najpopularniejsze.
Parametry
Nazwa | Typ | Wymagane | Przykładowa wartość | Opis |
---|---|---|---|---|
value |
number |
Tak | 5 | Wartość waluty wirtualnej. |
virtual_currency_name |
string |
Tak | Gemy | Nazwa waluty wirtualnej. |
item_name |
string |
Nie | Wzmocnienie początkowe | Nazwa produktu, w którego przypadku używana jest waluta wirtualna. |
Przykład
Poniższy 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
– Wzmocnienie początkowe- Aktywuj, gdy ktoś kupi produkt wirtualny
tutorial_begin
To zdarzenie oznacza początek procesu rejestracji. Wykorzystaj to w ścieżce z tutorial_complete, aby dowiedzieć się, ilu użytkowników ukończy samouczek.
Parametry
Brak parametrów dla tego zdarzenia.
Przykład
Poniższy przykład dotyczy implementacji za pomocą Menedżera tagów:
Pokaż konfigurację tagu
Konfiguracja tagu:
- Typ tagu: zdarzenie GA4
- Nazwa zdarzenia:
tutorial_begin
- Wywołuj, gdy ktoś rozpocznie proces rejestracji
tutorial_complete
Zdarzenie to wskazuje ukończenie przez użytkownika procesu rejestracji. Użyj tej na ścieżce z tutorial_begin, aby dowiedzieć się, ilu użytkowników aplikacji Google Web Designer.
Parametry
Brak sugerowanych parametrów dla tego zdarzenia.
Przykład
Poniższy przykład dotyczy implementacji za pomocą Menedżera tagów:
Pokaż konfigurację tagu
Konfiguracja tagu:
- Typ tagu: zdarzenie GA4
- Nazwa zdarzenia:
tutorial_complete
- Wywołuj, gdy użytkownik ukończy proces rejestracji
unlock_achievement
Zarejestruj to zdarzenie, gdy użytkownik odblokuje osiągnięcie. To zdarzenie może pomóc zrozumieć, jak użytkownicy odbierają Twoją grę.
Parametry
Nazwa | Typ | Wymagane | Przykładowa wartość | Opis |
---|---|---|---|---|
achievement_id |
string |
Tak | A_12345 | Identyfikator odblokowanego osiągnięcia. |
Przykład
Poniższy przykład dotyczy implementacji 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 odblokuje osiągnięcie
view_cart
To zdarzenie oznacza, że użytkownik wyświetlił koszyk.
Parametry
Nazwa | Typ | Wymagane | Przykładowa wartość | Opis |
---|---|---|---|---|
currency |
string |
Tak* | USD |
Waluta elementów powiązanych ze zdarzeniem (w języku angielskim)
3-literowy
w formacie ISO 4217. * Jeśli ustawisz value , wartość currency jest wymagana
pozwala na precyzyjne obliczanie danych o przychodach.
|
value |
number |
Tak* | 30.03 | Wartość pieniężna zdarzenia. * Ustaw value na sumę wartości (price * quantity) dla wszystkich elementów w:
items Nie podawaj parametrów shipping ani tax .
* Pole value jest zwykle wymagane do przydatnego raportowania.
Jeśli zaznaczysz
jako konwersję, zalecamy
value
* Pole currency jest wymagane, jeśli masz ustawioną wartość value .
|
items |
Array<Item> |
Tak | Elementy zdarzenia. |
Parametry obiektu item
Nazwa | Typ | Wymagane | Przykładowa wartość | Opis |
---|---|---|---|---|
item_id |
string |
Tak* | SKU_12345 |
Identyfikator elementu.
*Wymagana jest wartość |
item_name |
string |
Tak* | Koszulka „Stan and Friends” |
Nazwa elementu.
*Wymagana jest wartość |
affiliation |
string |
Nie | Google Store |
przynależność produktu do wyznaczenia firmy dostawcy lub sklepu stacjonarnego,
adresu sklepu stacjonarnego. Uwaga: atrybut „przynależność” jest dostępny tylko dla zakresu produktu. |
coupon |
string |
Nie | SUMMER_FUN | Nazwa lub kod kuponu powiązanego z produktem. Parametry coupon na poziomie zdarzenia i produktu są:
niezależnego.
|
discount |
number |
Nie | 2,22 | Wartość jednostkowego rabatu kwotowego powiązanego z produktem. |
index |
number |
Nie | 5 | Indeks lub pozycja elementu na liście. |
item_brand |
string |
Nie | Marka produktu. | |
item_category |
string |
Nie | Odzież | Kategoria produktu. jeśli są częścią hierarchii kategorii lub taksonomia, będzie to pierwsza kategoria. |
item_category2 |
string |
Nie | Dorosły | Druga hierarchia kategorii lub dodatkowa taksonomia 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 taksonomia elementu. |
item_category5 |
string |
Nie | Krótkie rękawy | Piąta hierarchia kategorii lub dodatkowa taksonomia elementu. |
item_list_id |
string |
Nie | related_products | Identyfikator listy, na której produkt został przedstawiony użytkownikowi. Jeśli jest ustawione, parametr item_list_id na poziomie zdarzenia jest ignorowany.
Jeśli zasada jest nieskonfigurowana, używana jest wartość item_list_id na poziomie zdarzenia (jeśli nie jest skonfigurowana)
obecnie.
|
item_list_name |
string |
Nie | Produkty powiązane | Nazwa listy, na której produkt został przedstawiony użytkownikowi. Jeśli jest ustawione, parametr item_list_name na poziomie zdarzenia jest ignorowany.
Jeśli zasada jest nieskonfigurowana, używana jest wartość item_list_name na poziomie zdarzenia (jeśli nie jest skonfigurowana)
obecnie.
|
item_variant |
string |
Nie | zielony | Wersja produktu, czyli niepowtarzalny kod lub opis dodatkowego produktu. szczegóły/opcje. |
location_id |
string |
Nie | ChIJIQBpAG2ahYAR_6128GcTUEo (identyfikator Miejsc Google dla San Francisco) |
Fizyczna lokalizacja związana z produktem (np.
lokalizacja sklepu). Zalecamy używanie metody
Google
Identyfikator miejsca, który odpowiada powiązanemu produktowi. Lokalizacja niestandardowa
Możesz też użyć identyfikatora. Uwaga: pole „identyfikator lokalizacji” jest dostępne tylko w zakresie produktu. |
price |
number |
Nie | 10.01 |
Cena jednostkowa produktu w określonej walucie.
.
Jeśli rabat ma zastosowanie do produktu, ustaw price na obniżoną cenę za jednostkę i
określ zniżkę za jednostkę w parametrze discount .
|
quantity |
number |
Nie | 3 |
Liczba sztuk produktu. |
items
.
Przykład
Poniższy 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):
- Produkty 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 niektóre treści zostały wyświetlone użytkownikowi. Użyj tego zdarzenia, aby: by dowiedzieć się, które produkty cieszą się największą popularnością.
Parametry
Nazwa | Typ | Wymagane | Przykładowa wartość | Opis |
---|---|---|---|---|
currency |
string |
Tak* | USD |
Waluta elementów powiązanych ze zdarzeniem (w języku angielskim)
3-literowy
w formacie ISO 4217. * Jeśli ustawisz value , wartość currency jest wymagana
pozwala na precyzyjne obliczanie danych o przychodach.
|
value |
number |
Tak* | 30.03 | Wartość pieniężna zdarzenia. * Ustaw value na sumę wartości (price * quantity) dla wszystkich elementów w:
items Nie podawaj parametrów shipping ani tax .
* Pole value jest zwykle wymagane do przydatnego raportowania.
Jeśli zaznaczysz
jako konwersję, zalecamy
value
* Pole currency jest wymagane, jeśli masz ustawioną wartość value .
|
items |
Array<Item> |
Tak | Elementy zdarzenia. |
Parametry obiektu item
Nazwa | Typ | Wymagane | Przykładowa wartość | Opis |
---|---|---|---|---|
item_id |
string |
Tak* | SKU_12345 |
Identyfikator elementu.
*Wymagana jest wartość |
item_name |
string |
Tak* | Koszulka „Stan and Friends” |
Nazwa elementu.
*Wymagana jest wartość |
affiliation |
string |
Nie | Google Store |
przynależność produktu do wyznaczenia firmy dostawcy lub sklepu stacjonarnego,
adresu sklepu stacjonarnego. Uwaga: atrybut „przynależność” jest dostępny tylko dla zakresu produktu. |
coupon |
string |
Nie | SUMMER_FUN | Nazwa lub kod kuponu powiązanego z produktem. Parametry coupon na poziomie zdarzenia i produktu są:
niezależnego.
|
discount |
number |
Nie | 2,22 | Wartość jednostkowego rabatu kwotowego powiązanego z produktem. |
index |
number |
Nie | 5 | Indeks lub pozycja elementu na liście. |
item_brand |
string |
Nie | Marka produktu. | |
item_category |
string |
Nie | Odzież | Kategoria produktu. jeśli są częścią hierarchii kategorii lub taksonomia, będzie to pierwsza kategoria. |
item_category2 |
string |
Nie | Dorosły | Druga hierarchia kategorii lub dodatkowa taksonomia 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 taksonomia elementu. |
item_category5 |
string |
Nie | Krótkie rękawy | Piąta hierarchia kategorii lub dodatkowa taksonomia elementu. |
item_list_id |
string |
Nie | related_products | Identyfikator listy, na której produkt został przedstawiony użytkownikowi. Jeśli jest ustawione, parametr item_list_id na poziomie zdarzenia jest ignorowany.
Jeśli zasada jest nieskonfigurowana, używana jest wartość item_list_id na poziomie zdarzenia (jeśli nie jest skonfigurowana)
obecnie.
|
item_list_name |
string |
Nie | Produkty powiązane | Nazwa listy, na której produkt został przedstawiony użytkownikowi. Jeśli jest ustawione, parametr item_list_name na poziomie zdarzenia jest ignorowany.
Jeśli zasada jest nieskonfigurowana, używana jest wartość item_list_name na poziomie zdarzenia (jeśli nie jest skonfigurowana)
obecnie.
|
item_variant |
string |
Nie | zielony | Wersja produktu, czyli niepowtarzalny kod lub opis dodatkowego produktu. szczegóły/opcje. |
location_id |
string |
Nie | ChIJIQBpAG2ahYAR_6128GcTUEo (identyfikator Miejsc Google dla San Francisco) |
Fizyczna lokalizacja związana z produktem (np.
lokalizacja sklepu). Zalecamy używanie metody
Google
Identyfikator miejsca, który odpowiada powiązanemu produktowi. Lokalizacja niestandardowa
Możesz też użyć identyfikatora. Uwaga: pole „identyfikator lokalizacji” jest dostępne tylko w zakresie produktu. |
price |
number |
Nie | 10.01 |
Cena jednostkowa produktu w określonej walucie.
.
Jeśli rabat ma zastosowanie do produktu, ustaw price na obniżoną cenę za jednostkę i
określ zniżkę za jednostkę w parametrze discount .
|
quantity |
number |
Nie | 3 |
Liczba sztuk produktu. |
items
.
Przykład
Poniższy 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):
- Produkty 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 wyświetliła się lista elementów danej 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 na poziomie produktu. |
item_list_name |
string |
Nie | Produkty powiązane | Nazwa listy, na której produkt został przedstawiony użytkownikowi. Ignorowane na poziomie produktu. |
items |
Array<Item> |
Tak | Elementy zdarzenia. |
Parametry obiektu item
Nazwa | Typ | Wymagane | Przykładowa wartość | Opis |
---|---|---|---|---|
item_id |
string |
Tak* | SKU_12345 |
Identyfikator elementu.
*Wymagana jest wartość |
item_name |
string |
Tak* | Koszulka „Stan and Friends” |
Nazwa elementu.
*Wymagana jest wartość |
affiliation |
string |
Nie | Google Store |
przynależność produktu do wyznaczenia firmy dostawcy lub sklepu stacjonarnego,
adresu sklepu stacjonarnego. Uwaga: atrybut „przynależność” jest dostępny tylko dla zakresu produktu. |
coupon |
string |
Nie | SUMMER_FUN | Nazwa lub kod kuponu powiązanego z produktem. Parametry coupon na poziomie zdarzenia i produktu są:
niezależnego.
|
discount |
number |
Nie | 2,22 | Wartość jednostkowego rabatu kwotowego powiązanego z produktem. |
index |
number |
Nie | 5 | Indeks lub pozycja elementu na liście. |
item_brand |
string |
Nie | Marka produktu. | |
item_category |
string |
Nie | Odzież | Kategoria produktu. jeśli są częścią hierarchii kategorii lub taksonomia, będzie to pierwsza kategoria. |
item_category2 |
string |
Nie | Dorosły | Druga hierarchia kategorii lub dodatkowa taksonomia 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 taksonomia elementu. |
item_category5 |
string |
Nie | Krótkie rękawy | Piąta hierarchia kategorii lub dodatkowa taksonomia elementu. |
item_list_id |
string |
Nie | related_products | Identyfikator listy, na której produkt został przedstawiony użytkownikowi. Jeśli jest ustawione, parametr item_list_id na poziomie zdarzenia jest ignorowany.
Jeśli zasada jest nieskonfigurowana, używana jest wartość item_list_id na poziomie zdarzenia (jeśli nie jest skonfigurowana)
obecnie.
|
item_list_name |
string |
Nie | Produkty powiązane | Nazwa listy, na której produkt został przedstawiony użytkownikowi. Jeśli jest ustawione, parametr item_list_name na poziomie zdarzenia jest ignorowany.
Jeśli zasada jest nieskonfigurowana, używana jest wartość item_list_name na poziomie zdarzenia (jeśli nie jest skonfigurowana)
obecnie.
|
item_variant |
string |
Nie | zielony | Wersja produktu, czyli niepowtarzalny kod lub opis dodatkowego produktu. szczegóły/opcje. |
location_id |
string |
Nie | ChIJIQBpAG2ahYAR_6128GcTUEo (identyfikator Miejsc Google dla San Francisco) |
Fizyczna lokalizacja związana z produktem (np.
lokalizacja sklepu). Zalecamy używanie metody
Google
Identyfikator miejsca, który odpowiada powiązanemu produktowi. Lokalizacja niestandardowa
Możesz też użyć identyfikatora. Uwaga: pole „identyfikator lokalizacji” jest dostępne tylko w zakresie produktu. |
price |
number |
Nie | 10.01 |
Cena jednostkowa produktu w określonej walucie.
.
Jeśli rabat ma zastosowanie do produktu, ustaw price na obniżoną cenę za jednostkę i
określ zniżkę za jednostkę w parametrze discount .
|
quantity |
number |
Nie | 3 |
Liczba sztuk produktu. |
items
.
Przykład
Poniższy 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):
- Produkty 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 produktów e-commerce}}item_list_name
– {{nazwa listy produktów e-commerce}}- Aktywator: 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 zdarzenie oznacza, że promocja wyświetliła się z listy.
Parametry
Nazwa | Typ | Wymagane | Przykładowa wartość | Opis |
---|---|---|---|---|
creative_name |
string |
Nie | summer_banner2 | Nazwa kreacji promocyjnej. Ignorowane na poziomie produktu. |
creative_slot |
string |
Nie | featured_app_1 | Nazwa boksu kreacji promocyjnej powiązanego z
. Ignorowane na poziomie produktu. |
promotion_id |
string |
Nie | P_12345 |
Identyfikator promocji powiązanej ze zdarzeniem. Ignorowane na poziomie produktu. |
promotion_name |
string |
Nie | Letnia wyprzedaż |
Nazwa promocji powiązanej ze zdarzeniem. Ignorowane na poziomie produktu. |
items |
Array<Item> |
Tak* | Elementy zdarzenia. * Tablica items powinna mieć jeden
element reprezentujący element powiązany z promocją. Jeśli kilka
elementów, tylko pierwszy element w argumencie items
i sposobu ich wykorzystania.
|
Parametry obiektu item
Nazwa | Typ | Wymagane | Przykładowa wartość | Opis |
---|---|---|---|---|
item_id |
string |
Tak* | SKU_12345 |
Identyfikator elementu.
*Wymagana jest wartość |
item_name |
string |
Tak* | Koszulka „Stan and Friends” |
Nazwa elementu.
*Wymagana jest wartość |
affiliation |
string |
Nie | Google Store |
przynależność produktu do wyznaczenia firmy dostawcy lub sklepu stacjonarnego,
adresu sklepu stacjonarnego. Uwaga: atrybut „przynależność” jest dostępny tylko dla zakresu produktu. |
coupon |
string |
Nie | SUMMER_FUN | Nazwa lub kod kuponu powiązanego z produktem. Parametry coupon na poziomie zdarzenia i produktu są:
niezależnego.
|
creative_name |
string |
Nie | summer_banner2 | Nazwa kreacji promocyjnej. Jeśli jest ustawione, parametr creative_name na poziomie zdarzenia jest ignorowany.
Jeśli zasada jest nieskonfigurowana, używana jest wartość creative_name na poziomie zdarzenia (jeśli nie jest skonfigurowana)
obecnie. |
creative_slot |
string |
Nie | featured_app_1 | Nazwa boksu kreacji promocyjnej powiązanego z
elementu. Jeśli jest ustawione, parametr creative_slot na poziomie zdarzenia jest ignorowany.
Jeśli zasada jest nieskonfigurowana, używana jest wartość creative_slot na poziomie zdarzenia (jeśli nie jest skonfigurowana)
obecnie. |
discount |
number |
Nie | 2,22 | Wartość jednostkowego rabatu kwotowego powiązanego z produktem. |
index |
number |
Nie | 5 | Indeks lub pozycja elementu na liście. |
item_brand |
string |
Nie | Marka produktu. | |
item_category |
string |
Nie | Odzież | Kategoria produktu. jeśli są częścią hierarchii kategorii lub taksonomia, będzie to pierwsza kategoria. |
item_category2 |
string |
Nie | Dorosły | Druga hierarchia kategorii lub dodatkowa taksonomia 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 taksonomia elementu. |
item_category5 |
string |
Nie | Krótkie rękawy | Piąta hierarchia kategorii lub dodatkowa taksonomia elementu. |
item_list_id |
string |
Nie | related_products | Identyfikator listy, na której produkt został przedstawiony użytkownikowi. Jeśli jest ustawione, parametr item_list_id na poziomie zdarzenia jest ignorowany.
Jeśli zasada jest nieskonfigurowana, używana jest wartość item_list_id na poziomie zdarzenia (jeśli nie jest skonfigurowana)
obecnie.
|
item_list_name |
string |
Nie | Produkty powiązane | Nazwa listy, na której produkt został przedstawiony użytkownikowi. Jeśli jest ustawione, parametr item_list_name na poziomie zdarzenia jest ignorowany.
Jeśli zasada jest nieskonfigurowana, używana jest wartość item_list_name na poziomie zdarzenia (jeśli nie jest skonfigurowana)
obecnie.
|
item_variant |
string |
Nie | zielony | Wersja produktu, czyli niepowtarzalny kod lub opis dodatkowego produktu. szczegóły/opcje. |
location_id |
string |
Nie | ChIJIQBpAG2ahYAR_6128GcTUEo (identyfikator Miejsc Google dla San Francisco) |
Fizyczna lokalizacja związana z produktem (np.
lokalizacja sklepu). Zalecamy używanie metody
Google
Identyfikator miejsca, który odpowiada powiązanemu produktowi. Lokalizacja niestandardowa
Możesz też użyć identyfikatora. Uwaga: pole „identyfikator lokalizacji” jest dostępne tylko w zakresie produktu. |
price |
number |
Nie | 10.01 |
Cena jednostkowa produktu w określonej walucie.
.
Jeśli rabat ma zastosowanie do produktu, ustaw price na obniżoną cenę za jednostkę i
określ zniżkę za jednostkę w parametrze discount .
|
promotion_id |
string |
Nie | P_12345 |
Identyfikator promocji powiązanej z produktem. Jeśli jest ustawione, parametr promotion_id na poziomie zdarzenia jest ignorowany.
Jeśli zasada jest nieskonfigurowana, używana jest wartość promotion_id na poziomie zdarzenia (jeśli nie jest skonfigurowana)
obecnie.
|
promotion_name |
string |
Nie | Letnia wyprzedaż |
Nazwa promocji powiązanej z produktem. Jeśli jest ustawione, parametr promotion_name na poziomie zdarzenia jest ignorowany.
Jeśli zasada jest nieskonfigurowana, używana jest wartość promotion_name na poziomie zdarzenia (jeśli nie jest skonfigurowana)
obecnie.
|
quantity |
number |
Nie | 3 |
Liczba sztuk produktu. |
items
.
Przykład
Poniższy 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
- Produkty 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
}
]
}
});
working_lead
Mierzy zdarzenia, gdy użytkownik kontaktuje się z przedstawicielem.
Parametry
Nazwa | Typ | Wymagane | Przykładowa wartość | Opis |
---|---|---|---|---|
currency |
string |
Tak* | USD |
Waluta elementów powiązanych ze zdarzeniem (w języku angielskim)
3-literowy
w formacie ISO 4217. * Jeśli ustawisz value , wartość currency jest wymagana
pozwala na precyzyjne obliczanie danych o przychodach.
|
value |
number |
Tak* | 30.03 | Wartość pieniężna zdarzenia. * Ustaw value na sumę wartości (price * quantity) dla wszystkich elementów w:
items Nie podawaj parametrów shipping ani tax .
* Pole value jest zwykle wymagane do przydatnego raportowania.
Jeśli zaznaczysz
jako konwersję, zalecamy
value
* Pole currency jest wymagane, jeśli masz ustawioną wartość value .
|
lead_status |
string |
Nie | Rozpoczęte rozmowy | Stan potencjalnego klienta. |
items |
Array<Item>
|
Nie | Elementy zdarzenia. |
Parametry obiektu item
Nazwa | Typ | Wymagane | Przykładowa wartość | Opis |
---|---|---|---|---|
item_id |
string |
Tak* | SKU_12345 |
Identyfikator elementu.
*Wymagana jest wartość |
item_name |
string |
Tak* | Koszulka „Stan and Friends” |
Nazwa elementu.
*Wymagana jest wartość |
affiliation |
string |
Nie | Google Store |
przynależność produktu do wyznaczenia firmy dostawcy lub sklepu stacjonarnego,
adresu sklepu stacjonarnego. Uwaga: atrybut „przynależność” jest dostępny tylko dla zakresu produktu. |
coupon |
string |
Nie | SUMMER_FUN | Nazwa lub kod kuponu powiązanego z produktem. Parametry coupon na poziomie zdarzenia i produktu są:
niezależnego.
|
discount |
number |
Nie | 2,22 | Wartość jednostkowego rabatu kwotowego powiązanego z produktem. |
index |
number |
Nie | 5 | Indeks lub pozycja elementu na liście. |
item_brand |
string |
Nie | Marka produktu. | |
item_category |
string |
Nie | Odzież | Kategoria produktu. jeśli są częścią hierarchii kategorii lub taksonomia, będzie to pierwsza kategoria. |
item_category2 |
string |
Nie | Dorosły | Druga hierarchia kategorii lub dodatkowa taksonomia 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 taksonomia elementu. |
item_category5 |
string |
Nie | Krótkie rękawy | Piąta hierarchia kategorii lub dodatkowa taksonomia elementu. |
item_list_id |
string |
Nie | related_products | Identyfikator listy, na której produkt został przedstawiony użytkownikowi. Jeśli jest ustawione, parametr item_list_id na poziomie zdarzenia jest ignorowany.
Jeśli zasada jest nieskonfigurowana, używana jest wartość item_list_id na poziomie zdarzenia (jeśli nie jest skonfigurowana)
obecnie.
|
item_list_name |
string |
Nie | Produkty powiązane | Nazwa listy, na której produkt został przedstawiony użytkownikowi. Jeśli jest ustawione, parametr item_list_name na poziomie zdarzenia jest ignorowany.
Jeśli zasada jest nieskonfigurowana, używana jest wartość item_list_name na poziomie zdarzenia (jeśli nie jest skonfigurowana)
obecnie.
|
item_variant |
string |
Nie | zielony | Wersja produktu, czyli niepowtarzalny kod lub opis dodatkowego produktu. szczegóły/opcje. |
location_id |
string |
Nie | ChIJIQBpAG2ahYAR_6128GcTUEo (identyfikator Miejsc Google dla San Francisco) |
Fizyczna lokalizacja związana z produktem (np.
lokalizacja sklepu). Zalecamy używanie metody
Google
Identyfikator miejsca, który odpowiada powiązanemu produktowi. Lokalizacja niestandardowa
Możesz też użyć identyfikatora. Uwaga: pole „identyfikator lokalizacji” jest dostępne tylko w zakresie produktu. |
price |
number |
Nie | 10.01 |
Cena jednostkowa produktu w określonej walucie.
.
Jeśli rabat ma zastosowanie do produktu, ustaw price na obniżoną cenę za jednostkę i
określ zniżkę za jednostkę w parametrze discount .
|
quantity |
number |
Nie | 3 |
Liczba sztuk produktu. |
items
.
Przykład
Poniższy przykład dotyczy implementacji za pomocą Menedżera tagów:
Pokaż konfigurację tagu
Konfiguracja tagu:
- Typ tagu: zdarzenie GA4
- Nazwa zdarzenia:
working_lead
- Parametry zdarzenia (nazwa parametru – wartość):
currency
– USDvalue
- 30.03lead_status
– rozpoczęte rozmowyitems
– {{Elementy e-commerce}}- Wywołuj zdarzenie, gdy użytkownik kontaktuje się z przedstawiciel