Ulepszone e-commerce

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 id lub name.

name plik tekstowy, *Tak

Nazwa produktu (np. Android T-Shirt).

* Należy ustawić jedną z wartości id lub name.

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.

name plik tekstowy, *Tak

Nazwa produktu (np. Android T-Shirt).

* Należy ustawić jeden identyfikator lub element name.

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 id lub name.

name plik tekstowy, *Tak

Nazwa promocji (np. Letnia wyprzedaż).

* Należy ustawić jedną z wartości id lub name.

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 purchase lub refund

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:

  1. Dodaj kod pomiarowy, aby mierzyć każdy etap procesu płatności.
  2. 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'
    }
  ]
});