Na tej stronie opisujemy, jak używać tagu gtag.js do zbierania danych o Ulepszonym e-commerce. Jeśli skonfigurujesz Google Analytics w tagu gtag.js i włączysz w Google Analytics Ulepszone e-commerce, możesz go używać do wysyłania do Google Analytics danych o wyświetleniach, produktach oraz danych o promocjach i działaniach.
Typy danych i działania Ulepszonego e-commerce
Istnieje wiele typów danych e-commerce, które możesz wysyłać:
Dane o wyświetleniach
Reprezentuje informacje o produkcie, który został wyświetlony. Jest to tzw. impressionFieldObject
i zawiera te wartości:
Klucz | Typ wartości | Wymagane | Opis |
---|---|---|---|
id |
plik tekstowy, | *Tak |
Identyfikator produktu lub kod SKU (np. P67890).
* Należy ustawić jedną z wartości |
name |
plik tekstowy, | *Tak |
Nazwa produktu (np. Android T-Shirt).
* Należy ustawić jedną z wartości |
list |
plik tekstowy, | Nie | Lista lub kolekcja, do których należy produkt (np. wyniki wyszukiwania) |
list_name |
plik tekstowy, | Nie | Lista lub kolekcja, do których należy produkt (np. wyniki wyszukiwania) |
brand |
plik tekstowy, | Nie | Marka powiązana z produktem (np. Google). |
category |
plik tekstowy, | Nie |
Kategoria, do której należy produkt (np. odzież). Jako separatora użyj / jako separatora, który pozwala określić maksymalnie 5 poziomów hierarchii (np. Odzież/Męska/T-shirty).
|
variant |
plik tekstowy, | Nie | Wersja produktu (np. czarna). |
position |
Liczba całkowita | Nie | Pozycja produktu na liście lub w kolekcji (np. 2). |
list_position |
Liczba całkowita | Nie | Pozycja produktu na liście lub w kolekcji (np. 2). |
price |
Liczba | Nie | Cena produktu (np. 29,20). |
Dane produktu
Dane produktów reprezentują poszczególne produkty, które zostały wyświetlone, dodane do koszyka itd. Są one nazywane productFieldObject
i zawierają następujące wartości:
Klucz | Typ wartości | Wymagane | Opis |
---|---|---|---|
id |
plik tekstowy, | *Tak |
Identyfikator produktu lub kod SKU (np. P67890).
* Należy ustawić jeden identyfikator lub element |
name |
plik tekstowy, | *Tak |
Nazwa produktu (np. Android T-Shirt).
* Należy ustawić jeden identyfikator lub element |
brand |
plik tekstowy, | Nie | Marka powiązana z produktem (np. Google). |
category |
plik tekstowy, | Nie | Kategoria, do której należy produkt (np. odzież). Używaj / jako separatora, aby określić do 5 poziomów hierarchii (np. Odzież/Męska/T-shirty). |
variant |
plik tekstowy, | Nie | Wersja produktu (np. czarna). |
price |
Liczba | Nie | Cena produktu (np. 29,20). |
quantity |
Liczba całkowita | Nie | Liczba sztuk produktu (np. 2). |
coupon |
plik tekstowy, | Nie | Kod kuponu powiązany z produktem (np. LATO_WYPRZEDAŻ13). |
position |
Liczba całkowita | Nie | Pozycja produktu na liście lub w kolekcji (np. 2). |
list_position |
Liczba całkowita | Nie | Pozycja produktu na liście lub w kolekcji (np. 2). |
Dane promocji
Reprezentuje informacje o wyświetlonej promocji. Odnosi się do elementu promoFieldObject
i zawiera te wartości:
Klucz | Typ wartości | Wymagane | Opis |
---|---|---|---|
id |
plik tekstowy, | *Tak |
Identyfikator promocji (np. PROMO_1234).
* Należy ustawić jedną z wartości |
name |
plik tekstowy, | *Tak |
Nazwa promocji (np. Letnia wyprzedaż).
* Należy ustawić jedną z wartości |
creative |
plik tekstowy, | Nie | Kreacja powiązana z promocją (np. baner_lato_baner2). |
creative_name |
plik tekstowy, | Nie | Nazwa kreacji (np. baner_letnia2). |
position |
plik tekstowy, | Nie | Pozycja kreacji (np. baner_slot_1). |
creative_slot |
plik tekstowy, | Nie | Nazwa boksu kreacji (np. baner_slot_1). |
Dane działania
Reprezentuje informacje o wykonanym działaniu związanym z e-commerce.
Jest to tzw. actionFieldObject
i zawiera te wartości:
Klucz | Typ wartości | Wymagane | Opis |
---|---|---|---|
id |
plik tekstowy, | *Tak |
Identyfikator transakcji (np. T1234).
* Wymagany, jeśli typem działania jest |
affiliation |
plik tekstowy, | Nie | Sklep lub podmiot stowarzyszony, w którym miała miejsce transakcja (np. Google Store). |
revenue |
Liczba | Nie |
Określa całkowite przychody lub całkowitą kwotę transakcji (np. 11,99). Ta wartość może obejmować dostawę, podatki i inne korekty łącznych przychodów, które chcesz uwzględnić przy obliczaniu przychodów. |
value | Liczba | Nie | Wartość (tj. przychody) powiązana ze zdarzeniem. |
tax |
Liczba | Nie | Łączny podatek z transakcją. |
shipping |
Liczba | Nie | Koszt dostawy powiązany z transakcją. |
coupon |
plik tekstowy, | Nie | Kupon na transakcję wykorzystany w ramach transakcji. |
list |
plik tekstowy, | Nie | Lista, do której należą powiązane produkty. Opcjonalnie. |
items |
tablica | Nie | Tablica zawierająca powiązane produkty. |
step |
Liczba całkowita | Nie | Liczba reprezentująca krok w procesie płatności. Opcjonalny w przypadku działań „checkout”. |
checkout_step |
Liczba całkowita | Nie | Liczba reprezentująca krok w procesie płatności. |
option |
plik tekstowy, | Nie |
Dodatkowe pole na działania checkout i checkout_option , które może opisać informacje dotyczące opcji na stronie płatności, np. wybranej formy płatności.
|
checkout_option |
plik tekstowy, | Nie | Opcja płatności (tj. wybrana forma płatności). |
Klucz | Typ wartości | Wymagane | Opis |
---|---|---|---|
coupon |
string, | Nie | Kod kuponu na zakupiony produkt. |
Działania związane z produktem i promocją
Działania określają sposób interpretowania danych o produktach i promocjach, które wysyłasz do Google Analytics.
Działanie | Zdarzenie | Opis |
---|---|---|
click |
Kliknięcie produktu lub linku do co najmniej jednego produktu. | |
detail |
Widok szczegółów produktu. | |
add |
Dodanie co najmniej jednego produktu do koszyka. | |
remove |
Usuń co najmniej jeden produkt z koszyka. | |
checkout |
Rozpoczęcie procesu płatności dla co najmniej jednego produktu. | |
checkout_option |
Wysyłanie wartości opcji dla danego etapu płatności. | |
purchase |
Sprzedaż co najmniej jednego produktu. | |
refund |
Zwrot środków za co najmniej 1 produkt. | |
promo_click |
Kliknięcie promocji wewnętrznej. | |
add_to_cart |
Użytkownik dodaje co najmniej jeden produkt do koszyka. | |
begin_checkout |
Użytkownik inicjuje proces płatności co najmniej jednego produktu. | |
checkout_progress |
Użytkownik realizuje kroki płatności po pierwszym etapie procesu płatności. | |
purchase |
Użytkownik finalizuje zakup. | |
refund |
Użytkownik otrzyma zwrot środków za co najmniej 1 produkt. | |
remove_from_cart |
Użytkownik usuwa co najmniej jeden produkt z koszyka. | |
select_content |
Użytkownik klika link do produktu. | |
set_checkout_option |
Etap realizacji transakcji przez użytkownika. | |
view_item |
Użytkownik wyświetla szczegóły produktu. | |
view_item_list |
Użytkownik wyświetla listę co najmniej 1 produktu. | |
view_promotion |
Użytkownik klika promocję wewnętrzną. | |
view_refund |
Użytkownik wyświetla zwrot środków za co najmniej 1 produkt. |
Przykłady
Pomiar wyświetleń produktów
Aby mierzyć wyświetlenia produktu, wyślij właściwość view_item_list
z informacjami o produkcie:
gtag('event', 'view_item_list', {
"items": [
{
"id": "P12345",
"name": "Android Warhol T-Shirt",
"list_name": "Search Results",
"brand": "Google",
"category": "Apparel/T-Shirts",
"variant": "Black",
"list_position": 1,
"quantity": 2,
"price": 2
},
{
"id": "P67890",
"name": "Flame challenge TShirt",
"list_name": "Search Results",
"brand": "MyBrand",
"category": "Apparel/T-Shirts",
"variant": "Red",
"list_position": 2,
"quantity": 1,
"price": 3
}
]
});
Pomiar kliknięć produktów
Aby mierzyć kliknięcie produktu, wyślij zdarzenie select_content
, określ product
jako właściwość content_type
i podaj informacje o produkcie:
gtag('event', 'select_content', {
"content_type": "product",
"items": [
{
"id": "P12345",
"name": "Android Warhol T-Shirt",
"list_name": "Search Results",
"brand": "Google",
"category": "Apparel/T-Shirts",
"variant": "Black",
"list_position": 1,
"quantity": 2,
"price": 2
}
]
});
Pomiar wyświetleń szczegółów produktu
Po kliknięciu informacji o produkcie użytkownik może wyświetlić stronę ze szczegółami produktu. Aby mierzyć wyświetlenia szczegółów produktu, wyślij zdarzenie view_item
ze szczegółami produktu:
gtag('event', 'view_item', {
"items": [
{
"id": "P12345",
"name": "Android Warhol T-Shirt",
"list_name": "Search Results",
"brand": "Google",
"category": "Apparel/T-Shirts",
"variant": "Black",
"list_position": 1,
"quantity": 2,
"price": '2.0'
}
]
});
Mierz dodawanie do koszyka i usuwanie z niego
Aby mierzyć dodanie produktu do koszyka, wyślij zdarzenie add_to_cart
z informacjami o produkcie:
gtag('event', 'add_to_cart', {
"items": [
{
"id": "P12345",
"name": "Android Warhol T-Shirt",
"list_name": "Search Results",
"brand": "Google",
"category": "Apparel/T-Shirts",
"variant": "Black",
"list_position": 1,
"quantity": 2,
"price": '2.0'
}
]
});
Aby mierzyć usunięcie produktu z koszyka, wyślij zdarzenie remove_from_cart
z informacjami o produkcie:
gtag('event', 'remove_from_cart', {
"items": [
{
"id": "P12345",
"name": "Android Warhol T-Shirt",
"list_name": "Search Results",
"brand": "Google",
"category": "Apparel/T-Shirts",
"variant": "Black",
"list_position": 1,
"quantity": 2,
"price": '2.0'
}
]
});
Pomiar liczby transakcji
Aby mierzyć każdy etap procesu płatności:
- Dodaj kod pomiarowy, aby mierzyć każdy etap procesu płatności.
- W razie potrzeby dodaj kod pomiarowy, aby rejestrować opcje płatności.
1. Mierz kroki procesu płatności
Aby mierzyć pierwszy etap płatności, wyślij zdarzenie begin_checkout
z elementami płatności:
gtag('event', 'begin_checkout', {
"items": [
{
"id": "P12345",
"name": "Android Warhol T-Shirt",
"list_name": "Search Results",
"brand": "Google",
"category": "Apparel/T-Shirts",
"variant": "Black",
"list_position": 1,
"quantity": 2,
"price": '2.0'
}
],
"coupon": ""
});
Aby mierzyć każdy kolejny etap płatności, wyślij zdarzenie checkout_progress
z elementami procesu płatności:
gtag('event', 'checkout_progress', {
"items": [
{
"id": "P12345",
"name": "Android Warhol T-Shirt",
"list_name": "Search Results",
"brand": "Google",
"category": "Apparel/T-Shirts",
"variant": "Black",
"list_position": 1,
"quantity": 2,
"price": '2.0'
}
],
"coupon": "SUMMER_DISCOUNT"
});
2. Pomiar opcji płatności
Aby mierzyć opcje płatności, wyślij zdarzenie set_checkout_option
z opcją płatności:
gtag('event', 'set_checkout_option', {
"checkout_step": 1,
"checkout_option": "shipping method",
"value": 3
});
Pomiar wyświetleń promocji
Aby mierzyć wyświetlenia promocji, wyślij zdarzenie view_promotion
z informacjami o promocji:
gtag('event', 'view_promotion', {
"promotions": [
{
"id": "abc123",
"name": "summer_promo"
},
{
"id": "xyz987",
"name": "spring savings"
}
]
});
Pomiar kliknięć promocji
Aby mierzyć kliknięcie promocji, wyślij zdarzenie select_content
i podaj promocję:
gtag('event', 'select_content', {
"promotions": [
{
"id": "abc123",
"name": "summer_promo"
}
]
});
Mierzenie zakupów
Aby mierzyć transakcję, wyślij zdarzenie purchase
z elementami w transakcji:
gtag('event', 'purchase', {
"transaction_id": "24.031608523954162",
"affiliation": "Google online store",
"value": 23.07,
"currency": "USD",
"tax": 1.24,
"shipping": 0,
"items": [
{
"id": "P12345",
"name": "Android Warhol T-Shirt",
"list_name": "Search Results",
"brand": "Google",
"category": "Apparel/T-Shirts",
"variant": "Black",
"list_position": 1,
"quantity": 2,
"price": '2.0'
},
{
"id": "P67890",
"name": "Flame challenge TShirt",
"list_name": "Search Results",
"brand": "MyBrand",
"category": "Apparel/T-Shirts",
"variant": "Red",
"list_position": 2,
"quantity": 1,
"price": '3.0'
}
]
});
Pomiar zwrotów
Aby mierzyć pełny zwrot środków za transakcję, wyślij zdarzenie refund
z identyfikatorem transakcji:
gtag('event', 'refund', { "transaction_id": "T12345" })
Aby mierzyć częściowy zwrot środków, wyślij zdarzenie refund
z identyfikatorem transakcji i produktami, za które chcesz otrzymać zwrot środków:
gtag('event', 'refund', {
"transaction_id": "79.18502354114992",
"affiliation": "Google online store",
"value": 23.07,
"currency": "USD",
"tax": 1.24,
"shipping": 0,
"items": [
{
"id": "P12345",
"name": "Android Warhol T-Shirt",
"list_name": "Search Results",
"brand": "Google",
"category": "Apparel/T-Shirts",
"variant": "Black",
"list_position": 1,
"quantity": 2,
"price": '2.0'
},
{
"id": "P67890",
"name": "Flame challenge TShirt",
"list_name": "Search Results",
"brand": "MyBrand",
"category": "Apparel/T-Shirts",
"variant": "Red",
"list_position": 2,
"quantity": 1,
"price": '3.0'
}
]
});