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

Musisz upewnić się, że hurtownia danych, z którą się łączysz, jest skonfigurowana jako miejsce docelowe. Aby upewnić się, że skonfigurowano to prawidłowo:

• Upewnij się, że użytkownik udostępniany Klaviyo ma odpowiednie uprawnienia.
• Pamiętaj, aby ustawić tabele z odpowiednimi nazwami, pokazanymi poniżej, w oparciu o swój magazyn.

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

Aby dodać połączenie z hurtownią danych do Klaviyo, przejdź do Zaawansowana platforma danych klientów Klaviyo > Zarządzanie danymi > Synchronizacja.

Aby dodać hurtownię danych, wybierz obsługiwaną hurtownię danych w oknie modalnym Select a connector modal.

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

Podczas łączenia hurtowni danych możesz albo importować dane z hurtowni danych do Klaviyo, albo ustawić hurtownię danych jako miejsce docelowe synchronizacji wychodzącej.

Import danych za pomocą SFTP

Jeśli chcesz zaimportować dane z hurtowni danych do Klaviyo, możesz to zrobić przez SFTP.

Aby zaimportować dane do Klaviyo, wybierz Importuj dane podczas pierwszego łączenia miejsca docelowego hurtowni lub kliknij przycisk Importuj na stronie Synchronizacja danych, jeśli połączenie jest już ustanowione.

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

Gdy wyeksportujesz potrzebne dane z magazynu danych, wygeneruj nowy klucz SSH na swojej maszynie lokalnej i dodaj go do Klaviyo, wybierając przycisk Dodaj klucz SSH.

Skonfiguruj klienta SFTP i zaimportuj

Gdy klucz SSH zostanie pomyślnie dodany do Klaviyo, trzeba będzie skonfigurować klienta SFTP i zaimportować dane.

1. Otwórz klienta SFTP i skonfiguruj nowe połączenie, używając danych uwierzytelniających podanych w Klaviyo. Po pomyślnym dodaniu klucza SSH zobaczysz wyświetlone dane uwierzytelniające
2. Po zakończeniu uwierzytelnienia i zanim rozpoczniesz import, sprawdź, czy Twoja baza danych odpowiada zalecanym wytycznym
3. Prześlij plik bazy danych za pomocą klienta SFTP i sprawdź

Zobaczysz też widok listy ostatnich importów z następującymi informacjami:

• Status
  Ukończone lub nieukończone.
• Przetworzone wiersze
  Procent łącznej liczby wierszy przetworzonych do tej pory.
• Data importu
  Data importu.
• Zaimportowane przez
  Użytkownik, który zaimportował dane.

Eksportuj dane do hurtowni danych 

Aby skonfigurować hurtownię danych jako miejsce docelowe, potrzebny będzie następujący zestaw 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 i klaviyo_profile.

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

• Nazwa: Nazwa bazy danych w Redshift (zaleca się użycie tej samej nazwy co nazwa bazy danych w Redshift)
• Adres URL hosta: Punkt końcowy serwera Amazon Redshift (w Redshift nazywany adresem URL połączenia)
• Baza danych: Nazwa umożliwiająca identyfikację źródła danych
• 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, ustaw nazwy tabel na klaviyo_profile i klaviyo_event.

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

• Nazwa: nazwa zrozumiała dla komputera bazy danych Amazon S3.
• 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 poniższy skrypt, aby skonfigurować tabele klaviyo_profile i klaviyo_event . 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 następujący skrypt, aby utworzyć tabele klaviyo_profile i klaviyo_event .

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 bazy danych: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:

text Copy

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:

text Copy

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ą/które masz rolę/role, uruchom SHOW GRANTS TO USER <your_username> i upewnij się, że obie role znajdują się na liście. Skontaktuj się z administratorem systemu, jeśli trzeba dostosować rolę.

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.
  

Po wprowadzeniu danych logowania do hurtowni danych, z którą przeprowadzasz synchronizację, wybierz dane, które chcesz zsynchronizować z Klaviyo.

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

Wartość ustawiona w polu Częstotliwość okresowej synchronizacji w sekcji Wybierz, jak często Twoje dane będą synchronizowane określa, jak często będzie wykonywana synchronizacja z Klaviyo do hurtowni danych.

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

Po połączeniu integracje, jeśli konfiguracja się powiodła, zobaczysz ekran końcowy z informacją, że połączenie jest Włączone, wraz z:

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

Jeśli synchronizacja nie została pomyślnie połączona, zamiast tego zobaczysz status Nie można połączyć oraz opcje ponowienia połączenia lub edycji informacji w danych uwierzytelniających.

Po pomyślnym połączeniu hurtowni danych nastąpi powrót do głównej strony listy Synchronizacja danych. Tutaj zobaczysz:

• Magazyn Miejsce docelowe
• Status Włączono
• Wszelkie potencjalne błędy, które mogły wystąpić w ramach synchronizacji w ciągu ostatnich 24 godzin
• Ostatnia synchronizacja, która miała miejsce, wraz ze znacznikiem czasu tego zdarzenia

Ponieważ zawsze będzie można połączyć tylko 1 miejsce docelowe, na tym widoku listy zobaczysz tylko 1 miejsce docelowe.

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 są 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.
  • W toku
    Dane są aktywnie synchronizowane z hurtownią danych. Szacowany procent ukończenia:
  • 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 trzeba sprawdzić ustawienia konfiguracji lub nawet konfigurację hurtowni danych.
  • Wstrzymano
    Synchronizacja została ręcznie wstrzymana.
  • Wyłączono
    Synchronizacja została wyłączona, ponieważ sama integracja została wyłączona lub usunięta.
• Rozpoczęto
  Czas rozpoczęcia synchronizacji.
• Zakończono
  Czas zakończenia synchronizacji.

Okresowe

Karta Okresowe zawiera dzienniki pokazujące status Twoich okresowych synchronizacji. Gdy klienci nadal wchodzą w interakcje z Twoją marką i tworzone są nowe dane, będą one rutynowo wysyłane do Twojej hurtowni danych. Podczas konfigurowania połączenia z hurtownią danych okresowe synchronizacje będą odbywać się co godzinę.

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

• Nazwa
  Dane są 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.
  • W toku
    Dane są aktywnie synchronizowane z hurtownią danych. Szacowany procent ukończenia:
  • 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 trzeba będzie przejrzeć ustawienia konfiguracji, a nawet ustawienia hurtowni danych.
  • Wstrzymano
    Synchronizacja została ręcznie wstrzymana.
  • WYŁĄCZONE
    Synchronizacja została wyłączona, ponieważ sama integracje została wyłączona lub usunięta.
• Świeżość danych
  Świeżość danych odnosi się do tego, jak aktualne są dane. Na przykład jeśli synchronizacja ma świeżość 2 minuty, oznacza to, że wszelkie nowe dane utworzone w Klaviyo w ciągu ostatnich 2 minut nie znajdują się jeszcze w hurtowni danych.
• Przyciski Wstrzymaj, Wznów oraz ponownego włączania poszczególnych synchronizacji.

Usuwanie połączeń z hurtownią danych

Aby usunąć połączenie hurtowni danych z konta Klaviyo, wybierz kartę integracje.

Otwórz menu obok integracji hurtowni danych i wybierz Usuń integrację, aby usunąć połączenie.

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:

• Podsumowanie
  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