Zdarzenia produktowe pozwalają śledzić, jak kontakty wchodzą w interakcję z Twoimi produktami – na przykład gdy wyświetlają produkt, dodają go do koszyka lub finalizują zakup. Te dane możesz następnie wykorzystać w automatyzacjach, segmentach i analityce, dzięki czemu lepiej zrozumiesz zachowania klientów i spersonalizujesz komunikację.
W tym artykule wyjaśniamy, jak wysyłać zdarzenia produktowe oraz jakich zasad należy przestrzegać, aby dane były poprawnie zapisywane.
Aby dowiedzieć się więcej o zdarzeniach produktowych, zajrzyj do artykułu „Czym jest zdarzenie produktowe".
Istnieją 2 sposoby wysyłania zdarzeń produktowych do User.com:
Javascript SDK
REST API
Ogólnie wysyłanie zdarzeń produktowych przypomina wysyłanie standardowych zdarzeń. Jest jednak kilka aspektów, na które trzeba zwrócić uwagę:
Podczas wysyłania zdarzenia produktowego używaj słowa kluczowego product_event.
Uwzględnij wymagane atrybuty: „product_id" oraz „event_type"
Przekazywanie nazwy produktu jest opcjonalne. Jeśli jej nie podasz, a produkt jeszcze nie istnieje, zostanie on utworzony bez nazwy.
Lista typów zdarzeń jest zamknięta. Nie możesz dodawać nowych. Dostępne opcje to:
click
promo click
view
detail
liking
add to observation
reservation
add
add to cart
remove
checkout
checkout option
order
purchase
return
refund
Możesz dołączyć atrybuty produktu, takie jak „nazwa produktu", „kategoria" lub dowolne inne atrybuty niestandardowe, których potrzebujesz.
Przed wysłaniem zdarzeń produktowych upewnij się, że atrybuty produktu już istnieją w Twoim workspace. Ważne jest zachowanie tego samego typu atrybutu.
User.com nie przechowuje historycznych wartości atrybutów zdarzeń produktowych (z wyjątkiem event_type). Każde nowe zdarzenie produktowe aktualizuje bieżące wartości atrybutów w profilu produktu. Oznacza to, że starsze wartości są nadpisywane.
Ponieważ atrybuty produktu zawsze odzwierciedlają najnowszą wartość, nie będziesz w stanie śledzić różnic między wariantami w obrębie jednego produktu. Jeśli musisz rozróżniać warianty (np. te same buty w różnych rozmiarach), utwórz osobny produkt dla każdego wariantu i przypisz każdemu z nich unikalne product_id.
Aby Twoje dane były uporządkowane i łatwe w obsłudze, zalecamy utworzenie atrybutów produktu jeszcze przed ich wysłaniem do systemu. Dzięki temu z wyprzedzeniem przypiszesz odpowiedni typ danych (np. integer, boolean, date i inne).
Jeśli atrybut zostanie wysłany bez wcześniejszego zdefiniowania, zostanie automatycznie utworzony jako string. Może to obniżyć dokładność filtrowania i ograniczyć możliwości segmentacji oraz raportowania w przyszłości.
Aby zapoznać się z dostępnymi typami atrybutów i wybrać najlepszą opcję dla swoich potrzeb, zajrzyj do tego artykułu.
Endpointy REST API do wysyłania zdarzenia produktowego:
Poniżej znajdziesz przykład wysłania zdarzenia produktowego za pomocą REST API:
curl -X POST
"https://<your_app_subdomain>.user.com/api/public/products-by-id/"
-H 'authorization: Token <your_64_char_api_key>'
-H 'content-type: application/json'
-d '{
"name": "my product",
"custom_id": "my_product_id",
"product_url": "https://myshop.com/products/my_product/",
"image_url": "https://myshop.com/media/products/myproduct.jpg"
}'Jeśli wyślesz zdarzenie produktowe bez podania nazwy, system najpierw sprawdzi, czy produkt o danym „product_id" już istnieje.
Jeśli nie zostanie znaleziony pasujący produkt, zostanie utworzony nowy produkt z tym „product_id", ale zapisany bez nazwy.
Zdarzenie produktowe możesz również wyzwolić bezpośrednio z HTML – na przykład gdy kontakt kliknie przycisk lub link.
<a href="#"
onclick="userengage('product_event', {
product_id: 'the_id',
event_type: 'add to cart',
name: 'product name',
my_attribute: 'value',
my_attribute_2: 'value_2'
})">
CLICK ME!
</a>Dla lepszej organizacji danych i długoterminowej elastyczności zdecydowanie zalecamy tworzenie atrybutów produktu przed ich wysłaniem do systemu. Zdefiniowanie atrybutów z wyprzedzeniem pozwala ustawić właściwy typ danych (np. integer, boolean, date itd.).
Jeśli atrybuty nie zostaną wcześniej zdefiniowane, zostaną automatycznie utworzone z typem danych string . Może to obniżyć precyzję filtrowania i ograniczyć Twoje możliwości segmentacji i raportowania w przyszłości.
Aby zapoznać się z dostępnymi typami atrybutów i wybrać odpowiedni dla swojego przypadku użycia, zajrzyj do tego artykułu.
Aby wysyłać zdarzenia produktowe metodą JavaScript, upewnij się, że żądanie zawiera wymagane parametry.
Pola wymagane:
product_id
event_type
Pola opcjonalne:
name
description
Dowolne dodatkowe atrybuty zdarzenia produktowego istotne dla Twojego przypadku użycia
Dla „event_type" wybierz jedną z predefiniowanych wartości wymienionych wcześniej w tym artykule.
Przykład:
userengage("product_event", {
product_id: "12345",
event_type: "add to cart",
name: "Product Name",
description: "Product description"
});Zrozumienie zainteresowań klientów i intencji zakupowych: śledź kluczowe akcje, takie jak wyświetlenia produktów, kliknięcia, dodania do koszyka i zakupy, dzięki czemu lepiej zrozumiesz, czym interesują się klienci i w którym momencie rezygnują z procesu zakupowego.
Zwiększanie konwersji dzięki zautomatyzowanym follow-upom w czasie rzeczywistym: wykorzystuj zdarzenia produktowe do uruchamiania automatyzacji opartych na zachowaniu klientów. Na przykład wysyłaj przypomnienia lub oferty, gdy kontakt dodaje produkt do koszyka, ale nie finalizuje zakupu.
Tworzenie precyzyjniejszych segmentów do działań targetowanych: buduj segmenty na podstawie realnych interakcji z produktami, dzięki czemu dotrzesz do właściwej grupy odbiorców z trafnymi komunikatami – np. do klientów, którzy oglądali konkretny produkt lub wykazali zainteresowanie konkretną kategorią.
Mierzenie zaangażowania produktowego i optymalizacja wyników: analizuj dane ze zdarzeń produktowych w czasie, aby oceniać popularność produktów, śledzić trendy zaangażowania i identyfikować produkty radzące sobie najlepiej lub najgorzej – co pozwala podejmować lepsze decyzje marketingowe i sprzedażowe.
Zwiększanie przychodów dzięki spersonalizowanym rekomendacjom produktowym: wykorzystuj zdarzenia zakupu, aby polecać produkty trafnie dopasowane do tego, co klienci już kupili. Dzięki temu możesz prowadzić dedykowane kampanie promujące produkty komplementarne lub podobne, zachęcając do ponownych zakupów i zwiększając średnią wartość zamówienia.
Stosuj odpowiednie typy danych dla atrybutów, aby zachować dokładność i spójność. Na przykład ustaw „Price" jako „float", aby uniknąć błędów.
Dostosuj dane produktowe, dodając atrybuty zgodne z potrzebami Twojego biznesu, co pozwala na precyzyjniejsze śledzenie i analizę.
Strategicznie zarządzając produktami, odkryjesz wartościowe insighty i zwiększysz skuteczność swoich działań marketingowych i angażujących.