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 VARIANT kolommen 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/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

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.

sql
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.

sql
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.

  1. Maak een service principal (of een workspace-gebruiker) aan voor Klaviyo.
  2. Genereer een persoonlijk toegangstoken:
  3. 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.

sql
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

USE CATALOG

Hiermee kan Klaviyo toegang krijgen tot de catalogus die je exportschema bevat.

USE SCHEMA

Hiermee krijgt Klaviyo toegang tot het exportschema.

SELECT

Hiermee kan Klaviyo bestaande rijen lezen, zodat het records kan updaten in plaats van ze te dupliceren.

MODIFY

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:

sql
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

  1. Navigeer in Klaviyo naar Geavanceerd > Gegevensbeheer > Synchroniseren.
  2. Als je al een sync hebt, klik je op Sync maken.
  3. Selecteer Gegevens exporteren naar je datawarehouse.
  4. Kies Databricks en klik vervolgens op Verbinden met Databricks.
  5. 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: abc-12345678.cloud.databricks.com

HTTP-pad

Het HTTP-pad van het SQL-warehouse dat Klaviyo zal gebruiken.

SQL Warehouses > selecteer je warehouse > Verbindingsinformatie. Voorbeeld: /sql/1.0/warehouses/1234abcd5678efgh

Catalogus

De catalogus die je exportschema bevat.

De catalogus die je hebt gebruikt in stap 1 (bijvoorbeeld main).

Schema

Het schema dat de 3 Klaviyo-tabellen bevat.

Het schema dat je in stap 1 hebt gemaakt (bijvoorbeeld KLAVIYO_EXPORT).

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

  1. Klik op Volgende om Controleren te openen. Controleer je verbindingsgegevens, gedeelde gegevens, uitgesloten integraties, geselecteerde meetwaarden en het bereik voor de eerste gegevenssynchronisatie.
  2. 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:

sql
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:

sql
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:

sql
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 https:// -prefix of afsluitende slash heeft en of het toegangstoken geldig is en niet is verlopen.

Verbindingstest mislukt met een machtigingsfout

Bevestig de verleningen in stap 4, waaronder USE CATALOG en Kan gebruiken op het SQL-warehouse.

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 klaviyo_profile, klaviyo_event en klaviyo_metric zijn.

Fouten over het type VARIANT

Controleer of je SQL-warehouse een Databricks SQL-versie draait die VARIANT ondersteunt en of de tabellen zijn gemaakt met de TBLPROPERTIES die in stap 2 wordt getoond.

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.

  1. Ga naar integraties in Klaviyo.
  2. Open het menu naast de Databricks-exportintegratie en selecteer Integratie verwijderen.
  3. Klik in het bevestigingsvenster op Integratie verwijderen.

Extra hulpbronnen

Was dit artikel nuttig?
Gebruik dit formulier alleen voor feedback op artikelen. Meer informatie over hoe je contact opneemt met support.

Ontdek meer van Klaviyo

Community
Maak contact met collega's, partners en Klaviyo-experts om inspiratie op te doen, inzichten te delen en antwoorden te krijgen op al je vragen.
Partners
Huur een Klaviyo-gecertificeerde expert in om je te helpen met een specifieke taak of voor doorlopend marketingbeheer.
Support

Krijg ondersteuning via je account.

E-mailsupport (gratis proefperiodes en betaalde accounts) 24/7 beschikbaar

Chat-/virtuele assistentie
Beschikbaarheid varieert per locatie en type abonnement