Jak tworzyć niestandardowe zdarzenia behawioralne za pomocą kreatora kodu HubSpot?

Zdarzenia niestandardowe pozwalają definiować i śledzić zdarzenia charakterystyczne dla Twojej firmy. Zdarzenia niestandardowe można powiązać z właściwościami zdarzeń, które następnie można wykorzystać w narzędziach HubSpot. 

Istnieją różne sposoby tworzenia zdarzeń niestandardowych: 

• Wysyłanie przez API: użyj punktu końcowego definicji zdarzenia niestandardowego, aby utworzyć zdarzenie. Następnie użyj identyfikatora zdarzenia w punkcie końcowym wysyłania zdarzenia niestandardowego, aby wysłać wystąpienia zdarzenia do HubSpot.
• Przechwytywanie danych z witryny internetowej bez API:
  • Kod Javascript: za pomocą niestandardowego Javascript można wstawić niestandardowy kod do skryptu śledzącego HubSpot, korzystając z edytora kodu.
  • Użyj wizualizatora zdarzeń (tylkoMarketing Hub Enterprise ): śledź wyświetlenia stron lub kliknięcia elementów, wybierając je na swojej stronie internetowej. Dowiedz się więcej o tworzeniu zdarzeń niestandardowych za pomocą wizualizatora zdarzeń.
• Importuj arkusz kalkulacyjny: prześlij arkusz kalkulacyjny z danymi zdarzeń, aby przechwycić aktywność offline, uzupełnić dane lub ręcznie zintegrować dowolne narzędzie z HubSpot.
• Skonfiguruj webhooki (tylkoDataHub Professional i Enterprise): dostosuj warunki wyzwalające webhook oraz dane, które będą wysyłane. 

Uwaga: wszelkie zdarzenia utworzone w starszej wersji narzędzia Zdarzenia niestandardowe przestaną działać po 1 sierpnia 2025 r.

Proces tworzenia zdarzeń składa się z dwóch części:

• Zdefiniowanie zdarzenia w HubSpot, w tym wszelkich niestandardowych właściwości zdarzenia.
• Tworzenie fragmentu kodu JavaScript lub definiowanie wywołania API, które uruchomi zdarzenie. 

Tworzenie zdarzenia za pośrednictwem API

Jeśli wysyłasz dane do HubSpot za pośrednictwem API, możesz skorzystać zopcji Wyślij przez API lub użyć punktu końcowego definicji zdarzenia niestandardowego, aby utworzyć swoje zdarzenie. Dowiedz się więcej o definiowaniu wywołania API w dokumentacji dla programistów HubSpot.

Do wywołania API potrzebujesz kilku informacji, które możesz uzyskać w HubSpot:

• Nazwa zdarzenia: wewnętrzna nazwa zdarzenia. 
• Nazwy właściwości: wewnętrzne nazwy właściwości, do których będą wysyłane dane.

Aby zakończyć tworzenie zdarzenia w celu wysłania danych za pośrednictwem API:

• Wybierz opcję Wyślij dane do HubSpot i skopiuj identyfikator śledzenia.
• Kliknij Utwórz.

Aby znaleźć wewnętrzną nazwę istniejącego zdarzenia i nazwy właściwości:

1. Na koncie HubSpot przejdź do sekcjiZarządzanie danymi>Zarządzanie zdarzeniami.
2. Kliknij nazwę zdarzenia. Zostaniesz przeniesiony do strony szczegółów zdarzenia.
3. W górnej części znajdź nazwę zdarzenia w sekcji Nazwa wewnętrzna. Aby skopiować nazwę wewnętrzną, kliknij ikonę kopiowania obok nazwy. 
   
   
4. Aby znaleźć nazwy wewnętrzne właściwości, które będziesz aktualizować, kliknij nazwę właściwości.
5. W prawym panelu kliknij ikonę kodu, a następnie wyświetl nazwę w sekcji Nazwa wewnętrzna.

Tworzenie zdarzeń za pomocą fragmentu kodu JavaScript

1. W swoim koncie HubSpot przejdź do sekcjiZarządzanie danymi>Zarządzanie wydarzeniami.
2. W prawym górnym rogu kliknijUtwórz zdarzenie, a następnie wybierz Utwórz zdarzenie niestandardowe.
3. Wybierz opcjęKod JavaScript.

4. Wprowadź nazwę zdarzenia i opcjonalnie dodaj jego opis.
5. Wybierz opcję Powiązany obiekt. Dzięki temu możesz powiązać wystąpienia zdarzenia z różnymi obiektami w HubSpot, w tym z kontaktami, firmami, transakcjami i zgłoszeniami. 

6. KliknijDalej.

Dodawanie właściwości

Po utworzeniu zdarzenia dostępne będą domyślne właściwości zdarzenia. Możesz również utworzyć własne właściwości niestandardowe. Właściwości zdarzenia są przechowywane oddzielnie od innych właściwości CRM i są unikalne dla danego zdarzenia (tj. nie można edytować tych właściwości w ustawieniach konta). 

1. Aby wyłączyć tworzenie domyślnych właściwości zdarzenia, przełącz opcjęDomyślne właściwości zdarzenia na wyłączoną.
2. Aby utworzyć właściwości niestandardowe, wybierz typ właściwości, klikając typ pola dla swojej właściwości. Dostępne opcje to: 
   • Niestandardowa właściwość ciągu znaków: utwórz właściwość, która jest zwykłym ciągiem znaków tekstowych. 
   • Niestandardowa właściwość liczbowa: utwórz właściwość, która jest wartością liczbową.
   • Właściwość niestandardowego znacznika czasu: utwórz właściwość będącą wartością daty. Dane należy przesłać w formacie milisekund epoki lub ISO8601.
   • Właściwość niestandardowa daty: utwórz właściwość będącą wartością daty.
   • Właściwość niestandardowa typu logiczny: utwórz właściwość będącą wartością logiczną. 
   • Właściwość niestandardowa typu wyliczeniowego: utwórz właściwość z zestawem predefiniowanych wartości.
3. Po wybraniu właściwości skonfiguruj ją w prawym panelu:

8. Wprowadź nazwę właściwości i opis właściwości.
   • W przypadku właściwości wyliczeniowych kliknij Dalej i wprowadź etykiety oraz wartości właściwości.
     • Właściwości wyliczeniowe mogą być pojedyncze lub wielokrotnego wyboru. Aby włączyć wartości wielokrotnego wyboru, włącz przełącznikObsługa wielu wartości.

• • • Przed wysłaniem danych należy ustawić wartości i etykiety. Jeśli ten krok nie zostanie wykonany przed wysłaniem danych, które nie znajdują się na liście, dane te nie będą dostępne do wykorzystania. Aby wysłać wiele wartości za pośrednictwem API, należy je oddzielić średnikiem.

9. Kliknij Dalej.
10. Po skonfigurowaniu zdarzenia i jego właściwości możesz dodać to zdarzenie do kodu śledzenia swojej witryny, wybierając fragment kodu JavaScript.
11. KliknijGotowe.

Tworzenie zdarzeń za pomocą fragmentu kodu JavaScript pozwala automatycznie dodać JavaScript do kodu śledzenia HubSpot. Można to wykorzystać do przechwytywania bardziej złożonych danych zdarzeń, których kod śledzenia nie przechwytuje domyślnie. 

1. Wybierz fragment kodu JavaScript. Użyj fragmentu kodu w prawym panelu, aby śledzić zdarzenie w HubSpot. Wszelkie utworzone właściwości niestandardowe zostaną wstępnie zdefiniowane w fragmencie kodu. 
2. W razie potrzeby zmodyfikuj fragment, wprowadzając tekst w prawym panelu. Każdy dodany kod zostanie automatycznie uwzględniony jako część kodu śledzenia HubSpot.
3. Po zakończeniu kliknij Utwórz, aby zakończyć tworzenie zdarzenia i automatycznie rozpocząć śledzenie.
    
   

Importowanie danych wydarzeń

Prześlij dane dotyczące frekwencji z wydarzeń stacjonarnych, dane z sygnaturą czasową pochodzące z aplikacji, które nie są zintegrowane z HubSpot, jednorazowe dane potencjalnych klientów lub dane kampanii od dostawcy lub inne dane dotyczące wydarzeń w formie arkusza kalkulacyjnego. Wydarzenia umożliwiają rejestrowanie zachowań, a następnie wykorzystywanie tych zachowań w całym HubSpot. 

• Adres e-mail kontaktowy.
• Wystąpiło o godzinie. Dowiedz się więcej o formatowaniu właściwości daty w plikach importu.

Przykładowy plik

Aby zaimportować niestandardowe wydarzenia:

1. W koncie HubSpot przejdź do sekcjiZarządzanie danymi>Zarządzanie zdarzeniami.
2. W prawym górnym rogu kliknijUtwórz wydarzenie, a następnie wybierzUtwórz wydarzenie niestandardowe.
3. WybierzImportuj arkusz kalkulacyjny.
4. Wprowadź nazwę zdarzenia i opcjonalnie dodaj jego opis.
5. Wybierz obiekt powiązany. W tej chwili wydarzenia utworzone poprzez import mogą być powiązane tylko z kontaktami.
6. Prześlij plik. Wybierz sposób importowania obiektów i język pliku, a następnie kliknij Dalej.
7. Przypisz kolumny do właściwości wydarzenia i kontaktu, a następnie kliknij Dalej.
8. Potwierdź nazwę importowanego pliku.
9. Zaznacz pole wyboru, aby potwierdzić, że kontakty oczekują wiadomości od Ciebie i że plik importu nie zawiera zakupionej listy. Dowiedz się więcej o zasadach dopuszczalnego użytkowania HubSpot.
10. Wybierz format daty właściwości „Wystąpiło o ”.
11. Kliknij przycisk Zakończ import.

Utwórz wydarzenia za pośrednictwem API

1. Na koncie HubSpot przejdź do sekcjiZarządzanie danymi>Zarządzanie wydarzeniami.
2. W prawym górnym rogu kliknijUtwórz wydarzenie, a następnie wybierzUtwórz wydarzenie niestandardowe.
3. Wybierz opcjęWyślij przez API.

4. Wprowadź nazwę zdarzenia i opcjonalnie podaj jego opis. 

5. Aby dodać niestandardowe właściwości zdarzenia:
   • Wpisz nazwęwłaściwości. Nazwa ta zostanie również zastosowana jakonazwa wewnętrzna.
   • Kliknij menu rozwijaneTyp pola i wybierz typ pola.
   • Opcjonalnie dodajopis.
   • Jeśli chcesz dodać więcej niestandardowych właściwości, kliknij+ Dodaj niestandardową właściwość.
   • KliknijDalej.

6. Aby połączyć obiekty:
   • Kliknij menu rozwijane Wybierzobiekt główny, a następnie wybierz powiązany obiekt. Umożliwia to powiązanie wystąpień zdarzeń z różnymi obiektami, w tym kontaktami, firmami, transakcjami i zgłoszeniami.
   • KliknijDostosuj dopasowanie i wybierz identyfikator dopasowania między rekordami zdarzenia i obiektu. Zdarzenie zostanie połączone z rekordem obiektu tylko wtedy, gdy ich identyfikatory dopasowania są identyczne. Jeśli używasz niestandardowego identyfikatora dopasowania, wybrana właściwość obiektu musi wymagać unikalnych wartości.
7. KliknijDalej.
8. Aby śledzić zdarzenie w HubSpot, kliknijopcję Kopiuj obok identyfikatora śledzenia.
9. Kliknij opcjęUtwórz zdarzenie.

Skonfiguruj webhooki

Ustaw warunki, które będą wyzwalać webhook.

1. W swoim koncie HubSpot przejdź do sekcjiZarządzanie danymi>Zarządzanie zdarzeniami.
2. W prawym górnym rogu kliknijopcję Utwórz zdarzenie, a następnie wybierz opcję Utwórz zdarzenie niestandardowe.
3. Wybierz opcjęKonfiguracja webhooków.
4. Wprowadźnazwę zdarzenia i wybierzpowiązany obiekt.
5. KliknijDalej.
6. Skonfiguruj zdarzenie testowe:
   • Skopiuj adresURL webhooka. 
   • Przejdź dostrony ustawień webhookóww aplikacji zewnętrznej, z którą chcesz się zintegrować.
   • Wklej skopiowany adres URL.
   • Kliknij Wyślij zdarzenie testowe.
7. KliknijDalej.
8. Sprawdź właściwości swojego webhooka. Kliknij menurozwijane Typ właściwości, aby wybrać typ właściwości. 

9. KliknijDalej.
10. Wybierz właściwość z webhooka zewnętrznego, która dokładnie odpowiada właściwości obiektu HubSpot. 

Korzystaj z danych niestandardowych zdarzeń

Dane niestandardowych zdarzeń można przeglądać i wykorzystywać w narzędziach HubSpot. Poniżej dowiesz się, gdzie można przeglądać wystąpienia zdarzeń i w jaki sposób można włączyć te dane do innych narzędzi.

Wybrane zdarzenia można otworzyć bezpośrednio w wybranych narzędziach HubSpot za pomocą menu rozwijanego działań na liście zdarzeń, widoku pojedynczego zdarzenia lub w prawym górnym rogu wykresów w zakładce analizy.

Raportowanie zdarzeń niestandardowych

Wystąpienia zdarzeń niestandardowych można analizować za pomocą narzędzia zdarzeń niestandardowych, a dane zdarzeń będą również dostępne w kreatorze raportów niestandardowych i raportach atrybucji.

Dowiedz się więcej o analizowaniu zdarzeń niestandardowych.

Wyświetlanie zdarzeń na osi czasu kontaktu

Wystąpienia zdarzeń pojawią się na osi czasu rekordu kontaktu wraz z wszelkimi wypełnionymi właściwościami.

Aby wyświetlić szczegóły zdarzenia na osi czasu kontaktu:

1. Przejdź do rekordu kontaktu, w którym wystąpiło zdarzenie niestandardowe.
2. Aby filtrować oś czasu kontaktu według wystąpień zdarzeń, kliknij opcję Filtruj aktywność, a następnie wybierz opcję Zdarzenie niestandardowe.
3. Na osi czasu kontaktu kliknij, aby rozwinąć zdarzenie i wyświetlić jego szczegóły.

Uwaga: nie można wyświetlić aktywności na osi czasu dla zdarzeń niestandardowych utworzonych za pomocą webhooków.

Używanie zdarzeń niestandardowych w przepływach pracy

W przepływie pracy można opóźnić działanie na podstawie wystąpień zdarzeń niestandardowych, używając opcji Opóźnij do momentu wystąpienia zdarzenia lub wyzwalacza rejestracji zdarzenia.

1. Na koncie HubSpot przejdź do Automatyzacja > Przepływy pracy.
2. Kliknij nazwę przepływu pracy. Możesz też dowiedzieć się, jak utworzyć nowy przepływ pracy.
3. Aby dodać wyzwalacz:
   • W edytorze przepływu pracy kliknij opcję Skonfiguruj wyzwalacze.
   • W lewym panelu wybierz opcję Gdy wystąpi zdarzenie. Skonfiguruj wyzwalacz, a następnie kliknij opcję Zastosuj filtr.
   • Aby jeszcze bardziej udoskonalić wyzwalacz, kliknij Dodaj filtry udoskonalające. Możesz wybrać dodatkowe właściwości, aby udoskonalić obiekty, które chcesz włączyć do przepływu pracy.
   • Domyślnie rekordy zostaną włączone do przepływu pracy tylko wtedy, gdy po raz pierwszy spełnią warunki wyzwalacza. Aby włączyć ponowne włączenie, w sekcji Czy [obiekt] powinien zostać ponownie włączony do tego przepływu pracy? wybierz opcję Tak, włącz ponownie za każdym razem, gdy wystąpi wyzwalacz.
4. Aby dodać opóźnienie:
   • W edytorze przepływu pracy kliknij ikonę +, aby dodać akcję przepływu pracy.
   • W prawym panelu wybierz opcję Opóźnij do wystąpienia zdarzenia.
   • Skonfiguruj opóźnienie:
     • Kliknij menu rozwijane Zdarzenie, a następnie wybierz zdarzenie niestandardowe.
     • Następnie wybierz właściwość zdarzenia, które chcesz opóźnić.
     • Wybierz filtr dla właściwości zdarzenia.
     • Kliknij opcję Zastosuj filtr.
   • • Wybierz maksymalny czas oczekiwania lub zaznacz pole wyboru Opóźnij tak długo, jak to możliwe .
5. Kliknij przycisk Zapisz.

Uwaga:wszystkie wyzwalacze rejestracji zdarzeń zostaną rozdzielone za pomocą operatora OR. Oznacza to, że aby rekord został zarejestrowany w przepływie pracy, musi wystąpić tylko jeden z wyzwalaczy rejestracji zdarzeń.

Przepływ pracy opóźni wtedy zarejestrowane rekordy, dopóki nie spełnią one określonych kryteriów zdarzenia niestandardowego, lub zostanie uruchomiony, gdy zdarzenie nastąpi.