Modelldata i scheman
I den här lektionen ska du modellera Lumas data i scheman. Det här är en av de längsta lektionerna i självstudiekursen, så ta ett glas vatten och slipp!
Standardisering och interoperabilitet är viktiga begrepp bakom Adobe Experience Platform. Experience Data Model (XDM) är ett försök att standardisera kundupplevelsedata och definiera scheman för kundupplevelsehantering.
XDM är en öppet dokumenterad specifikation som utformats för att förbättra möjligheterna med digitala upplevelser. Det innehåller gemensamma strukturer och definitioner för alla program som används för att kommunicera med plattformstjänster. Genom att följa XDM-standarder kan alla kundupplevelsedata införlivas i en gemensam representation som kan ge insikter på ett snabbare och mer integrerat sätt. Ni kan få värdefulla insikter från kundåtgärder, definiera kundmålgrupper genom segment och uttrycka kundattribut i personaliseringssyfte.
XDM är det grundläggande ramverk som gör att Adobe Experience Cloud, som drivs av Experience Platform, kan leverera rätt budskap till rätt person, i rätt kanal, i precis rätt ögonblick. Den metod som Experience Platform bygger på. XDM-system används Experience Data Model-scheman för plattformstjänster.
Dataarkitekturer måste skapa scheman utanför kursen, men Datatekniker kommer att arbeta nära med de scheman som skapas av dataarkitekten.
Innan du börjar övningarna ska du titta på den här korta videon och lära dig mer om scheman och Experience Data Model (XDM):
Behörigheter krävs
I Konfigurera behörigheter lektionen anger du alla åtkomstkontroller som krävs för att slutföra lektionen.
Skapa bonusschema via användargränssnittet
I den här övningen ska vi skapa ett schema för Lumas lojalitetsdata.
- Gå till användargränssnittet för plattformen och se till att din sandlåda är markerad.
- Gå till Scheman till vänster navigering
- Välj Skapa schema överst till höger
- Välj Individuell XDM-profil eftersom vi kommer att modellera attribut för en enskild kund (poäng, status osv.).
Lägg till standardfältgrupper
Därefter uppmanas du att lägga till fältgrupper i schemat. Alla fält måste läggas till i scheman med hjälp av grupper. Du kan välja bland en stor uppsättning standardfältgrupper från Adobe eller skapa egna. När ni börjar utforma egna data i Experience Platform är det bra att bekanta sig med de branschledande fältgrupperna från Adobe. När det är möjligt är det en god praxis att använda dem eftersom de ibland driver tjänster längre fram i kedjan, t.ex. kundens AI, Attribution AI och Adobe Analytics.
När du arbetar med egna data är det ett stort steg att avgöra vilken av dina egna data som ska samlas in i Platform och hur de ska modelleras. Det här stora ämnet diskuteras mer ingående i kursen Modellera era kundupplevelsedata med XDM. I den här självstudiekursen vägleder jag dig genom implementeringen av några förbestämda scheman.
Så här lägger du till fältgrupper:
-
I Lägg till fältgrupper modal, välj följande fältgrupper:
- Demografiska detaljer för grundläggande kunddata som namn och födelsedatum
- Kontaktinformation, privat för grundläggande kontaktinformation som e-postadress och telefonnummer
-
Du kan förhandsgranska fälten i fältgruppen genom att markera ikonen till höger om raden.
-
Kontrollera Bransch > Detaljhandel för att visa branschspecifika fältgrupper.
-
Välj Lojalitet om du vill lägga till fälten för bonusprogram.
-
Välj Lägg till fältgrupp om du vill lägga till alla tre fältgrupper i schemat.
Ta dig tid att utforska schemats aktuella status. Fältgrupperna har lagt till standardfält som är relaterade till en person, deras kontaktinformation och lojalitetsprogrammets status. Dessa två fältgrupper kan vara användbara när du skapar scheman för det egna företagets data. Markera en specifik fältgruppsrad eller markera kryssrutan bredvid fältgruppnamnet för att se hur visualiseringen ändras.
Spara schemat:
- Markera schemats översta nod.
- Retur
Luma Loyalty Schema
som Visningsnamn. - Välj Spara.
Lägga till en anpassad fältgrupp
Nu ska vi skapa en anpassad fältgrupp.
Medan lojalitetsfältgruppen innehöll en loyaltyID
Luma vill hantera alla sina systemidentifierare i en enda grupp för att säkerställa konsekvens i alla sina scheman.
Fältgrupper måste skapas i schemaarbetsflödet. Så här skapar du fältgruppen:
- Välj Lägg till under Fältgrupper för schema rubrik
- Välj Skapa ny fältgrupp
- Använd
Luma Identity profile field group
som Visningsnamn - Använd
system identifiers for XDM Individual Profile class
som Beskrivning - Välj Lägg till fältgrupper
Den nya, tomma fältgruppen läggs till i ditt schema. The + -knappar kan användas för att lägga till nya fält på valfri plats i hierarkin. I det här fallet vill vi lägga till fält på rotnivå:
-
Välj + bredvid schemats namn. Då läggs ett nytt fält till under ditt innehavar-id-namnutrymme för att hantera konflikter mellan dina anpassade fält och alla standardfält.
-
I Fältegenskaper sidofältet lägger till information om det nya fältet:
- Fältnamn:
systemIdentifier
- Visningsnamn:
System Identifier
- Typ: Objekt
- Välj Använd
- Fältnamn:
Lägg nu till två fält under systemIdentifier
objekt:
-
Första fältet
- Fältnamn:
loyaltyId
- Visningsnamn
Loyalty Id
- Typ: Sträng
- Fältnamn:
-
Andra fältet
- Fältnamn:
crmId
- Visningsnamn:
CRM Id
- Typ: Sträng
- Fältnamn:
Din nya fältgrupp bör se ut så här. Välj Spara för att spara schemat, men lämna schemat öppet för nästa övning.
Skapa en datatyp
Fältgrupper, till exempel din nya Luma Identity profile field group
kan återanvändas i andra scheman, vilket gör att du kan använda standarddatadefinitioner i flera system. Men de kan bara återanvändas i scheman som delar en klass, i det här fallet klassen XDM Individual Profile.
Datatypen är en annan flerfältskonstruktor som kan återanvändas i scheman över flera klasser. Låt oss konvertera våra nya systemIdentifier
till en datatyp:
Med Luma Loyalty Schema
fortfarande öppen väljer du systemIdentifier
objekt och markera Konvertera till ny datatyp
Om du Avbryt ut ur schemat och navigera till Datatyper kommer du att se din nya datatyp. Vi kommer att använda den här datatypen senare i lektionen.
Skapa CRM-schema via API
Nu ska vi skapa ett schema med API:t.
- Använd Individuell XDM-profil class
- Ge den ett namn
Luma CRM Schema
- Använd följande fältgrupper: Demografiska uppgifter, personliga kontaktuppgifter och Luma Identity-profilgrupp
Först skapar vi det tomma schemat:
-
Öppna Postman
-
Öppna begäran om du inte har någon åtkomsttoken OAuth: Request Access Token och markera Skicka för att begära en ny åtkomsttoken.
-
Öppna dina miljövariabler och ändra värdet för CONTAINER_ID från
global
tilltenant
. Kom ihåg att du måste användatenant
när du vill interagera med egna anpassade element i plattformen, till exempel skapa ett schema. -
Välj Spara
-
Öppna förfrågan Schema Registry API > Schemas > Create a new custom schema.
-
Öppna Brödtext och klistra in följande kod och markera Skicka för att anropa API. Det här anropet skapar ett nytt schema med samma
XDM Individual Profile
basklass:code language-json { "type": "object", "title": "Luma CRM Schema", "description": "Schema for CRM data of Luma Retail ", "allOf": [{ "$ref": "https://ns.adobe.com/xdm/context/profile" }] }
note note NOTE Namnutrymmesreferenserna i den här och efterföljande kodexempel (till exempel https://ns.adobe.com/xdm/context/profile
), kan hämtas med hjälp av list-API-anrop med CONTAINER_ID och acceptera sidhuvud inställt på rätt värden. Vissa är också lättåtkomliga i användargränssnittet. -
Du borde skaffa en
201 Created
svar -
Kopiera
meta:altId
från svarsorganet. Vi kommer att använda den senare i en annan övning.
-
Det nya schemat ska vara synligt i användargränssnittet, men utan fältgrupper
meta:altId
eller schema-ID kan också hämtas genom att API-begäran görs Schema Registry API > Schemas > Retrieve a list of schemas within the specified container. med CONTAINER_ID ange till tenant
och en godkännanderubrik application/vnd.adobe.xdm+json
.- Ingen auth-token: Kör OAuth: Begär åtkomsttoken begäran om att generera en ny token
401: Not Authorized to PUT/POST/PATCH/DELETE for this path : /global/schemas/
: Uppdatera CONTAINER_ID miljövariabel frånglobal
tilltenant
403: PALM Access Denied. POST access is denied for this resource from access control
: Verifiera dina användarbehörigheter i Admin Console
Lägg till standardfältgrupper
Nu är det dags att lägga till fältgrupperna i schemat:
-
I Postman, Öppna förfrågan Schema Registry API > Schemas > Update one or more attributes of a custom schema specified by ID.
-
I Parametrar flik, klistra in
meta:altId
värdet från föregående svar somSCHEMA_ID
-
Öppna fliken Brödtext och klistra in följande kod och markera Skicka för att anropa API. Det här anropet lägger till standardfältgrupperna i
Luma CRM Schema
:code language-json [{ "op": "add", "path": "/allOf/-", "value": { "$ref": "https://ns.adobe.com/xdm/context/profile-personal-details" } }, { "op": "add", "path": "/allOf/-", "value": { "$ref": "https://ns.adobe.com/xdm/context/profile-person-details" } } ]
-
Du bör få statusen 200 OK för svaret och fältgrupperna ska vara synliga som en del av ditt schema i användargränssnittet
Lägg till anpassad fältgrupp
Nu lägger vi till Luma Identity profile field group
till schemat. Först måste vi hitta ID:t för vår nya fältgrupp med hjälp av en list-API:
-
Öppna förfrågan Schema Registry API > Field groups > Retrieve a list of field groups within the specified container.
-
Välj Skicka för att hämta en lista över alla anpassade fältgrupper i ditt konto
-
Ta tag i
$id
värdet påLuma Identity profile field group
(ditt eget värde skiljer sig från värdet i den här skärmbilden)
-
Öppna förfrågan Schema Registry API > Schemas > Update one or more attributes of a custom schema specified by ID. igen
-
The Parametrar ska fortfarande ha
$id
av ditt schema -
Öppna Brödtext och klistra in följande kod, ersätta
$ref
värdet med$id
på egen handLuma Identity profile field group
:code language-json [{ "op": "add", "path": "/allOf/-", "value": { "$ref": "REPLACE_WITH_YOUR_OWN_FIELD_GROUP_ID" } }]
-
Välj Skicka
Kontrollera att fältgruppen har lagts till i schemat genom att kontrollera både API-svaret och gränssnittet.
Skapa offlineköpshändelseschema
Nu ska vi skapa ett schema baserat på XDM ExperienceEvent klassen för Lumas inköpsdata offline. Eftersom du nu bekantar dig med användargränssnittet i schemaredigeraren kommer jag att minska antalet skärmbilder i instruktionerna:
- Skapa ett schema med XDM ExperienceEvent class
- Lägg till standardfältgruppen Handelsinformation om du vill hämta information om vanliga order. Tillbringa några minuter med att utforska objekten inuti.
- Sök efter
Luma Identity profile field group
. Den är inte tillgänglig! Kom ihåg att fältgrupper är kopplade till en klass, och eftersom vi använder en annan klass för det här schemat kan vi inte använda det. Vi måste lägga till en ny fältgrupp för klassen XDM ExperienceEvent som innehåller identitetsfälten. Vår datatyp kommer att göra det väldigt enkelt! - Välj Skapa ny fältgrupp alternativknapp
- Ange Visningsnamn as
Luma Identity ExperienceEvent field group
och väljer Lägg till fältgrupper knapp - Se till att + knapparna visas på i Struktur så att du kan lägga till nya fält
- I Struktur avsnitt, markera + på schemats översta nivå
- Som Fältnamn, ange
systemIdentifier
- Som Visningsnamn, ange
System Identifier
- Som Typ, markera Systemidentifierare som är en anpassad datatyp som du skapade tidigare
- Välj Använd knapp
- Namnge ditt schema
Luma Offline Purchase Events Schema
- Välj Spara knapp
Observera hur datatypen lade till alla fält!
Välj även XDM ExperienceEvent under Klass rubrik och inspektera några av fälten från den här klassen. Observera att fält för _id och tidsstämplar krävs när klassen XDM ExperienceEvent används. Dessa fält måste fyllas i för varje post som du infogar när du använder det här schemat:
Skapa webbhändelseschema
Nu ska vi skapa ett till schema för Lumas webbplatsdata. Nu bör du vara expert på att skapa scheman! Bygg följande schema med dessa egenskaper
Välj Consumer Experience Event fältgrupp. Den här fältgruppen innehåller objekten commerce och productListItems som också fanns i Handelsinformation. Ja Consumer Experience Event är en kombination av flera andra standardfältgrupper som också är tillgängliga separat. AEP Web SDK ExperienceEvent Mixin fältgruppen innehåller även andra fältgrupper, inklusive några av de i Consumer Experience Event. Lyckligtvis smälter de ihop sömlöst.
Observera att vi inte lade till Luma Identity ExperienceEvent field group
till detta schema. Det beror på att Web SDK har ett annat sätt att samla in identiteter. Om du väljer XDM ExperienceEvent i Disposition i schemaredigeraren kommer du att märka att ett av fälten som läggs till som standard anropas IdentityMap. IdentityMap används av olika Adobe-program för att länka till plattformen. Du kommer att se hur identiteter skickas till plattformen via identityMap i lektionen om direktuppspelning.
Skapa produktkatalogschema
Genom att använda Handelsinformation och Consumer Experience Event fältgrupper, Luma rapporterar viss information om produktrelaterade händelser via standarddatatypen productListItems. Men de har också ytterligare produktinformationsfält som de vill skicka till Platform. I stället för att fylla i alla dessa fält i sina butiks- och e-handelssystem föredrar Luma att importera fälten direkt från sitt produktkatalogsystem. Med en "schemarelation" kan du definiera en relation mellan två scheman för klassificering eller sökning. Luma använder en relation för att klassificera sin produktinformation. Vi börjar processen nu och slutför den i slutet av nästa lektion.
Först måste vi skapa ett schema för Lumas produktkatalog med en anpassad klass:
-
Välj Skapa schema och väljer Bläddra i listrutan
-
Välj Skapa ny klass alternativknapp
-
Ge den ett namn
Luma Product Catalog Class
-
Lämna Beteende as Post
-
Välj Tilldela klass knapp
-
Skapa ett nytt fältgrupp anropad
Luma Product Catalog field group
med följande fält:- productName: Produktnamn: String
- productCategory: Product Category: String
- productColor: Produktfärg: String
- productSku: Product SKU: String | Krävs
- productSize: Produktstorlek: String
- productPrice: Product Price: Double
-
Namnge schemat
Luma Product Catalog Schema
(se till att uppdatera rätt fält och inte uppdatera klassnamnet) -
Spara schemat
Ditt nya schema bör se ut så här. Anteckna hur productSku
-fältet visas i Obligatoriska fält avsnitt:
Nästa steg är att definiera relationen mellan de två ExperienceEvent-scheman och Luma Product Catalog Schema
Men det finns ytterligare några steg som vi måste ta i nästa lektion innan vi kan göra det.
Ytterligare resurser
Nu när du har dina scheman kartidentiteter!