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.

1. Gå till användargränssnittet för plattformen och se till att din sandlåda är markerad.
2. Gå till Scheman i den vänstra navigeringen
3. Välj Skapa schema överst till höger
4. 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:

1. I Lägg till fältgrupper modal, välj följande fältgrupper:

   1. Demografiska detaljer för grundläggande kunddata som namn och födelsedatum
   2. Kontaktinformation, privat för grundläggande kontaktinformation som e-postadress och telefonnummer

2. Du kan förhandsgranska fälten i fältgruppen genom att markera ikonen till höger om raden.
   

3. Kontrollera Bransch > Detaljhandel för att visa branschspecifika fältgrupper.

4. Välj Lojalitet om du vill lägga till fälten för bonusprogram.

5. 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 ditt företags data. Markera en specifik fältgruppsrad eller markera kryssrutan bredvid fältgruppnamnet för att se hur visualiseringen ändras.

Så här sparar du schemat:

1. Markera schemats översta nod.
2. Retur Luma Loyalty Schema som Visningsnamn.
3. Välj Spara.
   

Lägg 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:

1. Välj Lägg till under Fältgrupper för schema rubrik
   

2. Välj Skapa ny fältgrupp

3. Använd Luma Identity profile field group som Visningsnamn

4. Använd system identifiers for XDM Individual Profile class som Beskrivning

5. 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å:

1. 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.

2. I Fältegenskaper sidofältet lägger till information om det nya fältet:

   1. Fältnamn: systemIdentifier
   2. Visningsnamn: System Identifier
   3. Typ: Objekt
   4. Välj Använd

   

Lägg nu till två fält under systemIdentifier objekt:

1. Första fältet
   1. Fältnamn: loyaltyId
   2. Visningsnamn: Loyalty Id
   3. Typ: Sträng
2. Andra fältet
   1. Fältnamn: crmId
   2. Visningsnamn: CRM Id
   3. Typ: Sträng

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 groupkan å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 omvandla 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.

Först skapar vi det tomma schemat:

1. Öppna Postman

2. Om du inte har gjort någon begäran de senaste 24 timmarna har din auktoriseringstoken antagligen gått ut. Öppna förfrågan Adobe I/O Access Token Generation > Local Signing (Non-production use-only) > IMS: JWT Generate + Auth via User Token och markera Skicka för att begära nya JWT- och Access-token.

3. Öppna dina miljövariabler och ändra värdet för CONTAINER_ID från global till tenant. Kom ihåg att du måste använda tenant när du vill interagera med egna anpassade element i plattformen, till exempel skapa ett schema.

4. Välj Spara
   

5. Öppna förfrågan Schema Registry API > Schemas > Create a new custom schema.

6. Öppna Brödtext och klistra in följande kod och markera Skicka för att göra API-anropet. Det här anropet skapar ett nytt schema med samma XDM Individual Profile basklass:

   {
     "type": "object",
     "title": "Luma CRM Schema",
     "description": "Schema for CRM data of Luma Retail ",
     "allOf": [{
       "$ref": "https://ns.adobe.com/xdm/context/profile"
     }]
   }
   

   OBSERVERA

   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.

7. Du borde skaffa en 201 Created svar

8. Kopiera meta:altId från svarsorganet. Vi kommer att använda den senare i en annan övning.
   

9. Det nya schemat ska vara synligt i användargränssnittet, men utan fältgrupper
   

Lägg till standardfältgrupper

Nu är det dags att lägga till fältgrupperna i schemat:

1. I Postman, Öppna förfrågan Schema Registry API > Schemas > Update one or more attributes of a custom schema specified by ID.

2. I Parametrar flik, klistra in meta:altId värdet från föregående svar som SCHEMA_ID

3. Öppna fliken Brödtext och klistra in följande kod och markera Skicka för att göra API-anropet. Detta anrop lägger till standardfältgrupperna i Luma CRM Schema:

   [{
       "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"
       }
     }
   ]
   

4. 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:

1. Öppna förfrågan Schema Registry API > Field groups > Retrieve a list of field groups within the specified container.

2. Välj Skicka för att hämta en lista över alla anpassade fältgrupper i ditt konto

3. 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)
   

4. Öppna förfrågan Schema Registry API > Schemas > Update one or more attributes of a custom schema specified by ID. igen

5. The Parametrar ska fortfarande ha $id av ditt schema

6. Öppna Brödtext och klistra in följande kod, ersätta $ref värdet med $id på egen hand Luma Identity profile field group:

   [{
     "op": "add",
     "path": "/allOf/-",
     "value": {
       "$ref": "REPLACE_WITH_YOUR_OWN_FIELD_GROUP_ID"
     }
   }]
   

7. 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:

1. Skapa ett schema med XDM ExperienceEvent class
2. Lägg till standardfältgruppen Handelsinformation om du vill hämta information om vanliga order. Tillbringa några minuter med att utforska objekten inuti.
3. 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!
4. Välj Skapa ny fältgrupp alternativknapp
5. Ange Visningsnamn as Luma Identity ExperienceEvent field group och väljer Lägg till fältgrupper knapp
6. Se till att + knapparna visas på i Struktur så att du kan lägga till nya fält
7. I Struktur avsnitt, markera + på schemats översta nivå
8. Som Fältnamn, ange systemIdentifier
9. Som Visningsnamn, ange System Identifier
10. Som Typ, markera Systemidentifierare som är en anpassad datatyp som du skapade tidigare
11. Välj Använd knapp
12. Namnge ditt schema Luma Offline Purchase Events Schema
13. 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 det här schemat. 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. Istä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:

1. Välj Skapa schema och väljer Bläddra i listrutan
   
2. Välj Skapa ny klass alternativknapp
3. Ge den ett namn Luma Product Catalog Class
4. Lämna Beteende as Post
5. Välj Tilldela klass knapp
   
6. Skapa ett nytt fältgrupp anropad Luma Product Catalog field group med följande fält:
   1. productName: Produktnamn: Sträng
   2. productCategory: Produktkategori: Sträng
   3. productColor: Produktfärg: Sträng
   4. productSku: Produkt-SKU: Sträng | Krävs
   5. productSize: Produktstorlek: Sträng
   6. productPrice: Produktpris: Dubbel
7. Namnge schemat Luma Product Catalog Schema (se till att uppdatera rätt fält och inte uppdatera klassnamnet)
8. 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 SchemaMen det finns ytterligare några steg som vi måste ta i nästa lektion innan vi kan göra det.

Ytterligare resurser

• Systemdokumentation för Experience Data Model (XDM)
• API för schemaregister

Nu när du har dina scheman kan du kartidentiteter!

Resurser för Business.Adobe.com