Uwaga: import z hurtowni danych jest częścią Zaawansowanej platformy danych klientów Klaviyo i nie jest zawarty w standardowej aplikacji marketingowej Klaviyo. Aby uzyskać dostęp do tej funkcji, wymagana jest subskrypcja.

Zrozumienie importu zdarzeń hurtowni danych w Klaviyo

Czego się dowiesz?

Dowiedz się, jak korzystać z hurtowni danych importu zdarzeń, aby zsynchronizować dane zdarzeń z magazynu do Klaviyo, dzięki czemu możesz zasilać segmenty, sekwencje i raportowanie zachowaniem, które pochodzi spoza natywnych integracji Klaviyo(np. systemów POS, platform wsparcia lub niestandardowych aplikacji).

Czym jest hurtownia danych event import?

hurtownia danych event import pozwala Klaviyo połączyć się bezpośrednio z Twoją hurtownią danych i skonfigurować synchronizację importu z tabel hurtowni lub widoków zawierających dane zdarzeń.

Każdy wiersz w Twojej tabeli źródłowej jest traktowany w Klaviyo jako pojedyncze zdarzenie:

Znaczniki czasu wiersza, nazwa metryki i identyfikatory określają, co się wydarzyło, kiedy i dla kogo.
Dodatkowe kolumny stają się właściwościami zdarzeń, które możesz wykorzystać w segmentacji, sekwencji i analityce.

Import zdarzeń opiera się na tej samej infrastrukturze importu z hurtowni danych, co import profilu, ale jest ukierunkowany na potok pozyskiwania zdarzeń Klaviyozamiast profilu.

Jak działa import zdarzeń hurtowni danych?

Po połączeniu Klaviyo z Twoim magazynem i skonfigurowaniu synchronizacji zdarzeń:

Klaviyo odpytuje Twój magazyn o skonfigurowaną tabelę lub widok.
Przy każdym uruchomieniu Klaviyo odczytuje tylko wiersze, których znacznik czasu wykrywania zmian jest nowszy niż ostatnia udana synchronizacja. Pozwala to na import przyrostowy bez konieczności ponownego przetwarzania całej tabeli.
Każdy wiersz jest następnie przetwarzany w następujący sposób:
- Klaviyo określa nazwę metryki (typ zdarzenia) na podstawie opcji wybranych podczas konfiguracji synchronizacji: pojedyncza wybrana metryka lub dynamicznie na podstawie wartości wyznaczonej kolumny nazwy metryki w tabeli źródłowej.
- Znacznik czasu zdarzenia, identyfikatory profilu i opcjonalny unikalny identyfikator, wartość i waluta wartości są ustawiane na podstawie mapowań pól skonfigurowanych podczas konfiguracji synchronizacji.
- Wszystkie pozostałe kolumny są przyjmowane jako właściwości zdarzeń, używając nazw kolumn jako nazw właściwości. Nazwy kolumn z trzema znakami podkreślenia (np. parent___child1, parent___child2) mogą być używane do tworzenia właściwości zdarzenia(parent) z właściwościami podrzędnymi.
Klaviyo ładuje wynikowe zdarzenia na Twoje konto, gdzie zachowują się one jak inne niestandardowe API metryki w segmentacji, sekwencji i analityce.

Importy odbywają się cyklicznie (np. co godzinę), dzięki czemu nowe lub zaktualizowane wiersze w Twoim magazynie są regularnie tłumaczone na zdarzenia w Klaviyo.

Kilka słów na początek

Przed utworzeniem synchronizacji importu zdarzeń upewnij się, że spełnione są następujące wymagania:

Twoje konto ma dostęp do Zaawansowanej platformy danych klientów Klaviyo i importu z hurtowni danych.
Utworzyłeś i zatwierdziłeś połączenie hurtowni danych w Klaviyo. Zapoznaj się z artykułami centrum pomocy technicznej dla hurtowni danych, aby uzyskać szczegółowe informacje na temat wymaganego konta usługi i schematów.
Twoja tabela źródłowa lub widok zawiera wymagane kolumny.
Masz wystarczające uprawnienia w swoim magazynie, aby udostępnić niezbędne tabele/widoki użytkownikowi usługi Klaviyo.

Struktura tabeli źródłowej dla zdarzeń

Aby upewnić się, że twoje dane wydarzenia mogą zostać poprawnie zaimportowane, twoja tabela źródłowa lub widok musi spełniać wymagane pola i strukturę Klaviyo.

Pola wymagane

Następujące kolumny są wymagane w V1 importu zdarzeń hurtowni danych:

Kolumna	Wymagane?	Typ	Opis
Znacznik czasu zdarzenia	Wymagane	Znacznik czasu / data i godzina	Kiedy zdarzenie miało miejsce.
Nazwa metryki	Wymagane, jeśli pojedyncza metryka nie została wybrana podczas konfiguracji synchronizacji.	Ciąg znaków / tekst	Nazwa zdarzenia lub metryki (np. `Złożone zamówienie`, `Otwarty bilet pomocy technicznej`).
Identyfikator profilu	Wymagane (co najmniej 1)	Ciąg znaków / tekst	Jeden z: adres e-mail, numer telefonu, identyfikator zewnętrzny lub identyfikator Klaviyo. W wierszu możesz umieścić wiele elementów, ale musisz zmapować co najmniej jeden.
Znacznik czasu wykrycia zmiany	Wymagane	Sygnatura czasowa	Stabilny znacznik czasu używany do wykrywania nowych lub zaktualizowanych wierszy od ostatniego uruchomienia. Musi różnić się od znacznika czasu zdarzenia, abyś mógł bezpiecznie importować zdarzenia historyczne. Powinien on odzwierciedlać moment dodania wiersza do zbioru danych i musi być stabilny, aby synchronizacja działała poprawnie.

Pola opcjonalne

Pola te są zalecane, jeśli mają zastosowanie, ale nie są bezwzględnie wymagane:

Kolumna	Wymagane?	Typ	Opis
Unikalny identyfikator	Polecane	Ciąg znaków/liczba	Unikalny identyfikator zdarzenia (używany do deduplikacji).
Wartość	Polecane	Liczba	Wartość liczbowa dla zdarzenia (np. suma zamówień, wykorzystane punkty). Mapuje do pola najwyższego poziomu `wartości` w modelu zdarzeń Klaviyo.
Wartość waluty	Polecane	Ciąg znaków / tekst	Kod waluty powiązany z `wartością` (np. `USD`). Mapuje do pola najwyższego poziomu `value_currency`.

Właściwości zdarzenia

Wszystkie inne kolumny w twojej tabeli są traktowane jako właściwości zdarzeń:

Kolumny są importowane jako spłaszczone właściwości, z nazwą kolumny używaną bezpośrednio jako nazwa właściwości w Klaviyo.
Nie musisz jawnie mapować każdej właściwości; niezamapowane kolumny zostaną uwzględnione jako właściwości zdarzeń.
W razie potrzeby zagnieżdżony JSON może być przechowywany wewnątrz indywidualnej wartości właściwości (na przykład obiekt JSON pozycji wiersza), ale sama nazwa właściwości pochodzi z kolumny najwyższego poziomu.

Klaviyo wykonuje parsowanie typu best-effort dla właściwości zdarzeń i nie zapewnia logiki transformacji dla poszczególnych pól w ramach konfiguracji importu zdarzeń.

Typowe przypadki użycia

Klienci zazwyczaj używają hurtowni danych do importowania zdarzeń:

1) Importowanie zdarzeń offline lub POS

Przenieś zdarzenia sklepowe lub offline (np. zakupy w punktach sprzedaży, zwroty lub spotkania) ze swojego magazynu, aby zachowywały się jak inne zdarzenia i metryki Klaviyo.

Przykłady:

Zdarzenia zakupu w sklepie z sumą zamówień, lokalizacją sklepu i typem oferty.
Powołanie Zakończone zdarzenia z pracownikiem, typem usługi i czasem trwania

2) Interakcje związane z obsługą i wsparciem

Synchronizuj zdarzenia związane z pomocą techniczną i usługami, takie jak tworzenie zgłoszeń, ich rozwiązywanie lub zwroty, aby wzbogacić osie czasu klientów i zasilać wiadomości w oparciu o historię usług.

Przykłady:

Utworzony bilet pomocy technicznej i rozwiązany bilet pomocy technicznej
Zwrócone zamówienie z kodami powodów i kwotami zwrotu

3) Zdarzenia modelowane lub pochodne

Konwertuj zachowania modelowane w magazynie na zdarzenia, które są łatwiejsze w użyciu w Klaviyo.

Przykłady:

Wysoki wskaźnik rezygnacji Zdarzenia ryzyka generowane z modelu w Twoim magazynie
Zdarzenia Lifecycle Milestone Reached, gdy klient przechodzi kolejne etapy w niestandardowym modelu cyklu życia.

Skonfiguruj synchronizację importu zdarzeń hurtowni danych

1) Podłącz swoją hurtownię danych

Jeśli nie podłączyłeś jeszcze swojego magazynu:

Na stronie Klaviyo przejdź do Zaawansowana platforma danych klientów Klaviyo > Zarządzanie danymi > Synchronizacja.
Kliknij Dodaj hurtownię danych i wybierz złącze magazynu.
Wykonaj kroki połączenia dla swojej platformy, postępując zgodnie z odpowiednią instrukcją połączenia połączoną z artykułem przeglądowym importu z hurtowni danych.

Klaviyo obsługuje jedno połączenie aktywnej hurtowni danych na konto.

2) Utwórz nową synchronizację importu zdarzeń

Gdy twój magazyn jest już podłączony:

W Zaawansowana platforma danych klientów Klaviyo > Zarządzanie danymi > Synchronizacja wybierz połączenie z magazynem.
Wybierz Importuj dane (jeśli konfigurujesz import po raz pierwszy) lub kliknij Utwórz synchronizację / Dodaj synchronizację dla istniejącego połączenia.
Po wyświetleniu monitu o typ danych wybierz opcję Zdarzenia (zamiast Profil).
Wybierz tabelę lub widok w magazynie, który zawiera zdarzenia, które chcesz zaimportować.

3) Mapuj wymagane pola

Następnie zmapujesz kolumny z tabeli magazynu na wymagane pola zdarzeń Klaviyo.

Konfiguracja importu zdarzeń wymaga podania mapowań dla:

Znacznik czasu zdarzenia
nazwa met ryki (stała wybrana w konfiguracji lub kolumna zawierająca nazwę metryki dla każdego wiersza)
identyfikator profilu (co najmniej jeden)
Znacznik czasu wykrycia zmiany

Możesz także mapować zalecane pola:

Unikalny identyfikator
Wartość
Wartość waluty

Wszelkie pozostałe kolumny, których nie mapujesz jawnie na te podstawowe pola, automatycznie stają się właściwościami zdarzeń.

Interfejs konfiguracyjny uniemożliwia mapowanie wielu kolumn do tego samego pola najwyższego poziomu i sprawdza, czy wszystkie wymagane pola są obecne, zanim zezwoli na zapisanie.

4) Wybierz kadencję synchronizacji i zakres historyczny

Gdy zapiszesz import wydarzenia:

Klaviyo planuje powtarzające się synchronizacje, aby działały w regularnych odstępach czasu (zazwyczaj co godzinę).
Przy każdym uruchomieniu przetwarzane są tylko wiersze, których znacznik czasu wykrywania zmian jest nowszy niż ostatnie udane uruchomienie, zapewniając, że import jest przyrostowy.

W przypadku historycznej zasypki możesz wybrać jedną z poniższych opcji:

Skieruj import zdarzeń do tabeli lub widoku, który zawiera już wszystkie istotne zdarzenia historyczne, lub
Zacznij od dedykowanej tabeli historycznej, a następnie przełącz się na widok oparty na przechwytywaniu danych zmian w celu bieżących aktualizacji.

Jak zaimportowane zdarzenia zachowują się w Klaviyo?

Po zaimportowaniu:

Każdy wiersz pojawia się jako zdarzenie niestandardowej metryki API w Klaviyo.
Nazwa metryki, którą zmapowałeś (lub skonfigurowałeś jako stałą), określa nazwę typu zdarzenia, którą widzisz w produkcie (na przykład Złożone zamówienie).
Wszystkie identyfikatory profili są rozwiązywane do istniejących profili, jeśli jest to możliwe; w przeciwnym razie Klaviyo tworzy nowy profil przy użyciu dostarczonych pól identyfikatora, podobnie jak w przypadku innych ścieżek pozyskiwania zdarzeń.

Możesz użyć tych zdarzeń do:

Twórz segmenty na podstawie tego , co ktoś zrobił i filtruj według właściwości zdarzenia.
uruchamiać i filtrować sekwencję.
Analizuj zachowanie w metryce i raportowanie wraz ze zdarzeniami z innych źródeł.

Ograniczenia i najlepsze praktyki

Pamiętaj o następujących kwestiach podczas korzystania z importu zdarzeń hurtowni danych:

Import zdarzeń w wersji 1 koncentruje się wyłącznie na danych zdarzeń. aktualizacje właściwości profilu pochodzące ze zdarzeń mogą zostać dodane w późniejszej iteracji; na razie właściwości profilu powinny być aktualizowane poprzez import profilu lub inne obsługiwane ścieżki.
Znacznik czasu wykrywania zmian musi różnić się od znacznika czasu zdarzenia. Użycie tej samej kolumny w obu przypadkach może uniemożliwić bezpieczne zaimportowanie zdarzeń historycznych po pierwszej synchronizacji.
Aby uzyskać optymalną szybkość, ustaw pole wykrywania zmian na znacznik czasu utworzenia nowej tabeli. Rekordy są grupowane w cyklach synchronizacji przy użyciu tej wartości, więc czas importowania rekordów historycznych można skrócić, jeśli wszystkie rekordy historyczne mają znaczniki czasu wykrywania zmian w wąskim zakresie (np. znacznik czasu zadania, które tworzy nową tabelę).
W miarę możliwości używaj stabilnego , unikalnego identyfikatora dla każdego zdarzenia, aby poprawić deduplikację i ułatwić debugowanie.
Jeśli twoja tabela zawiera wiele typów zdarzeń (metryka) z różnymi zestawami kolumn, generalnie dobrze jest trzymać je razem: kolumny, które są NULL dla poszczególnych wierszy są po prostu ignorowane dla tych zdarzeń w Klaviyo.
W przypadku złożonych obiektów zagnieżdżonych (np. tablice pozycji) zalecamy spłaszczenie do wielu kolumn, jeśli jest to możliwe, szczególnie w przypadku właściwości, których spodziewasz się użyć w segmentacji lub sekwencji.

```