Exempel på frågor query-examples
I det här avsnittet finns exempel som används ofta för att ställa frågor om händelser i resesteg i datasjön. Innan man går in på specifika användningsfall är det viktigt att förstå de nyckelidentifierare som används i data om resehändelser.
Se till att fälten som används i dina frågor har associerade värden i motsvarande schema.
Nyckelidentifierare key-identifiers
- id: unikt för alla steg-händelseposter. Två olika steghändelser kan inte ha samma ID.
- instanceID: instanceID är samma för alla steg-händelser som är kopplade till en profil inom en körning. Om en profil återgår till resan används ett annat instans-ID. Det nya instans-ID:t är samma för alla steg-händelser för den ommatade instansen (från start till slut).
- profileID: Profilens identitet motsvarar resenamnutrymmet.
| note note |
|---|
| NOTE |
| I felsökningssyfte rekommenderar vi att du använder travelVersionID i stället för travelVersionName när du frågar efter resor. Läs mer om attribut för reseegenskaper i det här avsnittet. |
Grundläggande användningsfall/vanliga frågor common-queries
Den här frågan ger antalet distinkta profiler som har passerat den angivna resan under den angivna tidsramen.
Datasjöfråga
| code language-sql |
|---|
|
Lär dig hur du felsöker ignorerade händelsetyper i travel_step_events.
Den här frågan returnerar den avvisade regeluppsättningen och regelinformationen när en profil hindras från att registrera en resa på grund av begränsningar eller behörighetskrav.
Exempel
| code language-sql |
|---|
|
Den här frågan returnerar information om steghändelser för profiler som tagits bort under en resa och som inte fått någon reseåtgärd. Det hjälper till att identifiera varför profiler ignorerades på grund av affärsregler som tysta timbegränsningar.
Datasjöfråga
| code language-sql |
|---|
|
Exempel
| code language-sql |
|---|
|
Frågeresultaten visar nyckelfält som hjälper till att identifiera orsaken till att en profil tas bort:
-
actionExecutionError - Om värdet är
businessRuleProfileDiscardedignoreras profilen på grund av en affärsregel. FälteteventTypeinnehåller ytterligare information om vilken specifik affärsregel som orsakade borttagningen. -
eventType - Anger vilken typ av affärsregel som orsakade borttagningen:
quietHours: Profilen ignorerades på grund av konfigurationen för tysta timmarforcedDiscardDueToQuietHours: Profilen tvingades ignoreras eftersom skyddsgränsen nåddes för profiler som hålls i tysta timmar
Den här frågan räknar de distinkta profiler som upplevde fel vid varje nod i en resa, grupperade efter nodnamn. Den innehåller alla typer av körningsfel och hämtningsfel.
Datasjöfråga
| code language-sql |
|---|
|
Den här frågan räknar det totala antalet händelser som har tagits bort från en resa. Den filtrerar efter olika bortkastningshändelsekoder, inklusive fel i segmentexportjobb, borttagning av dispatcher och kassering av tillståndsdatorer.
Datasjöfråga
| code language-sql |
|---|
|
Den här frågan returnerar alla steg-händelser och tjänsthändelser för den angivna profilen och resan för den angivna tiden i kronologisk ordning.
Datasjöfråga
| code language-sql |
|---|
|
Dessa frågor kan till exempel användas för att beräkna hur lång tid en vänteaktivitet tar. På så sätt kan du kontrollera att vänteaktiviteten är korrekt konfigurerad.
Datasjöfråga
| code language-sql |
|---|
|
Datasjöfråga
| code language-sql |
|---|
|
Datauppsättningen för händelser i resesteg innehåller alla stepEvents och serviceEvents. stepEvents används vid rapportering, eftersom de avser aktiviteter (händelser, åtgärder osv.) i profiler under en resa. serviceEvents lagras i samma datauppsättning och de anger ytterligare information för felsökningsändamål, till exempel orsaken till att en upplevelsehändelse ignoreras.
Här är ett exempel på en fråga som kontrollerar detaljerna för en serviceEvent:
Datasjöfråga
| code language-sql |
|---|
|
Meddelande-/åtgärdsfel message-action-errors
| accordion | ||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|
| Lista över alla fel som påträffats under resor | ||||||||||||
|
Med den här frågan kan du lista alla fel som påträffas under resor när ett meddelande/en åtgärd körs.
Exempelutdata
Den här frågan returnerar alla olika fel som inträffade när en åtgärd kördes i en resa tillsammans med antalet gånger som varje fel inträffade, ordnade efter frekvens. |
Profilbaserade frågor profile-based-queries
Den här frågan kontrollerar om en viss profil har påbörjat en resa genom att räkna händelserna som är kopplade till den profilen och den aktuella kombinationen av resan.
| code language-sql |
|---|
|
Exempelutdata
| table 0-row-1 1-row-1 |
|---|
| EVENT_COUNT |
| 3 |
Den här frågan returnerar det exakta antalet gånger en profil har påbörjat en resa. Ett resultat som är större än 0 bekräftar att profilen har passerat resan.
Metod 1: Om namnet på ditt meddelande inte är unikt i resan (det används på flera platser).
| code language-sql |
|---|
|
Exempelutdata
| table 0-row-1 1-row-1 |
|---|
| MESSAGE_SENT_COUNT |
| 1 |
Ett resultat som är större än 0 bekräftar att meddelandeåtgärden har utförts. Den här frågan talar bara om för oss om meddelandeåtgärden har utförts på resans sida.
Metod 2: Om namnet på ditt meddelande är unikt under resan.
| code language-sql |
|---|
|
Exempelutdata
| table 0-row-1 1-row-1 |
|---|
| MESSAGE_SENT_COUNT |
| 1 |
Frågan returnerar antalet gånger som meddelandet anropades för den valda profilen.
Den här frågan hämtar alla slutförda meddelandeåtgärder för en viss profil under de senaste 30 dagarna grupperade efter meddelandenamn.
| code language-sql |
|---|
|
Exempelutdata
| table 0-row-2 1-row-2 2-row-2 3-row-2 4-row-2 | |
|---|---|
| MESSAGE_NAME | MESSAGE_COUNT |
| Välkomstmeddelande | 1 |
| Produktrekommendation | 3 |
| Cart Abandonment Reminder | 2 |
| Nyhetsbrev varje vecka | 4 |
Frågan returnerar listan med alla meddelanden tillsammans med antalet som anropats för den valda profilen.
Den här frågan returnerar alla resor som en viss profil har angivit under de senaste 30 dagarna, tillsammans med antalet poster för varje resa.
| code language-sql |
|---|
|
Exempelutdata
| table 0-row-2 1-row-2 2-row-2 3-row-2 | |
|---|---|
| JOURNEY_NAME | POST_COUNT |
| Welcome Journey v2 | 1 |
| Produktrekommendationer | 5 |
| Återengagemangskampanj | 2 |
Frågan returnerar listan med alla resenamn tillsammans med det antal gånger den efterfrågade profilen har angetts för varje resa.
Den här frågan ger en daglig uppdelning av antalet distinkta profiler som har passerat en resa under en viss tidsperiod.
| code language-sql |
|---|
|
Exempelutdata
| table 0-row-2 1-row-2 2-row-2 3-row-2 4-row-2 5-row-2 | |
|---|---|
| POST_DATE | PROFILES_COUNT |
| 2024-11-25 | 1 245 |
| 2024-11-24 | 1 189 |
| 2024-11-23 | 15 340 |
| 2024-11-22 | 1 205 |
| 2024-11-21 | 1 167 |
Frågan returnerar, för den angivna perioden, antalet profiler som har angetts för resan varje dag. Om en profil anges via flera identiteter räknas den två gånger. Om återinträde är aktiverat kan antalet profiler dupliceras över olika dagar om det återgick till resan på en annan dag.
Lär dig hur du felsöker ignorerade händelsetyper i travel_step_events.
Frågor relaterade till den lästa målgruppen read-segment-queries
Den här frågan beräknar varaktigheten för ett målgruppsexportjobb genom att hitta tidsskillnaden mellan när jobbet placerades i kö och när det slutfördes.
| code language-sql |
|---|
|
Frågan returnerar tidsskillnaden i minuter, mellan den tidpunkt då målgruppens exportjobb placerades i kö och den tidpunkt det slutligen avslutades.
Den här frågan räknar antalet distinkta profiler som ignorerades på grund av instansdupliceringsfel under Läs publik-aktiviteten.
| code language-sql |
|---|
|
Frågan returnerar alla profil-ID:n som ignorerades av resan eftersom de var dubbletter.
Den här frågan returnerar antalet profiler som ignorerades eftersom de hade ett ogiltigt namnutrymme eller saknades en identitet för det önskade namnutrymmet.
| code language-sql |
|---|
|
Frågan returnerar alla profil-ID:n som ignorerades under resan eftersom de hade ett ogiltigt namnutrymme eller ingen identitet för det namnutrymmet.
Den här frågan räknar de profiler som ignorerades eftersom de saknade en identitetskarta som krävs för körning av resan.
| code language-sql |
|---|
|
Frågan returnerar alla profil-ID:n som ignorerades under resan eftersom identitetskartan saknades.
Den här frågan identifierar profiler som ignorerades när resan kördes i testläge, men profilen hade inte attributet testProfile inställt på true.
| code language-sql |
|---|
|
Frågan returnerar alla profil-ID:n som ignorerades under resan eftersom exportjobbet kördes i testläge, men profilen hade inte attributet testProfile inställt på true.
Den här frågan returnerar antalet profiler som ignorerades på grund av interna systemfel under körningen.
| code language-sql |
|---|
|
Frågan returnerar alla profil-ID:n som ignorerades av resan på grund av ett internt fel.
Den här frågan innehåller en omfattande översikt över aktiviteten Läs målgrupp, inklusive information om segmentexportjobb, händelsekoder, status och antal profiler för alla faser i målgruppsexportprocessen.
Datasjöfråga
| code language-sql |
|---|
|
Den returnerar alla servicehändelser som hör till den angivna reseversionen. Vi kan följa verksamhetskedjan:
- ämnesskapande
- skapa exportjobb
- avslutande av exportjobb (med mätvärden för exporterade profiler)
- arbetarens avslutande av bearbetningen
Vi kan också upptäcka problem som:
- fel i ämne eller skapande av exportjobb (inklusive timeout för API-anrop för målgruppsexport)
- exporteringsjobb som kan fastna (när det gäller en viss reseversion har vi ingen händelse om att exportjobbet avslutas)
- arbetarutleveranser, om vi har tagit emot en händelse om att exportjobben har avslutats, men ingen arbetare har avslutat
VIKTIGT! Om ingen händelse returneras av frågan kan det bero på någon av följande orsaker:
- transportversionen inte har nått schemat
- Om reseversionen ska ha utlöst exportjobbet genom att anropa orchestrator, gick något fel i det överordnade flödet: problem vid resedistribution, affärshändelse eller problem med schemaläggare.
Den här frågan filtrerar efter specifika felhändelsekoder som är relaterade till fel i läsningen av målgrupper, t.ex. ämnesfel, API-anropsfel, timeout och misslyckade exportjobb.
Datasjöfråga
| code language-sql |
|---|
|
Den här frågan hämtar bearbetningsstatus för målgruppsexportjobb, och visar om de lyckades eller misslyckades tillsammans med profilexportstatistik.
Datasjöfråga
| code language-sql |
|---|
|
Om ingen post returneras betyder det att antingen:
- ett fel uppstod när ämnet eller exportjobbet skapades
- exportjobbet fortfarande körs
I den här frågan kombineras antalet ignorerade profiler med exportjobbstatistik för att ge en fullständig bild av målgruppens exportresultat för varje enskilt exportjobb.
Datasjöfråga
| code language-sql |
|---|
|
Den här frågan sammanställer övergripande mätvärden för alla exportjobb för en viss reseversion, vilket är användbart för återkommande resor eller affärsutlösta resor med återanvändning av ämnen.
Datasjöfråga
| code language-sql |
|---|
|
Den här frågan skiljer sig från den föregående.
Den returnerar den totala mätningen för en viss reseversion, oavsett vilka jobb som kan ha körts för den (vid återkommande resor utlöstes affärshändelser som utnyttjar återanvändning av ämnet).
Frågor relaterade till målgruppskvalifikation segment-qualification-queries
Den här frågan identifierar profiler som har ignorerats eftersom deras status för målgruppsrealisering inte matchade kundens konfiguration för målgruppskvalifikation (t.ex. konfigurerad för "enter" men profilen "avslutad").
Datasjöfråga
| code language-sql |
|---|
|
Exempel
| code language-sql |
|---|
|
Den här frågan returnerar alla profil-ID:n som ignorerades av reseversionen på grund av felaktig målgruppsrealisering.
Den här frågan hämtar alla målgruppsklassificeringar eller externa händelser som har tagits bort för en viss profil på grund av interna tjänstfel.
Datasjöfråga
| code language-sql |
|---|
|
Exempel
| code language-sql |
|---|
|
Den här frågan returnerar alla händelser (externa händelser/målgruppsklassificeringshändelser) som har ignorerats på grund av någon annan anledning till en profil.
Händelsebaserade frågor event-based-queries
Den här frågan räknar antalet gånger en affärshändelse har tagits emot av en resa, grupperad efter datum, inom en angiven tidsram.
| code language-sql |
|---|
|
Den här frågan identifierar när en extern händelse för en viss profil ignorerades eftersom ingen aktiv eller matchande resa har konfigurerats för att ta emot händelsen.
| code language-sql |
|---|
|
Lär dig hur du felsöker ignorerade händelsetyper i travel_step_events.
Den här frågan hämtar externa händelser som ignorerats för en viss profil på grund av interna tjänstfel, tillsammans med händelse-ID och felkod.
| code language-sql |
|---|
|
Lär dig hur du felsöker ignorerade händelsetyper i travel_step_events.
Den här frågan sammanställer alla händelser som ignoreras av transporttillståndsdatorn, grupperade efter felkod, för att hjälpa till att identifiera de vanligaste orsakerna till ignorering.
| code language-sql |
|---|
|
Lär dig hur du felsöker ignorerade händelsetyper i travel_step_events.
Den här frågan identifierar alla händelser som har ignorerats eftersom en profil försökte att ange en resa igen när återinträde inte var tillåtet i resekonfigurationen.
| code language-sql |
|---|
|
Lär dig hur du felsöker ignorerade händelsetyper i travel_step_events.
Frågor för aktiveringsbara profiler engageable-profiles-queries
Med hjälp av de här frågorna kan du övervaka och analysera hur många profiler du kan aktivera. En engagerande profil är en unik profil som har använts under resor eller kampanjer de senaste tolv månaderna. Läs mer om Engagerbara profiler och licensanvändning.
- Kontrollera att alla icke-aggregerade fält inkluderas i
GROUP BY-satsen - Undvik att referera till datauppsättningar som inte finns i sandlådan - bekräfta datauppsättningsnamnen i plattformens användargränssnitt
- Använd
distinctnär du räknar unika profiler för att undvika dubbletter i identitetsnamnutrymmen - När du använder
LIMITplacerar du den i slutet av frågan efterORDER BY-satser
Den här frågan returnerar antalet distinkta profiler som har använts under en viss resa, vilket ökar antalet profiler som kan aktiveras.
| code language-sql |
|---|
|
Den här frågan hjälper dig att förstå hur många unika profiler en viss resa har bidragit till antalet aktiverbara profiler under de senaste 12 månaderna.
Den här frågan visar antalet unika profiler som använts av varje resa i din organisation under de senaste 12 månaderna, vilket hjälper dig att identifiera vilka resor som bidrar mest till ditt engagerande profilantal.
| code language-sql |
|---|
|
Exempelutdata
| table 0-row-3 1-row-3 2-row-3 3-row-3 | ||
|---|---|---|
| JOURNEY_VERSION_ID | JOURNEY_NAME | ENGAGED_PROFILES |
| 67b14482-143e-4f83-9cf5-cfec0fca3d26 | Välkomstkampanj v2 | 125 450 |
| a3c21b89-456d-4e21-b8f3-9a8e7c6d5432 | Produktlansering | 98 230 |
| f9e8d7c6-b5a4-3210-9876-543210fedcba | Återengagemang - flöde | 45 670 |
Detta hjälper er att identifiera vilka resor som engagerar de flesta profiler och som bidrar mest till att antalet engagerande profiler ökar.
| note note |
|---|
| NOTE |
Den här frågegruppen sorteras efter både journeyVersionID och journeyVersionName. Båda fälten måste inkluderas i GROUP BY-satsen eftersom de är markerade i frågan. Om du utelämnar fält från GROUP BY-satsen misslyckas frågan. |
Den här frågan ger en daglig uppdelning av nyligen engagerade profiler, vilket hjälper dig att identifiera toppar i antal aktiverbara profiler.
| code language-sql |
|---|
|
Exempelutdata
| table 0-row-2 1-row-2 2-row-2 3-row-2 4-row-2 5-row-2 | |
|---|---|
| ENGAGEMENT_DATE | ENGAGED_PROFILES |
| 2024-11-25 | 8 450 |
| 2024-11-24 | 7 820 |
| 2024-11-23 | 125 340 |
| 2024-11-22 | 9 230 |
| 2024-11-21 | 8 670 |
Med den här typen av utdata kan du övervaka dagliga trender och identifiera när ett stort antal profiler används. I det här exemplet visar den 23 november en betydande topp (125 340 profiler) jämfört med det vanliga dagliga engagemanget (~8 000 profiler), vilket skulle göra det värt att undersöka vilken resa eller kampanj som orsakade ökningen av antalet engagerande profiler.
Den här frågan hjälper dig att identifiera vilka resor som har engagerat ett stort antal nya profiler under de senaste tidsperioderna, vilket kan förklara plötsliga ökningar i antalet aktiverbara profiler.
| code language-sql |
|---|
|
Exempelutdata
| table 0-row-4 1-row-4 2-row-4 3-row-4 | |||
|---|---|---|---|
| JOURNEY_VERSION_ID | JOURNEY_NAME | ENGAGEMENT_DATE | ENGAGED_PROFILES |
| 67b14482-143e-4f83-9cf5-cfec0fca3d26 | Black Friday Campaign | 2024-11-23 | 125 340 |
| a3c21b89-456d-4e21-b8f3-9a8e7c6d5432 | Produktlansering | 2024-11-22 | 45 230 |
| f9e8d7c6-b5a4-3210-9876-543210fedcba | Nyhetsbrev - helgdag | 2024-11-21 | 32 150 |
Den här frågan filtrerar efter resor som använt mer än 1 000 profiler per dag de senaste 7 dagarna. Utdata visar vilka specifika resor och datum som ligger bakom stora profilåtaganden. Justera tröskelvärdet för HAVING-satsen baserat på dina behov (ändra t.ex. > 1000 till > 10000 för större tröskelvärden).
Den här frågan innehåller ett antal unika profiler som använts under alla resor de senaste 12 månaderna, vilket ger dig en översikt över ditt resebaserade engagemang.
| code language-sql |
|---|
|
Exempelutdata
| table 0-row-1 1-row-1 |
|---|
| TOTAL_ENGAGED_PROFILES |
| 2 547 890 |
Detta enda nummer representerar det totala antalet unika profiler som har använts av minst en resa under de senaste 12 månaderna.
| note note |
|---|
| NOTE |
| Den här frågan räknar distinkta profil-ID:n i datauppsättningen för kundstegshändelser. Det faktiska antalet profiler som kan aktiveras och som visas på kontrollpanelen för licensanvändning kan skilja sig något, eftersom den även innehåller profiler som används via kampanjer och andra Journey Optimizer-funktioner bortom resor. |
Vanliga resebaserade frågor journey-based-queries
Den här frågan returnerar ett dagligt antal unika reseversioner som har haft aktivitet, vilket hjälper dig att förstå mönster för körning av resan över tid.
| code language-sql |
|---|
|
Exempelutdata
| table 0-row-2 1-row-2 2-row-2 3-row-2 4-row-2 5-row-2 | |
|---|---|
| ACTIVITY_DATE | ACTIVE_JOURNEYS |
| 2024-11-25 | 12 |
| 2024-11-24 | 15 |
| 2024-11-23 | 14 |
| 2024-11-22 | 11 |
| 2024-11-21 | 13 |
Frågan returnerar, för den angivna perioden, antalet unika resor som utlöstes varje dag. En enda resa som utlöses på flera dagar räknas en gång om dagen.
Frågor om reseinstanser journey-instances-queries
I den här frågan används CTE (Common Table Expressions) för att identifiera profiler som väntar på en viss nod i en resa genom att söka efter profiler som passerat genom noden men som ännu inte har gått vidare till nästa nod.
Datasjöfråga
| code language-sql |
|---|
|
Exempel
| code language-sql |
|---|
|
Den här frågan räknar vilka resinstanser som avslutats under en angiven tidsperiod, inklusive avslut på grund av slutförande, fel, timeout eller fel vid capping.
Datasjöfråga
| code language-sql |
|---|
|
Exempel
| code language-sql |
|---|
|
Den här frågan innehåller en detaljerad beskrivning av resans avslutningar, som visar nodnamnet och avslutningsstatusen för varje avslutad instans för att hjälpa till att identifiera var och varför profiler lämnade resan.
Datasjöfråga
| code language-sql |
|---|
|
Exempel
| code language-sql |
|---|
|
Frågor relaterade till prestandamått för anpassade åtgärder query-custom-action
Den här frågan innehåller prestandamått för anpassade HTTP-åtgärder, inklusive totalt antal anrop, slutförda anrop, antal fel per typ (4xx, 5xx, timeouts, cApped) och genomströmning i begäranden per sekund för varje slutpunkt.
Datasjöfråga
| code language-sql |
|---|
|
Exempel
| code language-sql |
|---|
|
Den här frågan ger samma prestandamått som föregående fråga men är ordnad som en tidsserie, och visar hur slutpunktsprestanda varierar över tid med en minuts granularitet.
Datasjöfråga
| code language-sql |
|---|
|
Exempel
| code language-sql |
|---|
|
Den här frågan beräknar responstidens för anpassade åtgärdsslutpunkter, vilket hjälper dig att förstå fördröjningsfördelningen och identifiera prestandavärden vid olika percentiltröskelvärden.
Datasjöfråga
| code language-sql |
|---|
|
Exempel
| code language-sql |
|---|
|
Den här frågan tillhandahåller fördröjningspercentiler ordnade som en tidsserie, så att du kan spåra hur svarstiderna för slutpunkter ändras över tid på olika percentilnivåer.
Datasjöfråga
| code language-sql |
|---|
|
Exempel
| code language-sql |
|---|
|
Den här frågan analyserar köväntetider för begränsning av slutpunkter, vilket visar väntetiderna i 50 och 95:e percentilen så att du lättare kan förstå hur strypningen påverkar dina anpassade åtgärder.
Datasjöfråga
| code language-sql |
|---|
|
Exempel
| code language-sql |
|---|
|
Den här frågan tillhandahåller köns kötidspoängen som en tidsserie, vilket gör att du kan övervaka hur begränsning påverkar väntetiderna över tiden för varje slutpunkt.
Datasjöfråga
| code language-sql |
|---|
|
Exempel
| code language-sql |
|---|
|
Den här frågan innehåller en detaljerad beskrivning av fel för en specifik slutpunkt, grupperade efter feltyp och felkod, inklusive information om nya försök.
Datasjöfråga
| code language-sql |
|---|
|
Exempel
| code language-sql |
|---|
|