Jak tworzyć zdarzenia niestandardowe

Podsumowanie

Wykorzystaj niestandardowe zdarzenia w HubSpot, aby 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ć we wszystkich narzędziach HubSpot. Na przykład możesz chcieć śledzić zdarzenia offline, takie jak obecność na osobistej premierze produktu.

Poznaj trzy różne metody tworzenia zdarzeń niestandardowych. Zdarzenia niestandardowe można wysyłać za pośrednictwem API, przesyłać arkusz kalkulacyjny z danymi zdarzeń lub korzystać z webhooków (tylko w planachData Hub Professional i Enterprise ).

Po skonfigurowaniu zdarzenia niestandardowego możesz przeglądać dane dotyczące tego zdarzenia w różnych narzędziach. Możesz tworzyć raporty z danymi dotyczącymi zdarzeń niestandardowych, przeglądać wystąpienia zdarzeń niestandardowych na osiach czasu kontaktów oraz wykorzystywać zdarzenia niestandardowe w przepływach pracy.

Na koniec śledź wyniki swoich niestandardowych zdarzeń w narzędziu do zarządzania niestandardowymi zdarzeniami. Być może będziesz również musiał rozwiązać problemy z nieznanymi właściwościamiw narzędziu do zarządzania niestandardowymi zdarzeniami.

Jakie są różne metody tworzenia zdarzeń niestandardowych?

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

• Zdefiniuj zdarzenie w HubSpot, w tym wszelkie niestandardowe właściwości zdarzenia.
• Stwórz fragment kodu JavaScript lub zdefiniuj wywołanie API, które uruchomi zdarzenie.

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

• Wysyłanie przez API: użyj punktu końcowego definicji zdarzenia niestandardowego, aby utworzyć swoje zdarzenie. Następnie użyj identyfikatora zdarzenia w punkcie końcowym wysyłania zdarzenia niestandardowego, aby wysłać wystąpienia zdarzenia do HubSpot.
• Przechwytuj dane ze swojej witryny bez użycia API:
  • Kod JavaScript: korzystając z niestandardowego kodu JavaScript, możesz wstawić niestandardowy kod do skryptu śledzenia HubSpot za pomocą edytora kodu.
  • Użyj wizualizatora zdarzeń: śledź wyświetlenia stron lub kliknięte elementy, 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 rejestrować aktywność offline, uzupełniać dane lub ręcznie zintegrować dowolne narzędzie z HubSpot.
• Skonfiguruj webhooki (Data Hub tylko w planach Professional i Enterprise ): dostosuj warunki uruchamiania webhooka oraz dane, które będą wysyłane. 

Uwaga: wszelkie zdarzenia utworzone w starszej wersji narzędzia do zdarzeń niestandardowych przestaną działać po 1 sierpnia 2025 r.

Jak utworzyć niestandardowe zdarzenia za pomocą 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 potrzebne będzie kilka informacji, które można 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ą przesył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ę zdarzenia dla istniejącego zdarzenia oraz nazwy właściwości:

1. Na swoim koncie HubSpot przejdź do sekcjiZarządzanie danymi>Zarządzanie zdarzeniami.
2. Kliknij nazwę zdarzenia. Zostaniesz przeniesiony na stronę szczegółów zdarzenia.
3. W górnej części strony 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 zamierzasz zaktualizować, kliknij nazwę właściwości.
5. W prawym panelu kliknij ikonę kodu, a następnie wyświetl nazwę w sekcji Nazwa wewnętrzna.

Jak utworzyć niestandardowe zdarzenia za pomocą kodu JavaScript?

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

4. Wprowadź nazwę zdarzenia i opcjonalnie podaj jego opis.
5. Wybierz obiekt powiązany. Pozwala to powiązać wystąpienia zdarzenia z różnymi obiektami w HubSpot, w tym z kontaktami, firmami, transakcjami i zgłoszeniami. 

6. KliknijDalej.

Jak dodać właściwości do mojego zdarzenia?

Po utworzeniu zdarzenia dostępne będą domyślne właściwości zdarzenia. Można również utworzyć własne właściwości niestandardowe. 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 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łączone.
2. Aby utworzyć właściwości niestandardowe, wybierz typ właściwości, klikając opcję Typ pola dla danej właściwości. Dostępne opcje to: 
   • Własność typu niestandardowego ciągu znaków: utwórz właściwość, która jest ciągiem tekstu zwykłego. 
   • 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ść, która jest wartością daty. Dane należy przesłać w formacie milisekund epoki lub ISO8601.
   • Niestandardowa właściwość daty: utwórz właściwość, która jest wartością daty.
   • Niestandardowa właściwość logiczna: utwórz właściwość, która jest wartością logiczną. 
   • Własna właściwość wyliczeniowa: 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ługuj wiele wartości.

• • • Przed wysłaniem danych musisz ustawić wartości i etykiety. Jeśli ten krok nie zostanie wykonany 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 przez API, oddziel je ś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 opcję Fragment kodu JavaScript.
11. Kliknij„Gotowe”.

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, wpisując tekst w prawym panelu. Każdy dodany kod zostanie automatycznie uwzględniony w kodzie śledzenia HubSpot.
3. Po zakończeniu kliknij Utwórz, aby zakończyć tworzenie zdarzenia i automatycznie rozpocząć śledzenie.
    
   

Jak zaimportować niestandardowe dane zdarzeń z arkuszy kalkulacyjnych?

Prześlij dane dotyczące frekwencji z wydarzeń stacjonarnych, dane z datą i godziną pochodzące z aplikacji, których nie integrujesz z HubSpot, jednorazowe dane dotyczące potencjalnych klientów lub kampanii od dostawcy lub dowolne inne dane dotyczące wydarzeń w formie arkusza kalkulacyjnego. Wydarzenia pozwalają na rejestrowanie zachowań, a następnie wykorzystywanie ich w całym HubSpot. 

Importy mogą tworzyć i aktualizować następujące rekordy:

• Kontakty

• Firmy
• Transakcje
• Bilety
• Usługi
• Projekty
• Spotkania
• Kursy
• Oferty 
• Zamówienia
• Obiekty niestandardowe

Wymagane właściwości różnią się w zależności od typu obiektu.

Importy zdarzeń mogą być używane tylko w przypadku zdarzeń, które już miały miejsce. Plik importu niestandardowych zdarzeń musi zawierać następujące elementy:

• Adres e-mail do kontaktu.
• Wystąpiło o 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 koncie HubSpot przejdź do opcji Zarządzanie danymi > Zarządzanie zdarzeniami.
2. W prawym górnym rogu kliknijUtwórz wydarzenie, a następnie wybierzUtwórz wydarzenie niestandardowe.
3. Wybierz opcjęImportuj arkusz kalkulacyjny.
4. Kliknij opcję Utwórz nowe wydarzenie lub Importuj do istniejącego wydarzenia.
   • Jeśli wybierzesz opcję Importuj do istniejącego wydarzenia, użyj menu rozwijanego, aby wybrać istniejące wydarzenie, a następnie kontynuuj, wykonując kroki niezbędne do przesłania arkusza kalkulacyjnego.
   • Jeśli wybierzesz opcję Utwórz nowe wydarzenie, wykonaj poniższe czynności.
5. Wprowadź nazwę wydarzenia i opcjonalnie podaj jego opis.
6. Wybierz obiekt powiązany. W tej chwili wydarzenia utworzone poprzez import mogą być powiązane wyłącznie z kontaktami.
7. Prześlij arkusz kalkulacyjny lub wklej dane bezpośrednio z arkusza. Wybierz sposób importu obiektów oraz język pliku, a następnie kliknij Dalej.
8. Przypisz kolumny do właściwości wydarzenia i kontaktu, a następnie kliknij Dalej.
9. Potwierdź nazwę pliku importu.
10. Zaznacz pole wyboru, aby potwierdzić, że kontakty oczekują wiadomości od Ciebie oraz że plik importu nie zawiera zakupionej listy. Dowiedz się więcej o zasadach dopuszczalnego użytkowania HubSpot.
11. Wybierz format daty dla właściwości „Wystąpiło w ”.
12. Kliknij Zakończ import.

Jak wysyłać niestandardowe zdarzenia przez punkt końcowy API?

1. Na swoim 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 wydarzenia:
   • Wpisz nazwęwłaściwości. Nazwa ta zostanieró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 powiązać obiekty:
   • Kliknij menu rozwijane Wybierzobiekt główny, a następnie wybierz powiązany obiekt. Pozwala to powiązać wystąpienia zdarzeń z różnymi obiektami, w tym kontaktami, firmami, transakcjami i zgłoszeniami.
   • KliknijDostosuj dopasowanie i wybierz identyfikator dopasowania między rekordami zdarzenia a obiektu. Zdarzenie zostanie powiązane z rekordem obiektu tylko wtedy, gdy ich identyfikatory dopasowania będą identyczne. Jeśli używasz niestandardowego identyfikatora dopasowania, wybrana właściwość obiektu musi wymagać unikalnych wartości.
7. Kliknij„Dalej”.
8. Aby śledzić wydarzenie w HubSpot, kliknijopcję Kopiuj obok identyfikatora śledzenia.
9. KliknijUtwórz wydarzenie.

Jak utworzyć niestandardowe zdarzenia za pomocą webhooków?

Ustaw warunki, które uruchomią webhook.

1. W swoim 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. Wybierzopcję Konfiguruj webhooki.
4. Wprowadźnazwę wydarzenia 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 dostawcy, która dokładnie odpowiada właściwości obiektu w HubSpot. 

Gdzie mogę wyświetlić i wykorzystać dane zdarzeń niestandardowych w HubSpot?

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

Możesz otworzyć wybrane zdarzenia bezpośrednio w wybranych narzędziach HubSpot, korzystając z menu rozwijanego akcji na liście zdarzeń, w widoku pojedynczego zdarzenia lub w prawym górnym rogu wykresów w zakładce analizy.

Jak tworzyć raporty z danymi niestandardowych zdarzeń

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

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

Jak przeglądać wystąpienia 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świetlać aktywności na osi czasu w przypadku zdarzeń niestandardowych utworzonych przy użyciu webhooków.

Jak korzystać z wydarzeń niestandardowych w przepływach pracy?

W przepływie pracy można wprowadzić opóźnienie w oparciu o wystąpienia zdarzeń niestandardowych, używając Opóźnij do momentu wystąpienia zdarzenia lub 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ę Konfiguruj wyzwalacze.
   • W panelu po lewej stronie wybierz opcję Gdy wystąpi zdarzenie. Skonfiguruj wyzwalacz, a następnie kliknij Zastosuj filtr.
   • Aby jeszcze bardziej zawęzić wyzwalacz, kliknij Dodaj filtry zawężające. Możesz wybrać dodatkowe właściwości, aby zawęzić 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łączaj ponownie za każdym razem, gdy wystąpi wyzwalacz.
4. Aby dodać opóźnienie:
   • W edytorze przepływu pracy kliknij ikonę plusa (+), aby dodać akcję przepływu pracy.
   • W prawym panelu wybierz opcję Opóźnij do momentu wystąpienia zdarzenia.
   • Skonfiguruj opóźnienie:
     • Kliknij menu rozwijane „Zdarzenie”, a następnie wybierz zdarzenie niestandardowe.
     • Następnie wybierz właściwość zdarzenia, na którą chcesz zastosować opóźnienie.
     • Wybierz filtr dla tej właściwości zdarzenia.
     • Kliknij Zastosuj filtr.
   • • Wybierz maksymalny czas oczekiwania lub zaznacz pole wyboru Opóźnij tak długo, jak to możliwe.
5. Kliknij Zapisz.

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

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

Jak zarządzać i śledzić stan mojego zdarzenia niestandardowego oraz monitorować błędy dostarczania?

Aby zapewnić dokładność danych i prawidłowe działanie integracji, można skorzystać z zakładki Monitor w narzędziu do zarządzania zdarzeniami.

Jak śledzić wydajność w narzędziu do zarządzania zdarzeniami niestandardowymi?

• Trendy dotyczące realizacji: Na koncie HubSpot przejdź do opcji Zarządzanie danymi > Zarządzanie zdarzeniami. Kliknij kartę Monitoruj, aby porównać liczbę zrealizowanych zdarzeń w różnych okresach.

• Rozwiązywanie problemów z błędami dostarczania: Na koncie HubSpot przejdź do opcji Zarządzanie danymi > Zarządzanie zdarzeniami. Na lewym pasku bocznym karty Monitor wybierz opcję Błędy dostarczania. Ta tabela identyfikuje zdarzenia, których synchronizacja nie powiodła się, i podaje konkretną przyczynę niepowodzenia (np. niezgodność typów danych lub naruszenia schematu).

Jak rozwiązać błędy „Nieznana właściwość” w narzędziu do zarządzania zdarzeniami niestandardowymi?

Jeśli dane są wysyłane przez API dla właściwości, która nigdy nie została zdefiniowana w HubSpot, pojawi się to w dzienniku błędów. Możesz to szybko rozwiązać:

1. Najedź kursorem na zdarzenie w tabeli „Dzienniki błędów ”.

2. Kliknij Działania, a następnie wybierzDodaj właściwości do zdarzenia.

3. Potwierdź sugerowane typy pól, aby HubSpot mógł natychmiast zacząć akceptować te dane.