Informacje o zasadach importu zdarzeń do hurtownia danych do Klaviyo

Czego się dowiesz?

Naucz się korzystać z importu zdarzeń danych hurtownia do synchronizowania danych zdarzeń z hurtowni do Klaviyo. Dzięki temu segmenty, sekwencja i raportowanie będą wspomagać działania pochodzące spoza natywnych integracji Klaviyo (np. systemy POS, platformy wsparcia lub niestandardowe aplikacje) .

Na czym polega import zdarzeń hurtownia danych?

hurtownia danych import zdarzeń pozwala Klaviyo połączyć się bezpośrednio z hurtownia danych oraz skonfigurować import synchronizacji z tabel lub widoków hurtowni, które zawierają dane zdarzeń.

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

• Znacznik czasu, nazwa metryki i identyfikatory wiersza definiują,co się stało, kiedy i dla kogo.
• Dodatkowe kolumny stają się właściwościami zdarzeń, których można używać w sekwencjach, sekwencjach i danych analitycznych.

Import zdarzeń opiera się na tej samej infrastrukturze danych importowanych z hurtowni co import profili, ale jest ukierunkowany na potok pozyskiwania zdarzeń Klaviyo zamiast na profil.

Jak działa import zdarzeń w hurtownia danych?

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

1. Klaviyo wysyła do hurtowni zapytanie o skonfigurowaną tabelę lub widok.
2. Przy każdym uruchomieniu Klaviyo odczytuje tylko wiersze, których sygnatura czasowa wykrycia zmian jest nowsza niż ostatnia pomyślna synchronizacja. Umożliwia to importowanie przyrostowe bez ponownego przetwarzania całej tabeli.
3. 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: albo jako pojedyncza wybrana metryka, albo dynamicznie na podstawie wartości oznaczonej kolumny z nazwą metryki w tabeli źródłowej.
   • Znacznik czasu zdarzenia, identyfikatory profilu oraz opcjonalny unikalny identyfikator, wartość i waluta wartości są ustawiane na podstawie mapowań pól skonfigurowanych podczas konfiguracji synchronizacji.
   • Wszystkie pozostałe kolumny są importowane jako właściwości zdarzenia, z użyciem nazw kolumn jako nazw właściwości. Nazwy kolumn z trzema podkreśleniami (np. parent___child1, parent___child2) mogą służyć do utworzenia właściwości zdarzenia (parent) z właściwościami podrzędnymi.
4. Klaviyo ładuje wynikowe zdarzenia do konta, gdzie zachowują się jak inne niestandardowe metryki API w obszarach segmentacji, sekwencji i danych analitycznych.

Importowanie odbywa się w powtarzającej się częstotliwości (np. co godzinę), dlatego nowe lub zaktualizowane wiersze w magazynie są w Klaviyo regularnie przekształcane na zdarzenia.

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 importuje z hurtowni danych.
• Utworzono i zatwierdzono połączenie hurtowni danych z pomocą Klaviyo. Przeczytaj artykuły w centrum wsparcia dotyczące Twojej hurtownia danych, aby uzyskać szczegółowe informacje na temat wymaganej usługi konto i jej schematów.
• Tabela lub widok źródłowy zawiera wymagane kolumny poniżej.
• Masz wystarczające uprawnienia w swojej hurtowni, aby udostępnić niezbędne tabele/widoki użytkownikowi usługi Klaviyo.

Struktura tabeli źródłowej dla zdarzeń

Aby zapewnić poprawne zaimportowanie danych zdarzeń, tabela lub widok źródłowy muszą spełniać wymagane pola i strukturę Klaviyo.

Pola wymagane

Instalacja importu zdarzeń hurtownia danych w V1 wymaga następujących kolumn:

Pola opcjonalne

Te pola są zalecane, gdy ma to zastosowanie, ale nie są bezwzględnie wymagane:

Właściwości zdarzenia

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

• Kolumny są importowane jako właściwości spłaszczone, przy czym nazwy kolumny są używane w Klaviyo bezpośrednio jako nazwy właściwości.
• Nie trzeba jawnie mapować każdej właściwości; nieprzypisane kolumny zostaną uwzględnione jako właściwości zdarzenia.
• W razie potrzeby zagnieżdżony JSON może być przechowywany wewnątrz wartości pojedynczej właściwości (na przykład w obiekcie JSON pozycji), ale sama nazwa właściwości pochodzi z kolumny najwyższego poziomu.

Klaviyo dla właściwości zdarzeń przeprowadza analizę składniową typu „best-effort” i nie zapewnia logiki przekształcania poszczególnych pól w ramach konfiguracji importu zdarzeń.

Częste przypadki użycia

Klienci zazwyczaj korzystają z importu zdarzeń hurtownia w następujących przypadkach:

1) Importowanie zdarzeń offline lub POS

Przetwarzaj zdarzenia w sklepie stacjonarnym lub offline (np. zakupy w POS, zwroty lub umówione spotkania) ze swojej hurtowni, tak aby zachowywały się jak inne zdarzenia i metryka Klaviyo.

Przykłady:

• In-Store Purchase zdarzenia z łącznymi kwotami zamówień, lokalizacją sklepu i typem formy płatności
• Appointment Completed zdarzenia z członkiem personelu, typem usługi i czasem trwania

2) Interakcje w obsłudze serwisów i wsparcia

Synchronizacja zdarzeń związanych ze wsparciem i usługami, takimi jak tworzenie, rozwiązywanie zgłoszeń czy zwroty, pozwala wzbogacać oś czasu klientów i obsługiwać wiadomości na podstawie historii obsługi klienta.

Przykłady:

• Support Ticket Created i Support Ticket Resolved
• Order Returned z kodami przyczyn i kwotami zwrotów

3) Zdarzenia modelowane lub pochodne

Przekształca zachowania modelowane w hurtownie na zdarzenia łatwiejsze w użyciu w Klaviyo.

Przykłady:

• High Churn Risk zdarzenia generowane przez model w Twoim magazynie danych
• Lifecycle Milestone Reached zdarzenia, gdy klient przechodzi między etapami w niestandardowym modelu cyklu życia

Zorganizuj hurtownię synchronizację importu zdarzeń

1) Połącz hurtownię danych

Jeśli nie podłączono jeszcze hurtowni:

1. Przejdź w Klaviyo do Zaawansowana platforma danych klientów Klaviyo > Zarządzanie danymi > Synchronizacja.
2. Kliknij Dodaj hurtownia danych i wybierz łącznik do hurtowni danych.
3. Dokończ kroki połączenia dla swojej platformy zgodnie z odpowiednim przewodnikiem po połączeniach, który zamieszczony został w artykule dotyczącym importu z hurtowni danych.

Klaviyo obsługuje jedno połączenie danych dla każdego konta.

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

Po połączeniu hurtowni:

1. W sekcji Zaawansowana platforma danych klientów Klaviyo > Zarządzanie danymi > Synchronizacja wybierz połączenie z hurtownią.
2. Wybierz Importuj dane (jeśli konfigurujesz importy po raz pierwszy) lub kliknij Utwórz synchronizację/Dodaj synchronizację dla istniejącego połączenia.
3. Po wyświetleniu monitu o typ danych wybierz Zdarzenia (zamiast profil).
4. Wybierz w hurtowni tabelę lub widok zawierający zdarzenia, które chcesz zaimportować.

3) Zmapuj wymagane pola

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

Konfiguracja importu zdarzeń wymaga podania mapowania dla:

• Sygnatura czasowa zdarzenia
• nazwa metryki (stała wybrana w konfiguracji lub kolumna zawierająca nazwę metryki na wiersz)
• identyfikator profilu (co najmniej jeden)
• Zmień sygnaturę czasu wykrywania

Zalecane pola można również zmapować:

• Unikalny identyfikator
• Wartość
• Waluta wartości

Wszelkie pozostałe kolumny, których nie zmapujesz jawnie do tych pól podstawowych, automatycznie staną się właściwościami zdarzeń.

Interfejs użytkownika konfiguracji zapobiega mapowaniu wielu kolumn do tego samego pola najwyższego poziomu i zanim umożliwi zapisanie, weryfikuje, czy wszystkie wymagane pola są obecne.

4) Wybierz częstotliwość synchronizacji i zakres historyczny

Po zapisaniu importu zdarzenia:

• Klaviyo planuje cykliczne synchronizacje w regularnym tempie (zazwyczaj co godzinę).
• Przy każdym uruchomieniu przetwarzane są tylko wiersze, których sygnatura czasowa wykrycia zmian jest nowsza niż w ostatnim pomyślnym uruchomieniu, dzięki czemu importy będą miały charakter przyrostowy.

W przypadku zapasowych danych historycznych możesz:

• skieruj import zdarzeń na tabelę lub widok, który zawiera już wszystkie istotne zdarzenia historyczne, lub
• Zacznij od dedykowanej tabeli danych historycznych, a później przełącz się na widok wspierany przez change-data-capture, aby na bieżąco aktualizować dane.

Jak zaimportowane zdarzenia zachowują się w Klaviyo .?

Po zaimportowaniu:

• Każdy wiersz jest wyświetlany w Klaviyo jako zdarzenie niestandardowej metryki API.
• Nazwa metryki, którą zmapowano (lub skonfigurowano jako stałą), określa nazwę typu zdarzenia widoczną w produkcie (na przykład Placed Order).
• Tam, gdzie to możliwe, wszystkie identyfikatory profilu są przekształcane do istniejącego profilu; w przeciwnym razie Klaviyo utworzy nowy profil przy użyciu dostarczonych pól identyfikatora, podobnie jak w przypadku innych ścieżek pozyskiwania zdarzeń.

Tych zdarzeń możesz używać do:

• Twórz segmenty na podstawie działań użytkownika i filtruj według właściwości zdarzeń.
• Wyzwalacz i filtr sekwencji.
• Analizuj zachowania w metryce i raportujesz je razem ze zdarzeniami z innych źródeł.

Ograniczenia i najlepsze praktyki

Korzystając z importu zdarzeń w hurtownia danych, należy pamiętać o kilku kwestiach:

• Wersja V1 importu zdarzeń skupia się tylko na danych zdarzeń. Aktualizacji profilu właściwości powinny być importowane profile lub inne obsługiwane ścieżki.
• Sygnatura czasowa wykrycia zmiany musi być inna niż sygnatura czasowa zdarzenia. Użycie tej samej kolumny do obu typów może uniemożliwić bezpieczne importowanie zdarzeń historycznych po pierwszej synchronizacji.
• Aby uzyskać optymalną szybkość, ustaw w polu wykrywania zmian sygnaturę czasową utworzenia nowej tabeli. Rekordy są grupowane w cyklach synchronizacji z użyciem tej wartości, więc czas importowania rekordów historycznych można skrócić, jeśli wszystkie rekordy historyczne mają sygnaturę czasu wykrywania zmian w wąskim zakresie (np. sygnaturę czasu zadania, które tworzy nową tabelę).
• Tam, gdzie to możliwe, używaj stabilnego unikalnego identyfikatora dla każdego zdarzenia, aby usprawnić deduplikację i ułatwić debugowanie.
• Jeśli tabela zawiera wiele typów zdarzeń (metryki) z różnymi zestawami kolumn, zazwyczaj dobrze jest przechowywać je razem: kolumny, które mają wartość NULL dla poszczególnych wierszy, są po prostu ignorowane w Klaviyo w przypadku tych zdarzeń.
• W przypadku złożonych obiektów zagnieżdżonych (np. tablic z elementami zamówienia) zalecamy, aby tam, gdzie to możliwe, spłaszczać je na wiele kolumn, szczególnie w przypadku właściwości, które zamierzasz używać w segmentacji lub sekwencji.

„

• Zachowaj znacznik czasu wykrywania zmian w pobliże bieżącej daty. Klaviyo odczytuje dane w odstępach 1-godzinnych, wykonując iteracje wprzód, począwszy od najstarszego znacznika czasu wykrycia zmian w tabeli. Jeśli którykolwiek z wierszy ma sygnaturę czasu wykrycia zmiany daleko w przeszłości (na przykład pojedynczy rekord z 2023 r., podczas gdy wszystkie pozostałe są najnowsze), Klaviyo skanuje każde okno trwające 1 godzinę od tej daty w każdym cyklu synchronizacji, co spowalnia proces uzupełniania danych historycznych czas synchronizacji.
• Nie przekraczaj około 100 000 wierszy w jednym oknie sygnatury czasowej wykrywania zmiany. Jeśli zbyt wiele wierszy współdzieli to samo 1-godzinne okno, synchronizujące zapytanie może przekroczyć limit czasu.

Zalecana konfiguracja klucza klastrowego Snowflake

W przypadku tabel Snowflake grupowanie w kolumnie znacznika czasu wykrywania zmian pomaga zapytaniom Klaviyo pomijać niepotrzebne mikropartycje, skracając zarówno czas synchronizacji, jak i koszty obliczeń Snowflake:

ALTER TABLE your_schema.your_table CLUSTER BY (your_change_timestamp_column);