Zrozum synchronizację hurtowni danych w Klaviyo
Czego się dowiesz
Dowiedz się, jak zsynchronizować dane z Klaviyo do hurtowni danych i zaimportować dane z hurtowni do Klaviyo przez SFTP. Możesz zsynchronizować swój profil klienta i dane zdarzeń, umożliwiając sklep i analizowanie kluczowych informacji o kliencie poza Klaviyo.
Zaawansowana platforma danych klientów Klaviyo nie jest zawarta w standardowej aplikacji marketingowej Klaviyo, a dostęp do powiązanych funkcji wymaga subskrypcji. Przejdź do naszego przewodnika po rozliczeniach, aby dowiedzieć się, jak kupić ten plan.
Zanim zaczniesz
Musisz upewnić się, że hurtownia danych, z którą się łączysz, jest skonfigurowana jako miejsce docelowe. Aby upewnić się, że skonfigurowałeś to poprawnie:
- Proszę upewnić się, że użytkownik dostarczony do Klaviyo ma odpowiednie uprawnienia.
- Upewnij się, że ustawiłeś tabele z odpowiednimi nazwami, pokazanymi poniżej, w oparciu o twój magazyn.
Dodatkowo, upewnij się, że na białej liście Klaviyo znajdują się adresy IP ruchu wychodzącego z hurtowni danych. Zapewni to, że żądania Klaviyo nie będą blokowane przez twoją warstwę bezpieczeństwa. Adresy te są reprezentowane przez następujące zakresy CIDR:
184.72.183.187/3252.206.71.52/323.227.146.32/3244.198.39.11/3235.172.58.121/323.228.37.244/3254.88.219.8/323.214.211.176/32
Połącz się z hurtownią danych
Aby dodać połączenie hurtowni danych do Klaviyo, przejdź do Zaawansowana platforma danych klientów Klaviyo > Zarządzanie danymi > Synchronizacja.
Aby dodać magazyn danych, proszę wybrać obsługiwany magazyn danych w oknie Wybierz łącznik.
Możesz mieć tylko 1 miejsce docelowe hurtowni danych na konto.
Alternatywnie mogą Państwo wybrać hurtownię danych z rynku aplikacji Klaviyo, przechodząc do sekcji Integracje > Przeglądaj aplikacje i wyszukaj swoją platformę.
Podczas podłączania magazynu możesz zaimportować dane z hurtowni danych do Klaviyo lub ustawić magazyn jako miejsce docelowe synchronizacji wychodzącej.
Import danych za pomocą SFTP
Jeśli chcą Państwo zaimportować dane z hurtowni danych do Klaviyo, można to zrobić za pośrednictwem SFTP.
Aby zaimportować dane do Klaviyo, wybierz importuj importuj dane podczas pierwszego łączenia miejsca docelowego magazynu lub kliknij przycisk importuj importuj na stronie synchronizacji danych, jeśli masz już ustanowione połączenie.
Proces importowania importuj dane magazynu do Klaviyo jest następujący:
- Wyeksportuj żądane dane z hurtowni danych.
- Wygeneruj klucz SSH na swoim komputerze lokalnym.
- Skonfiguruj klienta SFTP i zaimportuj import.
Zostało to zademonstrowane na przykładzie Snowflake, ale proces importowania jest podobny niezależnie od integracji Twojego magazynu.
Eksportuj swoją bazę danych
Najpierw musisz wyeksportować dane z magazynu. Zaloguj się do swojego magazynu i wyeksportuj dane, które chcesz zaimportować import do Klaviyo do pliku CSV.
Proszę sformatować wyeksportowane dane zgodnie z formatem CSV i ograniczeniami rozmiaru.
Na komputerze lokalnym wygeneruj klucze SSH
Po wyeksportowaniu żądanych danych z magazynu wygeneruj nowy klucz SSH na komputerze lokalnym i dodaj go do Klaviyo, wybierając przycisk Dodaj klucz SSH.
Podczas dodawania klucza proszę upewnić się, że zaczyna się on od 1 z poniższych liter:
- Ssh-ras
- Ecdsa-sha2
- Ssh-ed
- Sk-ecdsa
- sk-ssh
Skonfiguruj klienta SFTP i zaimportuj
Po pomyślnym dodaniu klucza SSH do Klaviyo, musisz skonfigurować klienta SFTP i zaimportować zaimportować dane.
- Proszę otworzyć klienta SFTP i skonfigurować nowe połączenie przy użyciu danych uwierzytelniających podanych w Klaviyo. Po pomyślnym dodaniu klucza SSH zostaną wyświetlone dane uwierzytelniające.
- Po uwierzytelnieniu, proszę upewnić się, że baza danych jest zgodna z zalecanymi wytycznymi przed importem.
- Proszę przesłać plik bazy danych przez klienta SFTP i przejrzeć go.
Zobaczysz także widok listy ostatnio importowanych plików z następującymi informacjami:
-
Status
Ukończone lub nieukończone. -
Przetworzone wiersze
Procent całkowitej liczby wierszy przetworzonych do tej pory. -
importuj
data importu
Data importu import. -
Zaimportowane przez
Użytkownik, który zaimportował dane.
Eksportuj dane do swojego magazynu
Aby skonfigurować hurtownię danych jako miejsce docelowe, będziesz potrzebować następującego zestawu informacji i poświadczeń dla każdej hurtowni danych.
Amazon Redshift
Aby skonfigurować Amazon Redshift jako miejsce docelowe, uruchom poniższy skrypt w celu utworzenia tabel klaviyo_event i klaviyo_profile.
Po skonfigurowaniu jako miejsce docelowe, połącz swój magazyn z Klaviyo przy użyciu następującego zestawu poświadczeń:
- Name: Nazwa Twojej bazy danych w Redshift (zaleca się użycie tej samej nazwy, co nazwa Twojej bazy danych w Redshift).
- Host URL: Punkt końcowy serwera Amazon Redshift (nazywany adresem URL połączenia w Redshift)
- Baza danych: Nazwa identyfikująca Twoje źródło danych
- Port: numer portu używanego przez Redshift
- Schemat: Twój schemat bazy danych
- Nazwa użytkownika: Nazwa użytkownika używana do logowania się 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 swój magazyn z Klaviyo przy użyciu następującego zestawu poświadczeń:
- Name: Czytelna dla komputera nazwa bazy danych Amazon S3.
- Kubełek: Twoja nazwa zasobnika.
- Lokalizacja zasobnika: Nazwa regionu wybrana podczas tworzenia zasobnika.
- Identyfikator klucza dostępu: Twój identyfikator klucza dostępu AWS.
-
Tajny klucz dostępu: Twój tajny klucz dostępu AWS.
Google BigQuery
Aby skonfigurować Google BigQuery jako miejsce docelowe, uruchom następujący skrypt, aby ustawić tabele klaviyo_profile i klaviyo_event . Twoje konto Google BigQuery musi mieć profil płatności, aby proces połączenia zakończył się powodzeniem.
Pamiętaj, że w tym skrypcie musisz zastąpić symbol zastępczy "SERVICE konto e-mail" adresem e-mail konta usługi BigQuery.
Po skonfigurowaniu jako miejsce docelowe, połącz swój magazyn z Klaviyo przy użyciu następującego zestawu poświadczeń:
- Nazwa: Nazwa, która pomoże Ci zidentyfikować to miejsce docelowe
- Identyfikator projektu: Jest on znany jako identyfikator projektu i można go znaleźć w konsoli API.
- Zbiór danych: Znany również jako schemat. Jest to ta sama nazwa, której użyłeś w skrypcie, który powinieneś był uruchomić podczas konfiguracji.
-
Klucz konta usługi: Wklej całą zawartość pliku JSON pobranego podczas tworzenia konta usługi w BigQuery.
Microsoft Azure Synapse dane analityczne
Aby skonfigurować Microsoft Azure jako miejsce docelowe, uruchom poniższy skrypt w celu utworzenia tabel klaviyo_profile i klaviyo_event .
- Nazwa: Zaleca się użycie tej samej nazwy, co Twoja baza danych na platformie Azure.
- Workspace: Nazwa przestrzeni roboczej Azure Synapse.
- Nazwa bazy danych: identyfikuje Twoją dedykowaną bazę danych SQL Pool.
- Nazwa użytkownika: Twoja nazwa logowania do bazy danych dedykowanej puli SQL.
- Hasło do bazy danych:Twoje hasło logowania do dedykowanej bazy danych SQL Pool.
- nazwa konta: Twoje konto magazynu Windows Azure lub utworzony prefiks DNS.
- Sygnatura dostępu: Twój ciąg sygnatury dostępu współdzielonego (SAS), który potwierdza dostęp do kontenera Blob Storage.
-
Nazwa kontenera: nazwa kontenera Azure Blob dla tymczasowego obszaru przejściowego dla transferu danych.
Snowflake
Aby skonfigurować Snowflake jako miejsce docelowe, wykonaj następujące kroki:
1. Wygeneruj klucz prywatny, uruchamiając następujące polecenie w terminalu:
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 następujące polecenie w terminalu:
openssl rsa -in rsa_key.p8 -pubout -out rsa_key.pub
3. Uruchom poniższy skrypt, aby ustawić tabele KLAVIYO_PROFILE, KLAVIYO_EVENT i KLAVIYO_METRIC. Musisz mieć uprawnienia securityadmin i sysadmin, aby ukończyć poniższą konfigurację. Aby sprawdzić, jakie role posiadasz, uruchom SHOW GRANTS TO USER <your_username> i upewnij się, że na liście znajdują się obie role. Skontaktuj się z administratorem systemu, jeśli chcesz dostosować swoją rolę.
Po skonfigurowaniu jako miejsce docelowe, połącz swój magazyn z Klaviyo przy użyciu następującego zestawu poświadczeń:
- Nazwa: Zaleca się używanie tej samej nazwy, co twoja baza danych w Snowflake.
-
Nazwa użytkownika: Nazwa użytkownika do połączenia z bazą danych. Powinna ona być taka sama jak nazwa_użytkownika w skrypcie instalacyjnym.
-
Klucz prywatny: Wygenerowany klucz prywatny Snowflake.
- Magazyn: Twój magazyn w Snowflake.
- konto: Twoje konto w Snowflake.
- Baza danych: Twoja nazwa bazy danych. Powinna ona być taka sama jak nazwa_bazy danych w skrypcie instalacyjnym.
-
Schemat: Twój schemat bazy danych. Powinna ona być taka sama jak schema_name w skrypcie instalacyjnym.
Po wprowadzeniu danych uwierzytelniających dla hurtowni danych, z którą synchronizujesz, wybierz dane, które chcesz zsynchronizować z Klaviyo.
przedmioty daneprzedmioty dane
W sekcji obiektów danych możesz wybrać synchronizację wszystkich danych profilowych, tylko określonych danych zdarzeń lub obu typów danych, zaznaczając odpowiednie pola obok każdej opcji.
Klaviyo używa zagnieżdżonej struktury JSON podczas wysyłania danych do Twojej hurtowni danych. Profil i zdarzenia są wysyłane jako pojedyncza tabela, dzięki czemu możesz zapytać o jedną tabelę zamiast wielu potencjalnych nazw tabel w hurtowni danych.
Synchronizacja wszystkich danych z Klaviyo może spowodować naliczenie dodatkowych opłat od hurtowni danych.
Integracje do wykluczenia
W polu integracje do wykluczenia możesz wybrać konkretne integracje, które chcesz wykluczyć z synchronizacji hurtowni danych. Jest to przydatne, jeśli chcesz usunąć z synchronizacji dane określonej integracji, które zostały już połączone z Klaviyo.
Wykluczenie konkretnych integracji danych dotyczy tylko danych wydarzeń i nie wyklucza danych profilowych.
Synchronizacja selektywna
W polu Synchronizacja selektywna wybierasz konkretne zdarzenia, które chcesz zsynchronizować z hurtownią danych z Klaviyo. Domyślnie uwzględniane są wszystkie zdarzenia. Gdy ustawisz określone zdarzenia do synchronizacji z tym polem, synchronizowane będą tylko wybrane zdarzenia.
To pole pojawi się tylko wtedy, gdy wybierzesz obiekt Dane zdarzeń .
Określ częstotliwość synchronizacji danych
Wartość ustawiona dla pola Periodic sync cadence w sekcji Select how often your dane will sync definiuje częstotliwość synchronizacji z Klaviyo do hurtowni danych.
Kadencja synchronizacji okresowej jest domyślnie ustawiona na co godzinę i nie można jej zmienić.
Wybierz, ile danych historycznych chcesz zsynchronizować
W sekcji Wybierz, ile danych histor ycznych chcesz zsynchronizować , możesz określić, ile danych historycznych chcesz zsynchronizować z Klaviyo do hurtowni danych podczas pierwszego połączenia. Możesz wybrać:
- 30 dni
- 90 dni
- 1 rok
- Cały czas
Możesz ponieść dodatkowe koszty ze strony hurtowni danych, jeśli synchronizujesz dużą ilość danych jednocześnie.
Recenzja Sync
Po podłączeniu integracji, jeśli konfiguracja przebiegła pomyślnie, zobaczysz ekran końcowy informujący, że połączenie zostało włączone, wraz z:
- Szczegóły skonfigurowanej synchronizacji
- Jakie dane są udostępniane (profile, wydarzenia lub oba)?
- Wszelkie wykluczone integracje
Jeśli synchronizacja nie powiodła się, zamiast tego zobaczysz status Nie można się połączyć wraz z opcjami ponowienia połączenia lub edycji informacji w poświadczeniach.
Po pomyślnym podłączeniu hurtowni danych, zostaniesz przeniesiony z powrotem do głównej strony listy synchronizacji danych. Tutaj zobaczysz swoje dane:
- Miejsce docelowe magazynu
- Status włączania
- Wszelkie potencjalne błędy, które mogły wystąpić podczas synchronizacji w ciągu ostatnich 24 godzin.
- Ostatnia synchronizacja, która miała miejsce wraz ze znacznikiem czasu tego zdarzenia.
Ponieważ będzie można podłączyć tylko jedno miejsce docelowe, w widoku listy będzie widoczne tylko jedno miejsce docelowe.
pulpit synchronizujący danepulpit synchronizujący dane
Po pomyślnym nawiązaniu połączenia kliknij swoją integrację na stronie listy synchronizacji danych. Z tego miejsca zostaniesz przeniesiony do pulpitu synchronizacji danych, zawierającego historyczne i bieżące informacje o uruchomionych synchronizacjach danych.
Tutaj zobaczysz informacje o synchronizacji podzielone na 2 zakładki:
- Historyczne
- Okresowe
Historyczny
Karta Historyczne zawiera dzienniki, które pokazują stan synchronizacji Twoich danych historycznych. Synchronizacje historyczne odnoszą się do synchronizacji istniejących danych z Klaviyo do danych hurtowni po nawiązaniu połączenia.
Zobaczysz następujące informacje dla każdej synchronizacji:
-
Nazwa
Dane są włączane do synchronizacji. -
Status
Status i potencjalny postęp synchronizacji z szacowanym procentem lub potencjalnymi błędami. Statusy te mogą obejmować:
-
Zakończono
Twoje dane zostały zsynchronizowane dla tej jednorazowej synchronizacji. Nie zsynchronizuje się ponownie automatycznie. -
Zaplanowane
Kiedy następna synchronizacja ma zostać automatycznie uruchomiona. -
W toku
Dane są aktywnie synchronizowane z Twoją hurtownią danych z szacowanym procentem ukończenia. -
Błąd
Wystąpił błąd, ale Klaviyo będzie próbować ponownie nawiązać połączenie. W zależności od integracji, czas ten może się nieznacznie różnić. -
Nie powiodło się
Synchronizacja nie powiodła się nawet po próbie ponownego nawiązania połączenia. Oznacza to, że będziesz musiał przejrzeć ustawienia konfiguracji, a nawet hurtownię danych. -
Wstrzymano
Ręcznie wstrzymałeś synchronizację. -
wyłączać
Synchronizacja została wyłączona, ponieważ integracje zostały wyłączone lub usunięte.
-
Zakończono
-
Rozpoczęto w dniu
Czas rozpoczęcia synchronizacji. -
Zakończono na
Czas zakończenia synchronizacji.
Okresowe
Karta Okresowe zawiera dzienniki, które pokazują stan twoich okresowych synchronizacji. W miarę jak klient będzie kontynuował interakcję z Twoją marką i tworzone będą nowe dane, będą one rutynowo przesyłane do hurtowni danych. Podczas konfigurowania połączenia hurtowni danych okresowe synchronizacje będą odbywać się co godzinę.
Zobaczysz następujące informacje dla każdej synchronizacji:
-
Nazwa
Dane są włączane do synchronizacji. -
Status
Status i potencjalny postęp synchronizacji z szacowanym procentem lub potencjalnymi błędami. Statusy te mogą obejmować:
-
Zakończono
Twoje dane zostały zsynchronizowane dla tej jednorazowej synchronizacji. Nie zsynchronizuje się ponownie automatycznie. -
Zaplanowane
Kiedy następna synchronizacja ma zostać automatycznie uruchomiona. -
W toku
Dane są aktywnie synchronizowane z Twoją hurtownią danych z szacowanym procentem ukończenia. -
Błąd
Wystąpił błąd, ale Klaviyo będzie próbować ponownie nawiązać połączenie. W zależności od integracji, czas ten może się nieznacznie różnić. -
Nie powiodło się
Synchronizacja nie powiodła się nawet po próbie ponownego nawiązania połączenia. Oznacza to, że będziesz musiał przejrzeć ustawienia konfiguracji, a nawet hurtownię danych. -
Wstrzymano
Ręcznie wstrzymałeś synchronizację. -
wyłączać
Synchronizacja została wyłączona, ponieważ integracje zostały wyłączone lub usunięte.
-
Zakończono
-
świeżość danych
Świeżość psa odnosi się do tego, jak aktualny jest twój pies. Na przykład, jeśli synchronizacja ma świeżość 2 minut, oznacza to, że wszelkie nowe dane utworzone w Klaviyo w ciągu ostatnich 2 minut nie znajdują się jeszcze w Twojej hurtowni danych. - Przyciski do wstrzymywania, wznawiania i ponownego włączania poszczególnych synchronizacji.
Usuwanie połączeń hurtowni danych
Aby usunąć połączenie z hurtownią danych z konta Klaviyo, wybierz zakładkę Integracje.
Otwórz menu obok integracji hurtowni danych i wybierz opcję Usuń integrację, aby usunąć połączenie.
Wyświetl dzienniki błędów
Jeśli masz problemy z synchronizacją danych między Klaviyo a hurtownią danych, przeglądanie powiązanych dzienników błędów może dostarczyć dodatkowych informacji na temat przyczyny problemu.
Aby wyświetlić błędy, kliknij miejsce docelowe magazynu na stronie synchronizacji. Zarówno na karcie Historyczne, jak i Okresowe synchronizacje zobaczysz listę eksportów i ich status, wraz ze wskaźnikiem pokazującym, czy występują jakieś aktywne błędy.
Aby wyświetlić więcej szczegółów na temat konkretnego błędu, kliknij eksport, w którym wystąpił błąd.
Tutaj zobaczysz oś czasu synchronizacji wychodzących, wraz z komunikatem o błędzie lub powodzeniu w zależności od statusu synchronizacji.
Kliknięcie określonego błędu spowoduje otwarcie szuflady 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 wystąpienia błędu
Dodatkowe źródła
Zrozumienie sposobu wymiany informacji między Klaviyo a aplikacjami
Zrozumienie rodzajów informacji wymienianych między Klaviyo a aplikacjami