Przejdź do treści
Uwaga: Tłumaczenie tego artykułu jest podane wyłącznie dla wygody. Tłumaczenie jest tworzone automatycznie za pomocą oprogramowania tłumaczącego i mogło nie zostać sprawdzone. W związku z tym, angielska wersja tego artykułu powinna być uważana za wersję obowiązującą, zawierającą najnowsze informacje. Możesz uzyskać do niej dostęp tutaj.

Tworzenie niestandardowych zdarzeń

Data ostatniej aktualizacji: listopada 8, 2024

Dostępne z każdą z następujących podpisów, z wyjątkiem miejsc, w których zaznaczono:

Marketing Hub   Enterprise
Sales Hub   Enterprise
Service Hub   Enterprise
Operations Hub   Enterprise
Content Hub   Enterprise

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óre można następnie wykorzystać we wszystkich narzędziach HubSpot.

Zdarzenia można tworzyć na trzy różne sposoby:

  • Wysyłanie przez API: użyj punktu końcowego Custom event definition, 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 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.

 

Uwaga: narzędzie zdarzeń niestandardowych zastępuje starsze narzędzie zdarzeń. Wszelkie zdarzenia utworzone w starszym narzędziu będą nadal działać, a Ty nadal możesz zarządzać i analizować te zdarzenia w starszym narzędziu.

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

  • Zdefiniowanie zdarzenia w HubSpot, w tym wszelkich niestandardowych właściwości zdarzenia.
  • Utworzenie fragmentu kodu Javascript lub zdefiniowanie wywołania API , które wywoła zdarzenie.

Zdarzenie utworzone przez API

Jeśli wysyłasz dane do HubSpot za pośrednictwem interfejsu API, musisz użyć niestandardowego punktu końcowego definicji zdarzenia, aby utworzyć zdarzenie. Następnie należy zdefiniować wywołanie API w celu uruchomienia zdarzenia. Dowiedz się, jak zdefiniować wywołanie API w dokumentacji deweloperskiej HubSpot.

Będziesz potrzebować kilku informacji do wywołania API, które możesz uzyskać z wnętrza HubSpot:

  • Nazwa zdarzenia: wewnętrzna nazwa zdarzenia.
  • Właściwośćnames: 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 Zdarzenia niestandardowe.
  • Kliknij nazwę zdarzenia. Nastąpi przejście do strony szczegółów zdarzenia.
  • U góry znajdź nazwę zdarzenia w sekcji Nazwa wewnętrzna.

    internal-name-custom-event
  • Aby znaleźć wewnętrzne nazwy właściwości, które będziesz aktualizować, kliknij nazwę właściwości.
  • W prawym panelu kliknij ikonę kodu, a następnie wyświetl nazwę w sekcji Nazwa wewnętrzna.
Uwaga:
Podczas wysyłania danych na zdarzenie obowiązują poniższe limity:
  • Nazwy właściwości są ograniczone do 50 znaków.
  • URL i strona odsyłająca mogą otrzymać do 1024 znaków, podczas gdy wszystkie inne właściwości mogą otrzymać do 256 znaków.
  • Każde zdarzenie może zawierać dane dla maksymalnie 50 właściwości.
  • Wewnętrzne nazwy właściwości muszą zaczynać się od litery i zawierać tylko małe litery a-z, cyfry 0-9 i podkreślniki. Właściwość z taką samą nazwą wewnętrzną po pomniejszeniu jest traktowana jako duplikat i tylko jedna z nich zostanie użyta podczas uzupełniania.
Jeśli te limity zostaną przekroczone podczas wykonywania żądania HTTP API, żądanie nie powiedzie się. Jeśli te limity zostaną przekroczone podczas wykonywania żądania JS API, HubSpot obetnie wszelkie wartości nazw właściwości do dozwolonej długości i/lub zaktualizuje tylko 50 właściwości na zdarzenie.

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 zdarzenie.
  • Wybierz opcję Kod Javascript.
code-javascript
  • Kliknij przycisk Dalej.
  • Wprowadź nazwę zdarzenia i opcjonalnie podaj jego opis.
  • Wybierz Obiekt powiązany. Pozwala to powiązać zdarzenia z różnymi obiektami w HubSpot, w tym z Kontaktami, Firmami, Transakcjami i Zgłoszeniami.
custom-event-details

  • 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ż utworzyć 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 edytować tych właściwości z poziomu ustawień konta).

Aby utworzyć właściwości dla zdarzenia:

  • Wybierz typ właściwości, klikając pole Typ właściwości. Dostępne opcje to:
    • Custom string property: utwórz właściwość, która jest zwykłym ciągiem tekstowym.
    • Właściwość Custom number: utworzenie właściwości będącej 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 enumeration property: utwórz właściwość z zestawem predefiniowanych wartości.

      create-property-custom-behavioral-event
    • Po wybraniu właściwości skonfiguruj ją w prawym panelu:

    • 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. 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.
Uwaga: nie jest możliwe importowanie właściwości emulacji wielokrotnego wyboru.
    • Kliknij przycisk Gotowe.
  • Kliknij przycisk Dalej.
  • Po skonfigurowaniu zdarzenia i jego właściwości, możesz dodać to zdarzenie do kodu śledzenia swojej witryny, wybierając fragmenty kodu Javascript.

Tworzenie zdarzeń za pomocą fragmentów 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 fragmenty kodu według potrzeb, wprowadzając tekst w prawym panelu. Każdy dodany kod zostanie automatycznie dołączony jako część kodu śledzenia HubSpot.
  • Po zakończeniu kliknij przycisk Utwórz , aby zakończyć zdarzenie i automatycznie rozpocząć śledzenie.
    example-code-snippet-custom-event

Import danych zdarzeń

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 leadów lub kampanii od dostawcy lub inne dane dotyczące zdarzeń w formie arkusza kalkulacyjnego. Zdarzenia pozwalają uchwycić zachowanie, a następnie wykorzystać je w HubSpot.

Import może tworzenie i aktualizacja rekord kontaktu. Import zdarzeń może być używany tylko dla zdarzeń, które już miały miejsce. W pliku importu zdarzeń niestandardowych należy uwzględnić następujące elementy:

same-custom-events-file

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 zdarzenie.
  • Wybierz opcję Importuj arkusz kalkulacyjny.
import-spreadsheet
  • Kliknij przycisk Dalej.
  • Wprowadź nazwę zdarzenia i opcjonalnie podaj jego opis.
  • Wybierz powiązany obiekt. W tej chwili zdarzenia utworzone za pomocą importu mogą być powiązane tylko z kontaktami.

custom-event-details

  • 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 właściwości Occurred at.
  • Kliknij przycisk Zakończ import.

Używanie niestandardowych danych zdarzeń

Niestandardowe dane dotyczące 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 zdarzenia można otworzyć bezpośrednio w wybranych narzędziach HubSpot za pomocą rozwijanego menu akcji na liście zdarzeń, w widoku pojedynczego zdarzenia lub w prawym górnym rogu wykresów w zakładce analizy.

Raportowanie zdarzeń niestandardowych

Zdarzenia niestandardowe 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 dotyczących atrybucji.

Dowiedz się więcej o analizie własnych zdarzeń.

Zdarzenia można wyświetlać na osi czasu kontaktu

Zdarzenia zakończone pojawią się na osi czasu rekordu kontaktu, wraz z wszelkimi właściwościami, które zostały wypełnione.

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

  • Przejdź do rekordukontaktu, który ukończył zdarzenie 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ąć zdarzenie i wyświetlić jego szczegóły.

Używanie niestandardowych zdarzeń w przepływach pracy

W przepływie przepływu pracy można opóźnić na podstawie niestandardowych zakończeń zdarzeń za pomocą akcjiOpóźnienie do momentu wystąpienia zdarzenia lub wyzwalacza zapisu do zdarzenia.

  • Na koncie HubSpot przejdź do sekcji Automatyzacje > 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 Zastosuj filtr.
    • Aby doprecyzować triger, kliknij Dodaj filtry doprecyzowujące. Możesz wybrać dodatkowe właściwości, aby doprecyzować obiekty, które mają zapisywać się w przepływie pracy.
    • Domyślnie rekordy zapisują się w przepływie pracy tylko za pierwszym razem, gdy spełniają wyzwalacze zapisu. Aby włączyć Wyzwalacz ponownego zapisu, w sekcji Czy [obiekt] powinien być ponownie zapisywany w tym przepływie pracy, wybierz Tak, zapisuj się ponownie za każdym razem, gdy wystąpi wyzwalacz.
  • Aby dodać opóźnienie:
    • W edytorze przepływu pracy kliknij ikonę + plus, aby dodać działanie przepływu pracy.
    • W prawym panelu wybierz Opóźnienie 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óźnienie tak długie, jak to możliwe .
  • Kliknij przycisk Zapisz.

Uwaga: wszystkie wyzwalacze zapisu zostaną rozdzielone za pomocą operatora OR. Oznacza to, że tylko jeden z wyzwalaczy zapisu musi wystąpić, aby rekord zapisywał się w przepływie pracy.

Przepływ pracy będzie następnie opóźniał zapisywanie się rekordów do momentu spełnienia określonych niestandardowych kryteriów zdarzeń lub będzie wyzwalany w momencie wystąpienia zdarzenia.

Czy ten artykuł okazał się pomocny?
Niniejszy formularz służy wyłącznie do przekazywania opinii dotyczących dokumentacji. Dowiedz się, jak uzyskać pomoc dotyczącą HubSpot.