Dowiedz się więcej o synchronizowaniu hurtowni danych w Klaviyo

Czego się dowiesz?

Dowiedz się, jak synchronizować dane z Klaviyo z Twoją hurtownią danych i importować dane z hurtowni do Klaviyo przez SFTP. Możesz synchronizować dane profilu klienta i zdarzeń, co pozwala przechowywać i analizować kluczowe informacje o Twoich klientach poza Klaviyo.

This content requires Functional cookies to be enabled.

Update Cookie Settings

Kilka słów na początek

Zanim wyeksportujesz dane z Klaviyo, skonfiguruj swoją hurtownię danych jako miejsce docelowe:

• Upewnij się, że użytkownik udostępniany Klaviyo ma odpowiednie uprawnienia.
• W przypadku miejsc docelowych, które korzystają z tabel, utwórz tabele o nazwach podanych w instrukcjach konfiguracji poniżej.

Dodatkowo pamiętaj, aby dodać adresy IP ruchu wychodzącego hurtowni danych Klaviyo do białej listy. Dzięki temu żądania Klaviyo nie będą blokowane przez warstwę zabezpieczeń. Adresy te są reprezentowane przez następujące zakresy CIDR:

• 184.72.183.187/32
• 52.206.71.52/32
• 3.227.146.32/32
• 44.198.39.11/32
• 35.172.58.121/32
• 3.228.37.244/32
• 54.88.219.8/32
• 3.214.211.176/32

Nawiąż połączenie z hurtownią danych

1. Przejdź do Zarządzanie danymi > Synchronizowanie. Jeśli masz już połączenie, kliknij Utwórz synchronizację.
2. Wybierz Eksportuj dane do hurtowni danych.
3. Wybierz swój magazyn, a następnie kliknij Połącz z [warehouse name] na stronie konfiguracji.

Możesz też wybrać hurtownię danych z platformy handlowej aplikacji Klaviyo, przechodząc do Integracje > Przeglądaj aplikacje i wyszukując swoją platformę.

Opcja Importuj dane z Twojej hurtowni danych konfiguruje bezpośredni import z hurtowni. Aby przesyłać pliki CSV przez SFTP, postępuj zgodnie z następną sekcją.

Import danych za pomocą SFTP

Jeśli chcesz zaimportować dane z Twojej hurtowni danych do Klaviyo, możesz to zrobić przez SFTP. Aby uzyskać bezpośrednie połączenie z hurtownią danych, zobacz Omówienie importu z hurtowni danych w Klaviyo.

Przejdź do Integracje, otwórz Zarządzaj danymi > transfer danych SFTP, a następnie wybierz kartę Konfiguracja SFTP.

Proces importowania danych z hurtowni danych do Klaviyo wygląda następująco:

1. Wyeksportuj wybrane dane z hurtowni danych.
2. Wygeneruj klucze SSH na lokalnym komputerze.
3. Skonfiguruj klienta SFTP i zaimportuj.

Eksportuj bazę danych

Najpierw musisz wyeksportować dane z magazynu danych. Zaloguj się do hurtowni danych i wyeksportuj dane, które chcesz zaimportować do Klaviyo, do pliku CSV.

Na komputerze lokalnym wygeneruj klucze SSH

Na komputerze lokalnym wygeneruj nową parę kluczy SSH. Zachowaj klucz prywatny dla klienta SFTP.

1. W sekcji konfiguracja SFTP kliknij Dodaj klucz SSH. Wpisz tytuł klucza i wklej swój klucz publiczny w polu klucz SSH.
2. Kliknij Dodaj klucz.

Skonfiguruj klienta SFTP i zaimportuj

Po dodaniu klucza publicznego do Klaviyo skonfiguruj klienta SFTP i prześlij plik CSV.

1. Utwórz połączenie w kliencie SFTP, używając serwera, portu i nazwy użytkownika wyświetlonych w sekcji Dane logowania SFTP na stronie Konfiguracja SFTP. Uwierzytelnij przy użyciu pasującego klucza prywatnego.
2. Przed przesłaniem upewnij się, że plik CSV ma format zgodny z zalecanymi wytycznymi dotyczącymi formatowania, do których link znajduje się powyżej.
3. Prześlij plik CSV za pomocą klienta SFTP.

Aby sprawdzić import, otwórz zakładkę Import danych w Transfer danych SFTP. Ostatnie importy pokazują:

• Status
  W kolejce, przetwarzane, ukończone, nieudane lub anulowane. Ukończony import nadal może zawierać błędy.
• Przetworzone wiersze
  Procent pliku przetworzony do tej pory. Rozwiń import, aby sprawdzić liczbę przetworzonych i pominiętych wierszy.
• Data importu
  Data importu.
• Zaimportowane przez
  Użytkownik, który zaimportował dane.

Eksportuj dane do hurtowni danych 

Aby skonfigurować hurtownię danych jako miejsce docelowe, będziesz potrzebować poniższego zestawu informacji i danych uwierzytelniających dla każdej hurtowni danych.

Amazon Redshift

Aby skonfigurować Amazon Redshift jako miejsce docelowe, uruchom poniższy skrypt, aby utworzyć tabele klaviyo_event, klaviyo_profile i klaviyo_metric.

Zanim uruchomisz ten przykład, poproś administratora bazy danych o dostosowanie go: zastąp symbole zastępcze, popraw niedopasowane */ w pobliżu początku i uruchom specyficzne dla tabel instrukcje GRANT po utworzeniu tabel.

Po skonfigurowaniu jako miejsce docelowe połącz hurtownię danych z Klaviyo, używając poniższego zestawu danych uwierzytelniających:

• Nazwa: Nazwa ułatwiająca identyfikację tego połączenia. Możesz użyć takiej samej nazwy jak nazwa bazy danych na platformie Redshift.
• Adres URL hosta: Punkt końcowy serwera Amazon Redshift (w Redshift nazywany adresem URL połączenia)
• Baza danych: Nazwa bazy danych Redshift, z którą połączy się Klaviyo
• Port: Numer portu używany przez Redshift
• Schemat: Schemat Twojej bazy danych
• Nazwa użytkownika: Nazwa użytkownika używana do logowania do Redshift
• Hasło do bazy danych: Hasło używane do logowania do Redshift
  

Amazon S3

Aby skonfigurować Amazon S3 jako miejsce docelowe, przygotuj nazwę swojego bucketa, region bucketa oraz dane uwierzytelniające dostępu AWS.

Po skonfigurowaniu jako miejsce docelowe połącz hurtownię danych z Klaviyo, używając poniższego zestawu danych uwierzytelniających:

• Nazwa: Nazwa ułatwiająca identyfikację tego połączenia.
• Zasobnik: nazwa zasobnika.
• Lokalizacja zasobnika: Nazwa regionu wybrana podczas tworzenia zasobnika magazynu.
• Identyfikator klucza dostępu: Identyfikator Twojego klucza dostępu do AWS.
• Tajny klucz dostępu: Twój tajny klucz dostępu do AWS.
  

Google BigQuery

Aby skonfigurować Google BigQuery jako miejsce docelowe, uruchom następujący skrypt, aby skonfigurować tabele klaviyo_profile, klaviyo_event i klaviyo_metric. Twoje konto Google BigQuery musi mieć profil płatności, aby proces łączenia zakończył się powodzeniem.

Pamiętaj, że w tym skrypcie musisz zastąpić symbol zastępczy „SERVICE ACCOUNT EMAIL” adresem e-mail konta usługi BigQuery.

Po skonfigurowaniu jako miejsce docelowe połącz hurtownię danych z Klaviyo, używając poniższego zestawu danych uwierzytelniających:

• Nazwa: Nazwa ułatwiająca identyfikację tego miejsca docelowego
• ID projektu: Jest to tzw. identyfikator projektu i można go znaleźć w konsoli interfejsu API.
• Zbiór danych: Nazywany również schematem. to ta sama nazwa co użyta w skrypcie, który należało uruchomić podczas konfiguracji.
• Klucz konta usługi: Wklej całą zawartość pliku JSON pobranego podczas tworzenia konta usługi w BigQuery.
  

Microsoft Azure Synapse Analytics

Aby skonfigurować Microsoft Azure jako miejsce docelowe, uruchom poniższy skrypt, aby utworzyć tabele klaviyo_profile, klaviyo_event oraz klaviyo_metric. Poproś administratora bazy danych o dostosowanie przykładu przed jego uruchomieniem: zaczyna się on od instrukcji DROP TABLE, w tym od zduplikowanej instrukcji DROP TABLE klaviyo_profile. Usuń instrukcje DROP TABLE podczas tworzenia nowych tabel lub jeśli musisz zachować istniejące dane.

Po skonfigurowaniu jako miejsce docelowe połącz hurtownię danych z Klaviyo, używając poniższego zestawu danych uwierzytelniających:

• Nazwa: Najlepiej użyć takiej samej nazwy jak nazwa bazy danych na platformie Azure.
• Obszar roboczy: Nazwa obszaru roboczego Azure Synapse.
• Nazwa bazy danych: Określa bazę danych dedykowanej puli SQL.
• Nazwa użytkownika: Nazwa użytkownika logowania do bazy danych dedykowanej puli SQL.
• Hasło do bazy danych: Twoje hasło logowania do bazy danych dedykowanej puli SQL.
• Nazwa konta: Konto magazynu Windows Azure lub prefiks DNS, który utworzono.
• Sygnatura dostępu: Ciąg sygnatury dostępu współdzielonego (SAS), który potwierdza dostęp do kontenera Blob Storage.
• Nazwa kontenera: Nazwa kontenera Azure Blob służącego jako obszar tymczasowy na potrzeby transferu danych.
  

Snowflake

Aby skonfigurować Snowflake jako miejsce docelowe, wykonaj następujące czynności:

1. Wygeneruj klucz prywatny, uruchamiając w terminalu następujące polecenie:

textCopy

openssl genrsa 2048 | openssl pkcs8 -topk8 -inform PEM -out rsa_key.p8 -nocrypt

2. Wygeneruj klucz publiczny, który odwołuje się do klucza prywatnego, uruchamiając w terminalu następujące polecenie:

textCopy

openssl rsa -in rsa_key.p8 -pubout -out rsa_key.pub

3. Uruchom poniższy skrypt, aby skonfigurować tabele KLAVIYO_PROFILE, KLAVIYO_EVENT i KLAVIYO_METRIC. Aby ukończyć poniższą konfigurację, musisz mieć uprawnienia securityadmin i sysadmin. Aby sprawdzić, jaką/jakie masz rolę/role, uruchom SHOW GRANTS TO USER <your_username> i upewnij się, że widzisz na liście obie role. Skontaktuj się z administratorem systemu, jeśli musisz zmienić swoją rolę. Przed uruchomieniem skryptu zastąp jego symbole zastępcze SET_ swoimi wartościami, a GENERATE_PUBLIC_KEY — kluczem publicznym, który wygenerowałeś. Skrypt używa CREATE OR REPLACE TABLE, co zastępuje wszystkie istniejące tabele o tych nazwach. Użyj nowej bazy danych lub poproś administratora o dostosowanie tych instrukcji, jeśli musisz zachować istniejące dane.

Po skonfigurowaniu jako miejsce docelowe połącz hurtownię danych z Klaviyo, używając poniższego zestawu danych uwierzytelniających:

• Nazwa: Najlepiej użyć takiej samej nazwy jak nazwa bazy danych na platformie Snowflake.
• Nazwa użytkownika: Nazwa użytkownika do połączenia z bazą danych. Powinna być taka sama jak user_name w skrypcie konfiguracji.
  
• Klucz prywatny: Wygenerowany klucz prywatny Snowflake.
  
• Magazyn:  Twój magazyn w Snowflake.
• Konto: Twoje konto w Snowflake.
• Baza danych: Nazwa Twojej bazy danych. Powinno to być takie samo jak database_name w skrypcie konfiguracji.
• Schemat: Schemat Twojej bazy danych. Powinien być taki sam jak schema_name w skrypcie konfiguracji.
  

Databricks

Aby skonfigurować Databricks jako miejsce docelowe, w tym skrypt konfiguracji, wymagane uprawnienia i dane uwierzytelniające połączenia, wykonaj kroki opisane w Jak eksportować dane Klaviyo do Databricks.

Jeśli formularz połączenia wyświetla sekcję Blob store, użyj jej do skonfigurowania magazynu dla eksportu. W przypadku miejsc docelowych w hurtowni danych ten magazyn etapuje dane przed załadowaniem ich do hurtowni. W przypadku Amazon S3 jest to miejsce docelowe eksportu.

1. Aby użyć zapisanego magazynu, wybierz Użyj konfiguracji blobów (jeśli jest wyświetlane), a następnie wybierz zgodny Magazyn blobów. Jeśli nie wybierzesz opcji Użyj konfiguracji blobów, kontynuuj, korzystając ze szczegółów połączenia wymienionych powyżej. Jeśli Klaviyo wymaga magazynu blobów, wybierz go przed kontynuowaniem.
2. Aby dodać magazyn, wybierz Utwórz z listy rozwijanej Magazyn obiektów blob. Wybierz dostawcę, jeśli pojawi się taki monit, wprowadź szczegóły połączenia, a następnie kliknij Utwórz.
3. Jeśli pojawi się pole Nazwa konfiguracji magazynu danych, wpisz nazwę konfiguracji magazynu danych, którą utworzono w Twoim magazynie danych.
4. W przypadku miejsca docelowego Amazon S3 wybierz Format pliku oraz zdecyduj, czy Kompresować wyeksportowane pliki, jeśli te opcje są dostępne.

Po wprowadzeniu danych połączenia kliknij Dalej. Następnie wybierz dane i harmonogram eksportu.

Obiekty danych

W sekcji Obiekty danych możesz wybrać synchronizowanie wszystkich danych profilu, tylko określonych danych zdarzeń albo obu typów danych, zaznaczając odpowiednie pole(-a) wyboru obok każdej opcji.

Integracje do wykluczenia

W polu Integracje do wykluczenia można wybrać konkretne integracje, które mają zostać wykluczone w synchronizacji z hurtownią danych. Jest to przydatne, jeśli chcesz także wykluczyć z synchronizacji dane konkretnej integracji, którą być może już połączono z Klaviyo.

Synchronizacja selektywna

W polu Selektywna synchronizacja wybierasz konkretne zdarzenia, które chcesz zsynchronizować z Klaviyo do swojej hurtowni danych. Domyślnie uwzględniane są wszystkie zdarzenia. Gdy ustawisz konkretne zdarzenia do synchronizacji z tym polem, synchronizowane będą tylko wybrane zdarzenia.

Określ częstotliwość synchronizacji danych

W sekcji Wybierz, jak często Twoje dane będą się synchronizować wybierz interwał w Co: 1, 2, 4, 6, 12 lub 24 godziny. Ustaw datę rozpoczęcia, godzinę rozpoczęcia oraz strefę czasową dla harmonogramu.

Określ, ile danych historycznych chcesz zsynchronizować

W sekcji Wybierz, ile danych historycznych chcesz zsynchronizować możesz zdefiniować, ile danych historycznych chcesz zsynchronizować z Klaviyo do swojej hurtowni danych podczas początkowego połączenia. Możesz wybrać:

• 30 dni
• 90 dni
• 1 rok
• Cały okres

Przegląd synchronizacji

Kliknij Dalej, aby otworzyć Przegląd. Sprawdź szczegóły połączenia i ustawienia eksportu, w tym:

• Szczegóły skonfigurowanej synchronizacji
• Jakie dane są udostępniane (profile, zdarzenia lub oba rodzaje)
• Wszelkie wykluczone integracje

Kliknij Połącz, aby zapisać połączenie i rozpocząć synchronizacje zgodnie z Twoim harmonogramem.

Jeśli Klaviyo wyświetla Nie można nawiązać połączenia, kliknij Edytuj dane uwierzytelniające, aby poprawić szczegóły połączenia, a następnie wróć do Sprawdź i ponownie kliknij Połącz.

Po zapisaniu połączenia Klaviyo przeniesie Cię z powrotem do Synchronizacja danych. Tabela połączeń pokazuje:

• Hurtownia
• Typ: import lub eksport
• Data utworzenia

Miejsca docelowe eksportu i bezpośrednie połączenia importu są widoczne w tej samej tabeli. Sprawdź Typ, aby je rozróżnić.

Pulpit synchronizacji danych

Gdy połączenie zostanie nawiązane, kliknij integracje na stronie listy Synchronizacja danych. Stąd przejdziesz do pulpitu synchronizacji danych, który zawiera historyczne i bieżące informacje o uruchomionych synchronizacjach danych.

Tutaj zobaczysz informacje o synchronizacji w podziale na 2 karty:

• Historyczne
• Okresowe

Historyczne

Karta Historyczne zawiera dzienniki pokazujące stan synchronizacji danych historycznych. Synchronizacje historyczne odnoszą się do synchronizacji istniejących danych z Klaviyo do hurtowni danych podczas nawiązywania połączenia.

Dla każdej synchronizacji zobaczysz następujące informacje:

• Nazwa
  Dane uwzględniane w synchronizacji.
• Status
  Status i potencjalny postęp synchronizacji wraz z szacowanym procentem lub informacjami o potencjalnych błędach. Te statusy mogą obejmować:
  
  
  • Ukończono
    Synchronizacja danych została zakończona dla tej jednorazowej synchronizacji. Nie zostanie ponownie zsynchronizowana automatycznie.
  • Zaplanowano
    Gdy zaplanowano następny automatyczny przebieg synchronizacji.
  • Synchronizowanie
    Dane są aktywnie synchronizowane z Twoją hurtownią danych, a szacowany procent ukończenia jest dostępny.
  • Błąd
    Wystąpił błąd, ale Klaviyo będzie nadal próbować ponownie nawiązać połączenie. W zależności od integracji ten czas może się nieznacznie różnić.
  • Niepowodzenie
    Synchronizacja zakończyła się całkowitym niepowodzeniem nawet po próbie ponownego nawiązania połączenia. Oznacza to, że musisz sprawdzić ustawienia konfiguracji lub nawet konfigurację hurtowni danych. Po rozwiązaniu problemu kliknij Włącz ponownie dla synchronizacji.
  • Wstrzymano
    Synchronizacja została ręcznie wstrzymana.
  • Anulowano
    Synchronizacja została anulowana i nie jest już zaplanowana.
• Rozpoczęto
  Czas rozpoczęcia synchronizacji.
• Zakończono
  Czas zakończenia synchronizacji.

Okresowe

Karta Okresowe pokazuje status trwających synchronizacji. Gdy klienci nadal wchodzą w interakcję z twoją marką i tworzone są nowe dane, są one wysyłane do twojej hurtowni danych zgodnie z wybranym harmonogramem. Po zakończeniu każdego uruchomienia Klaviyo planuje kolejne uruchomienie.

Dla każdej synchronizacji zobaczysz następujące informacje:

• Nazwa
  Dane uwzględniane w synchronizacji.
• Status
  Bieżący status synchronizacji oraz wszelkie błędy. Te statusy mogą obejmować:
  • Zaplanowano
    Synchronizacja czeka na następne zaplanowane uruchomienie.
  • Synchronizowanie
    Dane są aktywnie synchronizowane z Twoją hurtownią danych.
  • Błąd
    Wystąpił błąd, ale Klaviyo będzie nadal próbować ponownie nawiązać połączenie. W zależności od integracji ten czas może się nieznacznie różnić.
  • Niepowodzenie
    Synchronizacja całkowicie się nie powiodła, nawet po próbie ponownego nawiązania połączenia. Oznacza to, że musisz sprawdzić ustawienia konfiguracji, a nawet konfigurację hurtowni danych. Po rozwiązaniu problemu kliknij Włącz ponownie przy synchronizacji.
  • Wstrzymano
    Synchronizacja została ręcznie wstrzymana.
  • Anulowano
    Synchronizacja została anulowana i nie jest już zaplanowana.
• Aktualność danych
  Aktualność danych odnosi się do tego, jak aktualne są Twoje dane. Na przykład aktualność na poziomie 2 minut oznacza, że synchronizacja przetworzyła dane mniej więcej do stanu sprzed 2 minut. Nowsze dane mogą nadal czekać na synchronizację.
• Przyciski Wstrzymaj, Wznów oraz ponownego włączania poszczególnych synchronizacji.

Usuwanie połączeń z hurtownią danych

1. Przejdź do Integracje.
2. Otwórz menu obok integracji z hurtownią danych i wybierz Usuń integrację. W oknie potwierdzenia kliknij ponownie Usuń integrację.

Wyświetl dzienniki błędów

Jeśli występują problemy z synchronizacją danych między Klaviyo a Twoją hurtownią danych, wyświetlenie powiązanych dzienników błędów może dostarczyć dodatkowych informacji o przyczynie problemu.

Aby wyświetlić błędy, kliknij docelowy magazyn danych na stronie Synchronizowanie. Na kartach Historyczna i Okresowa synchronizacja zobaczysz listę eksportów i ich status, a także wskaźnik informujący, czy są jakieś aktywne błędy.

Aby wyświetlić więcej szczegółów dotyczących konkretnego błędu, kliknij eksport, w którym występuje niepowodzenie.

Tutaj zobaczysz oś czasu synchronizacji wychodzących oraz komunikat o błędzie lub powodzeniu w zależności od statusu synchronizacji.

Kliknięcie konkretnego błędu spowoduje otwarcie wysuwanego panelu z następującymi informacjami:

• Opis
  Krótki opis błędu zwróconego przez hurtownię danych
• Kod
  Kod błędu dla błędu
• Komunikat zewnętrzny
  Rzeczywisty komunikat o błędzie zwrócony przez hurtownię danych
• Data
  Data i godzina błędu

Dodatkowe źródła