Förstå synkronisering av datalager i Klaviyo

Förväntad lästid: 12 minut(er)

Uppdaterad 5 aug. 2025 14:23 EST

Lär dig hur du synkroniserar data från Klaviyo till ditt datalager, och importera lager data till Klaviyo via SFTP. Du kan synkronisera din kundprofil och händelse data, så att du kan butik och analysera viktig information om din kund utanför Klaviyo.

Advanced Klaviyo Data Platform ingår inte i Klaviyo:s standardmarknadsföringsapplikation, och en prenumeration krävs för att få tillgång till tillhörande funktionalitet. Gå till vår fakturering guide för att lära dig mer om hur du köper detta abonnemang.

Video som går igenom datalager synkning i Klaviyo kunddataplattform" aria-hidden=

Innan du börjar

Du måste se till att det datalager som du ansluter till är konfigurerat som destination. För att säkerställa att du har ställt in detta korrekt:

Se till att användaren som tillhandahålls till Klaviyo har rätt behörigheter.
Se till att du ställer in tabeller med lämpliga namn, se nedan, baserat på ditt lager.

Se dessutom till att godkännandelista Klaviyo's utgående datalager trafik IP-adresser. Detta kommer att säkerställa att Klaviyo:s förfrågningar inte blockeras av ditt säkerhetslager. Dessa adresser representeras av följande CIDR-intervall:

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

Anslut till ett datalager

För att lägga till en datalageranslutning till Klaviyo, navigera till Advanced Klaviyo Data Platform > data management > Syncing.

Om du vill lägga till ett datalager väljer du ett datalager som stöds i modalen Select a connector.

Du kan bara ha 1 datalagerdestination per Konto.

Alternativt kan du välja ditt datalager från Klaviyos appmarknad genom att gå till Integrations >, utforska appar och söka efter din plattform.

När du ansluter ett lager kan du antingen importera data från ditt datalager till Klaviyo eller ange ett lager som en destination för utgående synkronisering.

Importera data via SFTP

Om du vill importera data från ditt datalager till Klaviyo kan du göra det via SFTP.

Om du vill importera data till Klaviyo väljer du importera data när du först ansluter en lagerdestination, eller klickar på knappen importera på sidan för datasynkronisering om du redan har upprättat en anslutning.

Processen för att importera ett lager data till Klaviyo är som följer:

Exportera önskad data från ditt datalager.
Generera SSH-nyckel på din lokala maskin.
Konfigurera SFTP-klient och importör.

Detta demonstreras med Snowflake, men importprocessen är likartad oavsett vilken lagerintegrerare du använder.

Exportera din databas

Först måste du exportera dina data från ditt lager. Logga in på ditt lager och exportera de data som du vill importera till Klaviyo till en CSV-fil.

Formatera dina exporterade data baserat på CSV-format och storleksbegränsningar.

Generera SSH-nycklar på din lokala maskin

När du har exporterat önskad data från ditt lager genererar du en ny SSH-nyckel på din lokala maskin och lägger till den i Klaviyo genom att välja knappen Lägg till SSH-nyckel.

När du lägger till din nyckel, se till att den börjar med 1 av följande:

Ssh-ras
Ecdsa-sha2
Ssh-ed
Sk-ecdsa
sk-ssh

Konfigurera SFTP-klient och importera

När din SSH-nyckel har lagts till i Klaviyo måste du konfigurera din SFTP-klient och importera data.

Öppna din SFTP-klient och konfigurera en ny anslutning med de autentiseringsuppgifter som presenteras i Klaviyo Du kommer att se de autentiseringsuppgifter som presenteras efter att du har lagt till din SSH-nyckel
När du har autentiserat dig ska du kontrollera att din databas följer de rekommenderade riktlinjerna innan du importerar
Ladda upp din databasfil via din SFTP-klient och granska den

Du kommer också att se en lista över dina senaste importer med följande information:

Status
Avslutad eller ofullständig.
Bearbetade rader
Procentandel av det totala antalet rader som hittills har bearbetats.
Datum för import
Datum för import.
Importerad av
Användare som importerade data.

Exportera data till ditt lager

För att konfigurera ditt datalager som destination behöver du följande information och autentiseringsuppgifter för varje datalager.

Amazon Redshift

Om du vill konfigurera Amazon Redshift som destination kör du följande skript för att skapa tabellerna klaviyo_event och klaviyo_profile.

När du är konfigurerad som destination ansluter du ditt lager till Klaviyo med hjälp av följande uppsättning autentiseringsuppgifter:

Namn: Namnet på din databas i Redshift (vi rekommenderar att du använder samma namn som din databas i Redshift)
URL för värd: Slutpunkten för Amazon Redshift-servern (kallas anslutnings-URL i Redshift)
Databas: Det namn som identifierar källan data
Port: Det portnummer som används av Redshift
Schema: Ditt databasschema
Användarnamn: Det användarnamn som används för att logga in på Redshift
Databaslösenord: Det lösenord som används för att logga in på Redshift

Amazon S3

Om du vill konfigurera Amazon S3 som destination ställer du in tabellnamnen till klaviyo_profile och klaviyo_event.

När du är konfigurerad som destination ansluter du ditt lager till Klaviyo med hjälp av följande uppsättning autentiseringsuppgifter:

Namn på databasen: Det maskinläsbara namnet för Amazon S3-databasen.
Skopa: Ditt namn på skopan.
Plats för lagringsskopa: Det regionnamn som valdes när lagringsskopan skapades.
ID för åtkomstnyckel: ID för din AWS åtkomstnyckel.
Hemlig åtkomstnyckel: Din hemliga åtkomstnyckel för AWS.

Google BigQuery

Om du vill konfigurera Google BigQuery som destination kör du följande skript för att ställa in tabellerna klaviyo_profile och klaviyo_event . Ditt Google BigQuery-konto måste ha en betalningsprofil för att anslutningsprocessen ska lyckas.

Observera att du i det här skriptet måste ersätta platshållaren "SERVICE Konto e-post" med din BigQuery-tjänst Konto e-post.

När du är konfigurerad som destination ansluter du ditt lager till Klaviyo med hjälp av följande uppsättning autentiseringsuppgifter:

Namn på destinationen: Ett namn som hjälper dig att identifiera destinationen
Projekt-ID: Detta kallas projekt-ID och finns i din API-konsol.
Dataset: Även känt som schema. Det här är samma namn som du använde i skriptet som du skulle ha kört för installationen.
Nyckel till servicekontot: Klistra in hela innehållet i JSON-filen som du laddade ner när du skapade ditt servicekonto i BigQuery.

Microsoft Azure Synapse analys

Om du vill konfigurera Microsoft Azure som destination kör du följande skript för att skapa tabellerna klaviyo_profile och klaviyo_event .

När du är konfigurerad som destination ansluter du ditt lager till Klaviyo med hjälp av följande uppsättning autentiseringsuppgifter:

Namn: Vi rekommenderar att du använder samma namn som din databas i Azure.
Arbetsyta: Namnet på arbetsytan för Azure Synapse.
Databasnamn: Detta identifierar din Dedicated SQL Pool-databas.
Användarnamn: Ditt användarnamn för inloggning i din Dedicated SQL Pool-databas.
Databaslösenord:Ditt inloggningslösenord för din Dedicated SQL Pool-databas.
Kontonamn: Ditt Windows Azure-lagringskonto eller DNS-prefix som du skapade.
Åtkomstsignatur: Din SAS-sträng (shared access signature) som bevisar åtkomst till Blob Storage-behållaren.
Container name: Namnet på Azure Blob-containern för den tillfälliga mellanlagringsytan för dataöverföring.

Snowflake

Gör så här för att konfigurera Snowflake som destination:

1. Generera en privat nyckel genom att köra följande kommando i din terminal:

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

2. Skapa en publik nyckel som refererar till den privata nyckeln genom att köra följande kommando i terminalen:

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

3. Kör följande skript för att ställa in tabellerna KLAVIYO_PROFILE, KLAVIYO_EVENT och KLAVIYO_METRIC. Du måste ha behörigheterna securityadmin och sysadminprivilegier för att kunna slutföra installationen nedan. Om du vill granska vilka roller du har kör du SHOW GRANTS TO USER <your_username> och kontrollerar att du har båda rollerna listade. Kontakta en systemadministratör om du behöver få din roll justerad.

När du är konfigurerad som destination ansluter du ditt lager till Klaviyo med hjälp av följande uppsättning autentiseringsuppgifter:

Namn på databasen: Vi rekommenderar att du använder samma namn som din databas i Snowflake.
Username: Användarnamn för att ansluta till din databas. Detta bör vara samma som user_name i installationsskriptet.
Privat nyckel: Den privata Snowflake-nyckel som genererats.
Lagerlokal: Din lagerlokal i Snowflake.
Konto: Ditt Konto i Snowflake.
Databas: Namnet på din databas. Detta bör vara samma som databasnamn i installationsskriptet.
Schema: Ditt databasschema. Detta bör vara samma som schema_name i installationsskriptet.

När du har angett dina autentiseringsuppgifter för det datalager du synkroniserar med väljer du de data du vill synkronisera från Klaviyo.

dataobjekt

I avsnittet Dataobjekt kan du välja att synkronisera alla profilerdata, bara en specifik händelse data eller båda typerna av data genom att markera de tillämpliga rutorna bredvid varje alternativ.

Klaviyo använder en nästlad JSON-struktur när data skickas till ditt datalager. profil och events skickas var och en som en enda tabell, vilket gör att du kan göra en sökning mot 1 tabell istället för ett stort antal potentiella tabellnamn i din datalager.

profil och händelser data objekt

Synkronisering av all data från Klaviyo kan leda till att du får extra kostnader från ditt datalager.

Integrationer att exkludera

I fältet Integrationer som ska uteslutas kan du välja de specifika integrationer som du vill utesluta i synkroniseringen av datalager. Detta är användbart om du vill ta bort en specifik integratörs data som du kanske redan har anslutit till Klaviyo från att synkroniseras också.

Uteslutande av specifik integrerare data gäller endast för evenemang data, och utesluter inte profildata.

integrationer för att utesluta fält

Selektiv synkronisering

I fältet Selektiv synkron isering väljer du de specifika händelser som du vill synkronisera till ditt datalager från Klaviyo. Som standard inkluderas alla händelser. När du anger att specifika händelser ska synkroniseras med det här fältet synkroniseras endast de valda händelserna.

Detta fält visas endast om du väljer objektet Events data.

Selektivt synkroniseringsfält

Välj hur ofta dina data ska synkroniseras

Det värde som anges för fältet Periodisk synkroniseringskadens i avsnittet Välj hur ofta dina data ska synkroniseras definierar hur ofta en synkronisering ska ske från Klaviyo till ditt datalager.

Periodisk synkroniseringsfrekvens är som standard inställd på varje timme och kan inte ändras.

Periodisk synkronisering Kadensfält

Välj hur mycket historiska data du vill synkronisera

I avsnittet Välj hur mycket historiska data du vill synkronisera kan du definiera hur mycket historiska data du vill synkronisera från Klaviyo till ditt datalager under den första anslutningen. Du kan välja:

30 dagar
90 dagar
1 år
Hela tiden

Välj hur mycket data som ska synkroniseras till ditt datalager

Du kan få extra kostnader från ditt datalager om du synkroniserar en stor mängd data på en gång.

Sync recension

När du har anslutit din integrerare, och om installationen lyckades, kommer du att se en slutskärm som anger att anslutningen är aktiverad, tillsammans med:

Detaljer om den synkronisering du konfigurerade
Vilka uppgifter som delas (profiler, evenemang eller båda)
Eventuella undantagna integrationer

Anslutning framgångsrik modal

Om anslutningen till synkroniseringen inte lyckades visas i stället statusen Det gick inte att ansluta samt alternativ för att antingen försöka ansluta på nytt eller redigera informationen i dina autentiseringsuppgifter.

När du har anslutit din datalager kommer du att föras tillbaka till huvudsidan för datasynkroniseringslistan. Här kommer du att se din:

Magasinets destination
Status Enabled (aktiverad )
Eventuella fel som kan ha uppstått med din synkronisering under de senaste 24 timmarna
Den senaste synkroniseringen som inträffade tillsammans med en tidsstämpel för denna händelse

Eftersom du bara kommer att kunna ansluta 1 destination kommer du bara att se 1 destination i den här listvyn.

instrumentpanel för datasynkronisering

När du har en lyckad anslutning klickar du på din integrerare från listsidan för datasynkronisering. Härifrån kommer du till data syncing instrumentpanel som ger historisk och aktuell information om de data synkningar som har körts.

Synkroniseringsgränssnitt efter anslutning av lager

Här ser du synkroniseringsinformationen uppdelad i 2 flikar:

Historiskt
Periodiskt

Historisk

Fliken Historik innehåller loggar som visar statusen för dina historiska data synkroniseringar. Historiska synkroniseringar avser synkronisering av dina befintliga data från Klaviyo till ditt datalager när du upprättar en anslutning.

Du ser följande information för varje synkronisering:

Namn
data ingår i synkroniseringen.
Status för synkronisering
Status och potentiella framsteg för synkroniseringen med en uppskattad procentandel eller potentiella fel noterade. Dessa statusar kan inkludera:
- Slutförd
  Dina data har synkroniserats för den här engångssynkroniseringen. Den kommer inte att synkroniseras igen automatiskt.
- Schemalagd
  När nästa synkronisering är schemalagd att köras automatiskt.
- Pågående
  data synkroniseras aktivt till ditt datalager med en beräknad procentandel av slutförandet.
- Felaktigt
  Ett fel inträffade men Klaviyo kommer att fortsätta att försöka återupprätta en anslutning. Beroende på integrationsföretaget kan denna tidpunkt skilja sig något.
- Misslyckades
  Synkroniseringen misslyckades helt även efter försök att återupprätta en anslutning. Detta innebär att du måste se över dina konfigurationsinställningar eller till och med datalager setup.
- Paused
  Du har pausat synkroniseringen manuellt.
- inaktivera
  Synkroniseringen blev inaktiverad eftersom själva integreraren blev inaktiverad eller borttagen.
Startade den
Starttid för synkroniseringen.
Slutade på
Sluttid för synkroniseringen.

Periodiskt

På fliken Periodic finns loggar som visar status för dina periodiska synkroniseringar. När kunderna fortsätter att interagera med ditt varumärke och nya data skapas, kommer de rutinmässigt att skickas till ditt datalager. När du konfigurerar en anslutning till ett datalager kommer periodiska synkroniseringar att ske varje timme.

Du ser följande information för varje synkronisering:

Namn
data ingår i synkroniseringen.
Status för synkronisering
Status och potentiella framsteg för synkroniseringen med en uppskattad procentandel eller potentiella fel noterade. Dessa statusar kan inkludera:
- Slutförd
  Dina data har synkroniserats för den här engångssynkroniseringen. Den kommer inte att synkroniseras igen automatiskt.
- Schemalagd
  När nästa synkronisering är schemalagd att köras automatiskt.
- Pågående
  data synkroniseras aktivt till ditt datalager med en beräknad procentandel av slutförandet.
- Felaktigt
  Ett fel inträffade men Klaviyo kommer att fortsätta att försöka återupprätta en anslutning. Beroende på integrationsföretaget kan denna tidpunkt skilja sig något.
- Misslyckades
  Synkroniseringen misslyckades helt även efter försök att återupprätta en anslutning. Detta innebär att du måste se över dina konfigurationsinställningar eller till och med datalager setup.
- Paused
  Du har pausat synkroniseringen manuellt.
- inaktivera
  Synkroniseringen blev inaktiverad eftersom själva integreraren blev inaktiverad eller borttagen.
färskhet i data
Med datafärskhet menas hur uppdaterad din data är. Om en synkronisering till exempel har en färskhet på 2 minuter innebär det att alla nya data som skapats i Klaviyo under de senaste 2 minuterna ännu inte finns i ditt datalager.
Knappar för att pausa, återuppta och återaktivera enskilda synkroniseringar.

Ta bort anslutningar till datalager

För att ta bort en datalageranslutning från ditt Klaviyo-konto, välj fliken Integrationer.

Öppna menyn bredvid din datalagringsintegrering och välj Ta bort integrering för att ta bort anslutningen.

Visa felloggar

Om du har problem med att data synkroniseras mellan Klaviyo och ditt datalager kan du få ytterligare information om orsaken till problemet genom att titta på de tillhörande felloggarna.

För att visa fel klickar du på din lagerdestination på sidan Synkronisering. På flikarna Historisk och Periodisk synkronisering ser du en lista över exporterna och deras status, tillsammans med en indikator som visar om det finns några Aktiv-fel.

lista över export till lager med information om hälsa och antal fel