Förstå synkronisering av datalager i Klaviyo

Du kommer att lära dig

Läs mer om hur du synkroniserar data från Klaviyo till ditt datalager och importerar datalagerdata till Klaviyo via SFTP. Du kan synkronisera dina kundprofiler och händelsedata, så att du kan lagra och analysera viktig information om dina kunder utanför Klaviyo.

This content requires Functional cookies to be enabled.

Update Cookie Settings

Innan du börjar

Innan du exporterar data från Klaviyo ska du konfigurera ditt datalager som en destination:

• Se till att den användare som har angetts i Klaviyo har rätt behörigheter.
• För destinationer som använder tabeller skapar du tabellerna med de namn som visas i installationsanvisningarna nedan.

Se dessutom till att lägga till IP-adresserna för Klaviyos utgående datalagertrafik i godkännandelistan. Detta säkerställer att Klaviyos förfrågningar inte blockeras av ditt säkerhetslager. De här adresserna 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

1. Gå till Datahantering > Synkronisering. Om du redan har en anslutning klickar du på Skapa synkronisering.
2. Välj Exportera data till ditt datalager.
3. Välj ditt lager och klicka sedan på Anslut till [warehouse name] på konfigurationssidan.

Du kan också välja ditt datalager från Klaviyos appmarknadsplats genom att gå till Integrationer > Utforska appar och söka efter din plattform.

Alternativet Importera data från ditt datalager ställer in en direkt import från datalagret. Om du vill ladda upp CSV-filer via SFTP följer du nästa avsnitt.

Importera data via SFTP

Om du vill importera data från ditt datalager till Klaviyo kan du göra detta via SFTP. För en direkt anslutning till datalagret kan du läsa Förstå import av datalager i Klaviyo.

Gå till Integrationer, öppna Hantera data > SFTP-dataöverföring och välj sedan fliken SFTP-konfiguration.

Processen för att importera lagerdata till Klaviyo är följande:

1. Exportera de data du vill ha från ditt datalager.
2. Generera SSH-nycklar på din lokala maskin.
3. Konfigurera SFTP-klient och importera.

Exportera din databas

Först behöver du exportera dina data från ditt datalager. Logga in på ditt datalager och exportera de data du vill importera till Klaviyo till en CSV-fil.

Generera SSH-nycklar på din lokala maskin

Generera ett nytt SSH-nyckelpar på din lokala maskin. Behåll den privata nyckeln för din SFTP-klient.

1. På SFTP-konfiguration klickar du på Lägg till SSH-nyckel. Ange en nyckeltitel och klistra in din offentliga nyckel i SSH-nyckel.
2. Klicka på Lägg till nyckel.

Konfigurera SFTP-klient och importera

När du har lagt till din offentliga nyckel i Klaviyo konfigurerar du din SFTP-klient och laddar upp din CSV-fil.

1. Skapa en anslutning i din SFTP-klient med server, port och användarnamn som visas under SFTP-inloggningsuppgifter på SFTP-konfiguration. Autentisera med matchande privat nyckel.
2. Innan du laddar upp ska du se till att din CSV-fil följer de rekommenderade formateringsriktlinjerna som länkats ovan.
3. Ladda upp CSV-filen via din SFTP-klient.

Om du vill kontrollera importen öppnar du fliken Dataimport i SFTP-dataöverföring. Nyligen genomförda importer visar:

• Status
  I kö, Bearbetas, Slutförd, Misslyckades eller Avbröts. En slutförd import kan fortfarande innehålla fel.
• Bearbetade rader
  Andel av filen som har bearbetats hittills. Expandera en import för att kontrollera antalet bearbetade och hoppade över rader.
• Importdatum
  Importdatum.
• Importerad av
  Användare som importerade data.

Exportera data till ditt datalager 

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

Amazon Redshift

För att konfigurera Amazon Redshift som ett mål kör du följande skript för att skapa tabellerna klaviyo_event, klaviyo_profile och klaviyo_metric.

Låt din databasadministratör anpassa det här exemplet innan du kör det: ersätt platshållarna, korrigera det omatchade */ nära början och kör de tabellspecifika GRANT-uttrycken efter att du har skapat tabellerna.

När det har konfigurerats som en destination ansluter du ditt datalager till Klaviyo med följande uppsättning autentiseringsuppgifter:

• Namn: Ett namn för att identifiera den här anslutningen. Du kan använda samma namn som din databas i Redshift.
• Värd-URL: Slutpunkten för Amazon Redshift-servern (kallas anslutnings-URL i Redshift)
• Databas: Namnet på Redshift-databasen som Klaviyo kommer att ansluta till
• Port: Portnumret som används av Redshift
• Schema: Ditt databasschema
• Användarnamn: Användarnamnet som används för att logga in på Redshift
• Databaslösenord: Lösenordet som används för att logga in i Redshift
  

Amazon S3

För att konfigurera Amazon S3 som en destination, se till att ha ditt bucketnamn, bucketregion och AWS-åtkomstuppgifter redo.

När det har konfigurerats som en destination ansluter du ditt datalager till Klaviyo med följande uppsättning autentiseringsuppgifter:

• Namn: Ett namn som hjälper dig identifiera den här anslutningen.
• Bucket: Namnet på din bucket.
• Bucket-plats: Det regionnamn som valdes när förvaringsbehållaren skapades.
• ID för åtkomstnyckel: ID för din AWS-åtkomstnyckel.
• Hemlig åtkomstnyckel: Din hemliga AWS åtkomstnyckel.
  

Google BigQuery

För att konfigurera Google BigQuery som en destination kan du köra följande skript för att konfigurera tabellerna klaviyo_profile, klaviyo_event och klaviyo_metric. 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 ACCOUNT EMAIL" med e-postadressen för ditt BigQuery-tjänstekonto.

När det har konfigurerats som en destination ansluter du ditt datalager till Klaviyo med följande uppsättning autentiseringsuppgifter:

• Namn: Ett namn som hjälper dig att identifiera denna destination
• Projekt-ID: Detta är känt som projekt-ID och finns i din API-konsol.
• Datauppsättning: Ä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 konfigurationen.
• Tjänstkontonyckel: Klistra in hela innehållet i JSON-filen som du laddade ner när du skapade ditt tjänstekonto i BigQuery.
  

Microsoft Azure Synapse Analytics

För att konfigurera Microsoft Azure som en destination kör du följande skript för att skapa tabellerna klaviyo_profile, klaviyo_event och klaviyo_metric. Be din databasadministratör att anpassa exemplet innan du kör det: det börjar med DROP TABLE-instruktioner, inklusive en duplicerad DROP TABLE klaviyo_profile. Ta bort DROP TABLE-instruktionerna när du skapar nya tabeller, eller om du behöver bevara befintliga data.

När det har konfigurerats som en destination ansluter du ditt datalager till Klaviyo med följande uppsättning autentiseringsuppgifter:

• Namn: Vi rekommenderar att du använder samma namn som din databas i Azure.
• Arbetsyta: Namnet på Azure Synapse-arbetsytan.
• Databasnamn: Detta identifierar din Dedicated SQL Pool-databas.
• Användarnamn: Ditt inloggningsanvändarnamn för din Dedicated SQL Pool-databas.
• Databaslösenord: Ditt inloggningslösenord för din Dedicated SQL Pool-databas.
• Kontonamn: Ditt Windows Azure-lagringskonto eller DNS-prefixet som du skapade.
• Åtkomstsignatur: Din SAS-sträng (Shared Access Signature) som bevisar åtkomst till Blob Storage-behållaren.
• Behållarnamn: Azure Blob-containernamnet för tillfällig mellanlagringsplats 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:

textCopy

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

2. Generera en offentlig nyckel som refererar till den privata nyckeln genom att köra följande kommando i din terminal:

textCopy

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

3. Kör följande skript för att konfigurera tabellerna KLAVIYO_PROFILE, KLAVIYO_EVENT och KLAVIYO_METRIC. Du måste ha behörigheterna securityadmin och sysadmin för att kunna slutföra konfigurationen nedan. För att kontrollera vilken/vilka roll(er) du har, kör SHOW GRANTS TO USER <your_username> och se till att du har båda rollerna listade. Kontakta en systemadministratör om du behöver få din roll justerad. Innan du kör skriptet ska du ersätta dess SET_-platshållare med dina värden och GENERATE_PUBLIC_KEY med den offentliga nyckel som du genererade. Skriptet använder CREATE OR REPLACE TABLE, som ersätter eventuella befintliga tabeller med dessa namn. Använd en ny databas, eller låt din administratör anpassa dessa uttryck om du behöver bevara befintliga data.

När det har konfigurerats som en destination ansluter du ditt datalager till Klaviyo med följande uppsättning autentiseringsuppgifter:

• Namn: Vi rekommenderar att du använder samma namn som din databas i Snowflake.
• Användarnamn: Användarnamn för att ansluta till din databas. Det ska vara samma som user_name i konfigurationsskriptet.
  
• Privat nyckel: Den genererade privata Snowflake-nyckeln.
  
• Lager:  Ditt lager i Snowflake.
• Konto: Ditt konto i Snowflake.
• Databas: Ditt databasnamn. Det ska vara samma som database_name i installationsskriptet.
• Schema: Ditt databasschema. Detta ska vara samma som schema_name i installationsskriptet.
  

Databricks

Om du vill konfigurera Databricks som en destination, inklusive installationsskriptet, nödvändiga behörigheter och anslutningsuppgifter, följer du stegen i Så här exporterar du Klaviyo-data till Databricks.

Om ditt anslutningsformulär visar ett avsnitt för Blob store kan du använda det för att konfigurera lagring för din export. För data warehouse-destinationer mellanlagrar den här lagringen data innan den läses in i data warehouse. För Amazon S3 är det exportdestinationen.

1. Om du vill använda ett sparat lager väljer du Använd en blob-konfiguration om det visas och väljer sedan ett kompatibelt blob-lager. Om du inte väljer Använd en blob-konfiguration fortsätter du med anslutningsuppgifterna som listas ovan. Om Klaviyo kräver ett blob-lager väljer du ett innan du fortsätter.
2. Om du vill lägga till en butik väljer du Skapa i rullgardinsmenyn Blob store. Välj en leverantör om du uppmanas till det, ange anslutningsuppgifterna och klicka sedan på Skapa.
3. Om fältet Namn på lagringskonfiguration visas anger du namnet på den lagringskonfiguration som du skapade i ditt datalager.
4. För en Amazon S3-destination väljer du ett Filformat och om du vill Komprimera exporterade filer om de kontrollerna visas.

När du har angett dina anslutningsuppgifter klickar du på Nästa. Välj sedan data och schema för din export.

Dataobjekt

I avsnittet Data objects kan du välja att synkronisera alla profildata, bara specifika händelsedata eller båda typerna av data genom att markera relevanta rutor bredvid varje alternativ.

Integrationer att exkludera

I fältet Integrations to exclude kan du välja de specifika integrationer som du vill exkludera i datalagerssynkroniseringen. Det här är användbart om du vill förhindra att data från en specifik integration som du kanske redan har anslutit till Klaviyo också synkroniseras.

Selektiv synkronisering

I fältet Selektiv synkronisering 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 ställer in specifika händelser att synkronisera med det här fältet synkroniseras bara de valda händelserna.

Välj hur ofta dina data ska synkroniseras

I Välj hur ofta dina data ska synkroniseras väljer du ett intervall i Varje: 1, 2, 4, 6, 12 eller 24 timmar. Ange Startdatum, Starttid och Tidszon för schemat.

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 inledande anslutningen. Du kan välja:

• 30 dagar
• 90 dagar
• 1 år
• Total tid

Synka recensioner

Klicka på Nästa för att öppna Granska. Kontrollera anslutningsuppgifterna och exportinställningarna, inklusive:

• Information om synkroniseringen du har ställt in
• Vilka data som delas (profil, händelser eller båda)
• Alla exkluderade integrationer

Klicka på Anslut för att spara anslutningen och starta synkroniseringarna enligt ditt schema.

Om Klaviyo visar Det går inte att ansluta klickar du på Redigera inloggningsuppgifter för att korrigera anslutningsuppgifterna. Gå sedan tillbaka till Granska och klicka på Anslut igen.

När anslutningen har sparats tar Klaviyo dig tillbaka till Datasynkronisering. Anslutningstabellen visar:

• Lager
• Typ: import eller export
• Skapad

Exportdestinationer och direkta importanslutningar visas i samma tabell. Markera Typ för att skilja dem åt.

Instrumentpanel för datasynkronisering

När du har en lyckad anslutning klickar du på din integration på listsidan Datasynkning. Härifrån kommer du till instrumentpanelen för datasynkning som visar historisk och aktuell information om de datasynkroniseringar som har körts.

Här ser du synkroniseringsinformationen uppdelad i 2 flikar:

• Historiskt
• Periodiskt

Historiskt

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

För varje synkronisering ser du följande information:

• Namn
  Data som inkluderas i synkroniseringen.
• Status
  Status och möjlig förlopp för synkroniseringen med en uppskattad procentsats eller möjliga fel angivna. De här statusarna kan omfatta:
  
  
  • Slutförd
    Dina data har synkroniserats klart för den här engångssynkroniseringen. Den synkroniseras inte igen automatiskt.
  • Schemalagd
    När nästa synkronisering är schemalagd att köras automatiskt.
  • Synkroniserar
    Data synkroniseras aktivt till ditt datalager med en beräknad procentandel av slutförandet.
  • Fel
    Ett fel uppstod men Klaviyo kommer att fortsätta försöka återupprätta en anslutning. Beroende på integrationen kan den här tidsangivelsen skilja sig något.
  • Misslyckades
    Synkroniseringen misslyckades helt även efter att du försökt återupprätta en anslutning. Det innebär att du behöver granska dina konfigurationsinställningar eller till och med din datalagerkonfiguration. När du har löst problemet klickar du på Återaktivera för synkroniseringen.
  • Pausad
    Du har pausat synkroniseringen manuellt.
  • Avbruten
    Synkroniseringen har avbrutits och är inte längre schemalagd.
• Startade
  Starttid för synkroniseringen.
• Avslutades
  Sluttid för synkroniseringen.

Periodiskt

Fliken Periodisk visar statusen för pågående synkroniseringar. När kunder fortsätter att interagera med ditt varumärke och nya data skapas skickas de till ditt datalager enligt schemat du valde. När varje körning är klar schemalägger Klaviyo nästa körning.

För varje synkronisering ser du följande information:

• Namn
  Data som inkluderas i synkroniseringen.
• Status
  Synkens aktuella status och eventuella fel. Dessa statusar kan omfatta:
  • Schemalagd
    Synkroniseringen väntar på nästa schemalagda körning.
  • Synkroniserar
    Data synkroniseras aktivt till ditt datalager.
  • Fel
    Ett fel uppstod men Klaviyo kommer att fortsätta försöka återupprätta en anslutning. Beroende på integrationen kan den här tidsangivelsen skilja sig något.
  • Misslyckades
    Synkroniseringen misslyckades helt även efter att du försökte upprätta anslutningen igen. Det här innebär att du behöver granska dina konfigurationsinställningar eller till och med inställningarna för ditt datalager. När du har löst problemet klickar du på Aktivera igen för synkroniseringen.
  • Pausad
    Du har pausat synkroniseringen manuellt.
  • Avbruten
    Synkroniseringen har avbrutits och är inte längre schemalagd.
• Datafärskhet
  Datafärskhet avser hur uppdaterade dina data är. En aktualitet på 2 minuter innebär till exempel att synkroniseringen har bearbetat data fram till ungefär för 2 minuter sedan. Nyare data kan fortfarande vänta på att synkroniseras.
• Knappar för att Pausa, Återuppta och återaktivera enskilda synkroniseringar.

Ta bort datalageranslutningar

1. Gå till Integrationer.
2. Öppna menyn bredvid din datalagerintegration och välj Ta bort integration. I bekräftelsedialogrutan klickar du på Ta bort integration igen.

Visa felloggar

Om du har problem med datasynkronisering mellan Klaviyo och ditt datalager kan du få mer information om orsaken genom att titta på de tillhörande felloggarna.

För att visa fel klickar du på datalagerdestinationen på sidan Synkroniserar. På både fliken Historisk och fliken Periodisk synkronisering ser du en lista över exporterna och deras status, tillsammans med en indikator som visar om det finns några Aktiva fel.

Om du vill se fler detaljer om ett visst fel klickar du på den export som drabbas av felet.

Här ser du en tidslinje över de utgående synkningarna, tillsammans med ett fel- eller lyckat meddelande baserat på synkningens status.

Om du klickar på ett specifikt fel öppnas en panel med följande information:

• Beskrivning
  En kort beskrivning av felet som returnerades av datalagret
• Kod
  Felkoden för felet
• Externt meddelande
  Det faktiska felmeddelandet som returneras av datalagret
• Datum
  Datum och tid för felet

Ytterligare resurser