Komma igång med SQL i Composer och Klaviyo MCP-servern
Du kommer att lära dig
Lär dig hur du kan ställa analysfrågor om dina Klaviyo-data på vanlig svenska med Composer eller Klaviyos Model Context Protocol-server (MCP). Klaviyo dataplattform SQL samlar profiler, målgrupper, kampanjer, produkter och händelser för att besvara frågor som involverar flera datamängder. Du behöver inte skriva SQL.
SQL är för närvarande i beta och är tillgängligt för alla kunder.
Innan du börjar
Välj var du vill ställa dina frågor:
- Använd Composer för att arbeta i chatten i Klaviyo. Det krävs ingen ytterligare SQL-konfiguration.
- Använd Klaviyos MCP-server för att arbeta i en ansluten AI-klient, till exempel Claude eller ChatGPT. Om du redan har anslutit Klaviyo behöver du inte installera ett annat verktyg, men du kan behöva uppdatera klientens verktygslista.
Båda alternativen använder samma data och kan besvara samma typer av analysfrågor. SQL är utformat för analys. För dataexport i bulk använder du andra verktyg i Klaviyo, som till exempel anpassade rapporter.
Data ligger vanligtvis ungefär 30 minuter efter aktiviteten i ditt Konto. För en helt ny order, ett utskick eller en ändring i medlemskap, kontrollera direkt i Klaviyo.
Ställ din första analysfråga
Använd Composer
- Öppna Composer i Klaviyo. Om du behöver hjälp med att hitta den kan du läsa Komma igång med Composer.
- Ställ en analysfråga med vanligt språk. Inkludera mättalet, datumintervallet och eventuella målgrupps- eller produktuppgifter. Till exempel: ”Vilka är mina fem främsta produkter efter sålda enheter de senaste 90 dagarna?”
- Granska svaret och ställ sedan följdfrågor i samma konversation för att utforska det vidare.
Composer avgör när SQL ska användas. Du behöver inte namnge ett verktyg eller ändra en inställning.
Använd Klaviyo MCP-servern
För att ansluta en AI-klient behöver du rollen Ägare, Administratör eller Chef i det Klaviyo-konto du vill använda. När din anslutning använder en API-nyckel måste nyckeln ha åtkomst till de datauppsättningar som ingår i din fråga. Till exempel behöver en fråga om beställningar och segment åtkomst till händelser och segment.
- Anslut Klaviyo med hjälp av guiden för din klient eller konfiguration:
- Utvecklardokumentation för Klaviyo MCP-server för terminal- och fjärrserveranslutningar
- Klaviyo-appen för Claude: vanliga frågor
- Så använder du Klaviyo-appen för ChatGPT
- Guide till Klaviyos MCP-server för byråer för att arbeta med flera kundkonton
- Ställ en detaljerad analysfråga i din anslutna klient. Du behöver inte namnge verktyget ask_analytics_question. Din klient väljer det när det passar för frågan.
- Granska svaret och fortsätt med följdfrågor. Om verktyget inte är tillgängligt uppdaterar du din kunds verktygslista i Klaviyo med hjälp av felsökningsstegen nedan.
Om du ansluter via OAuth följer du din kunds guide för att granska och bevilja de begärda behörigheterna.
Bygg vidare på ett svar och kontrollera beräkningen
SQL är användbart när en fråga behöver information från flera datamängder. Till exempel blir antalet beställningar en mer detaljerad målgruppsanalys när du lägger till kunder, segmentmedlemskap och land.
Börja med en fråga och bygg sedan vidare på svaret i samma konversation:
- ”Hur många ordrar tog vi förra månaden?”
- ”Hur många kunder lade de beställningarna?”
- ”Dela upp beställningarna efter de segment som kunderna för närvarande tillhör.”
- ”Bryt ner resultaten efter segment och land och inkludera intäkter för varje grupp.”
- ”För förstagångsköpare, hur mycket produktbläddring skedde under de 10 dagarna före deras första beställning?”
Fråga hur svaret beräknades innan du delar en viktig siffra eller använder den för att fatta ett beslut. Till exempel:
- ”Vilka datamängder använde du?”
- ”Vilket datumintervall och vilka filter använde du?”
- ”Hur definierade du intäkter i den här beräkningen?”
- ”Kan du gå igenom hur du räknade ut det?”
Använd förklaringen för att kontrollera att svaret matchar den fråga du tänkte ställa. Om det inte gör det, förtydliga mättalet, datumen eller filtren och fråga igen.
Vilka uppgifter du kan fråga om
SQL kan besvara frågor om dessa datauppsättningar, beroende på behörigheterna för din anslutning.
Datauppsättning | Det du kan analysera |
|---|---|
Profiler | Kundattribut, identifierare, förutspått livstidsvärde, kanalengagemang, anpassade profilgenskaper samt samtycke för e-post och sms-marknadsföring |
Segment | Dynamiska målgrupper med medlemskap som räknas om utifrån sparade villkor; analysen använder det aktuella medlemskapet |
Listor | Målgrupper vars aktuella medlemskap du kan koppla till profiler och händelser |
Kampanjer | Engångsutskick, meddelanden, variationer inklusive A/B-tester och sändningssegment |
Katalog | Produkter synkroniserade från din e-handelsplattform, inklusive produktkategorier och variationer |
Händelser | Handel, meddelanden, samtycke, flöde, recension, kupong, support, Klaviyo Customer Hub och integrationsaktivitet, samt marknadsföringsantal och -nivåer |
Händelser och detaljer i händelser
Tillgängliga händelsedata inkluderar:
- Handelsaktivitet, till exempel att lägga till i en varukorg, lägga en beställning eller avbryta den, återbetalningar och produktvisningar
- E-postaktivitet, inklusive mottagningar, öppningar, klick, studsar, leveransfel och avslutade prenumerationer
- Sms- och WhatsApp-aktivitet, inklusive mottagningar, klick, fel, samtycke och avslutade prenumerationer
- Push-aktivitet, inklusive mottagna, öppningar och studsar
- Ändringar av samtycke och exkludering, inklusive prenumerationer, avslutade prenumerationer, tillägg eller borttagningar av exkludering och uppdateringar av preferenser
- Flödesaktivitet, inklusive inträden, borttagningar, uppfyllelse, överhoppningar och starter
- Profilsammanslagningar
- Inskickningar av omdömen och betyg, redigeringar, borttagningar och status för granskning
- Kupongtilldelningar och användningar
- Supportkonversationsaktivitet, inklusive startade konversationer, mottagna eller skickade meddelanden, eskaleringar, lösningar och att ärenden skapas eller stängs
- Aktivitet i Klaviyo Customer Hub, till exempel inloggningar, favoriter, klick på produkter eller kuponger och visningar av innehållsblock
- Integrationshändelser från källor som din API, Shopify och Lightspeed, inklusive kassarelaterad aktivitet, formulärinskick, lojalitetsregistreringar, sökningar och leveranser
- Marknadsföringsmättal, inklusive antal och frekvens för leverans, mottagare, öppningar, klick, studsar, avsluta prenumerationen, skräppostanmälningar och mänskligt engagemang
Vissa händelser innehåller nästlade värden: grupper av relaterade detaljer i en händelse. Till exempel kan en beställning innehålla en lista med artiklar, där varje artikel har en SKU, en kvantitet och ett pris. SQL kan läsa de här detaljerna, så att du kan fråga hur många beställningar som innehöll en viss SKU eller vad det genomsnittliga antalet artiklar per beställning var.
Kombinera datamängder
SQL kan koppla ihop relaterade datamängder för att besvara en fråga. Det här kallas en join, men du behöver inte begära en join uttryckligen. Det kan du till exempel göra:
- Koppla kampanjmeddelanden till kampanjnamn och engagemangsdata för att jämföra namngivna kampanjer.
- Koppla nuvarande medlemskap i listor eller segment till profiler och beställningar för att analysera en målgrupps köpaktivitet.
- Dela upp en målgrupp efter land, samtyckesstatus eller förutspått kundvärde.
- Koppla produkter till kategorier, eller variationer till överordnade produkter, för att analysera produkt- eller kategoriprestanda.
- Koppla kupongtilldelningar till kuponganvändning för att beräkna inlösen och identifiera kuponger som inte har lösts in.
Exempelfrågor
Anpassa datumen, produkterna, segmenten och kampanjinformationen efter ditt Konto.
Mål | Exempelfråga |
|---|---|
Jämför beställningar över tid | ”Hur många beställningar fick vi under Q2 2025, Q1 2026 och Q2 2026?” |
Analysera beställningsinformation | ”Hur många ordrar under de senaste 90 dagarna innehöll SKU:n FACEBUND01?” |
Sammanfatta intäkter och återbetalningar | ”Sammanfatta ordrarna i juni: totalt antal ordrar, total intäkt, antal återbetalda ordrar och totalt återbetalt belopp.” |
Förstå upprepade köp | ”Hur stor andel av kunderna har bara lagt 1 beställning?” |
Mät tiden mellan köp | ”Vad är det genomsnittliga antalet dagar mellan en kunds första och andra köp?” |
Jämför kundvärde | ”Jämför livstidsvärdet för e-postengagerade kunder med kunder som inte engagerar sig.” |
Hitta topprodukter | ”Vilka är mina topp 5 produkter efter antal sålda enheter de senaste 90 dagarna?” |
Jämför kampanjengagemang | ”Vilken veckodag har bäst öppningsfrekvens för kampanjer?” |
Utforska e-postprestanda | ”Vilka var mina 10 mest öppnade e-postmeddelanden, exklusive rea-kampanjer?” |
Analysera enheter | ”Vad är delningen mellan mobil och dator för mina e-postöppningar?” |
Granska flödesaktivitet | ”Vilka flöden har skickat meddelanden under det senaste året?” |
Jämför sms-prestanda | ”Vad var min klickfrekvens (CR) och avregistreringsfrekvens för sms i april, maj och juni?” |
Undersök studsar | ”Mitt nyhetsbrev den 2 juli hade 5,514 studsar. Kom de från 1 inkorgsleverantör? Vilka studstyper var det?” |
Kontrollera sändningsfrekvensen | ”Hur många profiler fick 2 eller fler e-postmeddelanden på 1 dag?” |
Förstå begränsningarna
Ej tillgängliga data
SQL stöder för närvarande inte:
- List- eller segmentmedlemskap vid en tidigare tidpunkt
- Registreringsformulär eller deras resultat
- Anpassade objekt
- Mallarna för e-post eller sms
Integrationshändelser kan inkludera formulärinsändningar, men det betyder inte att SQL stöder analys av registreringsformulär eller deras prestanda. Om din fråga beror på data som inte är tillgängliga kan svaret vara ofullständigt, eller så kanske klienten inte kan svara.
Aktualitet för data och skillnader jämfört med Klaviyo-rapporter
Data ligger vanligtvis cirka 30 minuter efter ditt Konto. Senaste aktiviteten kanske inte visas direkt.
Siffror ska generellt sett stämma överens med Klaviyo, men små skillnader kan förekomma på grund av skillnader i definitioner, optimeringar av frågor eller datafärskhet. SQL använder en annan datakälla än andra sätt att komma åt Klaviyo-data. Klaviyo har kontrollerat att dessa data har varit 99 % konsekventa under de senaste 3 åren.
Fråga efter beräkningen, datumintervallet och filtren när en siffra skiljer sig från en rapport. Förklaringen kan hjälpa dig att avgöra om du jämför samma mättal och period.
Genererade frågor och tidsgränser
SQL genererar en fråga utifrån din fråga. Det finns för närvarande ingen slutpunkt där du kan skicka in din egen SQL-fråga och få ett garanterat, upprepningsbart resultat. Olika formuleringar kan ge olika frågor och något olika resultat. Kontrollera beräkningen för viktiga siffror.
En MCP-klient kan sluta vänta på ett svar tidigare än Composer skulle göra. Claude har till exempel ett tidsgränsfönster på 60 sekunder. Om en fråga får tidsgräns ska du snäva in datumintervallet, minska antalet uppdelningar eller dela upp analysen i mindre frågor.
Felsökning
Analysverktyget är inte tillgängligt
Om du inte ser ask_analytics_question i din AI-klient kan du kontrollera att SQL är aktiverat för ditt Konto och uppdatera klientens verktygslista för Klaviyo.
I Claude:
- Gå till Anpassa > Anslutningar > Klaviyo.
- Öppna menyn med tre punkter uppe till höger.
- Klicka på Uppdatera verktygslistan och försök sedan med din fråga igen.
SQL kan inte returnera data som du vet finns i ditt Konto
Kontrollera om datamängden stöds och räkna med den typiska fördröjningen på 30 minuter. Om din anslutning använder en API-nyckel, kontrollera att den har åtkomst till alla datamängder som ingår, till exempel profiler, segment, listor, kampanjer, kataloger eller händelser. Uppdatera saknade behörigheter i Klaviyo, uppdatera klientens Klaviyo-verktygslista och försök att ställa frågan igen.
För en OAuth-anslutning granskar du behörigheterna i din klients anslutningsguide.
Tidsgränsen för en fråga löper ut
Prova ett kortare datumintervall eller färre delningar, eller dela upp frågan i mindre frågor. Försök igen med den mer avgränsade frågan och bygg sedan vidare på resultatet med följdfrågor.
Ett nummer matchar inte Klaviyo
Fråga hur SQL beräknade siffran, inklusive datauppsättningarna, datumintervallet och filtren. Kontrollera om mättalsdefinitionerna och hur aktuella data är kan förklara skillnaden. Om skillnaden är stor kan du kontakta Klaviyo Support och dela frågan, siffran du fick tillbaka och siffran du förväntade dig.
Composer avvisar en fråga
Omformulera frågan med ett specifikt mättal, ett datumintervall och en målgrupp. Kontrollera att den använder en av de datauppsättningar som stöds och försök igen.