Förstå datalager händelseimport i Klaviyo

Du kommer att lära dig

Lär dig hur du använder datalager event import för att synkronisera händelsedata från ditt lager till Klaviyo, så att du kan driva segment, flöde och rapportering med beteende som har sitt ursprung utanför Klaviyos inbyggda integrationer (t.ex. POS-system, supportplattformar eller anpassade applikationer).

Vad är datalager händelseimport?

datalager event import låter Klaviyo ansluta direkt till din datalager och konfigurera importsynkroniseringar från lagertabeller eller vyer som innehåller händelsedata.

Varje rad i din källtabell behandlas som en enskild händelse i Klaviyo:

• Radens tidsstämplar, mättalnamn och identifierare definierar vad som hände, när och för vem.
• Ytterligare kolumner blir händelseegenskaper som du kan använda för segmentering, flöde och analys.

Event import bygger på samma import av datalager-infrastruktur som profil import, men riktar sig till Klaviyo:s pipeline för händelseinmatning istället för profil.

Hur fungerar import av datalagerhändelser?

När du har anslutit Klaviyo till ditt lager och konfigurerat en händelsesynkronisering:

1. Klaviyo frågar ditt lager efter den konfigurerade tabellen eller vyn.
2. Vid varje körning läser Klaviyo endast rader vars tidsstämpel för ändringsdetektering är nyare än den senaste lyckade synkroniseringen. Detta möjliggör stegvis import utan att hela tabellen behöver bearbetas på nytt.
3. Varje rad behandlas sedan på följande sätt:
   • Klaviyo bestämmer mättal-namnet (händelsetyp) baserat på alternativ som valts under synkroniseringsinställningen: antingen en enda vald mättal eller dynamiskt baserat på värdet i en angiven mättal-namnkolumn i källtabellen.
   • Händelsens tidsstämpel, profilidentifierare och valfritt unikt ID, värde och värdevaluta ställs in baserat på fältmappningar som konfigureras under synkroniseringsinställningen.
   • Alla återstående kolumner tas in som händelseegenskaper, med kolumnnamnen som egenskapsnamn. Kolumnnamn med tre understreck (t.ex. parent___child1, parent___child2) kan användas för att skapa en händelseegenskap (parent) med underordnade egenskaper.
4. Klaviyo laddar de resulterande händelserna till ditt Konto, där de beter sig som andra anpassade API mättal i segmentering, flöde och analys.

Importer körs på en återkommande kadens (t.ex. varje timme), så nya eller uppdaterade rader i ditt lager översätts regelbundet till händelser i Klaviyo.

Innan du börjar

Se till att följande krav är uppfyllda innan du skapar en synkronisering av händelseimport:

• Ditt Konto har tillgång till Advanced Klaviyo Data Platform och import av datalager.
• Du har skapat och validerat en datalageranslutning i Klaviyo. Se supportcenterartiklarna för din datalager för mer information om vilka konto och scheman som krävs för tjänsten.
• Din källtabell eller källvy innehåller de obligatoriska kolumnerna nedan.
• Du har tillräckliga behörigheter i ditt lager för att exponera de nödvändiga tabellerna/vyerna för Klaviyo:s serviceanvändare.

Struktur för källtabell för händelser

För att säkerställa att dina evenemangsdata kan importeras korrekt måste din källtabell eller vy uppfylla Klaviyo:s obligatoriska fält och struktur.

Obligatoriska fält

Följande kolumner krävs i V1 av datalager event import:

Valfria fält

Dessa fält rekommenderas när de är tillämpliga men är inte obligatoriska:

Egenskaper för händelse

Alla andra kolumner i din tabell behandlas som händelseegenskaper:

• Kolumner importeras som plattade egenskaper, där kolumnnamnet används direkt som egenskapsnamn i Klaviyo.
• Du behöver inte uttryckligen mappa varje egenskap, utan kolumner som inte mappas kommer att inkluderas som händelseegenskaper.
• Nested JSON kan lagras inuti ett enskilt egenskapsvärde om det behövs (t.ex. ett JSON-objekt med radposter), men själva egenskapsbeteckningen kommer från en kolumn på högsta nivån.

Klaviyo utför bästa möjliga typanalys för händelseegenskaper och tillhandahåller inte transformationslogik per fält som en del av inställningen för händelseimport.

Vanliga användningsfall

Kunderna använder vanligtvis datalager event import för:

1) Importera offline- eller POS-händelser

Ta in händelser i butiken eller offline (t.ex. POS-köp, returer eller möten) från ditt lager så att de beter sig som andra Klaviyo händelser och mättal.

Exempel på detta:

• Händelser med köp i butik med ordertotal, butiksläge och anbudstyp
• Tidsbeställning Avslutade händelser med personal, typ av tjänst och varaktighet

2) Service och supportinteraktioner

Synkronisera support- och servicehändelser som skapande av ärende, lösning eller retur för att berika kundernas tidslinjer och förbättra meddelanden baserat på servicehistorik.

Exempel på detta:

• Supportärende skapat och supportärende löst
• Order Returned med orsakskoder och återbetalningsbelopp

3) Modellerade eller härledda händelser

Konvertera beteenden som modellerats i lagret till händelser som är enklare att använda i Klaviyo.

Exempel på detta:

• Hög kundbortfall Riskhändelser som genereras från en modell i ditt lager
• Milstolpe uppnådd i livscykeln Händelser när en kund flyttar steg i en anpassad livscykelmodell

Ställ in en synkronisering av import av datalagerhändelser

1) Anslut ditt datalager

Om du ännu inte har anslutit ditt lager:

1. På Klaviyo går du till Advanced Klaviyo Data Platform > Data management > Syncing.
2. Klicka på Add datalager och välj din warehouse connector.
3. Slutför anslutningsstegen för din plattform genom att följa den tillämpliga anslutningsguiden som länkas från artikeln om översikt över import av datalager.

Klaviyo stöder en Aktiv datalager-anslutning per Konto.

2) Skapa en ny synkronisering av importerad händelse

När din lagerlokal är ansluten:

1. Från Advanced Klaviyo Data Platform > Data management > Syncing väljer du din lageranslutning.
2. Välj Importera data (om du konfigurerar import för första gången) eller klicka på Skapa synkronisering / Lägg till synkronisering för en befintlig anslutning.
3. När du uppmanas att ange datatyp väljer du Events (i stället för profil).
4. Välj den tabell eller vy i ditt lager som innehåller de händelser du vill importera.

3) Kartlägg obligatoriska fält

Därefter ska du mappa kolumner från din lagertabell till Klaviyo:s obligatoriska händelsefält.

Konfigurationen av händelseimporten kräver att du tillhandahåller mappningar för:

• Händelsens tidsstämpel
• mättal-namn (antingen en konstant som du väljer i konfigurationen eller en kolumn som innehåller mättal-namnet per rad)
• profilidentifierare (minst en)
• Tidsstämpel för upptäckt av ändring

Du kan också mappa rekommenderade fält:

• Unique ID
• Värde
• Värde valuta

Alla återstående kolumner som du inte uttryckligen mappar till dessa kärnfält blir automatiskt händelseegenskaper.

Konfigurationsgränssnittet hindrar dig från att mappa flera kolumner till samma fält på högsta nivån och validerar att alla obligatoriska fält finns innan du kan spara.

4) Välj synkroniseringsfrekvens och historisk omfattning

När du sparar din evenemangsimport:

• Klaviyo schemalägger återkommande synkroniseringar för att köras med en regelbunden kadens (vanligtvis varje timme).
• Vid varje körning bearbetas endast rader vars tidsstämpel för ändringsdetektering är nyare än den senaste lyckade körningen, vilket säkerställer att importen är inkrementell.

För historisk återfyllning kan du antingen:

• Rikta din händelseimport mot en tabell eller vy som redan innehåller alla relevanta historiska händelser, eller
• Börja med en särskild historisk tabell och byt sedan till en vy som stöds av förändringsdata för löpande uppdateringar.

Hur importerade händelser beter sig i Klaviyo

När den är importerad:

• Varje rad visas som en händelse i en anpassad API mättal i Klaviyo.
• Det mättal-namn som du har mappat (eller konfigurerat som en konstant) bestämmer det händelsetypnamn som du ser i produkten (t.ex. Placed Order).
• Alla profilidentifierare kopplas till befintliga profiler där så är möjligt, annars skapar Klaviyo en ny profil med hjälp av de identifieringsfält som anges, på samma sätt som andra sökvägar för händelseinmatning.

Du kan använda dessa händelser för att:

• Skapa segment baserat på vad någon har gjort och filtrera på händelseegenskaper.
• utlösare och filter flöde.
• Analysera beteende i mättal och rapportering tillsammans med händelser från andra källor.

Begränsningar och bästa praxis

Tänk på följande när du använder datalager-händelseimport:

• V1 av evenemangsimport fokuserar endast på evenemangsdata. uppdateringar av profilegenskaper som härrör från händelser kan läggas till i en senare iteration; för närvarande bör profilegenskaper uppdateras via profilimport eller andra vägar som stöds.
• Tidsstämpeln för ändringsdetekteringen måste skilja sig från händelsens tidsstämpel. Om du använder samma kolumn för båda kan du förhindra att du importerar historiska händelser på ett säkert sätt efter den första synkroniseringen.
• För optimal hastighet bör du ställa in fältet för ändringsdetektering till tidsstämpeln för när den nya tabellen skapas. Poster staplas i synkroniserade cykler med hjälp av detta värde, så tiden för att importera historiska poster kan minskas om alla historiska poster har en tidsstämpel för ändringsdetektering inom ett smalt intervall (t.ex. tidsstämpeln för ett jobb som skapar den nya tabellen).
• Använd ett stabilt unikt ID per händelse där så är möjligt för att förbättra dedupliceringen och underlätta felsökning nedströms.
• Om din tabell innehåller flera händelsetyper (mättal) med olika uppsättningar kolumner är det i allmänhet bra att hålla ihop dem: kolumner som är NULL för vissa rader ignoreras helt enkelt för dessa händelser i Klaviyo.
• För komplexa nästlade objekt (t.ex. matriser med rader av artiklar) rekommenderar vi att du plattar ut dem i flera kolumner om det är möjligt, särskilt för egenskaper som du förväntar dig att använda i segmentering eller flöde.

```