DocumentatieExperience PlatformModelgegevens in schema's

Modelgegevens in schema's

Last update: Tue Jul 16 2024 00:00:00 GMT+0000 (Coordinated Universal Time)
  • Onderwerpen:

Gemaakt voor:

  • Beginner
  • tussenpersoon
  • Ontwikkelaar

In deze les, zult u de gegevens van Luma in schema's modelleren. Dit is een van de langste lessen in de zelfstudie, dus maak een glas water en sluit op!

Standaardisering en interoperabiliteit zijn de belangrijkste concepten achter Adobe Experience Platform. Het Model van Gegevens van de ervaring (XDM) is een inspanning om de gegevens van de klantenervaring te standaardiseren en schema's voor het beheer van de klantenervaring te bepalen.

XDM is een openbaar gedocumenteerde specificatie die wordt ontworpen om de macht van digitale ervaringen te verbeteren. Het verstrekt gemeenschappelijke structuren en definities voor om het even welke toepassing om met de diensten van het Platform te gebruiken te communiceren. Door zich aan de normen van XDM te houden, kunnen alle gegevens van de klantenervaring in een gemeenschappelijke vertegenwoordiging worden opgenomen die inzichten op een snellere, meer geïntegreerde manier kan leveren. U kunt waardevolle inzichten van klantenacties bereiken, klantenpubliek door segmenten bepalen, en klantenattributen voor verpersoonlijkingsdoeleinden uitdrukken.

XDM is het grondkader dat Adobe Experience Cloud, aangedreven door Experience Platform, toestaat om het juiste bericht aan de juiste persoon, op het juiste kanaal, op precies het juiste moment te leveren. De methodologie waarop het Experience Platform wordt gebouwd, XDM Systeem, stelt de Modelschema's van Gegevens van de Ervaring voor gebruik door de diensten van het Platform in werking.

Architecten van Gegevens zullen schema's buiten dit leerprogramma moeten tot stand brengen, maar de Ingenieurs van Gegevens zullen nauw met de schema's werken die door de Architect van Gegevens worden gecreeerd.

Voordat u met de oefeningen begint, bekijk deze korte video om meer over schema's en het Model van de Gegevens van de Ervaring te leren (XDM):

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

TIP
Voor een diepere duik in gegevens modellering in Experience Platform, adviseren wij het nemen van het cursus ModelUw Gegevens van de Ervaring van de Klant met XDM, beschikbaar voor vrij op Experience League!

Vereiste machtigingen

In vorm toestemmingenles, u opstelling alle toegangscontroles die worden vereist om deze les te voltooien.

Loyalty-schema maken via gebruikersinterface

In deze oefening, zullen wij een schema voor de loyaliteitsgegevens van Luma tot stand brengen.

  1. Ga naar de gebruikersinterface van het Platform en zorg ervoor dat uw zandbak wordt geselecteerd.

  2. Ga naar Schemas in de linkernavigatie.

  3. Selecteer de knop Create schema rechtsboven.
    Schema met OTB de groep van het Gebied

  4. Selecteer in de workflow Schema maken Individual Profile als basisklasse voor uw schema, omdat we kenmerken van een individuele klant (punten, status, enzovoort) gaan modelleren.

  5. Selecteer Next.
    Uitgezochte basisklasse

  6. Voer Luma Loyalty Schema in het tekstveld Schema display name in. In het onderstaande canvas kunt u ook de basisschemastructuur bekijken en verifiëren die wordt geleverd door de klasse die u hebt gekozen.

  7. Selecteer Finish om uw schema te maken.
    Einde creërend het loyaliteitsschema

Standaardveldgroepen toevoegen

Zodra het schema wordt gecreeerd, zult u aan de redacteur van het Schema worden opnieuw gericht waar u gebieden aan het schema kunt toevoegen. U kunt afzonderlijke velden rechtstreeks aan het schema toevoegen of veldgroepen gebruiken. Houd er rekening mee dat alle afzonderlijke velden nog steeds zijn gekoppeld aan een klasse of veldgroep. U kunt kiezen uit een groot aantal industriestandaard veldgroepen die door Adobe worden geleverd, of u kunt uw eigen veldgroepen maken. Wanneer u uw eigen gegevens in het Experience Platform gaat modelleren, is het goed om vertrouwd te raken met de industriestandaard veldgroepen die door de Adobe worden geleverd. Waar mogelijk, is het beste praktijken om hen te gebruiken aangezien zij soms stroomafwaartse diensten, zoals KlantenAI, Attribution AI, en Adobe Analytics aandrijven.

Wanneer u met uw eigen gegevens werkt, is het belangrijk te bepalen welke van uw eigen gegevens in Platform moeten worden vastgelegd en hoe deze moeten worden gemodelleerd. Dit grote onderwerp wordt besproken meer diepgaand in de cursus ModelUw Gegevens van de Ervaring van de Klant met XDM. In deze zelfstudie zal ik u enkel door de implementatie van sommige vooraf bepaalde schema's begeleiden.

Veld toevoegen:

  1. Selecteer Add onder de kop Field Groups .
    voeg een nieuwe gebiedsgroep toe

  2. Selecteer in het modaal Add Field groups de volgende veldgroepen:

    1. Demographic Details voor basisklantgegevens zoals naam en geboortedatum
    2. Personal Contact Details voor standaardcontactgegevens zoals e-mailadres en telefoonnummer

  3. U kunt een voorvertoning van de toegevoegde velden weergeven in de veldgroep door het pictogram aan de rechterkant van de rij te selecteren.
    Uitgezochte standaardgebiedsgroepen

  4. Schakel het selectievakje Industry > Retail in om industriespecifieke veldgroepen beschikbaar te maken.

  5. Selecteer Loyalty Details om de velden voor het loyaliteitsprogramma toe te voegen.

  6. Selecteer Add field groups om alle drie veldgroepen aan het schema toe te voegen.
    voeg standaardgebiedsgroepen aan loyaliteitsschema toe

Nu, neem wat tijd om de huidige staat van het schema te onderzoeken. De veldgroepen hebben standaardvelden toegevoegd die betrekking hebben op een persoon, de contactgegevens en de status van het loyaliteitsprogramma. Deze twee veldgroepen zijn wellicht handig wanneer u schema's voor de gegevens van uw eigen bedrijf maakt. Selecteer een specifieke veldgroeprij of schakel het selectievakje naast de naam van de veldgroep in om te zien hoe de visualisatie verandert.

Selecteer Save om het schema op te slaan.
sparen het schema

NOTE
Het is oké als een veldgroep een veld toevoegt voor een gegevenspunt dat u niet verzamelt. 'faxPhone' kan bijvoorbeeld een veld zijn waarvoor Luma geen gegevens verzamelt. Dat is prima. Enkel omdat een gebied in het schema wordt bepaald betekent niet dat de gegevens voor het ** later op moeten worden opgenomen. U kunt het veld ook uit het schema verwijderen.

Een aangepaste veldgroep toevoegen

Laten we nu een aangepaste veldgroep maken.

Terwijl de groep van het loyaliteitsgebied een loyaltyID gebied bevatte, zou Luma al hun systeemherkenningstekens in één enkele groep willen beheren helpen consistentie over hun schema's verzekeren.

Veldgroepen moeten worden gemaakt in de schemaworkflow. U kunt:

  • Voeg eerst een nieuw aangepast veld toe aan uw schema en maak vervolgens een aangepaste veldgroep, of
  • Maak eerst een aangepaste veldgroep en voeg daar vervolgens velden aan toe.

In deze zelfstudie beginnen we met het maken van een aangepaste veldgroep.

De veldgroep maken:

  1. Add selecteren onder de kop Schema Field Groups
    voeg een nieuwe gebiedsgroep toe
  2. Selecteren Create new field group
  3. Luma Identity profile field group gebruiken als de Display name
  4. system identifiers for XDM Individual Profile class gebruiken als de Description
  5. Selecteren Add field groups
    voeg een nieuwe gebiedsgroep toe

De nieuwe, lege veldgroep wordt toegevoegd aan uw schema. Met de knoppen + kunt u nieuwe velden toevoegen aan elke locatie in de hiërarchie. In ons geval willen we velden toevoegen op het hoofdniveau:

  1. Selecteer + naast de naam van het schema. Hiermee wordt een nieuw veld onder de naamruimte voor id van een huurder toegevoegd voor het beheer van conflicten tussen uw aangepaste velden en standaardvelden.

  2. Voeg in de zijbalk Field properties de details van het nieuwe veld toe:

    1. Field name: systemIdentifier

    2. Display name: System Identifier

    3. Type: Object

    4. In Field Group dropdown selecteer de Luminantiegids de groep van het profielgebied van de Identiteit die wij hebben gecreeerd.

      voeg een nieuwe gebiedsgroep toe

    5. Selecteren Apply

      pas nieuwe gebiedseigenschappen toe

Voeg nu twee velden toe onder het object systemIdentifier :

  1. Eerste veld

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

  2. Tweede veld

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

Uw nieuwe veldgroep moet er zo uitzien. Selecteer de knop Save om het schema op te slaan, maar laat het schema open voor de volgende oefening.
Volledige de gebiedsgroep van de Loyalty

Een gegevenstype maken

Veldgroepen, zoals uw nieuwe Luma Identity profile field group , kunnen in andere schema's opnieuw worden gebruikt, zodat u standaardgegevensdefinities op meerdere systemen kunt toepassen. Maar zij kunnen slechts in schema's worden opnieuw gebruikt die een klasse delen, in dit geval de individuele klasse van het Profiel XDM.

Het gegevenstype is een andere multifield constructie die in schema's over veelvoudige klassen kan worden opnieuw gebruikt. Laten we ons nieuwe systemIdentifier -object omzetten in een gegevenstype:

Zorg dat Luma Loyalty Schema nog steeds is geopend en selecteer het systemIdentifier -object en selecteer Convert to new data type

Volledige de gebiedsgroep van de Loyalty

Als u het schema Cancel verlaat en naar het tabblad Data types navigeert, ziet u het nieuwe gegevenstype. Dit gegevenstype wordt later in de les gebruikt.

Volledige de gebiedsgroep van de Loyalty

CRM-schema maken via API

Nu maken we een schema met de API.

TIP
Als u liever de API-oefening overslaat, kunt u het volgende schema maken met de gebruikersinterfacemethode:
  1. De klasse Individual Profile gebruiken
  2. Naam geven Luma CRM Schema
  3. Gebruik de volgende veldgroepen: Demografische details, Persoonlijke contactgegevens en Luminimitatieprofielveldgroep

Eerst maken we het lege schema:

  1. Openen Postman

  2. Als u geen toegangstoken hebt, open het verzoek OAuth: Request Access Token en selecteer verzend om een nieuw toegangstoken te verzoeken.

  3. Open uw milieuvariabelen en verander de waarde van CONTAINER_ID van global in tenant. Vergeet niet dat u tenant moet gebruiken wanneer u met uw eigen aangepaste elementen in Platform wilt werken, zoals het maken van een schema.

  4. Selecteer sparen
    verander CONTAINER_ID in huurder

  5. De aanvraag openen Schema Registry API > Schemas > Create a new custom schema.

  6. Open het Lichaam lusje en kleef de volgende code en selecteer verzenden om de API vraag te maken. Met deze aanroep wordt een nieuw schema gemaakt met dezelfde basisklasse XDM Individual Profile :

    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
    De naamruimteverwijzingen in dit en volgende codevoorbeelden (bijvoorbeeld https://ns.adobe.com/xdm/context/profile ) kunnen worden verkregen door API-aanroepen van lijsten te gebruiken met de CONTAINER_ID en koptekst te accepteren die is ingesteld op de juiste waarden. Sommige zijn ook gemakkelijk toegankelijk in het gebruikersinterface.

  7. U krijgt een 201 Created reactie

  8. Kopieer meta:altId uit de hoofdtekst van de reactie. We zullen het later in een andere oefening gebruiken.
    creeer het schema van CRM

  9. Het nieuwe schema moet zichtbaar zijn in de gebruikersinterface, maar zonder veldgroepen
    creeer het schema van CRM

NOTE
De id van meta:altId of schema kan ook worden verkregen door de API-aanvraag Schema Registry API > Schemas > Retrieve a list of schemas within the specified container. in te dienen met de instelling CONTAINER_ID op tenant en een accept header application/vnd.adobe.xdm+json .
TIP
Gemeenschappelijke kwesties met deze vraag en waarschijnlijke moeilijke situaties:
  • Geen autetoken: stel OAuth in werking: Verzoek om Token van de Toegang verzoek om een nieuw token te produceren
  • 401: Not Authorized to PUT/POST/PATCH/DELETE for this path : /global/schemas/: Werk CONTAINER_ID milieu variabele van global aan tenant bij
  • 403: PALM Access Denied. POST access is denied for this resource from access control: controleer uw gebruikersmachtigingen in de Admin Console

Standaardveldgroepen toevoegen

Nu is het tijd om de gebiedsgroepen aan het schema toe te voegen:

  1. Open in Postman de aanvraag Schema Registry API > Schemas > Update one or more attributes of a custom schema specified by ID.

  2. In het lusje van Params, kleef de meta:altId waarde van de vorige reactie als SCHEMA_ID

  3. Open het lusje van het Lichaam en kleef de volgende code en selecteer verzend om de API vraag te maken. Met deze aanroep worden de standaardveldgroepen aan uw Luma CRM Schema toegevoegd:

    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. U zou een 200 O.K. status voor de reactie moeten krijgen en de gebiedsgroepen zouden als deel van uw schema in UI zichtbaar moeten zijn

    Standaard toegevoegde gebiedsgroepen

Aangepaste veldgroep toevoegen

Nu voegen wij Luma Identity profile field group aan het schema toe. Ten eerste moeten we de id van onze nieuwe veldgroep vinden met een lijst-API:

  1. De aanvraag openen Schema Registry API > Field groups > Retrieve a list of field groups within the specified container.

  2. Selecteer verzenden knoop om een lijst van alle groepen van het douanegebied in uw rekening terug te winnen

  3. Pak de $id waarde van Luma Identity profile field group in (de waarde die u krijgt, verschilt van de waarde in deze schermafbeelding)
    wint de lijst van gebiedsgroepen terug

  4. Open de aanvraag opnieuw Schema Registry API > Schemas > Update one or more attributes of a custom schema specified by ID.

  5. Het lusje van Params zou nog $id van uw schema moeten hebben

  6. Open het lusje van het Lichaam en kleef de volgende code, die de $ref waarde met $id van uw vervangt Luma Identity profile field group:

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

  7. Selecteer verzenden
    Toevoegend de groep van het Gebied van de Identiteit

Controleer of de veldgroep aan het schema is toegevoegd door zowel de API-reactie als de interface te controleren.

Offline schema Aankoopgebeurtenissen maken

Laten we nu een schema maken op basis van de klasse Experience Event voor de aanschafgegevens voor offline gebruik van Luma. Aangezien u nu vertrouwd met het gebruikersinterface van de schemaredacteur wordt, zal ik het aantal screenshots in de instructies verminderen:

  1. Maak een schema met de klasse Experience Event .
  2. Geef het schema een naam Luma Offline Purchase Events Schema.
  3. Voeg de standaardveldgroep Commerce Details toe om algemene orderdetails vast te leggen. Besteed een paar minuten om de objecten daarbinnen te verkennen.
  4. Zoeken naar Luma Identity profile field group . Het is niet beschikbaar! Herinner dat de gebiedsgroepen aan een klasse gebonden zijn, en aangezien wij een verschillende klasse voor dit schema gebruiken kunnen wij het niet gebruiken. We moeten een nieuwe veldgroep toevoegen voor de klasse XDM ExperienceEvent die de identiteitsvelden bevat. Ons gegevenstype maakt dat echt gemakkelijk!
  5. Het keuzerondje Create new field group selecteren
  6. Voer de Display name as Luma Identity ExperienceEvent field group in en selecteer de knop Add field groups
  7. Selecteer + naast de naam van het schema.
  8. Voer systemIdentifier in als de Field Name .
  9. Voer System Identifier in als de Display Name .
  10. Als Type, uitgezochte Identifier van het Systeem die het type van douanegegevens is u vroeger creeerde.
  11. Als Field Group uitgezocht Luma het gebiedsgroep van Identity ExperienceEvent.
  12. Selecteer de knop Apply.
  13. Selecteer de knop Save.

Houd er rekening mee hoe het gegevenstype alle velden heeft toegevoegd!

voeg het gegevenstype aan de gebiedsgroep toe

Selecteer ook XDM ExperienceEvent onder de kop Class en inspecteer enkele velden die door deze klasse worden toegevoegd. _id- en tijdstempelvelden zijn vereist bij gebruik van de XDM ExperienceEvent-klasse. Deze velden moeten worden ingevuld voor elke record die u opgeeft bij gebruik van dit schema:

de Structuur van de Basis van de Gebeurtenis van de Ervaring

Webgebeurtenissenschema maken

Nu gaan we nog een schema maken voor de websitegegevens van Luma. Op dit punt zou u een deskundige in het creëren van schema's moeten zijn! Het volgende schema samenstellen met deze eigenschappen

Eigenschap
Waarde
Klasse
Experience Event
Schemanaam
Luma-webgebeurtenissenschema
Veldgroep
AEP Web SDK ExperienceEvent
Veldgroep
Consumentenervaringsgebeurtenis

Selecteer de veldgroep Consumer Experience Event . Deze veldgroep bevat de objecten commerce en productListItems die zich ook in Commerce Details bevonden. Consumer Experience Event is een combinatie van verschillende andere standaardveldgroepen die ook afzonderlijk beschikbaar zijn. AEP Web SDK ExperienceEvent -veldgroep bevat ook andere veldgroepen, waaronder enkele van dezelfde in Consumer Experience Event . Gelukkig vloeien ze naadloos samen.

We hebben de Luma Identity ExperienceEvent field group niet aan dit schema toegevoegd. Dit komt doordat de SDK van het Web een andere manier heeft om identiteiten te verzamelen. Als u de klasse XDM ExperienceEvent selecteert in het gedeelte Composition van de schema-editor, wordt een van de velden die de klasse standaard toevoegt, IdentityMap genoemd. IdentityMap wordt gebruikt door verschillende Adobe toepassingen om aan Platform te verbinden. U zult zien hoe identiteiten via identityMap naar Platform worden verzonden in de streaming opname les.

Productcatalogusschema maken

Door de Commerce Details en Consumer Experience Event gebiedsgroepen te gebruiken, meldt Luma sommige details van product-verwante gebeurtenissen via het standaardproductListItems gegevenstype. Maar ze hebben ook extra productdetailvelden die ze naar Platform willen sturen. In plaats van al deze velden op te nemen in hun verkooppunten en e-commercesystemen, zou Luma liever deze velden rechtstreeks uit hun productcatalogussysteem innemen. Een "schemaverhouding"staat u toe om een verhouding tussen twee schema's voor classificaties of raadplegingen te bepalen. Luma gebruikt een relatie om hun productdetails in te delen. We beginnen het proces nu en voltooien het aan het einde van de volgende les.

NOTE
Als u een bestaande klant van Analytics of van het Doel bent, is het classificeren van entiteiten met schemaverhoudingen analoog aan SAINT classificaties of het uploaden van uw productcatalogus voor Recommendations

Eerst moeten we een schema voor de productcatalogus van Luma maken met behulp van een aangepaste klasse:

  1. Selecteer de knop Create schema.

  2. Selecteer de optie Other in de workflow Schema maken.
    creeer nieuw Schema

  3. Selecteer de knop Create class

  4. Naam geven Luma Product Catalog Class

  5. De Behavior behouden als Record

  6. Selecteer de knop Create.
    creeer nieuwe Klasse

  7. De Klasse van de Catalogus van het Product van de Luma u hebt gecreeerd verschijnt in de lijst van Klassen hieronder. Zorg ervoor dat de klasse is geselecteerd en selecteer vervolgens Next .
    Nieuwe toegevoegde Klasse

  8. Geef het schema een naam Luma Product Catalog Schema .

  9. Maak een nieuwe field group genaamd Luma Product Catalog field group met de volgende velden:

    1. productName: Product Name: String
    2. productCategorie: Productcategorie: String
    3. productColor: Product Color: String
    4. productSku: Product SKU: String | Vereist
    5. productSize : Product Size : String
    6. productPrice: Product Price: Double

  10. Save het schema

Uw nieuwe schema zou als dit moeten kijken. Let op hoe het veld productSku wordt weergegeven in de sectie Required fields :
Het Schema van het Product

De volgende stap bestaat uit het definiëren van de relatie tussen de twee ExperienceEvent-schema's en de Luma Product Catalog Schema . Er zijn echter een paar extra stappen die we in de volgende les moeten ondernemen voordat we dat kunnen doen.

Aanvullende bronnen

Nu u uw schema's hebt kunt u kaartidentiteiten!

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