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

TIP
För en djupdykning i datamodellering i Experience Platform rekommenderar vi att du tar kursen Modellera era kundupplevelsedata med XDM, kan köpas kostnadsfritt på Experience League!

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 till vänster navigering
  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.).
    Schema med OOTB-fältgrupp

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.
    Välj standardfältgrupper

  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.
    Lägg till standardfältgrupper i bonusschema

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:

  1. Markera schemats översta nod.
  2. Retur Luma Loyalty Schema som Visningsnamn.
  3. Välj Spara.
    Namnge och spara schemat
NOTE
Det är okej om en fältgrupp lägger till ett fält för en datapunkt som du inte samlar in. "faxPhone" kan till exempel vara ett fält där Luma inte samlar in data. Det är okej. Bara för att ett fält är definierat i schemat betyder det inte att data för det måste bli inkapslad senare.

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:

  1. Välj Lägg till under Fältgrupper för schema rubrik
    Lägg till en ny fältgrupp
  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
    Lägg till en ny fältgrupp

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 till en ny fältgrupp

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.
Fältgruppen Förmåner har slutförts

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

Fältgruppen Lojalitet slutförd

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.

Fältgruppen Lojalitet slutförd

Skapa CRM-schema via API

Nu ska vi skapa ett schema med API:t.

TIP
Om du föredrar att hoppa över API-övningen kan du skapa följande schema med metoden för användargränssnittet:
  1. Använd Individuell XDM-profil class
  2. Ge den ett namn Luma CRM Schema
  3. Använd följande fältgrupper: Demografiska uppgifter, personliga kontaktuppgifter och Luma Identity-profilgrupp

Först skapar vi det tomma schemat:

  1. Öppna Postman

  2. Ö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.

  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
    Ändra CONTAINER_ID till klient

  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 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.
  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.
    Skapa CRM-schemat

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

NOTE
The 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.
TIP
Vanliga problem med detta samtal och troliga fixar:
  • 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ån global till tenant
  • 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:

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

    Standardfältgrupper har lagts till

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)
    Hämta listan med fältgrupper

  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:

    code language-json
    [{
      "op": "add",
      "path": "/allOf/-",
      "value": {
        "$ref": "REPLACE_WITH_YOUR_OWN_FIELD_GROUP_ID"
      }
    }]
    
  7. Välj Skicka
    Lägga till identitetsfältgruppen

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!

Lägg till datatypen i fältgruppen

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:

Experience Event Base-struktur

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

Egenskap
Värde
Klass
XDM ExperienceEvent
Fältgrupp
AEP Web SDK ExperienceEvent Mixin
Fältgrupp
Consumer Experience Event
Schemanamn
Schema för webbhändelser i Luma

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.

NOTE
Om du är en befintlig Analytics- eller Target-kund är klassificering av enheter med schemarelationer detsamma som SAINT-klassificeringar eller överföring av din produktkatalog för Recommendations

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
    Skapa nytt schema

  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
    Skapa ny klass

  6. Skapa ett nytt fältgrupp anropad Luma Product Catalog field group med följande fält:

    1. productName: Produktnamn: String
    2. productCategory: Product Category: String
    3. productColor: Produktfärg: String
    4. productSku: Product SKU: String | Krävs
    5. productSize: Produktstorlek: String
    6. productPrice: Product Price: Double
  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:
Produktschema

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

Nu när du har dina scheman kartidentiteter!

recommendation-more-help
513160b6-bf42-4c58-abdd-4f817b1cccad