2.1.3 Visualiseer uw eigen real-time klantprofiel - API
In deze oefening, zult u Postman en Adobe I/O gebruiken om Adobe Experience Platform APIs te vragen om uw eigen real-time klantenprofiel te bekijken.
Context
In het profiel van de Klant in real time, worden alle profielgegevens getoond naast gebeurtenisgegevens, evenals bestaande publiekslidmaatschappen. De getoonde gegevens kunnen van overal, van toepassingen van Adobe en externe oplossingen komen. Dit is de krachtigste weergave in Adobe Experience Platform, het ervaringssysteem.
Het profiel van de Klant in real time kan door alle toepassingen van Adobe, maar ook door externe oplossingen zoals de Centers van de Vraag of in-store clienteling apps worden verbruikt. De manier om dit te doen is die externe oplossingen met Adobe Experience Platform APIs te verbinden.
Uw id's
In het deelvenster Profielviewer op de website kunt u meerdere identiteiten vinden. Elke identiteit is gekoppeld aan een naamruimte.
Op het röntgenpaneel, kunnen wij vier verschillende combinaties identiteitskaart en Namespaces zien:
Onthoud deze id's voor de volgende stap.
Adobe I/O-project configureren
In deze oefening zult u Adobe I/O vrij intensief aan vraag tegen Platform APIs gebruiken. Volg onderstaande stappen om Adobe I/O in te stellen.
Ga naar https://developer.adobe.com/console/home
Selecteer de juiste Adobe Experience Platform-instantie in de rechterbovenhoek van het scherm. Uw instantie is --aepImsOrgName-- . Klik creëren nieuw project.
Selecteer + toevoegen aan Project en selecteren API.
U zult dan dit zien:
Selecteer Experience Platform API en klik daarna.
Dit zie je nu. Geef een naam op voor de referentie: --aepUserLdap-- - OAuth credential . Klik daarna.
Vervolgens moet u een productprofiel selecteren waarmee wordt gedefinieerd welke machtigingen beschikbaar zijn voor deze integratie.
Selecteer de vereiste productprofielen.
Klik sparen Vormde API.
Uw Adobe I/O-integratie is nu gereed.
Klik de Download voor Postman knoop en klik dan OAuth Server-aan-Server om een milieu van Postman te downloaden (wacht tot het milieu wordt gedownload, kan dit een paar seconden) nemen.
Uw IO-project heeft momenteel een algemene naam. Je moet je integratie een vriendelijke naam geven. Klik op Project X (of gelijkaardige naam) zoals vermeld
Klik uitgeven Project.
Voer een naam en beschrijving in voor uw integratie: --aepUserLdap-- AEP Tutorial .
Klik sparen.
Uw Adobe I/O-integratie is nu voltooid.
AEP-machtigingen voor API-referentie
Ga naar Adobe Experience Platform . Na het aanmelden landt je op de homepage van Adobe Experience Platform.
Ga naar Toestemmingen, Rollen, en klik het relevante productprofiel.
Klik API geloofsbrieven.
Klik op + Add API credentials.
Selecteer het onlangs gecreeerde project van Adobe I/O en klik sparen.
Verificatie naar Adobe I/O
Ga naar https://www.postman.com/downloads/ .
Download en installeer de relevante versie van Postman voor uw besturingssysteem.
Start de toepassing nadat u Postman hebt geïnstalleerd.
In Postman zijn er twee concepten: omgevingen en verzamelingen.
-
Het milieu bevat al uw milieuvariabelen die min of meer samenhangend zijn. In het milieu, zult u dingen zoals IMSOrg van ons milieu van het Platform, naast veiligheidsgeloofsbrieven zoals uw Privé Sleutel en anderen vinden. Het omgevingsbestand is het bestand dat u tijdens de vorige Adobe I/O-installatie hebt gedownload. De naam ziet er als volgt uit:
oauth_server_to_server.postman_environment.json. -
De verzameling bevat een aantal API-aanvragen die u kunt gebruiken. We gebruiken twee verzamelingen
- 1 Verzameling voor verificatie naar Adobe I/O
- 1 Verzameling voor de oefeningen in deze module
- 1 inzameling voor de oefeningen in de module van Real-Time CDP, voor de Authoring van de Bestemming
Gelieve te downloaden het dossier postman.zip aan uw lokale Desktop.
In dit {dossier 0} postman.zip, zult u de volgende dossiers vinden:
Adobe IO - OAuth.postman_collection.jsonAEP Tutorial.postman_collection.jsonDestination_Authoring_API.json
Pak het {dossier 0} postman.zip uit en sla deze 3 dossiers in een omslag op uw Desktop, samen met het gedownloade milieu van Postman van Adobe I/O op. U hebt deze 4 bestanden nodig in die map:
Ga terug naar Postman. Klik Invoer.
Klik dossiers.
Navigeer naar de map op uw bureaublad waarin u de vier gedownloade bestanden hebt uitgepakt. Selecteer deze 4 dossiers tezelfdertijd en klik Open.
Na het klikken Open, zal Postman u een overzicht van het Milieu en de Inzamelingen tonen u op het punt staat in te voeren. Klik Invoer.
U hebt nu alles wat u nodig hebt in Postman om te gaan communiceren met Adobe Experience Platform via de API's.
Het eerste wat je moet doen, is ervoor zorgen dat je op de juiste manier geverifieerd bent. Om voor authentiek te worden verklaard, moet u om een toegangstoken verzoeken.
Zorg ervoor dat u het juiste Milieu hebt geselecteerd alvorens om het even welk verzoek uit te voeren. U kunt de momenteel geselecteerde omgeving controleren door de vervolgkeuzelijst Omgeving in de rechterbovenhoek te controleren.
De geselecteerde omgeving moet een naam hebben die vergelijkbaar is met deze, --aepUserLdap-- OAuth Credential .
Uw Postman-omgeving en -verzamelingen zijn nu geconfigureerd en werken. U kunt nu verifiëren van Postman naar Adobe I/O.
In Adobe IO - OAuth inzameling, selecteer het verzoek met de naam POST - krijg het Symbolische van de Toegang. Klik verzenden.
Na een paar seconden, zou u een reactie moeten zien die in de 1} sectie van het Lichaam {van Postman wordt getoond:
Als uw configuratie succesvol was, zou u een gelijkaardige reactie moeten zien die de volgende informatie bevat:
Adobe I/O heeft u a drager - teken, met een specifieke waarde (zeer lange access_token) en een vervalvenster gegeven.
De token die we hebben ontvangen, is nu 24 uur geldig. Dit betekent dat als u Postman na 24 uur wilt gebruiken voor verificatie voor Adobe I/O, u een nieuwe token moet genereren door dit verzoek opnieuw uit te voeren.
Real-time klantprofiel-API, schema: profiel
Nu kunt u doorgaan en uw eerste aanvraag naar de realtime-API's van het klantprofiel van Platform verzenden.
In Postman, bepaal de plaats van de inzameling Leerprogramma AEP.
In 1. De verenigde Dienst van het Profiel, klik het eerste verzoek met de naam UPS - het Profiel van GET door identiteitskaart van de Entiteit & NS.
Voor dit verzoek zijn er drie vereiste variabelen:
Dus als u Adobe Experience Platform API's wilt vragen om u alle profielgegevens voor uw eigen ECID terug te geven, moet u de aanvraag als volgt configureren:
U zou ook de Kopbal - gebieden van uw verzoek moeten verifiëren. Ga naar Kopballen. U zult dan dit zien:
--aepSandboxName-- zijn.--aepSandboxName--Zodra u de zandbaknaam hebt gecontroleerd, verzendt de klik om uw verzoek naar Platform te verzenden.
U zou een directe reactie van Platform moeten krijgen, die u iets als dit toont:
Dit is de volledige reactie van Platform:
{
"A2_ETHkJxMvxbiEmIZlAj8Qn": {
"entityId": "A2_ETHkJxMvxbiEmIZlAj8Qn",
"mergePolicy": {
"id": "64e4b0ed-dfc3-4084-8e67-643e977168d7"
},
"sources": [
"672a10cdb015162aefedfc0f",
"672a10b1a05e282aee19737c"
],
"tags": [
"0938B898-469A-4513-8E86-87464307120F:va7",
"3ba34930-405e-4b31-aafa-bac22d35203e:va7"
],
"identityGraph": [
"G7z3JAFBY4I6Rzg",
"A2_ETHkJxMvxbiEmIZlAj8Qn",
"BkFvK4QcJpSPByuDGF4UAS0wMQ",
"BUF9zMKLrXq72p4HpbsHv1SDGF4UAS0wMUBnbWFpbC5jb20",
"A29btmFXmrfrYbXQWISCT9ZD"
],
"entity": {
"_experienceplatform": {
"identification": {
"core": {
"ecid": "79943948563923140522865572770524243489",
"phoneNumber": "+32473622044+18112024-01",
"email": "woutervangeluwe+18112024-01@gmail.com"
}
}
},
"userAccount": {
"ID": "3688250"
},
"pushNotificationDetails": [
{
"denylisted": false,
"token": "2E0945F186CE5ED8CBFD1EB519A8CF38BA2B28A67FB381D45AA15EE37D289214",
"identity": {
"namespace": {
"code": "ECID"
},
"id": "70559351147248820114888181867542007989"
},
"platform": "apns",
"appID": "com.adobe.demosystem.dxdemo"
}
],
"personalEmail": {
"address": "woutervangeluwe+18112024-01@gmail.com"
},
"_repo": {
"createDate": "2024-11-18T10:39:12.296Z"
},
"extSourceSystemAudit": {
"lastUpdatedDate": "2024-11-19T07:46:52.001Z"
},
"testProfile": true,
"mobilePhone": {
"number": "+32473622044"
},
"consents": {
"metadata": {
"time": "2024-11-19T07:46:52.001Z"
},
"idSpecific": {
"ECID": {
"70559351147248820114888181867542007989": {
"collect": {
"val": "y"
}
}
}
}
},
"person": {
"name": {
"lastName": "Van Geluwe",
"firstName": "Wouter"
}
},
"userActivityRegions": {
"IRL1": {
"captureTimestamp": "2024-11-19T07:46:51.239Z"
}
},
"identityMap": {
"ecid": [
{
"id": "70559351147248820114888181867542007989"
},
{
"id": "79943948563923140522865572770524243489"
}
],
"email": [
{
"id": "woutervangeluwe+18112024-01@gmail.com"
}
],
"phone": [
{
"id": "+32473622044+18112024-01"
}
],
"userid": [
{
"id": "3688250"
}
]
}
},
"lastModifiedAt": "2024-11-19T07:47:23Z"
}
}
Dit zijn momenteel alle beschikbare profielgegevens in Platform voor deze ECID.
U hoeft de ECID niet te gebruiken om profielgegevens aan te vragen via het realtime klantprofiel van het platform. U kunt elke id in een naamruimte gebruiken om deze gegevens aan te vragen.
Laten wij terug naar Postman gaan en doen alsof wij het vraagcentrum zijn, en een verzoek verzenden naar Platform die namespace van Telefoon en uw mobiel aantal specificeren.
Dus als u aan de API's van het Platform wilt vragen om u alle profielinformatie voor een specifieke Telefoon terug te geven, zult u het verzoek als volgt moeten vormen:
Als uw telefoonaantal speciale symbolen zoals + bevat, moet u uw volledig telefoonaantal selecteren, met de rechtermuisknop klikken en EncodeURIComponent klikken.
Dan heb je het volgende:
U zou ook de Kopbal - gebieden van uw verzoek moeten verifiëren. Ga naar Kopballen. U zult dan dit zien:
--aepSandboxName-- zijn.--aepSandboxName--Klik verzenden en verifieer de reactie, zult u zien dat het het zelfde zoals vóór is toen u ECID als identiteit gebruikte.
Laten wij het zelfde ding voor uw e-mailadres doen door namespace van e-mail en uw e-mailadres te specificeren.
Dus als u aan de API's van Platform wilt vragen om u alle profielgegevens voor een specifiek e-mailadres terug te geven, moet u de aanvraag als volgt configureren:
Als uw e-mailadres speciale symbolen zoals + bevat, moet u uw volledig e-mailadres selecteren, met de rechtermuisknop klikken en EncodeURIComponent klikken.
Dan heb je het volgende:
U zou ook de Kopbal - gebieden van uw verzoek moeten verifiëren. Ga naar Kopballen. U zult dan dit zien:
--aepSandboxName-- zijn.
--aepSandboxName--Klik verzenden en verifieer de reactie, zult u opnieuw zien dat het het zelfde zoals vóór met ECID en telefoonaantal is.
Dit is een zeer belangrijke vorm van flexibiliteit die aan merken wordt aangeboden. Dit betekent dat elke omgeving een aanvraag naar Platform kan verzenden met behulp van een eigen id en naamruimte, zonder dat de complexiteit van meerdere naamruimten en id's wordt begrepen.
Als voorbeeld:
- Het Centrum van de Vraag kan gegevens van Platform verzoeken gebruikend de namespace telefoon
- Het Systeem van de Loyaliteit kan gegevens van Platform verzoeken gebruikend namespace e-mail
- online toepassingen kunnen namespace gebruiken ecid
Het Centrum van de Vraag weet niet noodzakelijk welk soort herkenningsteken in het Systeem van de Loyalty wordt gebruikt en het Systeem van de Loyalty weet niet noodzakelijk welk soort herkenningsteken door online toepassingen wordt gebruikt. Elk afzonderlijk systeem kan de informatie gebruiken die ze hebben en begrijpen om de informatie te krijgen die ze nodig hebben, wanneer ze die nodig hebben.
Real-time klantprofiel-API, schema: profiel en ExperienceEvent
Nadat de API's van het platform zijn gecontroleerd op profielgegevens, kunnen we nu hetzelfde doen met ExperienceEvent-gegevens.
In Postman, bepaal de plaats van de inzameling Leerprogramma AEP.
In 1. De verenigde Dienst van het Profiel, selecteer het tweede verzoek met de naam UPS - het Profiel van GET & EE door identiteitskaart van de Entiteit & NS.
Voor dit verzoek zijn vier vereiste variabelen:
Dus als u aan de API's van Platform wilt vragen om u alle profielgegevens voor uw eigen ecid terug te geven, moet u de aanvraag als volgt configureren:
U zou ook de Kopbal - gebieden van uw verzoek moeten verifiëren. Ga naar Kopballen. U zult dan dit zien:
--aepSandboxName-- zijn.--aepSandboxName--Klik verzenden om uw verzoek naar Platform te verzenden.
U zou een directe reactie van Platform moeten krijgen, die u iets als dit toont:
Hieronder volgt de volledige reactie van Platform. In dit voorbeeld zijn er acht ExperienceEvents gekoppeld aan de ECID van deze klant. Bekijk hieronder de verschillende variabelen op het verzoek, aangezien wat u hieronder ziet het directe gevolg van uw configuratie in Lancering in vorige oefeningen is.
Wanneer het röntgendeelvenster de ExperienceEvent-informatie weergeeft, gebruikt het de onderstaande payload om de informatie te parseren en op te halen, zoals de productnaam (zoek naar productName in de onderstaande payload) en de productafbeelding URL (zoek naar productImageUrl in de onderstaande payload).
{
"_page": {
"orderby": "timestamp",
"start": "b1325606-9b96-4e51-b7dd-73aacf527c72-0",
"count": 14,
"next": ""
},
"children": [
{
"relatedEntityId": "A2_ETHkJxMvxbiEmIZlAj8Qn",
"entityId": "b1325606-9b96-4e51-b7dd-73aacf527c72-0",
"sourceId": "672a10b1074ceb2af0aa7034",
"timestamp": 1731923802848,
"entity": {
"environment": {
"ipV4": "141.134.241.99",
"type": "browser",
"browserDetails": {
"userAgentClientHints": {
"mobile": false,
"platform": "macOS",
"brands": [
{
"brand": "Chromium",
"version": "130"
},
{
"brand": "Google Chrome",
"version": "130"
},
{
"brand": "Not?A_Brand",
"version": "99"
}
]
},
"userAgent": "Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/130.0.0.0 Safari/537.36",
"viewportHeight": 992,
"viewportWidth": 1920
}
},
"web": {
"webPageDetails": {
"name": "Home",
"viewName": "Home",
"pageViews": {
"value": 1
},
"URL": "https://dsn.adobe.com/web/vangeluw-QIMU"
},
"webReferrer": {
"URL": "https://auth.services.adobe.com/"
}
},
"_experienceplatform": {
"interactionDetails": {
"core": {
"channel": "web"
}
},
"demoEnvironment": {
"brandName": "vangeluw-QIMU"
},
"identification": {
"core": {
"ecid": "79943948563923140522865572770524243489"
}
}
},
"implementationDetails": {
"name": "https://ns.adobe.com/experience/alloy/reactor",
"version": "2.24.0+2.27.0",
"environment": "browser"
},
"identityMap": {
"ECID": [
{
"id": "79943948563923140522865572770524243489",
"authenticatedState": "ambiguous",
"primary": true
}
]
},
"eventType": "web.webpagedetails.pageViews",
"_id": "b1325606-9b96-4e51-b7dd-73aacf527c72-0",
"placeContext": {
"localTime": "2024-11-18T10:56:42.848+01:00",
"localTimezoneOffset": -60
},
"device": {
"screenOrientation": "landscape",
"screenWidth": 1920,
"screenHeight": 1080
},
"timestamp": "2024-11-18T09:56:42.848Z"
},
"lastModifiedAt": "2024-11-18T09:56:45Z"
},
"_links": {
"next": {
"href": ""
}
}
}
Dit zijn momenteel alle beschikbare ExperienceEvent-gegevens in Platform voor deze ECID.
U hoeft de ECID niet te gebruiken om ExperienceEvent-gegevens aan te vragen vanuit Adobe Experience Platform in real-time profiel. U kunt elke id in een naamruimte gebruiken om deze gegevens aan te vragen.
Volgende stappen
Ga naar 2.1.4 creeer een publiek - UI
Ga terug naar Real-time het Profiel van de Klant
Ga terug naar Alle modules