Klaviyo-data exporteren naar Databricks
Advanced Klaviyo Data Platform is niet inbegrepen in Klaviyo's standaard marketingtoepassing en je hebt een abonnement nodig om toegang te krijgen tot de bijbehorende functionaliteit. Ga naar onze factureringsgids om te lezen hoe je dit abonnement kunt aanschaffen.
Wat je leert
Ontdek hoe je Databricks instelt als outbound sync-bestemming, zodat Klaviyo continu je profiel-, event- en meetwaardedata naar Delta-tabellen in je eigen Databricks-workspace schrijft. Zodra alles is gekoppeld, kan je datateam Klaviyo-data samenvoegen met de rest van je lakehouse voor analyse, modellering en rapportage.
Wil je in plaats daarvan data naar Klaviyo halen vanuit Databricks? Bekijk Klaviyo en Databricks verbinden.
Voordat je van start gaat
Zorg dat je het volgende hebt:
- Een Databricks-workspace met Unity Catalog ingeschakeld. Workspaces die alleen Hive-metastore gebruiken, worden niet ondersteund. Als je Hive-metastore gebruikt, overweeg dan federatie voor Hive-metastore.
- Een SQL-warehouse dat
VARIANTkolommen en tijdelijke tabellen met sessiebereik ondersteunt, zodat Klaviyo data kan schrijven. Serverless SQL-warehouses worden aanbevolen; Classic- en Pro-warehouses kunnen er enkele minuten over doen om te starten, wat synchronisaties kan vertragen. - Toestemming om schema's, tabellen en machtigingen te maken in de catalogus die je gaat gebruiken (of hulp van een Databricks-beheerder).
- Toestemming om integraties te beheren in Klaviyo.
- Klaviyo's uitgaande IP-adressen toegestaan, als je workspace inkomend verkeer beperkt met IP-toegangslijsten:
184.72.183.187/3252.206.71.52/323.227.146.32/3244.198.39.11/3235.172.58.121/323.228.37.244/3254.88.219.8/323.214.211.176/32
Je kunt per Klaviyo-account maar 1 exportbestemming voor datawarehouses hebben. Als je al exporteert naar een ander datawarehouse (bijvoorbeeld Snowflake of S3), moet je die bestemming verwijderen voordat je Databricks toevoegt.
Stap 1: maak een schema voor Klaviyo-gegevens
In Databricks bevinden schema's zich in een catalogus. Maak een apart schema om de tabellen in op te slaan waar Klaviyo naartoe schrijft. De SQL-voorbeelden in dit artikel gebruiken main als de catalogus en KLAVIYO_EXPORT als het schema. Als je andere namen gebruikt, vervang ze dan in alle SQL-voorbeelden en vul tijdens stap 5 in Klaviyo dezelfde namen in.
USE CATALOG main; -- or your organization's designated catalog
CREATE SCHEMA IF NOT EXISTS KLAVIYO_EXPORT;Stap 2: maak de doeltabellen
Voer het volgende script uit in het schema dat je in stap 1 hebt gemaakt. Klaviyo schrijft naar 3 tabellen:
klaviyo_profile: Eén rij per profiel, inclusief standaardvelden, locatie en aangepaste eigenschappen.klaviyo_event: Eén rij per event (bijvoorbeeld Placed Order of Opened Email), gekoppeld aan een profiel en meetwaarde.klaviyo_metric: Één rij per meetwaarde, gebruikt om de meetwaardenaam en bronintegratie voor elke gebeurtenis op te zoeken.
Aangepaste profieleigenschappen en eventeigenschappen worden opgeslagen in VARIANT -kolommen, zodat je geneste JSON rechtstreeks kunt opvragen zonder honderden afzonderlijke kolommen te beheren.
USE SCHEMA main.KLAVIYO_EXPORT;
CREATE TABLE klaviyo_profile (
id STRING NOT NULL,
external_id STRING,
email STRING,
phone_number STRING,
first_name STRING,
last_name STRING,
title STRING,
organization STRING,
properties VARIANT,
image STRING,
created TIMESTAMP,
updated TIMESTAMP,
location_address1 STRING,
location_address2 STRING,
location_city STRING,
location_country STRING,
location_latitude STRING,
location_longitude STRING,
location_region STRING,
location_zip STRING,
PRIMARY KEY (id)
)
TBLPROPERTIES ('delta.feature.variantType-preview' = 'supported');
CREATE TABLE klaviyo_event (
id STRING NOT NULL,
metric_id STRING NOT NULL,
profile_id STRING,
event_properties VARIANT,
datetime TIMESTAMP,
uuid STRING,
PRIMARY KEY (id)
)
TBLPROPERTIES ('delta.feature.variantType-preview' = 'supported');
CREATE TABLE klaviyo_metric (
id STRING NOT NULL,
name STRING NOT NULL,
integration_id STRING,
integration_name STRING,
integration_category STRING,
created TIMESTAMP,
updated TIMESTAMP,
PRIMARY KEY (id)
);Tabelnamen moeten exact overeenkomen. Klaviyo zoekt naar klaviyo_profile, klaviyo_event en klaviyo_metric in het schema dat je tijdens de configuratie opgeeft.
Stap 3: Maak een service principal en toegangstoken aan
Klaviyo verifieert bij Databricks met een personal access token (PAT). We raden aan om een toegewezen serviceprincipal te maken die alleen voor deze integratie wordt gebruikt, in plaats van een persoonlijk account.
- Maak een service principal (of een workspace-gebruiker) aan voor Klaviyo.
- Genereer een persoonlijk toegangstoken:
- Service principal: Vraag een workspacebeheerder om het eerste token te maken met de Databricks CLI.
- Workspacegebruiker: Maak een token aan in de Databricks-UI.
- Sla het token ergens veilig op. Je plakt het in Stap 5 in Klaviyo.
Behandel het toegangstoken als een wachtwoord. Iedereen met het token kan Databricks openen met de rechten van het gekoppelde account. Roteer het regelmatig en na personeelswisselingen.
Als je al een serviceprincipal hebt gemaakt voor importeren vanuit Databricks, kun je die opnieuw gebruiken. Voeg dan alleen de exportmachtigingen toe in stap 4.
Stap 4: machtigingen verlenen
Geef de Klaviyo-serviceprincipal toegang tot de catalogus, het schema en het SQL-warehouse. Vervang klaviyo_service_user door de toepassings-ID of gebruikersnaam van je serviceprincipal.
GRANT USE CATALOG ON CATALOG main TO `klaviyo_service_user`;
GRANT USE SCHEMA, SELECT, MODIFY ON SCHEMA main.KLAVIYO_EXPORT TO `klaviyo_service_user`;Machtiging | Doel |
|---|---|
| Hiermee kan Klaviyo toegang krijgen tot de catalogus die je exportschema bevat. |
| Hiermee krijgt Klaviyo toegang tot het exportschema. |
| Hiermee kan Klaviyo bestaande rijen lezen, zodat het records kan updaten in plaats van ze te dupliceren. |
| Hiermee kan Klaviyo rijen invoegen, bijwerken en verwijderen in de doeltabellen. |
Geef de service principal ook de machtiging Can use op het SQL-warehouse dat je wilt gebruiken. Ga in Databricks naar SQL Warehouses, selecteer je warehouse, klik op Permissions en voeg de service principal toe.
Controleer je configuratie (optioneel)
Bevestig met dezelfde identiteit en hetzelfde token die je aan Klaviyo geeft de tabellen en rechten:
SHOW TABLES IN main.KLAVIYO_EXPORT;
SHOW GRANTS ON SCHEMA main.KLAVIYO_EXPORT;Je zou alle 3 tabellen moeten zien en de serviceprincipal moet worden vermeld met USE SCHEMA, SELECT en MODIFY.
Stap 5: Koppel Databricks in Klaviyo
- Navigeer in Klaviyo naar Geavanceerd > Gegevensbeheer > Synchroniseren.
- Als je al een sync hebt, klik je op Sync maken.
- Selecteer Gegevens exporteren naar je datawarehouse.
- Kies Databricks en klik vervolgens op Verbinden met Databricks.
- Voer je verbindingsgegevens in:
Veld | Beschrijving | Waar je het vindt |
|---|---|---|
Naam | Een naam waaraan je deze verbinding herkent | Voer een beschrijvende naam in, zoals Klaviyo-export. |
Hostnaam van server | De host van je Databricks-workspace. | De adresbalk van je browser wanneer je bent ingelogd bij Databricks. Voorbeeld: |
HTTP-pad | Het HTTP-pad van het SQL-warehouse dat Klaviyo zal gebruiken. | SQL Warehouses > selecteer je warehouse > Verbindingsinformatie. Voorbeeld: |
Catalogus | De catalogus die je exportschema bevat. | De catalogus die je hebt gebruikt in stap 1 (bijvoorbeeld |
Schema | Het schema dat de 3 Klaviyo-tabellen bevat. | Het schema dat je in stap 1 hebt gemaakt (bijvoorbeeld |
Toegangstoken | Het persoonlijke toegangstoken voor de service principal of werkruimtegebruiker die je hebt gemaakt. | Het token dat je in stap 3 hebt gegenereerd. |
Klik op Volgende om je synchronisatie te configureren.
Je kunt Databricks ook vinden in de marktplaats voor apps van Klaviyo door naar Integraties > Apps verkennen te gaan en te zoeken naar Databricks.
Stap 6: configureer je gegevenssynchronisatie
Kies wat Klaviyo naar Databricks stuurt en wanneer het synchroniseert.
Gegevensobjecten
Kies of je profielen, gebeurtenissen of beide wilt synchroniseren. Meetwaardedata wordt samen met gebeurtenissen gesynchroniseerd, zodat je voor elke gebeurtenis de naam en bron van de meetwaarde kunt opzoeken.
Als je alle gegevens uit Klaviyo synchroniseert, kunnen je Databricks-compute- en opslagkosten stijgen.
Uit te sluiten integraties
Selecteer alle integraties waarvan je de gebeurtenissen niet naar Databricks wilt laten verzenden. Dit geldt alleen voor gebeurtenisgegevens; het sluit profielen niet uit.
Selectieve synchronisatie
Selecteer de meetwaarden waarvan je de events wilt synchroniseren, zoals Placed Order. Laat Selective sync leeg om alle events te synchroniseren uit integraties die je niet hebt uitgesloten. Dit veld verschijnt alleen als je het Events -dataobject selecteert.
Synchronisatiefrequentie
Onder Elke kies je hoe vaak je nieuwe en bijgewerkte gegevens wilt synchroniseren: elke 1, 2, 4, 6, 12 of 24 uur. De standaardinstelling is 1 uur. Stel startdatum, starttijd en tijdzone in voor het schema.
Historische gegevens
Kies hoeveel historische gegevens je tijdens de eerste synchronisatie wilt verzenden:
- 30 dagen
- 90 dagen
- 1 jaar
- Sinds het begin
Grote historische synchronisaties kunnen even duren en kunnen je Databricks-kosten verhogen. Overweeg om te beginnen met een kortere periode als je alleen recente gegevens nodig hebt.
Stap 7: Controleer, verbind en houd je synchronisatie in de gaten
- Klik op Volgende om Controleren te openen. Controleer je verbindingsgegevens, gedeelde gegevens, uitgesloten integraties, geselecteerde meetwaarden en het bereik voor de eerste gegevenssynchronisatie.
- Klik op Verbinden. Klaviyo test de verbinding en maakt de export aan als de test slaagt.
Als de installatie is gelukt, toont Klaviyo een bevestigingsbericht en ga je terug naar Synchroniseren. Je export is ingeschakeld en je kunt daar de synchronisatiestatus volgen.
Als de verbindingstest mislukt, bekijk je de foutdetails. Klik op Inloggegevens bewerken om je verbindingsgegevens te corrigeren. Klik daarna in de gegevensinstellingen op Volgende om terug te gaan naar Controleren en klik opnieuw op Verbinden.
Ga naar Geavanceerd > Databeheer > Synchroniseren om je synchronisatie te monitoren en klik op Databricks in de rij met de markering Exporteren. Gebruik deze tabbladen:
- Historisch: De status van je eerste backfill.
- Periodiek: De status van synchronisaties op je geselecteerde cadans, inclusief gegevensactualiteit (hoe ver je Databricks-tabellen achterlopen op Klaviyo).
- Instellingen: Bekijk en bewerk je verbindingsgegevens, dataselectie, synchronisatiefrequentie en historisch bereik. Klik op Gegevens bijwerken in de sectie die je wijzigt om op te slaan.
Zie Datawarehouse-synchronisatie in Klaviyo begrijpen voor meer informatie over synchronisatiestatussen, het pauzeren en hervatten van synchronisaties en het bekijken van foutenlogboeken.
Je Klaviyo-data opvragen in Databricks
Hier zijn een paar voorbeelden om mee te beginnen.
Tel events op meetwaardenaam in de afgelopen 7 dagen:
SELECT m.name AS metric, COUNT(*) AS events
FROM main.KLAVIYO_EXPORT.klaviyo_event e
JOIN main.KLAVIYO_EXPORT.klaviyo_metric m ON e.metric_id = m.id
WHERE e.datetime >= current_timestamp() - INTERVAL 7 DAYS
GROUP BY m.name
ORDER BY events DESC;Lees een aangepaste profieleigenschap uit de properties variatie-kolom:
SELECT id, email, properties:loyalty_tier::STRING AS loyalty_tier
FROM main.KLAVIYO_EXPORT.klaviyo_profile
WHERE properties:loyalty_tier IS NOT NULL;Haal de bestelwaarde op uit Placed Order-gebeurtenissen:
SELECT e.profile_id, e.datetime, e.event_properties:`$value`::DOUBLE AS order_value
FROM main.KLAVIYO_EXPORT.klaviyo_event e
JOIN main.KLAVIYO_EXPORT.klaviyo_metric m ON e.metric_id = m.id
WHERE m.name = 'Placed Order';Probleemoplossing
Probleem | Wat je moet controleren |
|---|---|
Verbindingstest mislukt met een verificatiefout | Controleer of de hostnaam geen |
Verbindingstest mislukt met een machtigingsfout | Bevestig de verleningen in stap 4, waaronder |
Klaviyo kan de doeltabellen niet vinden | Controleer of de catalogus en het schema in Klaviyo overeenkomen met waar je het script van stap 2 hebt uitgevoerd, en dat de tabelnamen exact |
Fouten over het type | Controleer of je SQL-warehouse een Databricks SQL-versie draait die |
Synchronisaties starten langzaam | Classic- en Pro-SQL-warehouses kunnen een paar minuten nodig hebben om te starten. Gebruik een serverless SQL-warehouse of verleng de automatische stop-tijd van het warehouse. |
Verzoeken zijn geblokkeerd | Als je workspace IP-toegangslijsten gebruikt, zet je de Klaviyo IP-adressen uit Voordat je begint op de positieve lijst. |
Een Databricks-export verwijderen
Als je de export verwijdert, worden toekomstige synchronisaties stopgezet. Gegevens die al naar je Databricks-tabellen zijn geschreven, worden niet verwijderd.
- Ga naar integraties in Klaviyo.
- Open het menu naast de Databricks-exportintegratie en selecteer Integratie verwijderen.
- Klik in het bevestigingsvenster op Integratie verwijderen.