Wdrażanie zdarzeń e‑commerce

Przed wdrożeniem skryptów zdarzeń, należy dodać skrypt osadzenia pixela na każdej stronie witryny. Instrukcja

Oczekiwane typy danych parametrów opisano na stronie:
Dostępne zdarzenia i wymagane parametry

View ‑ wszystkie strony

Wpinamy na: strona główna i wszystkie pozostałe podstrony serwisu. Co obsługuje: ogólny kod do wpięcia na cały serwis, jest to event analityczny. Event wywoływany na init.

<script>
  wph('track', 'ViewContent', { content_name: 'View' });
</script>

ProductList ‑ strona z listą produktów

Wpinamy na: strony kategorii, listingi produktowe, spisy produktów lub usług, strona główna jeśli występują bloki list produktowych (nie dotyczy widgetów rekomedacji). Co obsługuje: przekazuje listy produktów danej kategorii, ich ceny, nazwy oraz ID produktowe. Event wywoływany na init.

<script>
  wph('track', 'ViewContent', {
    content_name: 'ProductList',
    currency: 'WALUTA', // np. 'PLN', 'EUR'
    contents: [
      {
        id: 'PRODUKT_ID1', // typ text np. 'SUP1234', '878-3939', 'abcd-xyz'
        name: 'NAZWA_PRODUKTU1', // np. 'Ekstra niebieska sukienka'
        category: 'KATEGORIA_PRODUKTU1', // typ text np. 'Sukienki'
        price: CENA_PRODUKTU1 // typ number np. 19.45
      },
      {
        id: 'PRODUKT_ID2',
        name: 'NAZWA_PRODUKTU2',
        category: 'KATEGORIA_PRODUKTU2',
        price: CENA_PRODUKTU2
      },
    ],
  });
</script>

ViewProduct ‑ strona produktu

Wpinamy na: strony produktowe lub usług. Co obsługuje: przekazuje dane o produkcie, w szczególności o ID produktu, cenie, nazwie i kategorii. Event wywoływany na init.

<script>
  wph('track', 'ViewContent', {
    content_name: 'ViewProduct',
    currency: 'WALUTA',
    contents: [
      {
        id: 'PRODUKT_ID1',
        name: 'NAZWA_PRODUKTU1',
        category: 'KATEGORIA_PRODUKTU1',
        price: CENA_PRODUKTU1
      },
    ],
  });
</script>

AddToCart ‑ dodanie do koszyka

Wpinamy na: wszędzie, gdzie istnieje możliwość dodania produktu lub usługi do koszyka (strony produktowe, listy produktowe, strony kategorii). Co obsługuje: przekazuje dane o wybranym produkcie, w szczególności o ID produktu, cenie, nazwie i kategorii. Event wywoływany na moment dodania do koszyka (klik w przycisk lub event request).

<script>
  wph('track', 'AddToCart', {
    currency: 'WALUTA',
    contents: [
      {
        id: 'PRODUKT_ID1',
        name: 'NAZWA_PRODUKTU1',
        category: 'KATEGORIA_PRODUKTU1',
        price: CENA_PRODUKTU1,
        quantity: ILOŚĆ_PRODUKTU1
      },
    ],
  });
</script>

Purchase ‑ strona podsumowania po dokonaniu transakcji

Wpinamy na: strona potwierdzenia zakupu (checkout success/done), a gdy taka nie występuje to na stronę potwierdzenia zamówienia nawet przed przejściem do bramki płatniczej. Co obsługuje: przekazuje dane o transakcji, w szczególności o produktach, ID transakcji, wartość koszyka, dostawy, itp. Event wywoływany na init lub event request.

<script>
  wph('track', 'Purchase', {
    transaction_id: 'ID_TRANSAKCJI', // typ text np. 'SUP1234', '878-3939', 'abcd-xyz'
    value: WARTOŚĆ_NETTO_BEZ_KOSZTU_DOSTAWY, // typ number np. 19.99
    value_gross: WARTOŚĆ_BRUTTO_BEZ_KOSZTU_DOSTAWY, // typ number np. 23.59
    shipping_cost: KOSZT_DOSTAWY, // typ number np. 9.99
    currency: 'WALUTA', // np. 'PLN', 'EUR'
    contents: [
      {
        id: 'PRODUKT_ID1',
        name: 'NAZWA_PRODUKTU1',
        category: 'KATEGORIA_PRODUKTU1',
        price: CENA_PRODUKTU1
        quantity: ILOŚĆ_PRODUKTU1
      },
      {
        id: 'PRODUKT_ID2',
        name: 'NAZWA_PRODUKTU2',
        category: 'KATEGORIA_PRODUKTU2',
        price: CENA_PRODUKTU2
        quantity: ILOŚĆ_PRODUKTU2
      },
    ],
  });
</script>

AddToWishList ‑ dodanie do ulubionych ‑ zdarzenie pośrednie

Wpinamy na: wszędzie, gdzie istnieje możliwość dodania produktu lub usługi do listy ulubionych (strony produktowe, listy produktowe, strony kategorii). Co obsługuje: przekazuje dane o wybranym produkcie, w szczególności o ID produktu, cenie, nazwie i kategorii lub też może być pusty, wtedy jest eventem analitycznym. Event wywoływany na moment dodania produktu do ulubionych (klik lub event request).

<script>
  wph('track', 'ViewContent', {
    content_name: 'AddToWishList',
    currency: 'WALUTA',
    contents: [
      {
        id: 'PRODUKT_ID1',
        name: 'NAZWA_PRODUKTU1',
        category: 'KATEGORIA_PRODUKTU1',
        price: CENA_PRODUKTU1
      },
    ],
  });
</script>

RemoveFromWishList ‑ usunięcie z ulubionych ‑ zdarzenie pośrednie

Wpinamy na: wszędzie, gdzie istnieje możliwość usunięcia produktu lub usługi z ulubionych (strony produktowe, listy produktowe, strony kategorii, strona ulubionych). Co obsługuje: przekazuje dane o usuniętym produkcie, w szczególności o ID produktu, cenie, nazwie i kategorii lub też może być pusty, wtedy jest eventem analitycznym. Event wywoływany na moment usunięcia produktu z ulubionych (klik lub event request).

<script>
  wph('track', 'ViewContent', {
    content_name: 'RemoveFromWishList',
    currency: 'WALUTA',
    contents: [
      {
        id: 'PRODUKT_ID1',
        name: 'NAZWA_PRODUKTU1',
        category: 'KATEGORIA_PRODUKTU1',
        price: CENA_PRODUKTU1
      },
    ],
  });
</script>

WishList ‑ dodanie do koszyka oferty wcześniej dodanej do ulubionych ‑ zdarzenie konwersji

Wpinamy na: wszędzie, gdzie istnieje możliwość dodania produktu lub usługi do koszyka (strony produktowe, listy produktowe, strony kategorii). Co obsługuje: przekazuje dane o wybranym produkcie, w szczególności o ID produktu, cenie, nazwie i kategorii. Event wywoływany na moment dodania do koszyka produktu uprzednio dodanego do ulubionych (klik lub event request).

<script>
  wph('track', 'Conversion', {
    content_name: 'WishList',
    currency: 'WALUTA',
    contents: [
      {
        id: 'PRODUKT_ID1',
        name: 'NAZWA_PRODUKTU1',
        category: 'KATEGORIA_PRODUKTU1',
        price: CENA_PRODUKTU1
      },
    ],
  });
</script>

Najczęściej zadawane pytania (FAQ)

Dane nie zbierają się poprawnie lub są problemy z działaniem Pixela

Upewnij się, że np.: 'PRODUKT_ID1' jest zawsze automatycznie zastępowane rzeczywistym ID produktu na każdej stronie — wpisanie go dosłownie spowoduje błędne działanie.