Tworzenie zdarzeń niestandardowych

Zdarzenia niestandardowe umożliwiają definiowanie i śledzenie zdarzeń, które są unikalne dla Twojej firmy. Zdarzenia niestandardowe można powiązać z właściwościami zdarzeń, których można następnie używać we wszystkich narzędziach HubSpot.

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

• Wyślij przez API: użyj punktu końcowego definicji zdarzenia niestandardowego, aby utworzyć zdarzenie. Następnie użyj identyfikatora zdarzenia z punktem końcowym Wyślij niestandardowe zdarzenie, aby wysłać zakończenia zdarzeń do HubSpot.
• Przechwytywanie danych z witryny internetowej bez interfejsu API:
  • Kod JavaScript: za pomocą Custom Javascript można wstawić niestandardowy kod do skryptu śledzenia HubSpot za pomocą edytora kodu.
  • Użyj wizualizatora zdarzeń (tylkoMarketing Hub Enterprise ): śledź odsłony strony lub kliknięte elementy, wybierając je na swojej stronie internetowej. Dowiedz się więcej o tworzeniu niestandardowych zdarzeń 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.
• Konfiguracja webhooków (tylkoData Hub Professional i Enterprise): dostosuj warunki, które uruchamiają webhook i dane, które zostaną wysłane.

Uwaga: wszelkie wydarzenia utworzone w starszym narzędziu Custom Events nie będą już działać po 1 sierpnia 2025 roku.

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

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

Tworzenie wydarzenia za pośrednictwem interfejsu API

Jeśli wysyłasz dane do HubSpot za pośrednictwem interfejsu API, możesz użyć opcji Wyślij przez API lub użyć punktu końcowego definicji zdarzenia niestandardowego, aby utworzyć zdarzenie. Więcej informacji na temat definiowania wywołań API można znaleźć w dokumentacji HubSpot dla programistów.

Do wywołania API potrzebnych będzie kilka informacji, które można uzyskać z poziomu HubSpot:

• Nazwa zdarzenia: wewnętrzna nazwa zdarzenia.
• Property names: 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 interfejsu API:

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

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

1. Na koncie HubSpot przejdź do opcji Sprzedaż > Zarządzanie danymi > Zarządzanie zdarzeniami.
2. Kliknij nazwę zdarzenia. Nastąpi przeniesienie do strony szczegółów wydarzenia.
3. U góry znajdź nazwę wydarzenia w sekcji Nazwa wewnętrzna. Aby skopiować nazwę wewnętrzną, kliknij ikonę kopiowania obok nazwy.
   
   
4. Aby znaleźć wewnętrzne nazwy 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. Na koncie HubSpot przejdź do sekcji Zarządzanie danymi > Zarządzanie zdarzeniami.
2. W prawym górnym rogu kliknij Utwórz zdarzenie.
3. Wybierz Kod Javascript.

4. Wprowadź nazwę zdarzenia i opcjonalnie podaj jego opis.
5. Wybierz powiązany obiekt. Umożliwia to powiązanie ukończenia wydarzenia z różnymi obiektami w HubSpot, w tym z kontaktami, firmami, transakcjami i biletami.

6. Kliknij przycisk Dalej.

Dodawanie właściwości

Po utworzeniu zdarzenia dostępne będą jego domyślne właściwości. Można również tworzyć własne niestandardowe właściwości. Właściwości zdarzeń są przechowywane oddzielnie od innych właściwości CRM i są unikalne dla danego zdarzenia (tj. nie można ich edytować z poziomu ustawień konta).

1. Na swoim koncie HubSpot przejdź do Zarządzanie danymi > Zarządzanie wydarzeniami.
2. W prawym górnym rogu kliknij Utwórz wydarzenie.
3. Wybierz Kod Javascript.
4. Wprowadź nazwę wydarzenia i opcjonalnie podaj jego opis.
5. Aby wyłączyć tworzenie domyślnych właściwości zdarzeń, należy wyłączyć opcję Domyślne właściwości zdarzeń.
6. Aby utworzyć niestandardowe właściwości, wybierz typ właściwości, klikając Typ pola dla właściwości. Dostępne opcje to:
   • Custom string property: utwórz właściwość, która jest zwykłym ciągiem tekstowym.
   • Niestandardowa właściwość liczbowa: utwórz właściwość, która jest wartością liczbową.
   • Niestandardowa właściwość znacznika czasu: utwórz właściwość będącą wartością daty. Musisz wysłać dane w postaci milisekund epoki lub ISO8601.
   • Custom date property: utwórz właściwość będącą wartością daty.
   • Niestandardowa właściwość boolean: utwórz właściwość będącą wartością boolean.
   • Custom enumeration property: tworzenie właściwości z zestawem predefiniowanych wartości.
7. Po wybraniu właściwości skonfiguruj ją w prawym panelu:

8. Wprowadź nazwę właściwości i wprowadź jej opis.
   • W przypadku właściwości Enumeration kliknij przycisk Next i wprowadź etykiety i wartości właściwości.
     • Właściwości wyliczeniowe mogą być jedno- lub wielokrotnego wyboru. Aby włączyć wartości wielokrotnego wyboru, włącz przełącznik Support multi-value.

• • • Wartości i etykiety należy ustawić przed wysłaniem do nich danych. Jeśli ten krok nie zostanie ukończony przed wysłaniem danych, których nie ma na liście, dane te nie będą dostępne do użycia. Aby wysłać wiele wartości za pośrednictwem interfejsu API, oddziel je średnikiem.

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

Tworzenie zdarzeń za pomocą fragmentu kodu Javascript umożliwia automatyczne dodawanie 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.

• 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 we fragmencie kodu.
• Zmodyfikuj fragment kodu według potrzeb, wprowadzając tekst w prawym panelu. Każdy dodany kod zostanie automatycznie uwzględniony jako część kodu śledzenia HubSpot.
• Po zakończeniu kliknij przycisk Utwórz , aby zakończyć wydarzenie i automatycznie rozpocząć śledzenie.
  

Importowanie danych wydarzeń

Prześlij swoje dane dotyczące frekwencji z wydarzeń osobistych, dane ze znacznikami czasu pochodzące z aplikacji, których nie integrujesz z HubSpot, jednorazowe dane dotyczące potencjalnych klientów lub kampanii od dostawcy lub wszelkie inne dane dotyczące wydarzeń w formie arkusza kalkulacyjnego. Wydarzenia umożliwiają przechwytywanie zachowań, a następnie wykorzystywanie ich w HubSpot.

• Kontaktowy adres e-mail.
• Wystąpiło w znaczniku czasu. Dowiedz się więcej o formatowaniu właściwości daty w plikach importu.

Przykładowy plik

Aby zaimportować zdarzenia niestandardowe:

1. Na swoim koncie HubSpot przejdź do sekcji Zarządzanie danymi > Zarządzanie wydarzeniami.
2. W prawym górnym rogu kliknij Utwórz wydarzenie.
3. Wybierz opcję Importuj arkusz kalkulacyjny.

4. Wprowadź nazwę wydarzenia i opcjonalnie podaj jego opis.
5. Wybierz powiązany obiekt. Obecnie wydarzenia utworzone za pomocą importu 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. Zmapuj kolumny do właściwości zdarzeń i kontaktów, a następnie kliknij przycisk Dalej.
8. Potwierdź nazwę pliku importu.
9. Kliknij pole wyboru, aby zgodzić się, ż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 Occurred at.
11. Kliknij przycisk Zakończ import.

Utwórz zdarzenia przez API

1. Na koncie HubSpot przejdź do sekcji Zarządzanie danymi > Zarządzanie zdarzeniami.
2. W prawym górnym rogu kliknij Utwórz zdarzenie.
3. Wybierz opcję Wyślij przez API.

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

5. Aby dodać niestandardowe właściwości wydarzenia:
   • Wpisz nazwę właściwości. Nazwa ta zostanie również zastosowana do nazwy wewnętrznej .
   • Kliknij menu rozwijane Typ pola i wybierz typ pola.
   • Opcjonalnie dodaj opis.
   • Jeśli chcesz dodać więcej właściwości niestandardowych, kliknij + Dodaj właściwość niestandardową.
   • Kliknij przycisk Dalej.

6. Aby połączyć obiekty:
   • Kliknij menu rozwijane Wybierzobiekt podstawowy, a następnie wybierz powiązany obiekt. Umożliwia to powiązanie ukończonych wydarzeń z różnymi obiektami, w tym kontaktami, firmami, transakcjami i biletami.
   • Kliknij przycisk Dostosuj dopasowanie i wybierz pasujący identyfikator między rekordami wydarzenia i obiektu. Wydarzenie będzie powiązane z rekordem obiektu tylko wtedy, gdy ich pasujące identyfikatory będą identyczne. Jeśli używasz niestandardowego ID dopasowania, wybrana właściwość obiektu musi wymagać unikalnych wartości.
7. Kliknij przycisk Dalej.
8. Aby śledzić wydarzenie w HubSpot, kliknijKopiuj obok identyfikatora śledzenia.
9. Kliknij przycisk Utwórz zdarzenie.

Konfigurowanie webhooków

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

1. Na koncie HubSpot przejdź do sekcji Zarządzanie danymi > Zarządzanie wydarzeniami.
2. W prawym górnym rogu kliknij Utwórz wydarzenie.
3. Wybierz Konfiguracja webhooków.
4. Wprowadź nazwę zdarzenia i wybierz powiązany obiekt.

5. Kliknij przycisk Dalej.
6. Skonfiguruj zdarzenie testowe:
   • Skopiuj adres URL webhook.
   • Przejdź do strony ustawień webhook w aplikacji innej firmy, z którą chcesz się zintegrować.
   • Wklej skopiowany adres URL.
   • Kliknij Wyślij zdarzenie testowe.
7. Kliknij przycisk Dalej.
8. Przejrzyj właściwości elementu webhook. Kliknij menu rozwijane Property type , aby wybrać typ właściwości.

9. Kliknij przycisk Dalej.
10. Wybierz właściwość z elementu webhook innej firmy, która dokładnie odpowiada właściwości obiektu HubSpot.

Korzystanie z niestandardowych danych zdarzeń

Niestandardowe dane zdarzeń można wyświetlać i wykorzystywać we wszystkich narzędziach HubSpot. Poniżej dowiesz się, gdzie wyświetlić ukończone zdarzenia i w jaki sposób możesz włączyć te dane do innych narzędzi.

Wybrane wydarzenia można otworzyć bezpośrednio w wybranych narzędziach HubSpot za pomocą menu rozwijanego akcji na liście wydarzeń, widoku pojedynczego wydarzenia lub w prawym górnym rogu wykresów na karcie analizy.

Raportowanie zdarzeń niestandardowych

Zakończenia 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 wydarzeń niestandardowych.

Wyświetlanie ukończonych wydarzeń na osi czasu kontaktu

Zakończenie wydarzenia pojawi się na osi czasu rekordu kontaktu, wraz z wszelkimi wypełnionymi właściwościami.

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

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

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

Używanie zdarzeń niestandardowych w przepływach pracy

W przepływie pracy można opóźniać na podstawie ukończenia zdarzeń niestandardowych za pomocą akcjiOpóź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 Konfiguruj wyzwalacze.
   • W lewym panelu wybierz opcję Gdy wystąpi zdarzenie. Skonfiguruj wyzwalacz, a następnie kliknij Zastosuj filtr.
   • Aby doprecyzować triger, kliknij Dodaj filtry doprecyzowujące. Możesz wybrać dodatkowe właściwości, aby doprecyzować obiekty, które chcesz zarejestrować w przepływie pracy.
   • Domyślnie rekordy będą rejestrowane w przepływie pracy tylko za pierwszym razem, gdy spełnią kryteria rejestracji. Aby włączyć ponowną rejestrację, w sekcji Czy [obiekt] powinien zostać ponownie zarejestrowany w tym przepływie pracy, wybierz Tak, ponownie rejestruj za każdym razem, gdy wystąpi wyzwalacz.
4. Aby dodać opóźnienie:
   • W edytorze przepływu pracy kliknij ikonę + plus, 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, dla której chcesz ustawić opóźnienie.
     • Wybierz filtr dla właściwości zdarzenia.
     • Kliknij przycisk 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 tylko jeden z wyzwalaczy rejestracji zdarzeń musi wystąpić, aby rekord został zarejestrowany w przepływie pracy.

Przepływ pracy będzie następnie opóźniał zarejestrowane rekordy, dopóki nie spełnią określonych niestandardowych kryteriów zdarzenia lub zostaną wyzwolone po wystąpieniu zdarzenia.