Konfigurera en enhetshändelse configure-an-event
Enhetshändelser är länkade till en viss profil. De kan vara regelbaserade eller systemgenererade. Läs mer om enhetshändelse det här avsnittet.
Nedan följer de första stegen för att konfigurera en ny händelse:
-
Bläddra till Configurations på menyn Administration och klicka på Manage i avsnittet Events. Listan med händelser visas.
-
Klicka på Create Event för att skapa en ny händelse. Konfigurationsfönstret för händelsen öppnas till höger på skärmen.
-
Ange namnet på händelsen. Du kan också lägga till en beskrivning.
note note NOTE Endast alfanumeriska tecken och understreck tillåts. Maximala längden är 30 tecken. -
Välj Enhet i fältet Type.
-
I fältet Event ID type väljer du den händelse-ID-typ som du vill använda: Regelbaserad eller Systemgenererad. Läs mer om typer av händelse-ID i det här avsnittet.
-
Antalet resor som använder den här händelsen visas i fältet Used in. Du kan klicka på ikonen View journeys för att visa en lista över resor som använder den här händelsen.
-
Definiera schema- och nyttolastfälten: Här väljer du den händelseinformation (kallas vanligtvis nyttolast) som ska tas emot. Du kan sedan använda den här informationen i din resa. Se det här avsnittet.
note note NOTE När du väljer typen System Generated är endast scheman som har fältet för typen eventID tillgängliga. När du väljer typen Rule Based är alla Experience Event-scheman tillgängliga. -
För regelbaserade händelser klickar du i fältet Event ID condition. Använd den enkla eller avancerade uttrycksredigeraren för att definiera villkoret som ska användas av systemet för att identifiera de händelser som utlöser din resa.
I vårt exempel skrev vi ett villkor baserat på profilens stad. Det innebär att när systemet tar emot en händelse som matchar det här villkoret (City fält och Paris värde), skickas den till resorna.
note note NOTE I den enkla uttrycksredigeraren är inte alla operatorer tillgängliga, de är beroende av datatypen. För en strängtyp av fält kan du till exempel använda "contains" eller "equal to". Om du ändrar schemat med nya uppräkningsvärden efter att du har skapat händelsen måste du följa de här stegen för att tillämpa ändringarna på den befintliga händelsen: avmarkera uppräkningsfältet från händelsefälten, bekräfta valet och sedan markera uppräkningsfältet igen. Det nya uppräkningsvärdet visas nu. -
Lägg till en namnrymd. Det här steget är valfritt men rekommenderas eftersom du kan lägga till en namnrymd vilket innebär att du kan utnyttja information som lagras i realtidskundprofilen. Denna definierar vilken typ av nyckel händelsen har. Se det här avsnittet.
-
Definiera profilidentifieraren: välj ett fält bland dina nyttolastfält eller definiera en formel för att identifiera den person som är associerad med händelsen. Den här nyckeln konfigureras automatiskt (men kan fortfarande redigeras) om du väljer en namnrymd. Resor väljer nyckeln som ska motsvara namnutrymmet (om du t.ex. väljer ett e-postnamnutrymme markeras e-postnyckeln). Se det här avsnittet.
-
Klicka på Save.
Händelsen är nu konfigurerad och klar att injiceras i en resa. Ytterligare konfigurationssteg krävs för att ta emot händelser. Läs den här sidan.
Definiera nyttolastfälten define-the-payload-fields
Nyttolastdefinitionen gör att du kan välja vilken information systemet förväntar sig från händelsen under din resa och nyckeln för att identifiera vilken person som är associerad med händelsen. Nyttolasten baseras på Experience Cloud XDM-fältdefinitionen. Mer information om XDM finns i Adobe Experience Platform-dokumentationen.
-
Välj ett XDM-schema i listan och klicka på fältet Fields eller på ikonen Edit .
Alla fält som definieras i schemat visas. Listan med fält varierar mellan olika scheman. Du kan söka efter ett specifikt fält eller använda filtren för att visa alla noder och fält eller endast de markerade fälten. Enligt schemadefinitionen kan vissa fält vara obligatoriska och förmarkerade. Du kan inte avmarkera dem. Alla fält som är obligatoriska för att händelsen ska kunna tas emot på rätt sätt under resor markeras som standard.
note note NOTE Kontrollera att du har lagt till fältgruppen "orchestration" i XDM-schemat för systemgenererade händelser. Detta garanterar att schemat innehåller all nödvändig information som kan användas med Journey Optimizer. -
Markera de fält som du förväntar dig att ta emot från händelsen. Det här är de områden som affärsanvändaren kommer att utnyttja under resan. De måste även innehålla den nyckel som ska användas för att identifiera den person som är associerad med händelsen (se det här avsnittet).
note note NOTE För systemgenererade händelser läggs fältet eventID automatiskt till i listan med markerade fält så att Journey Optimizer kan identifiera händelsen. Det system som skickar händelsen ska inte generera ett ID, det ska använda det som finns i nyttolastförhandsvisningen. Se det här avsnittet. -
När du är klar med att markera de fält som behövs klickar du på Ok eller trycker på Enter.
Antalet markerade fält visas i fältet Fields.
Markera namnutrymmet select-the-namespace
Med namnutrymmet kan du definiera vilken typ av nyckel som används för att identifiera den person som är associerad med händelsen. Dess konfiguration är valfri. Det krävs om du i dina resor vill hämta ytterligare information som kommer från kundprofilen i realtid. Namnutrymmesdefinitionen behövs inte om du bara använder data från ett tredjepartssystem via en anpassad datakälla.
Du kan antingen använda en av de fördefinierade eller skapa en ny med hjälp av tjänsten Identity Namespace. Mer information finns i Adobe Experience Platform-dokumentationen.
Om du väljer ett schema som har en primär identitet fylls fälten Profiler identifier och Namespace i automatiskt. Om ingen identitet har definierats väljer vi identityMap > id som primärnyckel. Sedan måste du markera ett namnutrymme och nyckeln fylls i automatiskt (under fältet Namespace) med identityMap > id.
När du markerar fält taggas primära identitetsfält.
Välj ett namnutrymme i listrutan.
Endast ett namnutrymme tillåts per resa. Om du använder flera händelser under samma resa måste de använda samma namnutrymme. Läs den här sidan.
Definiera profilidentifieraren define-the-event-key
Nyckeln är fältet, eller kombinationen av fält, som är en del av händelsenyttolastdata och som gör att systemet kan identifiera den person som är associerad med händelsen. Nyckeln kan till exempel vara Experience Cloud ID, ett CRM ID eller en e-postadress.
Om du vill använda data som lagras i kundprofildatabasen för Adobe i realtid måste händelsenyckeln vara den information som du har definierat som en profils identitet i kundprofiltjänsten för realtid.
Profilidentifieraren gör det möjligt för systemet att utföra avstämningen mellan händelsen och personens profil. Om du väljer ett schema som har en primär identitet fylls fälten Profile identifier och Namespace i automatiskt. Om ingen identitet har definierats är identityMap > id primärnyckeln. Sedan måste du markera ett namnutrymme och nyckeln fylls i automatiskt med identityMap > id.
När du markerar fält taggas primära identitetsfält.
Om du behöver använda en annan nyckel, t.ex. ett CRM-ID eller en e-postadress, måste du lägga till den manuellt enligt följande:
-
Klicka i fältet Profile identifier eller på pennikonen.
-
Välj det fält som valts som nyckel i listan över nyttolastfält.
När händelsen tas emot kan nyckelns värde göra det möjligt för systemet att identifiera den person som är associerad med händelsen. Nyckeln är associerad med ett namnområde (se det här avsnittet) och kan användas för att utföra frågor på Adobe Experience Platform. Se den här sidan.
Nyckeln används också för att kontrollera att en person befinner sig på en resa. En person kan faktiskt inte befinna sig på två olika platser på samma resa. Därför tillåter systemet inte att samma nyckel, till exempel nyckeln CRMID=3224, finns på olika platser under samma resa.
Avancerad uttrycksredigerare adv-exp-editor
När du definierar villkoret för händelse-ID eller profilidentifieraren kan du växla till den avancerade uttrycksredigeraren för att skapa mer komplexa nycklar (till exempel en sammanfogning av två fält för händelserna).
Du har tillgång till de avancerade uttrycksfunktionerna från knappen Advanced mode om du vill utföra ytterligare ändringar. Dessa funktioner gör att du kan ändra de värden som används för att utföra specifika frågor, till exempel ändra format, utföra fältsammanfogningar, med hänsyn enbart till en del av ett fält (till exempel de 10 första tecknen). Läs den här sidan.
Förhandsgranska nyttolasten preview-the-payload
Med nyttolastens förhandsgranskning kan du validera nyttolastdefinitionen.
-
Klicka på ikonen View Payload om du vill förhandsgranska den nyttolast som systemet förväntar sig.
Du kan se att de markerade fälten visas.
-
Kontrollera förhandsgranskningen för att validera nyttolastdefinitionen.
-
Sedan kan du dela nyttolastförhandsvisningen med den person som ansvarar för händelsen som skickar. Den här nyttolasten kan hjälpa dem att utforma konfigurationen för en händelse som skickas till Journey Optimizer. Läs den här sidan.