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

Voordat je data exporteert uit Klaviyo, configureer je datawarehouse als bestemming:

• Zorg dat de gebruiker die aan Klaviyo is gekoppeld de juiste machtigingen heeft.
• Voor bestemmingen die tabellen gebruiken, maak je de tabellen aan met de namen die in de onderstaande installatie-instructies staan.

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

1. Ga naar Databeheer > Synchroniseren. Als je al een koppeling hebt, klik je op Synchronisatie maken.
2. Selecteer Gegevens exporteren naar je datawarehouse.
3. Selecteer je magazijn en klik vervolgens op Verbinden met [warehouse name] op de instelpagina.

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.

Met de optie Gegevens importeren uit je datawarehouse stel je een directe warehouse-import in. Volg het volgende gedeelte om CSV-bestanden via SFTP te uploaden.

Gegevens importeren via SFTP

Als je data uit je datawarehouse wilt importeren in Klaviyo, kun je dit doen via SFTP. Voor een directe warehouseverbinding, zie Inzicht in import uit datawarehouse in Klaviyo.

Ga naar integraties, open Gegevens beheren > SFTP-gegevensoverdracht en selecteer vervolgens het tabblad SFTP-instelling.

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

Genereer een nieuw SSH-sleutelpaar op je lokale apparaat. Bewaar de privésleutel voor je SFTP-client.

1. Klik in SFTP-configuratie op SSH-sleutel toevoegen. Voer een sleuteltitel in en plak je openbare sleutel in SSH-sleutel.
2. Klik op Sleutel toevoegen.

SFTP-client configureren en importeren

Nadat je je openbare sleutel aan Klaviyo hebt toegevoegd, configureer je je SFTP-client en upload je je CSV-bestand.

1. Maak in je SFTP-client een verbinding met de server, poort en gebruikersnaam die worden weergegeven onder SFTP Credentials in SFTP setup. Verifieer met de overeenkomende privésleutel.
2. Voordat je uploadt, zorg je ervoor dat je CSV-bestand voldoet aan de aanbevolen opmaakrichtlijnen waarnaar hierboven wordt gelinkt.
3. Upload het CSV-bestand via je SFTP-client.

Open om de import te controleren het tabblad Gegevens importeren in SFTP-gegevensoverdracht. Recente importen toont:

• Status
  In wachtrij, Bezig met verwerken, Voltooid, Mislukt of Geannuleerd. Een voltooide import kan nog steeds fouten bevatten.
• Verwerkte rijen
  Percentage van het bestand dat tot nu toe is verwerkt. Vouw een import uit om het aantal verwerkte en overgeslagen rijen te controleren.
• 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 informatie en inloggegevens nodig.

Amazon Redshift

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

Laat je databasebeheerder dit voorbeeld aanpassen voordat je het uitvoert: vervang de placeholders, corrigeer de niet-overeenkomende */ vlak bij het begin en voer de tabelspecifieke GRANT-statements uit nadat je de tabellen hebt gemaakt.

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 verbinding herkent. Je kunt dezelfde naam gebruiken als je database in Redshift.
• Host-URL: Het eindpunt van de Amazon Redshift-server (in Redshift de verbindings-URL genoemd)
• Database: De naam van de Redshift-database waarmee Klaviyo verbinding maakt
• 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

Zorg dat je je bucketnaam, bucketregio en AWS-toegangsgegevens bij de hand hebt om Amazon S3 als bestemming te configureren.

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 verbinding herkent.
• 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

Voer het volgende script uit om Google BigQuery als bestemming te configureren en de tabellen klaviyo_profile, klaviyo_event en klaviyo_metric 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, klaviyo_event en klaviyo_metric te maken. Laat je databasebeheerder het voorbeeld aanpassen voordat je het uitvoert: het begint met DROP TABLE-statements, waaronder een dubbele DROP TABLE klaviyo_profile. Verwijder de DROP TABLE-statements wanneer je nieuwe tabellen maakt, of als je bestaande data moet behouden.

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:

textCopy

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:

textCopy

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 sysadmin-rechten 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 ervoor dat beide rollen worden vermeld. Neem contact op met een systeembeheerder als je je rol moet laten aanpassen. Vervang voordat je het script uitvoert de SET_-placeholders door jouw waarden en GENERATE_PUBLIC_KEY door de openbare sleutel die je hebt gegenereerd. Het script gebruikt CREATE OR REPLACE TABLE, waarmee bestaande tabellen met die namen worden vervangen. Gebruik een nieuwe database of laat je beheerder die statements aanpassen als je bestaande gegevens wilt behouden.

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.
  

Databricks

Volg de stappen in Klaviyo-gegevens exporteren naar Databricks om Databricks als bestemming te configureren, inclusief het installatiescript, de vereiste machtigingen en verbindingsgegevens.

Als je verbindingsformulier een sectie Blob store toont, gebruik je die om opslag voor je export te configureren. Voor datawarehouse-bestemmingen zet deze opslag data tijdelijk klaar voordat deze in het datawarehouse wordt geladen. Voor Amazon S3 is dit de exportbestemming.

1. Om een opgeslagen store te gebruiken, selecteer je Een blobconfiguratie gebruiken (als dit wordt weergegeven) en kies je vervolgens een compatibele Blob-store. Als je Een blobconfiguratie gebruiken niet selecteert, ga je verder met de verbindingsgegevens die hierboven worden vermeld. Als Klaviyo een blob-store vereist, selecteer je er een voordat je verdergaat.
2. Om een store toe te voegen, kies je Maken in de dropdown Blob store. Selecteer een provider als daarom wordt gevraagd, voer de verbindingsgegevens in en klik vervolgens op Maken.
3. Als er een veld Naam van opslagconfiguratie verschijnt, voer dan de naam in van de opslagconfiguratie die je in je datawarehouse hebt gemaakt.
4. Voor een Amazon S3-bestemming kies je een Bestandsindeling en of je Geëxporteerde bestanden comprimeren wilt inschakelen, als die opties worden weergegeven.

Klik op Volgende nadat je je verbindingsgegevens hebt ingevoerd. Kies vervolgens de gegevens en planning voor je export.

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

Kies in Selecteer hoe vaak je gegevens worden gesynchroniseerd bij Elke een interval: 1, 2, 4, 6, 12 of 24 uur. Stel de Startdatum, Starttijd en Tijdzone in voor het schema.

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

Klik op Volgende om Controleren te openen. Controleer de verbindingsgegevens en exportinstellingen, waaronder:

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

Klik op Verbinden om de verbinding op te slaan en de synchronisaties te starten volgens je planning.

Als Klaviyo Kan geen verbinding maken weergeeft, klik je op Inloggegevens bewerken om de verbindingsgegevens te corrigeren. Ga daarna terug naar Controleren en klik opnieuw op Verbinden.

Nadat de koppeling is opgeslagen, brengt Klaviyo je terug naar Data syncing. De tabel met koppelingen toont:

• Warehouse
• Type: importeren of exporteren
• Gemaakt op

Exportbestemmingen en directe importverbindingen worden in dezelfde tabel weergegeven. Vink Type aan om ze van elkaar te onderscheiden.

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 die in de synchronisatie worden opgenomen.
• 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.
  • Synchroniseren
    Gegevens worden actief 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 na het opnieuw proberen een verbinding tot stand te brengen. Dit betekent dat je je configuratie-instellingen of zelfs de datawarehouse-configuratie moet controleren. Nadat je het probleem hebt opgelost, klik je op Opnieuw inschakelen voor de synchronisatie.
  • Gepauzeerd
    Je hebt de synchronisatie handmatig gepauzeerd.
  • Geannuleerd
    De synchronisatie is geannuleerd en wordt niet langer ingepland.
• Gestart op
  Starttijd van de synchronisatie.
• Beëindigd op
  Eindtijd van de synchronisatie.

Periodiek

Het tabblad Periodiek toont de status van lopende synchronisaties. Terwijl klanten met je merk blijven interageren en er nieuwe data wordt aangemaakt, wordt die volgens het door jou geselecteerde schema naar je datawarehouse gestuurd. Nadat elke run is afgerond, plant Klaviyo de volgende run in.

Je ziet de volgende informatie voor elke sync:

• Naam
  De gegevens die in de synchronisatie worden opgenomen.
• Status
  De huidige status van de synchronisatie en eventuele fouten. Deze statussen kunnen het volgende omvatten:
  • Gepland
    De synchronisatie wacht op de volgende geplande uitvoering.
  • Synchroniseren
    Gegevens worden actief gesynchroniseerd met je datawarehouse.
  • 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 verbinding te maken. Dit betekent dat je je configuratie-instellingen of zelfs de datawarehouse-instelling moet controleren. Nadat je het probleem hebt opgelost, klik je op Opnieuw inschakelen voor de synchronisatie.
  • Gepauzeerd
    Je hebt de synchronisatie handmatig gepauzeerd.
  • Geannuleerd
    De synchronisatie is geannuleerd en wordt niet langer ingepland.
• Gegevensactualiteit
  Gegevensactualiteit verwijst naar hoe actueel je gegevens zijn. Een actualiteit van 2 minuten geeft bijvoorbeeld aan dat de synchronisatie gegevens heeft verwerkt tot ongeveer 2 minuten geleden. Nieuwere gegevens wachten mogelijk nog om gesynchroniseerd te worden.
• Knoppen om individuele synchronisaties te Pauzeren, te Hervatten en opnieuw in te schakelen.

Datawarehouseverbindingen verwijderen

1. Navigeer naar Integraties.
2. Open het menu naast je datawarehouse-integratie en selecteer Integratie verwijderen. Klik in het bevestigingsvenster opnieuw op Integratie 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:

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

Extra hulpbronnen