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

Data ostatniej aktualizacji: października 15, 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órych można następnie używać we wszystkich narzędziach HubSpot.

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

  • 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:
    • Kodowanie 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ć 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, musisz użyć punktu końcowego definicji zdarzenia niestandardowego, aby utworzyć zdarzenie. Następnie należy zdefiniować wywołanie API w celu wyzwolenia zdarzenia. Dowiedz się, jak zdefiniować wywołanie API w dokumentacji deweloperskiej HubSpot.

Do wywołania API będziesz potrzebować kilku informacji, które możesz 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.

    internal-name-custom-event
  • 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.
Uwaga:
Podczas wysyłania danych na wydarzenie obowiązują poniższe limity:
  • Nazwy właściwości są ograniczone do 50 znaków.
  • Właściwości URL i referrer mogą otrzymać do 1024 znaków, podczas gdy wszystkie inne właściwości mogą otrzymać do 256 znaków.
  • Każde uzupełnienie zdarzenia 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ślenia. Właściwości z taką samą nazwą wewnętrzną po zmniejszeniu są uważane za duplikaty 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 skróci wszelkie wartości nazw właściwości do dozwolonej długości i/lub zaktualizuje tylko 50 właściwości na zakończenie zdarzenia.

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.
code-javascript
  • Kliknij przycisk Dalej.
  • 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.
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ż 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 utworzyć właściwości dla zdarzenia:

  • Wybierz typ nieruchomości, klikając typ pola dla swojej nieruchomoś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ść 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.

      create-property-custom-behavioral-event
    • 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. 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, oddziel je średnikiem.
    • Kliknij przycisk Gotowe.
    • Po utworzeniu właściwości pojawi się ona w tabeli pod domyślnymi właściwościami zdarzeń HubSpot. Możesz edytować lub usunąć swoją właściwość, wybierając menu rozwijane Akcje i wybierając Edytuj lub Usuń.
  • 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 snippet 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.
    example-code-snippet-custom-event

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ą przechwytywanie zachowań, a następnie wykorzystywanie ich w HubSpot.

  • 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.
import-spreadsheet
  • Kliknij przycisk Dalej.
  • 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.

custom-event-details

  • Przeciągnij i upuść plik w sekcji Wybierz plik lub kliknij Wybierz plik, aby przesłać plik z komputera. Podczas przesyłania pliku należy podać poniższe informacje:

same-custom-events-file

Przykładowy plik

Uwaga: podczas importowania danych zdarzeń obowiązują poniższe limity:
  • Plik musi być typu csv, .xlsx lub .xls.
  • Ograniczenie do 1 miliona wierszy.
  • Na chwilę obecną wydarzenia utworzone za pomocą importu mogą być powiązane tylko z kontaktami.
  • Zdarzenia będą tworzyć i aktualizować rekordy kontaktów. Importutworzy nowe rekordy i działania, a także zidentyfikuje i zaktualizuje istniejące rekordy. Aby utworzyć nowe rekordy lub działania, plik musi zawierać wymagane właściwości dla danego kontaktu. Aby zaktualizować istniejące rekordy, plik musi zawierać unikalny identyfikator.
  • Import zdarzeń powinien być używany dla zdarzeń, które już miały miejsce, zdarzenia z przyszłymi datami nie są obsługiwane.

  • Kliknij menu rozwijane, aby wybrać język nagłówków kolumn.
upload-spreadsheet-events
  • Kliknij przycisk Dalej.
  • Na ekranie Mapuj kolumny w pliku do właściwości HubSpot, HubSpot zmapuje kolumny w pliku do właściwości kontaktów i zdarzeń w oparciu o nagłówek, język nagłówka i nazwę właściwości.
  • Przewodnik mapowania wyświetla właściwości wymagane do utworzenia i/lub aktualizacji kontaktów i zdarzeń. Jeśli w pliku brakuje jakichkolwiek właściwości potrzebnych do ukończenia importu, należy poprawić plik importu i ponownie uruchomić import, aby uniknąć błędów.
  • Kolumny w arkuszu kalkulacyjnym mogą być mapowane na właściwości kontaktu lub zdarzenia. Kliknij menu rozwijane Importuj jako , aby wybrać sposób importowania danych z pliku. Następnie wybierz właściwość HubSpot, do której chcesz je zmapować. Możesz zmapować je do istniejącej właściwości lub utworzyć nową właściwość.
create-new-property
  • Kliknij przycisk Dalej.
  • Potwierdź nazwę pliku importu.
  • 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.
  • Kliknij menu rozwijane, aby wybrać format daty właściwości Occurred at.
  • Kliknij przycisk Zakończ import.

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 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 opcję Skonfiguruj 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 być ponownie rejestrowany 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.

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.