Begrijp datawarehousesynchronisatie in Klaviyo

Wat je leert

Leer hoe je gegevens synchroniseert van Klaviyo naar je datawarehouse en hoe je magazijngegevens importeert naar Klaviyo via SFTP. Je kunt je klantprofiel en evenementgegevens synchroniseren, zodat je belangrijke informatie over je klant ook buiten Klaviyo kunt bekijken en analyseren. 

Voordat je van start gaat

Je moet ervoor zorgen dat het datawarehouse waarmee je verbinding maakt is geconfigureerd als bestemming. Om er zeker van te zijn dat je dit goed hebt ingesteld:

• Zorg ervoor dat de gebruiker die aan Klaviyo wordt doorgegeven de juiste rechten heeft.
• Zorg ervoor dat je tabellen instelt met de juiste namen, zoals hieronder weergegeven, op basis van je magazijn.

Zorg er daarnaast voor dat de positieve lijst Klaviyo's uitgaande datawarehouse verkeer IP adressen bevat. Dit zorgt ervoor dat de verzoeken van Klaviyo niet worden geblokkeerd door je beveiligingslaag. Deze adressen worden voorgesteld 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

Verbinding maken met een datawarehouse 

Om een datawarehouse verbinding toe te voegen aan Klaviyo, navigeer naar Geavanceerd Klaviyo Data Platform > gegevensbeheer > Synchronisatie.

Om een datawarehouse toe te voegen, selecteert u een ondersteund datawarehouse in het modale venster Selecteer een connector.

U kunt ook uw datawarehouse selecteren in de app-marktplaats van Klaviyo door naar 'Integraties' te gaan > Apps verkennen en naar uw platform te zoeken.

Bij het koppelen van een magazijn kun je gegevens importeren vanuit je datawarehouse naar Klaviyo, of een magazijn instellen als uitgaande synchronisatiebestemming.

Gegevens importeren via SFTP

Als u gegevens uit uw datawarehouse in Klaviyo wilt importeren, kunt u dit doen via SFTP.

Om je gegevens te importeren in Klaviyo, selecteer je Gegevens importeren als je voor het eerst verbinding maakt met een magazijnbestemming, of klik je op de knop Gegevens importeren op de pagina Gegevens synchroniseren als je al een verbinding tot stand hebt gebracht.

Het importeren van magazijngegevens in Klaviyo gaat als volgt:

1. Exporteer de gewenste gegevens uit je datawarehouse.
2. Genereer SSH-sleutel op je lokale machine.
3. SFTP-client configureren en importeren.

Je database exporteren

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

SSH-sleutels genereren op je lokale apparaat

Zodra u de gewenste gegevens uit uw magazijn hebt geëxporteerd, genereert u een nieuwe SSH-sleutel op uw lokale machine en voegt u deze toe aan Klaviyo door de knop SSH-sleutel toevoegen te selecteren.

SFTP-client configureren en importeren

Zodra je SSH-sleutel met succes is toegevoegd aan Klaviyo, moet je je SFTP-client configureren en de gegevens importeren.

1. Open uw SFTP-client en configureer een nieuwe verbinding met de referenties die in Klaviyo worden weergegeven U ziet de referenties nadat u uw SSH-sleutel met succes hebt toegevoegd
2. Zorg er na verificatie voor dat uw database de aanbevolen richtlijnen volgt voordat u importeert
3. Upload uw databasebestand via uw SFTP-client en bekijk het

Je ziet ook een overzicht van je recente importeren met de volgende informatie:

• Status
  Voltooid of onvoltooid.
• Verwerkte rijen
  Percentage van het totaal aantal verwerkte rijen tot nu toe.
• datum importeren
  Datum van importeren.
• Geïmporteerd door
  Gebruiker die gegevens heeft geïmporteerd.

Gegevens exporteren naar je magazijn  

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

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

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

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

gegevens objecten 

In het gedeelte gegevensobjecten kun je ervoor kiezen om alle profielgegevens te synchroniseren, alleen specifieke gebeurtenisgegevens, of beide soorten gegevens door het/de betreffende vakje(s) naast elke optie aan te vinken.

Uit te sluiten integraties

In het veld uit te sluiten integraties kun je de specifieke integraties selecteren die je wilt uitsluiten in de datawarehousesynchronisatie. Dit is handig als je de gegevens van een specifieke integratie die je misschien al hebt gekoppeld aan Klaviyo ook niet wilt synchroniseren.

Selectieve synchronisatie

In het veld Selectieve synchronisatie selecteer je de specifieke gebeurtenissen die je vanuit Klaviyo naar je datawarehouse wilt synchroniseren. Standaard worden alle gebeurtenissen meegenomen. Als je specifieke gebeurtenissen instelt om met dit veld 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 het gedeelte Select how often your gegevens will sync definieert hoe vaak een synchronisatie zal plaatsvinden van Klaviyo naar je datawarehouse. 

Selecteer hoeveel historische gegevens je wilt synchroniseren 

In het gedeelte Selecteer hoeveel historische gegevens je wilt synchroniseren , kun je aangeven hoeveel historische gegevens je wilt synchroniseren van Klaviyo naar je datawarehouse tijdens de eerste verbinding. Je kunt kiezen: 

• 30 dagen 
• 90 dagen
• 1 jaar
• Altijd 

Sync beoordeling

Als je je integraties hebt aangesloten en de installatie is gelukt, krijg je een laatste scherm te zien waarin staat dat de verbinding is ingeschakeld, samen met: 

• Details van de synchronisatie die u hebt ingesteld
• Welke gegevens worden gedeeld (profielen, gebeurtenissen of beide)
• Uitgesloten integraties

Als je synchronisatie niet succesvol was, zie je in plaats daarvan de status Unable to connect, samen met opties om je verbinding opnieuw te proberen of om de informatie in je credentials aan te passen.

Zodra je je datawarehouse met succes hebt verbonden, kom je terug op de hoofdpagina van de synchronisatielijst. Hier zie je je:

• Magazijn Bestemming 
• De inschakelstatus
• Eventuele fouten die in de afgelopen 24 uur met uw synchronisatie zijn opgetreden
• De laatste synchronisatie die heeft plaatsgevonden, samen met een tijdstempel van deze gebeurtenis

Aangezien u slechts 1 bestemming kunt verbinden, ziet u slechts 1 bestemming in deze lijstweergave.

gegevens synchroniseren dashboard

Zodra je verbinding is gemaakt, klik je op je integraties op de pagina Gegevens synchroniseren lijst. Van hieruit kom je bij de gegevenssynchronisatie dashboard met historische en actuele informatie over de gegevens die zijn gesynchroniseerd.

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

• Historisch
• Periodiek

Historisch 

Het tabblad Historisch heeft logboeken die de status van je historische gegevenssynchronisaties weergeven. 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 synchronisatie: 

• Naam
  De gegevens worden meegenomen in de synchronisatie.
• Status
  Status en mogelijke voortgang van de synchronisatie met een geschat percentage of mogelijke fouten. Deze statussen kunnen zijn:
  
  
  • Voltooid
    Je gegevens zijn gesynchroniseerd voor deze eenmalige synchronisatie. Het zal niet automatisch opnieuw synchroniseren.
  • Gepland
    Wanneer de volgende synchronisatie is gepland om automatisch te worden uitgevoerd.
  • In uitvoering
    gegevens worden actief gesynchroniseerd met je datawarehouse met een geschat percentage van voltooiing.
  • Fout
    Er is een fout opgetreden, maar Klaviyo blijft proberen de verbinding te herstellen. Afhankelijk van de integraties kan deze timing enigszins verschillen.
  • Mislukt
    De synchronisatie is volledig mislukt, zelfs nadat is geprobeerd de verbinding te herstellen. Dit betekent dat je je configuratie-instellingen of zelfs de opzet van je datawarehouse moet herzien.
  • Gepauzeerd
    Je hebt de synchronisatie handmatig gepauzeerd.
  • uitschakelen
    De synchronisatie werd uitgeschakeld omdat de integraties zelf werden uitgeschakeld of verwijderd.
• Gestart op
  Begintijd van de synchronisatie.
• Eindigde op
  Eindtijd van de synchronisatie.

Periodiek

Het tabblad Periodiek heeft logboeken die de status van je periodieke synchronisaties weergeven. Wanneer klanten blijven interageren met je merk en er nieuwe gegevens worden aangemaakt, worden deze routinematig naar je datawarehouse gestuurd. Bij het opzetten van een datawarehouse verbinding zullen periodieke synchronisaties elk uur plaatsvinden. 

Je ziet de volgende informatie voor elke synchronisatie: 

• Naam
  De gegevens worden meegenomen in de synchronisatie.
• Status
  Status en mogelijke voortgang van de synchronisatie met een geschat percentage of mogelijke fouten. Deze statussen kunnen zijn:
  
  
  • Voltooid
    Je gegevens zijn gesynchroniseerd voor deze eenmalige synchronisatie. Het zal niet automatisch opnieuw synchroniseren.
  • Gepland
    Wanneer de volgende synchronisatie is gepland om automatisch te worden uitgevoerd.
  • In uitvoering
    gegevens worden actief gesynchroniseerd met je datawarehouse met een geschat percentage van voltooiing.
  • Fout
    Er is een fout opgetreden, maar Klaviyo blijft proberen de verbinding te herstellen. Afhankelijk van de integraties kan deze timing enigszins verschillen.
  • Mislukt
    De synchronisatie is volledig mislukt, zelfs nadat is geprobeerd de verbinding te herstellen. Dit betekent dat je je configuratie-instellingen of zelfs de opzet van je datawarehouse moet herzien.
  • Gepauzeerd
    Je hebt de synchronisatie handmatig gepauzeerd.
  • uitschakelen
    De synchronisatie werd uitgeschakeld omdat de integraties zelf werden uitgeschakeld of verwijderd.
• gegevensversheid
  Versheid van gegevens verwijst naar hoe actueel je gegevens zijn. Als een sync bijvoorbeeld een versheid van 2 minuten heeft, betekent dit dat alle nieuwe gegevens die in de afgelopen 2 minuten in Klaviyo zijn aangemaakt nog niet in je datawarehouse staan. 
• Knoppen om individuele synchronisaties te pauzeren, te hervatten en te re-inschakelen.

Verbindingen met datawarehouse verwijderen 

Om een datawarehouse-verbinding uit uw Klaviyo-account te verwijderen, selecteert u het tabblad Integraties.

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

Foutlogboeken bekijken 

Als je problemen ondervindt met het synchroniseren van gegevens tussen Klaviyo en je datawarehouse, kan het bekijken van de bijbehorende foutlogs extra informatie geven over de oorzaak van het probleem. 

Om fouten te bekijken, klik je in je magazijnbestemming op de Synchronisatiepagina. Op de tabbladen Historische en Periodieke synchronisatie zie je een overzicht van de exports en hun status, samen met een indicator die aangeeft of er actieve fouten zijn.

Om meer details over een bepaalde fout te bekijken, klik je in de export die de fout ondervindt. 

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 lade geopend met de volgende informatie:

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

Extra hulpbronnen 

Begrijpen hoe informatie wordt uitgewisseld tussen Klaviyo en apps

Inzicht in de soorten informatie die worden uitgewisseld tussen Klaviyo en apps