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 niestandardowych zdarzeń:

• Wysyłanie przez API: użyj punktu końcowego Custom event definition, aby utworzyć wydarzenie. Następnie użyj identyfikatora wydarzenia z punktem końcowym Wyślij wydarzenie niestandardowe, aby wysłać zakończenia wydarzeń do HubSpot.
• Przechwytywanie danych z witryny 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 (tylkoOperations Hub Professional i Enterprise): dostosuj warunki, które powodują uruchomienie webhooka i dane, które zostaną wysłane.

Uwaga: narzędzie zdarzeń niestandardowych zastępuje dotychczasowe narzędzie zdarzeń. Wszelkie zdarzenia utworzone w starszym narzędziu będą nadal działać i nadal można nimi zarządzać i analizować je w starszym narzędziu.

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 wywoła zdarzenie.

Tworzenie zdarzenia 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ć niestandardowego punktu końcowego definicji zdarzenia, 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.
• 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 do wysyłania danych przez 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:

• Na koncie HubSpot przejdź do sekcji Zarządzanie danymi > Niestandardowe zdarzenia.
• Kliknij opcję Zdarzenia niestandardowe.
• Kliknij nazwę wydarzenia. Zostaniesz przeniesiony na stronę szczegółów wydarzenia.
• U góry znajdź nazwę wydarzenia w sekcji Nazwa wewnętrzna.
  
  
  

• Aby znaleźć wewnętrzne nazwy właściwości, które będą aktualizowane, kliknij nazwę właściwości.
• W prawym panelu kliknij ikonę kodu, a następnie wyświetl nazwę w sekcji Nazwa wewnętrzna.

Tworzenie zdarzeń za pomocą fragmentu kodu Javascript

• Na koncie HubSpot przejdź do sekcji Zarządzanie danymi > Niestandardowe zdarzenia.
• W prawym górnym rogu kliknij Utwórz wydarzenie.
• Wybierz kod Javascript.

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

• Kliknij przycisk Dalej.

Dodaj właściwości

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

• Aby wyłączyć tworzenie domyślnych właściwości zdarzeń, należy wyłączyć opcję Domyślne właściwości zdarzeń.
• 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
  • Niestandardowa właściwość ciągu: utwórz właściwość, która jest zwykłym ciągiem tekstowym.
  • Niestandardowa właściwość liczbowa: utwórz właściwość będącą 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.
  • Niestandardowa właściwość wyliczeniowa: utwórz właściwość z zestawem predefiniowanych wartości.
    
    
    
  • Po wybraniu właściwości skonfiguruj ją w prawym panelu:

• • Wprowadź nazwę nieruchomoś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.

• • • Przed wysłaniem do nich danych należy ustawić wartości i etykiety. 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.

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

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ąć jego śledzenie.
  
  

Importowanie danych zdarzeń

Prześlij 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 inne dane dotyczące wydarzeń w formie arkusza kalkulacyjnego. Wydarzenia umożliwiają rejestrowanie 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:

• Na koncie HubSpot przejdź do sekcji Zarządzanie danymi > Niestandardowe zdarzenia.

• W prawym górnym rogu kliknij Utwórz wydarzenie.
• Wybierz opcję Importuj arkusz kalkulacyjny.

• Wprowadź nazwę wydarzenia i opcjonalnie podaj jego opis.
• Wybierz powiązany obiekt. Obecnie zdarzenia utworzone za pomocą importu mogą być powiązane tylko z kontaktami.

• Prześlij plik. Wybierz sposób importowania obiektów i język pliku, a następnie kliknij Dalej.

• Zmapuj kolumny do właściwości zdarzeń i kontaktów, a następnie kliknij przycisk Dalej.

• Potwierdź nazwę pliku importu.
• kliknij pole wyboru, aby wyrazić zgodę na to, ż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.
• Wybierz format daty dla właściwości Occurred at.
• Kliknij przycisk Zakończ import.

Tworzenie zdarzeń za pośrednictwem interfejsu API

• Na koncie HubSpot przejdź do sekcji Zarządzanie danymi > Niestandardowe zdarzenia.
• W prawym górnym rogu kliknij Utwórz wydarzenie.
• Wybierz opcję Wyślij przez API.

• Wprowadź nazwę wydarzenia i opcjonalnie podaj jego opis. Kliknij przycisk Dalej.
• Dodaj właściwości, wykonując następujące kroki. Pamiętaj, aby utworzyć niestandardową właściwość zdarzenia reprezentującą pasujący identyfikator. Kliknij przycisk Next.
• 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 identyfikatora dopasowania, wybrana właściwość obiektu musi wymagać unikalnych wartości.
• Kliknij przycisk Dalej.

Konfiguracja webhooków

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

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

• Kliknij przycisk Dalej.
• 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.
• Kliknij przycisk Dalej.
• Przejrzyj właściwości elementu webhook. Kliknij menu rozwijane Property type , aby wybrać typ właściwości.

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

Używanie 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 wydarzenia i w jaki sposób możesz włączyć te dane do innych narzędzi.

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

Raportowanie zdarzeń niestandardowych

Ukoń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 zdarzeń niestandardowych.

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

Ukończone zdarzenia 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:

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

Używanie niestandardowych zdarzeń w przepływach pracy

W przepływie pracy można opóźniać na podstawie niestandardowych zakończeń zdarzeń za pomocą akcjiOpóźnij do wystąpienia zdarzenia lub wyzwalacza rejestracji zdarzenia.

• Na koncie HubSpot przejdź do Automatyzacja > Przepływy pracy.
• Kliknij nazwę przepływu pracy. Możesz też dowiedzieć się, jak utworzyć nowy przepływ pracy.
• 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 przycisk 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.
• 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 .
• 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 opóźni następnie zapisanie rekordów, dopóki nie spełnią one określonych niestandardowych kryteriów zdarzenia lub zostaną uruchomione po wystąpieniu zdarzenia.