Gegevenssynchronisatie met datawarehouses begrijpen in Klaviyo

Wat je leert

Lees hoe je gegevens kunt synchroniseren van Klaviyo naar je datawarehouse en hoe je data uit je datawarehouse kunt importeren naar Klaviyo via SFTP. Je kunt je klantprofiel- en gebeurtenisgegevens synchroniseren, zodat je belangrijke informatie over je klanten buiten Klaviyo kunt opslaan en analyseren.

This content requires Functional cookies to be enabled.

Update Cookie Settings

Voordat je van start gaat

Je moet ervoor zorgen dat het datawarehouse waarmee je verbinding maakt, is geconfigureerd als een bestemming. Om zeker te weten dat je dit correct hebt ingesteld:

• Zorg dat de gebruiker die aan Klaviyo is gekoppeld de juiste machtigingen heeft.
• Zorg ervoor dat je tabellen de juiste namen geeft, hieronder weergegeven, op basis van je datawarehouse.

Zorg er daarnaast voor dat je de IP-adressen van Klaviyo's uitgaande datawarehouseverkeer op de positieve lijst zet. Zo zorg je ervoor dat de verzoeken van Klaviyo niet worden geblokkeerd door je beveiligingslaag. Deze adressen worden weergegeven door de volgende CIDR-bereiken:

• 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

Maak verbinding met een datawarehouse

Als je een datawarehouse-verbinding wilt toevoegen aan Klaviyo, ga je naar Advanced Klaviyo Data Platform > Geavanceerd gegevensbeheer > Synchroniseren.

Als je een datawarehouse wilt toevoegen, selecteer je een ondersteund datawarehouse in de Select a connector modal.

Je kunt ook je datawarehouse selecteren in de app-marktplaats van Klaviyo door naar integraties > Apps verkennen te gaan en naar je platform te zoeken.

Wanneer je een datawarehouse koppelt, kun je gegevens uit je datawarehouse importeren naar Klaviyo of een datawarehouse instellen als uitgaande synchronisatiebestemming.

Gegevens importeren via SFTP

Als je data uit je datawarehouse wilt importeren in Klaviyo, kun je dit doen via SFTP.

Om je data in Klaviyo te importeren, selecteer je Data importeren wanneer je voor het eerst een warehousebestemming verbindt, of klik je op de knop Importeren op de pagina Data synchroniseren als je al een verbinding hebt ingesteld.

Het proces om magazijngegevens in Klaviyo te importeren is als volgt:

1. Exporteer de gegevens die je wilt uit je datawarehouse.
2. Genereer SSH-sleutels op je lokale apparaat.
3. SFTP-client configureren en importeren.

Je database exporteren

Eerst moet je je gegevens exporteren uit je datawarehouse. Log in bij je datawarehouse en exporteer de gegevens die je naar Klaviyo wilt importeren naar een CSV-bestand.

SSH-sleutels genereren op je lokale apparaat

Zodra je de gewenste data uit je datawarehouse hebt geëxporteerd, genereer je een nieuwe SSH-sleutel op je lokale machine en voeg je deze toe aan Klaviyo door de knop SSH-sleutel toevoegen te selecteren.

SFTP-client configureren en importeren

Zodra je SSH-sleutel succesvol is toegevoegd aan Klaviyo, moet je je SFTP-client configureren en de data importeren.

1. Open je SFTP-client en configureer een nieuwe verbinding met de in Klaviyo getoonde inloggegevens. Je ziet de inloggegevens nadat je je SSH-sleutel met succes hebt toegevoegd.
2. Controleer nadat je geverifieerd bent eerst of je database de aanbevolen richtlijnen volgt voordat je gaat importeren
3. Upload je databasebestand via je SFTP-client en controleer het.

Je ziet ook een lijstweergave van je recente imports met de volgende informatie:

• Status
  Voltooid of onvoltooid.
• Verwerkte rijen
  Percentage van het totale aantal rijen dat tot nu toe is verwerkt.
• Importdatum
  Datum van import.
• Geïmporteerd door
  Gebruiker die gegevens heeft geïmporteerd.

Gegevens exporteren naar je datawarehouse 

Om je datawarehouse als bestemming te configureren, heb je voor elk datawarehouse de volgende set aan informatie en inloggegevens nodig.

Amazon Redshift

Om Amazon Redshift als bestemming te configureren, voer je het volgende script uit om de tabellen klaviyo_event en klaviyo_profile te maken.

Zodra dit is geconfigureerd als bestemming, koppel je je warehouse aan Klaviyo met behulp van de volgende set gegevens:

• Naam: De naam van je database in Redshift (het is aanbevolen om dezelfde naam te gebruiken als je database in Redshift)
• Host-URL: Het eindpunt van de Amazon Redshift-server (in Redshift de verbindings-URL genoemd)
• Database: De naam om je gegevensbron te identificeren
• Poort: Het poortnummer dat door Redshift wordt gebruikt
• Schema: Je databaseschema
• Gebruikersnaam: De gebruikersnaam die wordt gebruikt om in te loggen bij Redshift
• Databasewachtwoord: Het wachtwoord dat wordt gebruikt om in te loggen op Redshift
  

Amazon S3

Om Amazon S3 als bestemming te configureren, stel je de tabelnamen in op klaviyo_profile en klaviyo_event.

Zodra dit is geconfigureerd als bestemming, koppel je je warehouse aan Klaviyo met behulp van de volgende set gegevens:

• Naam: De machineleesbare naam voor Amazon S3-database.
• Bucket: De naam van je bucket.
• Bucketlocatie: De regionaam die werd gekozen toen de opslagbucket werd aangemaakt.
• Access key ID: Je toegangssleutel-ID voor AWS.
• Geheime toegangssleutel: Je geheime AWS-toegangssleutel.
  

Google BigQuery

Om Google BigQuery als bestemming te configureren, voer je het volgende script uit om de tabellen klaviyo_profile en klaviyo_event in te stellen. Je Google BigQuery-account moet een betalingsprofiel hebben om het verbindingsproces succesvol te laten verlopen.

Let op: in dit script moet je de placeholder "SERVICE ACCOUNT EMAIL" vervangen door je BigQuery-serviceaccount-e-mailadres.

Zodra dit is geconfigureerd als bestemming, koppel je je warehouse aan Klaviyo met behulp van de volgende set gegevens:

• Naam: Een naam waaraan je deze bestemming herkent
• Project-ID: Dit wordt het project-ID genoemd en kan worden gevonden in je API-console.
• Dataset: Ook wel schema genoemd. Dit is dezelfde naam die je hebt gebruikt in het script dat je voor het instellen hebt moeten uitvoeren.
• Serviceaccountkey: Plak de volledige inhoud van het JSON-bestand dat je hebt gedownload toen je je serviceaccount in BigQuery maakte.
  

Microsoft Azure Synapse Analytics

Om Microsoft Azure als bestemming te configureren, voer je het volgende script uit om de tabellen klaviyo_profile en klaviyo_event te maken.

Zodra dit is geconfigureerd als bestemming, koppel je je warehouse aan Klaviyo met behulp van de volgende set gegevens:

• Naam: Het beste kun je dezelfde naam gebruiken als je database in Azure.
• Werkruimte: De naam van de Azure Synapse-werkruimte.
• Databasenaam: Hiermee wordt je Dedicated SQL Pool-database geïdentificeerd.
• Gebruikersnaam: Je gebruikersnaam voor inloggen voor je Dedicated SQL Pool-database.
• Databasewachtwoord:Je inlogwachtwoord voor je Dedicated SQL Pool-database.
• Accountnaam: Je Windows Azure-opslagaccount of de DNS-prefix die je hebt gemaakt.
• Handtekening voor toegang: Je Shared Access Signature (SAS)-string waarmee je toegang tot de Blob Storage-container wordt bewezen.
• Containernaam: De naam van de Azure Blob-container voor een tijdelijke stagingruimte voor gegevensoverdracht.
  

Snowflake

Volg deze stappen om Snowflake als bestemming te configureren:

1. Genereer een privésleutel door de volgende opdracht uit te voeren in je terminal:

text Copy

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

2. Genereer een openbare sleutel die verwijst naar de privésleutel door de volgende opdracht uit te voeren in je terminal:

text Copy

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

3. Voer het volgende script uit om de tabellen KLAVIYO_PROFILE, KLAVIYO_EVENT en KLAVIYO_METRIC in te stellen. Je moet securityadmin- en sysadminprivileges hebben om de onderstaande installatie te voltooien. Om te controleren welke rol(len) je hebt, voer je SHOW GRANTS TO USER <your_username> uit en zorg je dat je beide rollen ziet staan. Neem contact op met een systeembeheerder als je je rol moet laten aanpassen.

Zodra dit is geconfigureerd als bestemming, koppel je je warehouse aan Klaviyo met behulp van de volgende set gegevens:

• Naam: Het beste kun je de naam gebruiken van je database in Snowflake.
• Gebruikersnaam: Gebruikersnaam om verbinding te maken met je database. Dit moet hetzelfde zijn als user_name in het installatiescript.
  
• Privésleutel: De gegenereerde Snowflake-privésleutel.
  
• Warehouse: Je warehouse in Snowflake.
• Account: Je account in Snowflake.
• Database: denaam van uw database. Dit moet hetzelfde zijn als database_name in het setup-script.
• Schema: Je databaseschema. Dit moet hetzelfde zijn als schema_name in het installatiescript.
  

Nadat je je inloggegevens hebt ingevoerd voor het datawarehouse waarmee je synchroniseert, kies je de gegevens die je vanuit Klaviyo wilt synchroniseren.

Gegevensobjecten

In het gedeelte Data objects kun je ervoor kiezen om alle profielgegevens te synchroniseren, alleen specifieke eventgegevens of beide typen gegevens door het/de toepasselijke vakje(s) naast elke optie aan te vinken.

Uit te sluiten integraties

In het veld Integraties om uit te sluiten kun je de specifieke integratie(s) selecteren die je wilt uitsluiten in de datawarehouse-sync. Dit is handig als je wilt voorkomen dat gegevens van een specifieke integratie die je mogelijk al met Klaviyo hebt verbonden ook worden gesynchroniseerd.

Selectieve synchronisatie

In het veld Selective sync selecteer je de specifieke gebeurtenissen die je vanuit Klaviyo naar je datawarehouse wilt synchroniseren. Standaard zijn alle gebeurtenissen inbegrepen. Als je met dit veld specifieke gebeurtenissen instelt om te synchroniseren, worden alleen de geselecteerde gebeurtenissen gesynchroniseerd.

Selecteer hoe vaak je gegevens worden gesynchroniseerd

De waarde die is ingesteld voor het veld Periodic sync cadence in de sectie Select how often your data will sync bepaalt hoe vaak er een synchronisatie plaatsvindt van Klaviyo naar je datawarehouse.

Selecteer hoeveel historische gegevens je wilt synchroniseren

In de sectie Selecteer hoeveel historische gegevens je wilt synchroniseren kun je bepalen hoeveel historische gegevens je tijdens de eerste verbinding wilt synchroniseren van Klaviyo naar je datawarehouse. Je kunt kiezen:

• 30 dagen
• 90 dagen
• 1 jaar
• Sinds het begin

Review synchroniseren

Zodra je je integraties hebt gekoppeld, zie je als de installatie is geslaagd een laatste scherm waarop staat dat de verbinding Ingeschakeld is, samen met:

• Details van de synchronisatie die je hebt ingesteld
• Welke gegevens worden gedeeld (profielen, events of beide)
• Alle uitgesloten integraties

Als je synchronisatie niet succesvol is verbonden, zie je in plaats daarvan de status Kan niet verbinden, samen met opties om je verbinding opnieuw te proberen of de informatie in je inloggegevens te bewerken.

Zodra je je datawarehouse met succes hebt verbonden, word je teruggebracht naar de hoofdpagina van de lijst Gegevens synchroniseren. Hier zie je je:

• Warehouse Bestemming
• De status Ingeschakeld
• Eventuele fouten die in de afgelopen 24 uur zijn opgetreden bij je synchronisatie
• De laatste synchronisatie die heeft plaatsgevonden, samen met een tijdstempel van deze gebeurtenis

Omdat je maar 1 bestemming kunt koppelen, zie je in deze lijstweergave maar 1 bestemming terug.

Dashboard voor gegevenssynchronisatie

Zodra je een succesvolle verbinding hebt, klik je in de lijstpagina Gegevenssynchronisatie op je integratie. Vanaf hier kom je in het dashboard voor gegevenssynchronisatie, met historische en actuele informatie over de uitgevoerde gegevenssynchronisaties.

Hier zie je de synchronisatie-informatie opgesplitst in 2 tabbladen:

• Historisch
• Periodiek

Historisch

Het tabblad Historisch bevat logs die de status van je synchronisaties van historische gegevens laten zien. Historische synchronisaties verwijzen naar het synchroniseren van je bestaande gegevens van Klaviyo naar je datawarehouse wanneer je een verbinding tot stand brengt.

Je ziet de volgende informatie voor elke sync:

• Naam
  De gegevens worden opgenomen in de synchronisatie.
• Status
  Status en mogelijke voortgang van de synchronisatie, met een geschat percentage of eventuele genoteerde fouten. Deze statussen kunnen het volgende bevatten:
  
  
  • Voltooid
    Je gegevens zijn klaar met synchroniseren voor deze eenmalige synchronisatie. Er wordt niet opnieuw automatisch gesynchroniseerd.
  • Gepland
    Wanneer de volgende synchronisatie is gepland om automatisch te worden uitgevoerd.
  • Bezig
    Er worden actief gegevens gesynchroniseerd naar je datawarehouse, met een geschat voltooiingspercentage.
  • Fout opgetreden
    Er is een fout opgetreden, maar Klaviyo blijft proberen om opnieuw een verbinding tot stand te brengen. Afhankelijk van de integratie kan deze timing iets afwijken.
  • Mislukt
    De sync is volledig mislukt, zelfs nadat je hebt geprobeerd om opnieuw verbinding te maken. Dit betekent dat je je configuratie-instellingen of zelfs de inrichting van je datawarehouse moet controleren.
  • Gepauzeerd
    Je hebt de synchronisatie handmatig gepauzeerd.
  • Uitgeschakeld
    De synchronisatie is uitgeschakeld omdat de integratie zelf is uitgeschakeld of verwijderd.
• Gestart op
  Starttijd van de synchronisatie.
• Beëindigd op
  Eindtijd van de synchronisatie.

Periodiek

Het tabblad Periodic bevat logs die de status van je periodieke synchronisaties tonen. Naarmate klanten blijven interageren met je merk en er nieuwe data wordt aangemaakt, wordt die routinematig naar je datawarehouse verzonden. Bij het instellen van een datawarehouse-verbinding vinden periodieke synchronisaties elk uur plaats.

Je ziet de volgende informatie voor elke sync:

• Naam
  De gegevens worden opgenomen in de synchronisatie.
• Status
  Status en mogelijke voortgang van de synchronisatie, met een geschat percentage of eventuele genoteerde fouten. Deze statussen kunnen het volgende bevatten:
  
  
  • Voltooid
    Je gegevens zijn klaar met synchroniseren voor deze eenmalige synchronisatie. Er wordt niet opnieuw automatisch gesynchroniseerd.
  • Gepland
    Wanneer de volgende synchronisatie is gepland om automatisch te worden uitgevoerd.
  • Bezig
    Er worden actief gegevens gesynchroniseerd naar je datawarehouse, met een geschat voltooiingspercentage.
  • Fout opgetreden
    Er is een fout opgetreden, maar Klaviyo blijft proberen om opnieuw een verbinding tot stand te brengen. Afhankelijk van de integratie kan deze timing iets afwijken.
  • Mislukt
    De synchronisatie is volledig mislukt, zelfs nadat je hebt geprobeerd opnieuw een verbinding tot stand te brengen. Dit betekent dat je je configuratie-instellingen of zelfs je datawarehouse-instelling moet controleren.
  • Gepauzeerd
    Je hebt de synchronisatie handmatig gepauzeerd.
  • Uitgeschakeld
    De synchronisatie is uitgeschakeld omdat de integraties zelf zijn uitgeschakeld of verwijderd.
• Actualiteit van gegevens
  Actualiteit van gegevens verwijst naar hoe up-to-date je gegevens zijn. Als een synchronisatie bijvoorbeeld een actualiteit van 2 minuten heeft, betekent dit dat nieuwe gegevens die in de afgelopen 2 minuten in Klaviyo zijn gemaakt, nog niet in je datawarehouse staan.
• Knoppen om individuele synchronisaties te Pauzeren, te Hervatten en opnieuw in te schakelen.

Datawarehouseverbindingen verwijderen

Om een datawarehouse-verbinding uit je Klaviyo-account te verwijderen, selecteer je het tabblad Integraties.

Open het menu naast je datawarehouse-integratie en selecteer Integratie verwijderen om de verbinding te verwijderen.

Foutlogboeken bekijken

Als je problemen ervaart met de gegevenssynchronisatie tussen Klaviyo en je datawarehouse, kan het bekijken van de bijbehorende foutlogboeken extra informatie geven over de oorzaak van het probleem.

Ga naar je datawarehousebestemming op de pagina Synchroniseren om fouten te bekijken. Op zowel het tabblad Historisch als Periodiek synchroniseren zie je een lijst met exports en hun status, samen met een indicator die laat zien of er actieve fouten zijn.

Klik op de export waarbij de fout optreedt om meer details over een specifieke fout te bekijken.

Hier zie je een tijdlijn van de uitgaande synchronisaties, samen met een fout- of succesmelding op basis van de status van de synchronisatie.

Als je op een specifieke fout klikt, wordt er een zijpaneel geopend met de volgende informatie:

• Overzicht
  Een korte beschrijving van de fout die door het datawarehouse is geretourneerd
• Code
  De foutcode voor de fout
• Extern bericht
  Het daadwerkelijke foutbericht dat wordt geretourneerd door het datawarehouse
• Datum
  De datum en tijd van de fout