Pomiar e-commerce

Możesz skonfigurować zdarzenia e-commerce, aby zbierać informacje o zachowaniach zakupowych użytkowników. Pozwalają one określić, które produkty są najpopularniejsze, oraz poznać wpływ promocji i lokowania produktu na przychody.

W tym artykule opisujemy poszczególne zdarzenia e-commerce oraz sposoby ich konfigurowania. Szczegółowe instrukcje konfigurowania zdarzenia e-commerce znajdziesz w artykule Konfigurowanie zdarzenia purchase.

Masz 3 minuty? Pomóż nam ulepszyć dokumentację e-commerce w GA4, wypełniając krótką ankietę online.

Tag Google Menedżer tagów

Zanim zaczniesz

Dodawanie tagu konfiguracji GA4 do witryny

Upewnij się, że masz do witryny dodany tag „Google Analytics: konfiguracja GA4” oraz masz dostęp do Analytics i kodu źródłowego witryny.

Pomiar zdarzeń e-commerce za pomocą tagu zdarzenia GA4

Aby wysyłać zdarzenia i parametry e-commerce do usługi w GA4:

1. Otwórz Menedżera tagów Google
2. W obszarze roboczym otwórz menu Tagi.
3. Utwórz nowy tag. Kliknij pole Konfiguracja tagu i wybierz tag Google Analytics: zdarzenie GA4.
4. Jako Nazwę zdarzenia użyj wbudowanej zmiennej {{Zdarzenie}}. Spowoduje to użycie nazwy zdarzenia e-commerce GA4 wysłanego za pomocą interfejsu gtag.js API.
5. W sekcji Więcej ustawień > E-commerce zaznacz Wyślij dane e-commerce.
6. Jako Źródło danych wybierz Warstwa danych.
7. Skonfiguruj regułę zdarzenia GA4, np. gdy użytkownik kliknie przycisk płatności. Zobacz wszystkie dostępne typy reguł.
8. Nazwij tag i zapisz go.

Rekomendacje

• Włącz tryb debugowania, aby widzieć zdarzenia w czasie rzeczywistym i łatwiej rozwiązywać problemy.
• Podczas wysyłania parametrów niestandardowych ze zdarzeniami e-commerce sprawdź limity wymiarów i danych niestandardowych
• Aby dane o przychodach były obliczane prawidłowo, ustaw parametr currency podczas wysyłania danych o przychodach (value)
• Ustaw każdy parametr e-commerce, którego dotyczą dane, niezależnie od tego, czy jest on opcjonalny
• Aby zobaczyć, jak otagować witrynę, skorzystaj z przykładowej witryny e-commerce.

Implementacja

Typowa implementacja e-commerce mierzy dowolne z tych działań:

• Wybieranie elementu z listy
• Wyświetlanie szczegółów produktu
• Dodanie produktu do koszyka lub usunięcie go z koszyka
• Rozpoczynanie procesu płatności
• Dokonywanie zakupów i zwracanie środków
• Stosowanie promocji

Podstawą tych działań są sprzedawane przez Ciebie produkty i usługi. Produkty i usługi możesz zaprezentować w postaci tablicy zawierającej elementy, które można dodawać do zdarzeń e-commerce. Oprócz przewidzianych parametrów w tablicy items możesz umieścić maksymalnie 27 parametrów niestandardowych.

Poniższy przykład pokazuje, jak utworzyć kolekcję items, do której odwołuje się ten przewodnik. Tablica items może zawierać maksymalnie 200 elementów.

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,
      quantity: 2
    }
]

Migracja z implementacji e-commerce UA

Jeśli w Universal Analytics masz już zaimplementowane e-commerce, możesz wykonać jedną z tych czynności, aby przejść na Google Analytics 4:

• Użyj implementacji e-commerce UA do wypełniania zdarzeń e-commerce GA4
• Zastąp wdrożenie e-commerce UA zdarzeniami e-commerce GA4.

Więcej informacji o przenoszeniu implementacji e-commerce z Universal Analytics do Google Analytics 4 znajdziesz w przewodniku po migracji e-commerce z GA4 do Menedżera tagów Google.

Czyszczenie obiektu e-commerce

Zalecamy użycie poniższego polecenia, aby wyczyścić obiekt e-commerce przed przekazaniem zdarzenia e-commerce na warstwę danych. Dzięki wyczyszczeniu obiektu wiele zdarzeń e-commerce na stronie nie będzie wpływać na siebie nawzajem.

dataLayer.push({ ecommerce: null });  // Clear the previous ecommerce object.

Wybierz element z listy

Gdy użytkownikowi wyświetli się lista wyników, wyślij zdarzenie view_item_list z parametrem w tablicy items zawierającym wyświetlone elementy. Szczegółowe informacje o parametrach do wysłania znajdziesz w dokumentacji zdarzeń.

Uwaga: opcji Wyślij dane e-commerce można użyć zamiast tej konfiguracji tagu.

Pokaż konfigurację tagu

Konfiguracja tagu:

• Typ tagu: zdarzenie GA4
• Nazwa zdarzenia: view_item_list
• Zmienne warstwy danych (nazwa – nazwa zmiennej warstwy danych):
• Elementy e-commerce – ecommerce.items
• Identyfikator listy produktów e-commerce – ecommerce.item_list_id
• Nazwa listy elementów e-commerce – ecommerce.item_list_name
• Parametry zdarzenia (nazwa parametru – wartość):
• items – {{Elementy e-commerce}}
• item_list_id – {{identyfikator listy elementów e-commerce}}
• item_list_name – {{nazwa listy elementów e-commerce}}
• Reguła: zdarzenie równa się view_item_list

Konfiguracja aktywatora:

• Typ reguły: zdarzenie niestandardowe
• Nazwa zdarzenia: view_item_list
• Ta reguła uruchamia się, gdy jest spełniony ten warunek: Wszystkie zdarzenia niestandardowe

dataLayer.push({ ecommerce: null });  // Clear the previous ecommerce object.
dataLayer.push({
  event: "view_item_list",
  ecommerce: {
    item_list_id: "related_products",
    item_list_name: "Related products",
    items: [
     {
      item_id: "SKU_12345",
      item_name: "Stan and Friends Tee",
      affiliation: "Google Merchandise Store",
      coupon: "SUMMER_FUN",
      discount: 2.22,
      index: 0,
      item_brand: "Google",
      item_category: "Apparel",
      item_category2: "Adult",
      item_category3: "Shirts",
      item_category4: "Crew",
      item_category5: "Short sleeve",
      item_list_id: "related_products",
      item_list_name: "Related Products",
      item_variant: "green",
      location_id: "ChIJIQBpAG2ahYAR_6128GcTUEo",
      price: 10.03,
      quantity: 3
    },
    {
      item_id: "SKU_12346",
      item_name: "Google Grey Women's Tee",
      affiliation: "Google Merchandise Store",
      coupon: "SUMMER_FUN",
      discount: 3.33,
      index: 1,
      item_brand: "Google",
      item_category: "Apparel",
      item_category2: "Adult",
      item_category3: "Shirts",
      item_category4: "Crew",
      item_category5: "Short sleeve",
      item_list_id: "related_products",
      item_list_name: "Related Products",
      item_variant: "gray",
      location_id: "ChIJIQBpAG2ahYAR_6128GcTUEo",
      price: 21.01,
      promotion_id: "P_12345",
      promotion_name: "Summer Sale",
      quantity: 2
    }]
  }
});

Gdy użytkownik wybierze element z listy, wyślij zdarzenie select_item z wybranym elementem w parametrze tablicy items. Szczegółowe informacje o parametrach do wysłania znajdziesz w dokumentacji zdarzeń.

Uwaga: opcji Wyślij dane e-commerce można użyć zamiast tej konfiguracji tagu.

Pokaż konfigurację tagu

Konfiguracja tagu:

• Typ tagu: zdarzenie GA4
• Nazwa zdarzenia: select_item
• Zmienne warstwy danych (nazwa – nazwa zmiennej warstwy danych):
• Elementy e-commerce – ecommerce.items
• Identyfikator listy produktów e-commerce – ecommerce.item_list_id
• Nazwa listy elementów e-commerce – ecommerce.item_list_name
• Parametry zdarzenia (nazwa parametru – wartość):
• items – {{Elementy e-commerce}}
• item_list_id – {{identyfikator listy elementów e-commerce}}
• item_list_name – {{nazwa listy elementów e-commerce}}
• Reguła: zdarzenie równa się select_item

Konfiguracja aktywatora:

• Typ reguły: zdarzenie niestandardowe
• Nazwa zdarzenia: select_item
• Ta reguła uruchamia się, gdy jest spełniony ten warunek: Wszystkie zdarzenia niestandardowe

dataLayer.push({ ecommerce: null });  // Clear the previous ecommerce object.
dataLayer.push({
  event: "select_item",
  ecommerce: {
    item_list_id: "related_products",
    item_list_name: "Related products",
    items: [
    {
      item_id: "SKU_12345",
      item_name: "Stan and Friends Tee",
      affiliation: "Google Merchandise Store",
      coupon: "SUMMER_FUN",
      discount: 2.22,
      index: 0,
      item_brand: "Google",
      item_category: "Apparel",
      item_category2: "Adult",
      item_category3: "Shirts",
      item_category4: "Crew",
      item_category5: "Short sleeve",
      item_list_id: "related_products",
      item_list_name: "Related Products",
      item_variant: "green",
      location_id: "ChIJIQBpAG2ahYAR_6128GcTUEo",
      price: 10.01,
      quantity: 3
    }
    ]
  }
});

Wyświetl szczegóły elementu

Aby zmierzyć liczbę wyświetleń szczegółów produktu, wyślij zdarzenie view_item za każdym razem, gdy użytkownik wyświetli ekran z informacjami o produkcie. Szczegółowe informacje o parametrach do wysłania znajdziesz w dokumentacji zdarzeń.

Uwaga: opcji Wyślij dane e-commerce można użyć zamiast tej konfiguracji tagu.

Pokaż konfigurację tagu

Konfiguracja tagu:

• Typ tagu: zdarzenie GA4
• Nazwa zdarzenia: view_item
• Zmienne warstwy danych (nazwa – nazwa zmiennej warstwy danych):
• Elementy e-commerce – ecommerce.items
• Wartość e-commerce – ecommerce.value
• Waluta e-commerce – ecommerce.currency
• Parametry zdarzenia (nazwa parametru – wartość):
• items – {{Elementy e-commerce}}
• value – {{Wartość e-commerce}}
• currency – {{waluta e-commerce}}
• Reguła: zdarzenie równa się view_item

Konfiguracja aktywatora:

• Typ reguły: zdarzenie niestandardowe
• Nazwa zdarzenia: view_item
• Ta reguła uruchamia się, gdy jest spełniony ten warunek: Wszystkie zdarzenia niestandardowe

dataLayer.push({ ecommerce: null });  // Clear the previous ecommerce object.
dataLayer.push({
  event: "view_item",
  ecommerce: {
    currency: "USD",
    value: 30.03,
    items: [
    {
      item_id: "SKU_12345",
      item_name: "Stan and Friends Tee",
      affiliation: "Google Merchandise Store",
      coupon: "SUMMER_FUN",
      discount: 2.22,
      index: 0,
      item_brand: "Google",
      item_category: "Apparel",
      item_category2: "Adult",
      item_category3: "Shirts",
      item_category4: "Crew",
      item_category5: "Short sleeve",
      item_list_id: "related_products",
      item_list_name: "Related Products",
      item_variant: "green",
      location_id: "ChIJIQBpAG2ahYAR_6128GcTUEo",
      price: 10.01,
      quantity: 3
    }
    ]
  }
});

Dodawanie produktu do koszyka lub usuwanie go z niego

Wysyłając zdarzenie add_to_cart z odpowiednimi produktami w tablicy items, mierzysz dodawanie produktu do koszyka. Szczegółowe informacje o parametrach do wysłania znajdziesz w dokumentacji zdarzeń.

Uwaga: opcji Wyślij dane e-commerce można użyć zamiast tej konfiguracji tagu.

Pokaż konfigurację tagu

Konfiguracja tagu:

• Typ tagu: zdarzenie GA4
• Nazwa zdarzenia: add_to_cart
• Zmienne warstwy danych (nazwa – nazwa zmiennej warstwy danych):
• Elementy e-commerce – ecommerce.items
• Wartość e-commerce – ecommerce.value
• Waluta e-commerce – ecommerce.currency
• Parametry zdarzenia (nazwa parametru – wartość):
• items – {{Elementy e-commerce}}
• value – {{Wartość e-commerce}}
• currency – {{waluta e-commerce}}
• Wyzwalacz: zdarzenie równa się add_to_cart

Konfiguracja aktywatora:

• Typ reguły: zdarzenie niestandardowe
• Nazwa zdarzenia: add_to_cart
• Ta reguła uruchamia się, gdy jest spełniony ten warunek: Wszystkie zdarzenia niestandardowe

dataLayer.push({ ecommerce: null });  // Clear the previous ecommerce object.
dataLayer.push({
  event: "add_to_cart",
  ecommerce: {
    currency: "USD",
    value: 30.03,
    items: [
    {
      item_id: "SKU_12345",
      item_name: "Stan and Friends Tee",
      affiliation: "Google Merchandise Store",
      coupon: "SUMMER_FUN",
      discount: 2.22,
      index: 0,
      item_brand: "Google",
      item_category: "Apparel",
      item_category2: "Adult",
      item_category3: "Shirts",
      item_category4: "Crew",
      item_category5: "Short sleeve",
      item_list_id: "related_products",
      item_list_name: "Related Products",
      item_variant: "green",
      location_id: "ChIJIQBpAG2ahYAR_6128GcTUEo",
      price: 10.01,
      quantity: 3
    }
    ]
  }
});

Możesz też mierzyć dodanie produktu do listy życzeń, wysyłając zdarzenie add_to_wishlist z odpowiednimi elementami w tablicy items. Szczegółowe informacje o parametrach do wysłania znajdziesz w dokumentacji zdarzeń.

Uwaga: opcji Wyślij dane e-commerce można użyć zamiast tej konfiguracji tagu.

Pokaż konfigurację tagu

Konfiguracja tagu:

• Typ tagu: zdarzenie GA4
• Nazwa zdarzenia: add_to_wishlist
• Zmienne warstwy danych (nazwa – nazwa zmiennej warstwy danych):
• Elementy e-commerce – ecommerce.items
• Wartość e-commerce – ecommerce.value
• Waluta e-commerce – ecommerce.currency
• Parametry zdarzenia (nazwa parametru – wartość):
• items – {{Elementy e-commerce}}
• value – {{Wartość e-commerce}}
• currency – {{waluta e-commerce}}
• Wyzwalacz: zdarzenie równa się add_to_wishlist

Konfiguracja aktywatora:

• Typ reguły: zdarzenie niestandardowe
• Nazwa zdarzenia: add_to_wishlist
• Ta reguła uruchamia się, gdy jest spełniony ten warunek: Wszystkie zdarzenia niestandardowe

dataLayer.push({ ecommerce: null });  // Clear the previous ecommerce object.
dataLayer.push({
  event: "add_to_wishlist",
  ecommerce: {
    currency: "USD",
    value: 30.03,
    items: [
    {
      item_id: "SKU_12345",
      item_name: "Stan and Friends Tee",
      affiliation: "Google Merchandise Store",
      coupon: "SUMMER_FUN",
      discount: 2.22,
      index: 0,
      item_brand: "Google",
      item_category: "Apparel",
      item_category2: "Adult",
      item_category3: "Shirts",
      item_category4: "Crew",
      item_category5: "Short sleeve",
      item_list_id: "related_products",
      item_list_name: "Related Products",
      item_variant: "green",
      location_id: "ChIJIQBpAG2ahYAR_6128GcTUEo",
      price: 10.01,
      quantity: 3
    }
    ]
  }
});

Gdy użytkownik później wyświetli koszyk, wyślij zdarzenie view_cart ze wszystkimi produktami w koszyku. Szczegółowe informacje o parametrach do wysłania znajdziesz w dokumentacji zdarzeń.

Uwaga: opcji Wyślij dane e-commerce można użyć zamiast tej konfiguracji tagu.

Pokaż konfigurację tagu

Konfiguracja tagu:

• Typ tagu: zdarzenie GA4
• Nazwa zdarzenia: view_cart
• Zmienne warstwy danych (nazwa – nazwa zmiennej warstwy danych):
• Elementy e-commerce – ecommerce.items
• Wartość e-commerce – ecommerce.value
• Waluta e-commerce – ecommerce.currency
• Parametry zdarzenia (nazwa parametru – wartość):
• items – {{Elementy e-commerce}}
• value – {{Wartość e-commerce}}
• currency – {{waluta e-commerce}}
• Reguła: zdarzenie równa się view_cart

Konfiguracja aktywatora:

• Typ reguły: zdarzenie niestandardowe
• Nazwa zdarzenia: view_cart
• Ta reguła uruchamia się, gdy jest spełniony ten warunek: Wszystkie zdarzenia niestandardowe

dataLayer.push({ ecommerce: null });  // Clear the previous ecommerce object.
dataLayer.push({
  event: "view_cart",
  ecommerce: {
    currency: "USD",
    value: 30.03,
    items: [
    {
      item_id: "SKU_12345",
      item_name: "Stan and Friends Tee",
      affiliation: "Google Merchandise Store",
      coupon: "SUMMER_FUN",
      discount: 2.22,
      index: 0,
      item_brand: "Google",
      item_category: "Apparel",
      item_category2: "Adult",
      item_category3: "Shirts",
      item_category4: "Crew",
      item_category5: "Short sleeve",
      item_list_id: "related_products",
      item_list_name: "Related Products",
      item_variant: "green",
      location_id: "ChIJIQBpAG2ahYAR_6128GcTUEo",
      price: 10.01,
      quantity: 3
    }
    ]
  }
});

Aby mierzyć, kiedy użytkownik usuwa produkt z koszyka, wysyłaj zdarzenie remove_from_cart. Szczegółowe informacje o parametrach do wysłania znajdziesz w dokumentacji zdarzeń.

Uwaga: opcji Wyślij dane e-commerce można użyć zamiast tej konfiguracji tagu.

Pokaż konfigurację tagu

Konfiguracja tagu:

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

Konfiguracja aktywatora:

• Typ reguły: zdarzenie niestandardowe
• Nazwa zdarzenia: remove_from_cart
• Ta reguła uruchamia się, gdy jest spełniony ten warunek: Wszystkie zdarzenia niestandardowe

dataLayer.push({ ecommerce: null });  // Clear the previous ecommerce object.
dataLayer.push({
  event: "remove_from_cart",
  ecommerce: {
    currency: "USD",
    value: 30.03,
    items: [
    {
      item_id: "SKU_12345",
      item_name: "Stan and Friends Tee",
      affiliation: "Google Merchandise Store",
      coupon: "SUMMER_FUN",
      discount: 2.22,
      index: 0,
      item_brand: "Google",
      item_category: "Apparel",
      item_category2: "Adult",
      item_category3: "Shirts",
      item_category4: "Crew",
      item_category5: "Short sleeve",
      item_list_id: "related_products",
      item_list_name: "Related Products",
      item_variant: "green",
      location_id: "ChIJIQBpAG2ahYAR_6128GcTUEo",
      price: 10.01,
      quantity: 3
    }
    ]
  }
});

Rozpoczęcie procesu płatności

Pierwszy etap procesu płatności możesz mierzyć, wysyłając zdarzenie begin_checkout z co najmniej 1 produktem zdefiniowanym w odpowiednich polach. Na tym etapie można też dodać kupon do całego zamówienia przez dodanie go do zdarzenia lub zastosować do konkretnego elementu, dodając go do określonych elementów w tablicy items. Więcej informacji o parametrach do wysłania znajdziesz w dokumentacji zdarzeń.

Uwaga: opcji Wyślij dane e-commerce można użyć zamiast tej konfiguracji tagu.

Pokaż konfigurację tagu

Konfiguracja tagu:

• Typ tagu: zdarzenie GA4
• Nazwa zdarzenia: begin_checkout
• Zmienne warstwy danych (nazwa – nazwa zmiennej warstwy danych):
• Elementy e-commerce – ecommerce.items
• Wartość e-commerce – ecommerce.value
• Waluta e-commerce – ecommerce.currency
• Kupon e-commerce – ecommerce.coupon
• Parametry zdarzenia (nazwa parametru – wartość):
• items – {{Elementy e-commerce}}
• value – {{Wartość e-commerce}}
• currency – {{waluta e-commerce}}
• coupon – {{kupon e-commerce}}
• Wyzwalacz: zdarzenie równa się start_checkout

Konfiguracja aktywatora:

• Typ reguły: zdarzenie niestandardowe
• Nazwa zdarzenia: begin_checkout
• Ta reguła uruchamia się, gdy jest spełniony ten warunek: Wszystkie zdarzenia niestandardowe

dataLayer.push({ ecommerce: null });  // Clear the previous ecommerce object.
dataLayer.push({
  event: "begin_checkout",
  ecommerce: {
    currency: "USD",
    value: 30.03,
    coupon: "SUMMER_FUN",
    items: [
    {
      item_id: "SKU_12345",
      item_name: "Stan and Friends Tee",
      affiliation: "Google Merchandise Store",
      coupon: "SUMMER_FUN",
      discount: 2.22,
      index: 0,
      item_brand: "Google",
      item_category: "Apparel",
      item_category2: "Adult",
      item_category3: "Shirts",
      item_category4: "Crew",
      item_category5: "Short sleeve",
      item_list_id: "related_products",
      item_list_name: "Related Products",
      item_variant: "green",
      location_id: "ChIJIQBpAG2ahYAR_6128GcTUEo",
      price: 10.01,
      quantity: 3
    }
    ]
  }
});

Gdy użytkownik przejdzie do następnego etapu procesu płatności i doda informacje o dostawie, wyślij zdarzenie add_shipping_info. Użyj parametru shipping_tier, aby określić opcję dostawy dla użytkownika, np. „Transport lądowy”, „Lotnisko” lub „Następnego dnia”. Szczegółowe informacje o parametrach do wysłania znajdziesz w dokumentacji zdarzeń.

Uwaga: opcji Wyślij dane e-commerce można użyć zamiast tej konfiguracji tagu.

Pokaż konfigurację tagu

Konfiguracja tagu:

• Typ tagu: zdarzenie GA4
• Nazwa zdarzenia: add_shipping_info
• Zmienne warstwy danych (nazwa – nazwa zmiennej warstwy danych):
• Elementy e-commerce – ecommerce.items
• Wartość e-commerce – ecommerce.value
• Waluta e-commerce – ecommerce.currency
• Kupon e-commerce – ecommerce.coupon
• Poziom dostawy e-commerce – ecommerce.shipping_tier
• Parametry zdarzenia (nazwa parametru – wartość):
• items – {{Elementy e-commerce}}
• value – {{Wartość e-commerce}}
• currency – {{waluta e-commerce}}
• coupon – {{kupon e-commerce}}
• shipping_tier – {{Poziom dostawy e-commerce}}
• Wyzwalacz: zdarzenie równa się add_shipping_info

Konfiguracja aktywatora:

• Typ reguły: zdarzenie niestandardowe
• Nazwa zdarzenia: add_shipping_info
• Ta reguła uruchamia się, gdy jest spełniony ten warunek: Wszystkie zdarzenia niestandardowe

dataLayer.push({ ecommerce: null });  // Clear the previous ecommerce object.
dataLayer.push({
  event: "add_shipping_info",
  ecommerce: {
    currency: "USD",
    value: 30.03,
    coupon: "SUMMER_FUN",
    shipping_tier: "Ground",
    items: [
    {
      item_id: "SKU_12345",
      item_name: "Stan and Friends Tee",
      affiliation: "Google Merchandise Store",
      coupon: "SUMMER_FUN",
      discount: 2.22,
      index: 0,
      item_brand: "Google",
      item_category: "Apparel",
      item_category2: "Adult",
      item_category3: "Shirts",
      item_category4: "Crew",
      item_category5: "Short sleeve",
      item_list_id: "related_products",
      item_list_name: "Related Products",
      item_variant: "green",
      location_id: "ChIJIQBpAG2ahYAR_6128GcTUEo",
      price: 10.01,
      quantity: 3
    }
    ]
  }
});

Wysyłaj zdarzenie add_payment_info, gdy użytkownik prześle dane karty. W razie potrzeby uwzględnij w tym zdarzeniu payment_type w przypadku wybranej formy płatności. Szczegółowe informacje o parametrach do wysłania znajdziesz w dokumentacji zdarzeń.

Uwaga: opcji Wyślij dane e-commerce można użyć zamiast tej konfiguracji tagu.

Pokaż konfigurację tagu

Konfiguracja tagu:

• Typ tagu: zdarzenie GA4
• Nazwa zdarzenia: add_payment_info
• Zmienne warstwy danych (nazwa – nazwa zmiennej warstwy danych):
• Elementy e-commerce – ecommerce.items
• Wartość e-commerce – ecommerce.value
• Waluta e-commerce – ecommerce.currency
• Kupon e-commerce – ecommerce.coupon
• Typ płatności e-commerce – ecommerce.payment_type
• Parametry zdarzenia (nazwa parametru – wartość):
• items – {{Elementy e-commerce}}
• value – {{Wartość e-commerce}}
• currency – {{waluta e-commerce}}
• coupon – {{kupon e-commerce}}
• payment_type – {{Typ płatności e-commerce}}
• Wyzwalacz: zdarzenie równa się add_payment_info

Konfiguracja aktywatora:

• Typ reguły: zdarzenie niestandardowe
• Nazwa zdarzenia: add_payment_info
• Ta reguła uruchamia się, gdy jest spełniony ten warunek: Wszystkie zdarzenia niestandardowe

dataLayer.push({ ecommerce: null });  // Clear the previous ecommerce object.
dataLayer.push({
  event: "add_payment_info",
  ecommerce: {
    currency: "USD",
    value: 30.03,
    coupon: "SUMMER_FUN",
    payment_type: "Credit Card",
    items: [
    {
      item_id: "SKU_12345",
      item_name: "Stan and Friends Tee",
      affiliation: "Google Merchandise Store",
      coupon: "SUMMER_FUN",
      discount: 2.22,
      index: 0,
      item_brand: "Google",
      item_category: "Apparel",
      item_category2: "Adult",
      item_category3: "Shirts",
      item_category4: "Crew",
      item_category5: "Short sleeve",
      item_list_id: "related_products",
      item_list_name: "Related Products",
      item_variant: "green",
      location_id: "ChIJIQBpAG2ahYAR_6128GcTUEo",
      price: 10.01,
      quantity: 3
    }
    ]
  }
});

Dokonywanie zakupu lub przyznawanie zwrotu środków

Aby mierzyć zakup, wysyłaj zdarzenie purchase z co najmniej 1 elementem zdefiniowanym w odpowiednich polach. Szczegółowe informacje o parametrach do wysłania znajdziesz w dokumentacji zdarzeń.

Uwaga: opcji Wyślij dane e-commerce można użyć zamiast tej konfiguracji tagu.

Pokaż konfigurację tagu

Konfiguracja tagu:

• Typ tagu: zdarzenie GA4
• Nazwa zdarzenia: purchase
• Elementy e-commerce – ecommerce.items
• Identyfikator transakcji e-commerce – ecommerce.transaction_id
• Wartość e-commerce – ecommerce.value
• Podatek od e-commerce – ecommerce.tax
• Dostawa e-commerce – ecommerce.shipping
• Waluta e-commerce – ecommerce.currency
• Kupon e-commerce – ecommerce.coupon
• Parametry zdarzenia (nazwa parametru – wartość):
• items – {{Elementy e-commerce}}
• transaction_id – {{identyfikator transakcji e-commerce}}
• value – {{Wartość e-commerce}}
• tax – {{Podatek e-commerce;
• shipping – {{Wysyłka e-commerce}}
• currency – {{waluta e-commerce}}
• coupon – {{kupon e-commerce}}
• Reguła: zdarzenie równa się zakup

Konfiguracja aktywatora:

• Typ reguły: zdarzenie niestandardowe
• Nazwa zdarzenia: purchase
• Ta reguła uruchamia się, gdy jest spełniony ten warunek: Wszystkie zdarzenia niestandardowe

dataLayer.push({ ecommerce: null });  // Clear the previous ecommerce object.
dataLayer.push({
  event: "purchase",
  ecommerce: {
    transaction_id: "T_12345",
    // Sum of (price * quantity) for all items.
    value: 72.05,
    tax: 3.60,
    shipping: 5.99,
    currency: "USD",
    coupon: "SUMMER_SALE",
    items: [
    {
      item_id: "SKU_12345",
      item_name: "Stan and Friends Tee",
      affiliation: "Google Merchandise Store",
      coupon: "SUMMER_FUN",
      discount: 2.22,
      index: 0,
      item_brand: "Google",
      item_category: "Apparel",
      item_category2: "Adult",
      item_category3: "Shirts",
      item_category4: "Crew",
      item_category5: "Short sleeve",
      item_list_id: "related_products",
      item_list_name: "Related Products",
      item_variant: "green",
      location_id: "ChIJIQBpAG2ahYAR_6128GcTUEo",
      price: 10.01,
      quantity: 3
    },
    {
      item_id: "SKU_12346",
      item_name: "Google Grey Women's Tee",
      affiliation: "Google Merchandise Store",
      coupon: "SUMMER_FUN",
      discount: 3.33,
      index: 1,
      item_brand: "Google",
      item_category: "Apparel",
      item_category2: "Adult",
      item_category3: "Shirts",
      item_category4: "Crew",
      item_category5: "Short sleeve",
      item_list_id: "related_products",
      item_list_name: "Related Products",
      item_variant: "gray",
      location_id: "ChIJIQBpAG2ahYAR_6128GcTUEo",
      price: 21.01,
      promotion_id: "P_12345",
      promotion_name: "Summer Sale",
      quantity: 2
    }]
  }
});

Uwaga: zdarzenie purchase zastępuje zdarzenie ecommerce_purchase i różni się od zdarzenia in_app_purchase, które jest raportowane automatycznie.

Mierz zwroty środków, wysyłając zdarzenie refund z określonymi odpowiednimi wartościami transaction_id oraz co najmniej 1 produktem zdefiniowanym w polach item_id i quantity. Zalecamy, aby uwzględnić informacje o produkcie w zdarzeniu refund, aby umożliwić wyświetlanie w Analytics danych o zwrotach środków na poziomie produktu.

Szczegółowe informacje o parametrach do wysłania znajdziesz w dokumentacji zdarzeń.

Uwaga: opcji Wyślij dane e-commerce można użyć zamiast tej konfiguracji tagu.

Pokaż konfigurację tagu

Konfiguracja tagu:

• Typ tagu: zdarzenie GA4
• Nazwa zdarzenia: refund
• Zmienne warstwy danych (nazwa – nazwa zmiennej warstwy danych):
• Elementy e-commerce – ecommerce.items
• Identyfikator transakcji e-commerce – ecommerce.transaction_id
• Wartość e-commerce – ecommerce.value
• Podatek od e-commerce – ecommerce.tax
• Dostawa e-commerce – ecommerce.shipping
• Waluta e-commerce – ecommerce.currency
• Kupon e-commerce – ecommerce.coupon
• Parametry zdarzenia (nazwa parametru – wartość):
• items – {{Elementy e-commerce}}
• transaction_id – {{identyfikator transakcji e-commerce}}
• value – {{Wartość e-commerce}}
• tax – {{Podatek e-commerce;
• shipping – {{Wysyłka e-commerce}}
• currency – {{waluta e-commerce}}
• coupon – {{kupon e-commerce}}
• Reguła: zdarzenie równa się zwrot

Konfiguracja aktywatora:

• Typ reguły: zdarzenie niestandardowe
• Nazwa zdarzenia: refund
• Ta reguła uruchamia się, gdy jest spełniony ten warunek: Wszystkie zdarzenia niestandardowe

dataLayer.push({ ecommerce: null });  // Clear the previous ecommerce object.
dataLayer.push({
  event: "refund",
  ecommerce: {
    currency: "USD",
    transaction_id: "T_12345", // Transaction ID. Required for purchases and refunds.
    value: 30.03,
    coupon: "SUMMER_FUN",
    shipping: 3.33,
    tax: 1.11,
    items: [
    {
      item_id: "SKU_12345",
      item_name: "Stan and Friends Tee",
      affiliation: "Google Merchandise Store",
      coupon: "SUMMER_FUN",
      discount: 2.22,
      index: 0,
      item_brand: "Google",
      item_category: "Apparel",
      item_category2: "Adult",
      item_category3: "Shirts",
      item_category4: "Crew",
      item_category5: "Short sleeve",
      item_list_id: "related_products",
      item_list_name: "Related Products",
      item_variant: "green",
      location_id: "ChIJIQBpAG2ahYAR_6128GcTUEo",
      price: 10.01,
      quantity: 3
    }
    ]
  }
});

Uwaga: zdarzenie refund zastępuje ecommerce_refund.

Zastosuj promocje

E-commerce obejmuje obsługę pomiaru wyświetleń i kliknięć wewnętrznych promocji, takich jak banery wyświetlane w celu promocji wyprzedaży.

Wyświetlenia promocji są zwykle mierzone przy początkowym wyświetleniu ekranu przez wysłanie zdarzenia view_promotion z parametrem items określającym promowany produkt. Szczegółowe informacje o parametrach do wysłania znajdziesz w dokumentacji zdarzeń.

Uwaga: opcji Wyślij dane e-commerce można użyć zamiast tej konfiguracji tagu.

Pokaż konfigurację tagu

Konfiguracja tagu:

• Typ tagu: zdarzenie GA4
• Nazwa zdarzenia: view_promotion
• Zmienne warstwy danych (nazwa – nazwa zmiennej warstwy danych):
• Nazwa kreacji e-commerce – ecommerce.creative_name
• Boks kreacji e-commerce – ecommerce.creative_slot
• Identyfikator promocji e-commerce – ecommerce.promotion_id
• Nazwa promocji e-commerce – ecommerce.promotion_name
• Elementy e-commerce – ecommerce.items
• Parametry zdarzenia (nazwa parametru – wartość):
• creative_name – {{Nazwa kreacji e-commerce}}
• creative_slot – {{ boks kreacji e-commerce}}
• promotion_id – {{identyfikator promocji e-commerce}}
• promotion_name – {{Nazwa promocji e-commerce}}
• items – {{Elementy e-commerce}}
• Reguła: zdarzenie równa się view_promotion

Konfiguracja aktywatora:

• Typ reguły: zdarzenie niestandardowe
• Nazwa zdarzenia: view_promotion
• Ta reguła uruchamia się, gdy jest spełniony ten warunek: Wszystkie zdarzenia niestandardowe

dataLayer.push({ ecommerce: null });  // Clear the previous ecommerce object.
dataLayer.push({
  event: "view_promotion",
  ecommerce: {
    creative_name: "Summer Banner",
    creative_slot: "featured_app_1",
    promotion_id: "P_12345",
    promotion_name: "Summer Sale",
    items: [
    {
      item_id: "SKU_12345",
      item_name: "Stan and Friends Tee",
      affiliation: "Google Merchandise Store",
      coupon: "SUMMER_FUN",
      discount: 2.22,
      index: 0,
      item_brand: "Google",
      item_category: "Apparel",
      item_category2: "Adult",
      item_category3: "Shirts",
      item_category4: "Crew",
      item_category5: "Short sleeve",
      item_list_id: "related_products",
      item_list_name: "Related Products",
      item_variant: "green",
      location_id: "ChIJIQBpAG2ahYAR_6128GcTUEo",
      price: 10.01,
      quantity: 3
    }
    ]
  }
});

Aby wskazać, że użytkownik kliknął promocję, wyślij zdarzenie select_promotion z tym produktem jako parametrem produktu. Szczegółowe informacje o parametrach do wysłania znajdziesz w dokumentacji zdarzeń.

Uwaga: opcji Wyślij dane e-commerce można użyć zamiast tej konfiguracji tagu.

Pokaż konfigurację tagu

Konfiguracja tagu:

• Typ tagu: zdarzenie GA4
• Zmienne warstwy danych (nazwa – nazwa zmiennej warstwy danych):
• Nazwa kreacji e-commerce – ecommerce.creative_name
• Boks kreacji e-commerce – ecommerce.creative_slot
• Identyfikator promocji e-commerce – ecommerce.promotion_id
• Nazwa promocji e-commerce – ecommerce.promotion_name
• Elementy e-commerce – ecommerce.items
• Parametry zdarzenia (nazwa parametru – wartość):
• creative_name – {{Nazwa kreacji e-commerce}}
• creative_slot – {{ boks kreacji e-commerce}}
• promotion_id – {{identyfikator promocji e-commerce}}
• promotion_name – {{Nazwa promocji e-commerce}}
• items – {{Elementy e-commerce}}
• Typ zmiennej: zmienna warstwy danych – „ecommerce.items”
• Reguła: zdarzenie równa się select_promotion

Konfiguracja aktywatora:

• Typ reguły: zdarzenie niestandardowe
• Nazwa zdarzenia: select_promotion
• Ta reguła uruchamia się, gdy jest spełniony ten warunek: Wszystkie zdarzenia niestandardowe

dataLayer.push({ ecommerce: null });  // Clear the previous ecommerce object.
dataLayer.push({
  event: "select_promotion",
  ecommerce: {
    creative_name: "Summer Banner",
    creative_slot: "featured_app_1",
    promotion_id: "P_12345",
    promotion_name: "Summer Sale",
    items: [
    {
      item_id: "SKU_12345",
      item_name: "Stan and Friends Tee",
      affiliation: "Google Merchandise Store",
      coupon: "SUMMER_FUN",
      discount: 2.22,
      index: 0,
      item_brand: "Google",
      item_category: "Apparel",
      item_category2: "Adult",
      item_category3: "Shirts",
      item_category4: "Crew",
      item_category5: "Short sleeve",
      item_list_id: "related_products",
      item_list_name: "Related Products",
      item_variant: "green",
      location_id: "ChIJIQBpAG2ahYAR_6128GcTUEo",
      price: 10.01,
      quantity: 3
    }
    ]
  }
});

Użyj niestandardowej zmiennej JavaScriptu

Jeśli Twoja witryna nie obsługuje warstwy danych, możesz użyć niestandardowej zmiennej JavaScriptu, aby wywołać funkcję, która zwraca obiekt danych e-commerce. Obiekt powinien używać składni warstwy danych omówionej we wcześniejszej części tego przewodnika, na przykład:

// A Custom JavaScript Variable that returns an ecommerceData object
// that follows the data layer syntax.
function getEcommerceData() {
  var ecommerceProductData = [
    {
      item_name: "Stan and Friends Tee",
      item_id: "SKU_12345",  // ID is required.
      // Rest of the product data should follow the data layer syntax.
    },
    // Multiple products may be included.
  ];
  return ecommerceProductData;
}

Jeśli zdecydujesz się użyć niestandardowej zmiennej JavaScriptu, możesz używać jej w taki sam sposób jak warstwy danych – możesz podać wartość z parametru 'items' jako parametr zdarzenia w konfiguracji tagu.

Konfiguracja tagu:

• Typ tagu: zdarzenie GA4
• Nazwa zdarzenia: dowolna
• Odczyt danych ze zmiennej: {{gaEcommerceData}}
• Wyzwalacz: zdarzenie równa się gtm.dom

Ustawienia zmiennej gaEcommerceData

• Typ zmiennej: niestandardowy JavaScript
• Treść funkcji: skorzystaj z powyższego przykładu

Uwaga: w przykładowej konfiguracji tagu użyto elementu Element DOM dostępny (gtm.dom) do aktywowania tagu zdarzenia Google Analytics 4. Stosuj ten model, jeśli chcesz wczytać wszystkie elementy strony przed wysłaniem zdarzenia, aby móc pobierać wartości z modelu obiektu dokumentu (DOM). Możesz np. użyć modelu DOM w przypadku zdarzenia view_item_list, aby przed wysłaniem zdarzenia wczytane były elementy, które użytkownik widzi.