Inzicht in het importeren van datawarehousegebeurtenissen in Klaviyo

Wat je leert

Leer hoe je datawarehouse-gebeurtenisimport kunt gebruiken om gebeurtenisgegevens uit je magazijn te synchroniseren met Klaviyo, zodat je segmenten, flow en rapportage kunt aandrijven met gedrag dat afkomstig is van buiten Klaviyo's native integraties (bijv. kassasystemen, ondersteuningsplatforms of aangepaste toepassingen).

Wat is datawarehouse-gebeurtenis importeren?

Met datawarehouse-gebeurtenisimport kan Klaviyo direct verbinding maken met je datawarehouse en importsynchronisaties configureren van magazijntabellen of weergaven die gebeurtenisgegevens bevatten.

Elke rij in je brontabel wordt in Klaviyo als een enkele gebeurtenis behandeld:

• De tijdstempels van de rijen, de naam van de meetwaarde en de identifiers bepalen wat er gebeurd is, wanneer en voor wie.
• Extra kolommen worden gebeurteniseigenschappen die je kunt gebruiken in segmentatie, flow en analytics.

Event import is gebouwd op dezelfde import uit datawarehouse infrastructuur als profiel import, maar richt zich op Klaviyo's event ingestion pipeline in plaats van profiel.

Hoe werkt het importeren van datawarehouse gebeurtenissen?

Nadat je Klaviyo met je magazijn hebt verbonden en een gebeurtenissynchronisatie hebt geconfigureerd:

1. Klaviyo bevraagt je magazijn voor de geconfigureerde tabel of weergave.
2. Bij elke run leest Klaviyo alleen rijen waarvan de change detection timestamp nieuwer is dan de laatste succesvolle synchronisatie. Dit maakt incrementele import mogelijk zonder de hele tabel opnieuw te verwerken.
3. Elke rij wordt dan als volgt verwerkt:
   • Klaviyo bepaalt de meetwaarde naam (type gebeurtenis) op basis van de opties die zijn geselecteerd tijdens het instellen van de synchronisatie: een enkele gekozen meetwaarde of dynamisch op basis van de waarde van een aangewezen meetwaarde naam kolom in de brontabel.
   • Gebeurtenis tijdstempel, profiel identifiers en optionele unieke ID, waarde en waarde valuta worden ingesteld op basis van veldkoppelingen geconfigureerd tijdens het instellen van de synchronisatie.
   • Alle overige kolommen worden opgenomen als eigenschappen van gebeurtenissen, waarbij de kolomnamen als namen voor de eigenschappen worden gebruikt. Kolomnamen met drie underscores (bijvoorbeeld parent___child1, parent___child2) kunnen worden gebruikt om een event eigenschap(parent) met child eigenschappen te maken.
4. Klaviyo laadt de resulterende gebeurtenissen in je account, waar ze zich gedragen als andere aangepaste API meetwaarde in segmentatie, flow en analytics.

Importeren gebeurt op een terugkerend ritme (bijvoorbeeld elk uur), zodat nieuwe of bijgewerkte rijen in je magazijn regelmatig worden vertaald naar gebeurtenissen in Klaviyo.

Voordat je van start gaat

Zorg ervoor dat aan de volgende vereisten is voldaan voordat je een gebeurtenis import sync aanmaakt:

• Je account heeft toegang tot het Advanced Klaviyo Data Platform en import uit datawarehouse.
• Je hebt een datawarehouseverbinding gemaakt en gevalideerd in Klaviyo. Raadpleeg de artikelen in het ondersteuningscentrum voor je datawarehouse voor meer informatie over de vereiste service account en schema's.
• Je brontabel of -weergave bevat de vereiste kolommen hieronder.
• Je hebt voldoende privileges in je magazijn om de nodige tabellen/views bloot te stellen aan de servicegebruiker van Klaviyo.

Bron tabelstructuur voor gebeurtenissen

Om ervoor te zorgen dat uw evenementgegevens correct kunnen worden geïmporteerd, moet uw brontabel of weergave voldoen aan de vereiste velden en structuur van Klaviyo.

Verplichte velden

De volgende kolommen zijn vereist in V1 van datawarehouse-gebeurtenisimport:

Optionele velden

Deze velden worden aanbevolen wanneer ze van toepassing zijn, maar zijn niet strikt verplicht:

Gebeurteniseigenschappen

Alle andere kolommen in je tabel worden behandeld als eigenschappen van gebeurtenissen:

• Kolommen worden geïmporteerd als afgevlakte eigenschappen, waarbij de kolomnaam direct wordt gebruikt als de naam van de eigenschap in Klaviyo.
• Je hoeft niet elke eigenschap expliciet in kaart te brengen; niet in kaart gebrachte kolommen worden opgenomen als eigenschappen voor gebeurtenissen.
• Indien nodig kan geneste JSON worden opgeslagen in een individuele waarde van een eigenschap (bijvoorbeeld een JSON object van regelitems), maar de naam van de eigenschap zelf komt uit een kolom op het hoogste niveau.

Klaviyo voert best-effort type parsing uit voor evenementeigenschappen en biedt geen transformatie logica per veld als onderdeel van het importeren van gebeurtenissen.

Algemene gebruikssituaties

Klanten gebruiken datawarehouse-gebeurtenisimport meestal voor:

1) Offline of POS gebeurtenissen importeren

Breng in-store of offline evenementen (bijv. POS-aankopen, retouren of afspraken) uit je magazijn zodat ze zich gedragen als andere Klaviyo evenementen en meetwaarde.

Voorbeelden:

• Aankoopgebeurtenissen in de winkel met ordertotalen, winkellocatie en aanbestedingstype
• Afspraak Afgeronde gebeurtenissen met medewerker, soort dienst en duur

2) Interacties tussen service en ondersteuning

Synchroniseer ondersteunings- en servicegebeurtenissen zoals het aanmaken van een ticket, het oplossen ervan of retourzendingen om de tijdlijn van je klanten te verrijken en berichten te sturen op basis van de servicegeschiedenis.

Voorbeelden:

• Support Ticket aangemaakt en Support Ticket opgelost
• Bestelling retour met redencodes en restitutiebedragen

3) Gemodelleerde of afgeleide gebeurtenissen

Zet magazijngemodelleerd gedrag om in gebeurtenissen die gemakkelijker te gebruiken zijn in Klaviyo.

Voorbeelden:

• Hoog verloop Risicovolle gebeurtenissen gegenereerd door een model in je magazijn
• Mijlpaal bereikt-events voor levenscyclus wanneer een klant fasen in een aangepast levenscyclusmodel doorloopt

Een synchronisatie voor het importeren van datawarehousegebeurtenissen instellen

1) Sluit je datawarehouse aan

Als je je magazijn nog niet hebt aangesloten:

1. Ga in Klaviyo naar Geavanceerd Klaviyo Data Platform > Gegevensbeheer > Synchronisatie.
2. Klik op Datawarehouse toevoegen en selecteer je warehouse connector.
3. Voltooi de verbindingsstappen voor jouw platform volgens de toepasselijke verbindingsgids die gelinkt is aan het import uit datawarehouse overzichtsartikel.

Klaviyo ondersteunt één actieve datawarehouseverbinding per account.

2) Maak een nieuwe gebeurtenis import sync

Zodra je magazijn is aangesloten:

1. Selecteer in Geavanceerd Klaviyo Data Platform > Gegevensbeheer > Synchronisatie je magazijnverbinding.
2. Kies Gegevens importeren (als je de import voor de eerste keer configureert) of klik op Synchronisatie maken / Synchronisatie toevoegen voor een bestaande verbinding.
3. Kies Gebeurtenissen (in plaats van Profiel) wanneer om het gegevenstype wordt gevraagd.
4. Kies de tabel of weergave in je magazijn die de gebeurtenissen bevat die je wilt importeren.

3) Verplichte velden in kaart brengen

Vervolgens ga je kolommen uit je magazijntabel koppelen aan de vereiste gebeurtenisvelden van Klaviyo.

Voor het importeren van gebeurtenissen moet je toewijzingen opgeven voor:

• Tijdstempel gebeurtenis
• meetwaarde naam (ofwel een constante die je selecteert in de configuratie of een kolom die de meetwaarde naam per rij bevat)
• profielidentificatie (ten minste één)
• Tijdstempel voor wijzigingsdetectie

Je kunt ook aanbevolen velden in kaart brengen:

• Unique ID
• Waarde
• Waarde valuta

Alle resterende kolommen die je niet expliciet aan deze kernvelden koppelt, worden automatisch eigenschappen van gebeurtenissen.

De configuratie-UI voorkomt dat je meerdere kolommen aan hetzelfde veld op het hoogste niveau koppelt en valideert of alle verplichte velden aanwezig zijn voordat je ze kunt opslaan.

4) Kies syncadens en historisch bereik

Wanneer je de import van je evenement opslaat:

• Klaviyo plant terugkerende synchronisaties op een regelmatig ritme (meestal elk uur).
• Bij elke run worden alleen rijen verwerkt waarvan de timestamp van de veranderingsdetectie nieuwer is dan de laatste succesvolle run, zodat de import incrementeel is.

Voor historische opvulling kun je het volgende doen:

• Richt je import van gebeurtenissen op een tabel of weergave die al alle relevante historische gebeurtenissen bevat, of
• Begin met een speciale historische tabel en schakel later over naar een weergave met veranderingsgegevens voor lopende updates.

Hoe geïmporteerde gebeurtenissen zich gedragen in Klaviyo

Eenmaal geïmporteerd:

• Elke rij verschijnt als een gebeurtenis van een aangepaste API meetwaarde in Klaviyo.
• De meetwaarde-naam die je hebt toegewezen (of als constante hebt geconfigureerd) bepaalt de naam van het gebeurtenistype dat je in het product ziet (bijvoorbeeld geplaatste bestelling).
• Alle profielidentifiers worden waar mogelijk omgezet naar een bestaand profiel; anders maakt Klaviyo een nieuw profiel aan met behulp van de opgegeven identificatievelden, vergelijkbaar met andere invoerpaden voor gebeurtenissen.

Je kunt deze gebeurtenissen gebruiken om:

• Stel segmenten samen op basis van wat iemand heeft gedaan en filter op eigenschappen van gebeurtenissen.
• triggeren en filterstroom.
• Analyseer gedrag in meetwaarde en rapportage naast gebeurtenissen uit andere bronnen.

Beperkingen en best practices

Houd rekening met het volgende als je datawarehouse-gebeurtenisimport gebruikt:

• V1 van gebeurtenisimport richt zich alleen op gebeurtenisgegevens. updates van profieleigenschappen afgeleid van gebeurtenissen kunnen in een latere iteratie worden toegevoegd; voor nu moeten profieleigenschappen worden bijgewerkt via profielimport of andere ondersteunde paden.
• Het tijdstempel van de wijzigingsdetectie moet verschillen van het tijdstempel van de gebeurtenis. Door dezelfde kolom voor beide te gebruiken kun je voorkomen dat je historische gebeurtenissen veilig kunt importeren na je eerste synchronisatie.
• Voor optimale snelheid stel je het veld voor wijzigingsdetectie in op de tijdstempel van wanneer de nieuwe tabel is aangemaakt. Records worden gebundeld in synchronisatiecycli met behulp van deze waarde, dus de tijd om historische records te importeren kan worden verkort als alle historische records een tijdstempel hebben voor het detecteren van wijzigingen in een smal bereik (bijvoorbeeld het tijdstempel van een taak die de nieuwe tabel aanmaakt).
• Gebruik waar mogelijk een stabiele unieke ID per gebeurtenis om ontdubbeling te verbeteren en downstream debuggen gemakkelijker te maken.
• Als je tabel meerdere gebeurtenistypen (meetwaarde) bevat met verschillende sets kolommen, is het over het algemeen prima om ze bij elkaar te houden: kolommen die NULL zijn voor bepaalde rijen worden gewoon genegeerd voor die gebeurtenissen in Klaviyo.
• Voor complexe geneste objecten (bijv. arrays van regelitems) raden we aan om waar mogelijk af te vlakken naar meerdere kolommen, vooral voor eigenschappen die je verwacht te gebruiken in segmentatie of flow.

```