DokumentationExperience PlatformModelldata i scheman

Modelldata i scheman

Last update: Thu Oct 03 2024 00:00:00 GMT+0000 (Coordinated Universal Time)
  • Ämnen:

Skapat för:

  • Nybörjare
  • Mellanliggande
  • Utvecklare

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. Metoden som Experience Platform bygger på, XDM System, används för att göra Experience Data Model-scheman tillgängliga för plattformstjänster.

Dataarkitekter måste skapa scheman utanför den här självstudiekursen, men Dataingenjörer kommer att ha ett nära samarbete 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):

https://video.tv.adobe.com/v/27105?learn=on

TIP
För en djupdykning i datamodellering i Experience Platform rekommenderar vi att du tittar på spellistan Modellera dina kundupplevelsedata med XDM, som är tillgänglig kostnadsfritt på Experience League!

Behörigheter krävs

I lektionen Konfigurera behörigheter ställer du in 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 Schemas i den vänstra navigeringen.

  3. Markera knappen Create schema högst upp till höger.
    Schema med OOTB-fältgrupp

  4. I arbetsflödet för att skapa schema väljer du Individual Profile som basklass för ditt schema, eftersom vi modellerar attribut för en enskild kund (punkter, status och så vidare).

  5. Välj Next.
    Välj basklass

  6. Ange Luma Loyalty Schema i textfältet Schema display name. På arbetsytan nedan kan du även granska och verifiera grundschemastrukturen som tillhandahålls av den klass du har valt.

  7. Välj Finish om du vill skapa ditt schema.
    Slutför skapandet av bonusschemat

Lägg till standardfältgrupper

När schemat har skapats omdirigeras du till schemaredigeraren där du kan lägga till fält i schemat. Du kan lägga till enskilda fält direkt i schemat eller använda fältgrupper. Observera att alla enskilda fält fortfarande är kopplade till en klass eller fältgrupp. 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 viktigt att du tar reda på vilken av dina egna data som ska samlas in i Platform och hur de ska modelleras. Det här stora avsnittet diskuteras mer ingående i spellistan Modellera dina kundupplevelsedata med XDM. I den här självstudiekursen kommer jag att vägleda dig genom implementeringen av några förbestämda scheman.

Så här lägger du till fältgrupper:

  1. Välj Add under rubriken Field Groups.
    Lägg till en ny fältgrupp

  2. Välj följande fältgrupper i Add Field groups modal:

    1. Demographic Details för grundläggande kunddata som namn och födelsedatum
    2. Personal Contact Details om du vill ha grundläggande kontaktinformation som e-postadress och telefonnummer

  3. Du kan förhandsgranska fälten i fältgruppen genom att markera ikonen till höger om raden.
    Välj standardfältgrupper

  4. Markera rutan Industry > Retail om du vill visa branschspecifika fältgrupper.

  5. Välj Loyalty Details om du vill lägga till fälten för bonusprogram.

  6. Välj Add field groups om du vill lägga till alla tre fältgrupperna 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.

Välj Save om du vill spara schemat.
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 har definierats i schemat betyder det inte att data för det måste hämtas senare. Du kan även ta bort fältet från schemat.

Lägga till en anpassad fältgrupp

Nu ska vi skapa en anpassad fältgrupp.

Medan lojalitetsfältgruppen innehöll ett loyaltyID-fält vill Luma 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. Du kan antingen:

  • Lägg till ett nytt anpassat fält i schemat först och skapa sedan en anpassad fältgrupp, eller
  • Skapa först en anpassad fältgrupp och lägg sedan till fält i den.

I den här självstudiekursen börjar vi med att skapa en anpassad fältgrupp.

Så här skapar du fältgruppen:

  1. Välj Add under rubriken Schema Field Groups
    Lägg till en ny fältgrupp
  2. Välj Create new field group
  3. Använd Luma Identity profile field group som Display name
  4. Använd system identifiers for XDM Individual Profile class som Description
  5. Välj Add field groups
    Lägg till en ny fältgrupp

Den nya, tomma fältgruppen läggs till i ditt schema. Knapparna + 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. Lägg till information om det nya fältet i sidofältet Field properties:

    1. Field name: systemIdentifier

    2. Display name: System Identifier

    3. Type: Object

    4. I listrutan Field Group väljer du den Luma Identity-profilfältgrupp som vi har skapat.

      Lägg till en ny fältgrupp

    5. Välj Apply

      Använd nya fältegenskaper

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

  1. Första fältet

    1. Field name: loyaltyId
    2. Display name: Loyalty Id
    3. Type: String

  2. Andra fältet

    1. Field Name: crmId
    2. Display Name: CRM Id
    3. Type: String

Din nya fältgrupp bör se ut så här. Välj knappen Save om du vill spara ditt schema, men lämna schemat öppet för nästa övning.
Förmånsfältgruppen har slutförts

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 tillämpa standarddatadefinitioner i flera system. Men de kan bara återanvändas i scheman som delar en klass, i det här fallet klassen för enskild XDM-profil.

Datatypen är en annan flerfältskonstruktor som kan återanvändas i scheman över flera klasser. Låt oss konvertera vårt nya systemIdentifier-objekt till en datatyp:

Med Luma Loyalty Schema fortfarande öppen markerar du objektet systemIdentifier och väljer Convert to new data type

Förmånsfältgruppen har slutförts

Om du Cancel lämnar schemat och navigerar till fliken Data types ser du din nya datatyp. Vi kommer att använda den här datatypen senare i lektionen.

Förmånsfältgruppen har slutförts

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 klassen Individual Profile
  2. Ge den namnet 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. Om du inte har någon åtkomsttoken öppnar du begäran OAuth: Request Access Token och väljer 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 dina egna anpassade element i Platform, till exempel skapa ett schema.

  4. Välj Spara
    Ändra CONTAINER_ID till klient

  5. Öppna begäran Schema Registry API > Schemas > Create a new custom schema.

  6. Öppna fliken Brödtext och klistra in följande kod och välj Skicka för att göra API-anropet. 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
    Namnområdesreferenserna i detta och efterföljande kodexempel (till exempel https://ns.adobe.com/xdm/context/profile) kan hämtas med list-API-anrop med CONTAINER_ID och acceptera sidhuvudet inställt på rätt värden. Vissa är också lättåtkomliga i användargränssnittet.

  7. Du bör få ett 201 Created-svar

  8. Kopiera meta:altId från svarstexten. 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
Du kan även hämta meta:altId- eller schema-ID:t genom att göra API-begäran Schema Registry API > Schemas > Retrieve a list of schemas within the specified container. med CONTAINER_ID inställd på tenant och ett accept-huvud application/vnd.adobe.xdm+json.
TIP
Vanliga problem med detta samtal och troliga fixar:
  • Ingen autentiseringstoken: Kör OAuth: Begär åtkomsttoken-begäran för att generera en ny token
  • 401: Not Authorized to PUT/POST/PATCH/DELETE for this path : /global/schemas/: Uppdatera miljövariabeln CONTAINER_ID 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. Öppna begäran Schema Registry API > Schemas > Update one or more attributes of a custom schema specified by ID. i Postman

  2. Klistra in värdet meta:altId från föregående svar som SCHEMA_ID på fliken Params

  3. Öppna fliken Brödtext och klistra in följande kod och välj Skicka för att göra API-anropet. Det här anropet lägger till standardfältgrupperna i din 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 ska vi lägga till Luma Identity profile field group i 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 begäran Schema Registry API > Field groups > Retrieve a list of field groups within the specified container.

  2. Välj knappen Skicka om du vill hämta en lista över alla anpassade fältgrupper i ditt konto

  3. Hämta $id-värdet för Luma Identity profile field group (ditt värde skiljer sig från värdet i den här skärmbilden)
    Hämta listan med fältgrupper

  4. Öppna begäran Schema Registry API > Schemas > Update one or more attributes of a custom schema specified by ID. igen

  5. Fliken Params bör fortfarande ha $id för ditt schema

  6. Öppna fliken Brödtext och klistra in följande kod som ersätter värdet $ref med värdet $id för din 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ägger 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 skapar vi ett schema baserat på klassen Experience Event för Lumas offlineköp. 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 klassen Experience Event.
  2. Namnge schemat Luma Offline Purchase Events Schema.
  3. Lägg till standardfältgruppen Commerce Details för att hämta information om vanliga order. Tillbringa några minuter med att utforska objekten inuti.
  4. 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!
  5. Markera alternativknappen Create new field group
  6. Ange Display name som Luma Identity ExperienceEvent field group och välj knappen Add field groups
  7. Välj + bredvid schemats namn.
  8. Ange systemIdentifier som Field Name.
  9. Ange System Identifier som Display Name.
  10. Som Type väljer du System Identifier, som är den anpassade datatypen som du skapade tidigare.
  11. Som Field Group väljer du Luma Identity ExperienceEvent-fältgruppen.
  12. Markera knappen Apply.
  13. Markera knappen Save.

Observera hur datatypen lade till alla fält!

Lägg till datatypen i fältgruppen

Välj också XDM ExperienceEvent under rubriken Class och inspektera några av fälten som klassen bidragit med. 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
Experience Event
Schemanamn
Schema för webbhändelser i Luma
Fältgrupp
AEP Web SDK ExperienceEvent
Fältgrupp
Consumer Experience Event

Markera fältgruppen Consumer Experience Event. Den här fältgruppen innehåller objekten commerce och productListItems som också fanns i Commerce Details. Consumer Experience Event är en kombination av flera andra standardfältgrupper som också är tillgängliga separat. Fältgruppen AEP Web SDK ExperienceEvent 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 i det här schemat. Det beror på att Web SDK har ett annat sätt att samla in identiteter. Om du väljer klassen XDM ExperienceEvent i avsnittet Composition i schemaredigeraren kommer du att märka att ett av fälten som läggs till som standard kallas 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 fältgrupperna Commerce Details och Consumer Experience Event rapporterar Luma 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. Markera knappen Create schema.

  2. Välj alternativet Other i arbetsflödet Skapa schema.
    Skapa nytt schema

  3. Markera knappen Create class

  4. Ge den namnet Luma Product Catalog Class

  5. Lämna Behavior som Record

  6. Markera knappen Create.
    Skapa ny klass

  7. Den Luma-produktkatalogklass som du har skapat visas i tabellen Classes nedan. Kontrollera att klassen är markerad och välj sedan Next.
    Ny klass har lagts till

  8. Namnge schemat Luma Product Catalog Schema.

  9. Skapa en ny field group med namnet 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 | Obligatoriskt
    5. productSize: Produktstorlek: String
    6. productPrice: Product Price: Double

  10. schemat Save

Ditt nya schema bör se ut så här. Observera hur fältet productSku visas i avsnittet Required fields:
Produktschema

Nästa steg är att definiera relationen mellan de två ExperienceEvent-scheman och Luma Product Catalog Schema, men det finns några ytterligare 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 kan du mappa identiteter!

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