Gegevens verzamelen via de Adobe Experience Platform Edge Network Server-API
In deze snelstartgids wordt uitgelegd hoe u gegevens voor het bijhouden van gegevens kunt invoeren van apparaten zoals IoT-apparaten, set-top boxes, gameconsoles, bureaubladtoepassingen rechtstreeks in Adobe Experience Platform met de Adobe Experience Platform Edge Network Server API en Edge Network. Gebruik die gegevens vervolgens in Customer Journey Analytics.
Hiervoor moet u:
-
Een schema en gegevensset instellen in Adobe Experience Platform om het model (schema) te bepalen van de gegevens die u wilt verzamelen en waar te om de gegevens (dataset) daadwerkelijk te verzamelen.
-
Een gegevensstroom instellen om het Adobe Experience Platform Edge Network te configureren om de verzamelde gegevens te routeren naar de gegevensset die u in Adobe Experience Platform hebt geconfigureerd.
-
Server-API gebruiken om gegevens rechtstreeks vanuit uw toepassing of game die op een desktop, spelconsole, IoT-apparaat of set-top box worden uitgevoerd, naar uw datastream te verzenden.
-
Implementeren en valideren. Zorg voor een omgeving waarin u uw ontwikkeling kunt doorlopen en publiceer deze live op uw productieomgeving als alles is gevalideerd.
-
Een verbinding instellen in de Customer Journey Analytics. Deze verbinding zou (minstens) uw dataset van Adobe Experience Platform moeten omvatten.
-
Een gegevensweergave instellen in Customer Journey Analytics om metriek en afmeting te bepalen die u in Analysis Workspace wilt gebruiken.
-
Een project instellen in Customer Journey Analytics om uw rapporten en visualisaties te bouwen.
Een schema en gegevensset instellen
Als u gegevens in Adobe Experience Platform wilt invoeren, moet u eerst definiëren welke gegevens u wilt verzamelen. Alle gegevens die in Adobe Experience Platform worden ingevoerd, moeten voldoen aan een standaard, gedenormaliseerde structuur, zodat deze kan worden herkend en kan worden toegepast door de mogelijkheden en functies op de downstreammarkt. Het Model van Gegevens van de ervaring (XDM) is het standaardkader dat een structuur in de vorm van schema's verstrekt.
Zodra u een schema hebt bepaald, gebruikt u één of meerdere datasets om de inzameling van gegevens op te slaan en te beheren. Een dataset is een opslag en beheersconstructie voor een inzameling van gegevens (typisch een lijst) die een schema (kolommen) en gebieden (rijen) bevat.
Alle gegevens die in Adobe Experience Platform worden opgenomen moeten met een vooraf gedefinieerd schema in overeenstemming zijn alvorens het als dataset kan worden voortgeduurd.
Een schema instellen
U wilt enkele minimale gegevens bijhouden van profielen die uw game op een console afspelen, zoals identificatie, scores, voortgang en andere informatie.
U moet eerst een schema definiëren dat deze gegevens modelleert.
Uw schema instellen:
-
Selecteer in de gebruikersinterface van Adobe Experience Platform de optie Schemas binnen DATA MANAGEMENT.
-
Selecteren Create schema. .
-
In Uitgezocht een klassenstap van de Create schematovenaar:
-
Selecteren Experience Event.
note info INFO Een schema van de Gebeurtenis van de Ervaring wordt gebruikt om het gedrag van een profiel (zoals scènenaam, drukknop om aan winkelwagentje toe te voegen). Een afzonderlijk profielschema wordt gebruikt om het profiel te modelleren attributes (zoals naam, e-mail, geslacht). -
Selecteren Next.
-
-
In de Name and review step van de Create schema wizard:
-
Voer een Schema display name voor uw schema en (optioneel) a Description.
-
Selecteren Finish.
-
-
Op het tabblad Structuur van het voorbeeldschema:
-
Selecteren + Add in Field groups.
Veldgroepen zijn herbruikbare verzamelingen van objecten en kenmerken waarmee u het schema eenvoudig kunt uitbreiden.
-
In de Add fields groups selecteert u de Blinding Light veldgroep in de lijst. Deze veldgroep wordt gemaakt om de voortgang van de gebruiker bij te houden bij het afspelen van een fictieve game met de naam Blinding Light op een console.
U kunt de voorvertoningsknop selecteren om een voorvertoning weer te geven van de velden die deel uitmaken van deze veldgroep, zoals
scores > afterMatch.
Selecteren Back om de voorvertoning te sluiten.
-
Selecteren Add field groups.
-
-
Selecteren + naast de naam van het schema.
-
In de Field Properties paneel, enter
identificationals de Field name, Identification als de Display name, selecteert u Object als de Type en selecteert u ExperienceEvent Core v2.1 als de Field Group.note note NOTE Als die veldgroep niet beschikbaar is, zoekt u naar een andere veldgroep met identiteitsvelden. of een nieuwe veldgroep maken en nieuwe identiteitsvelden toevoegen (zoals ecid,crmId, en andere die u nodig hebt) naar de veldgroep en selecteer die nieuwe veldgroep.
Het identificatieobject voegt id-mogelijkheden toe aan uw schema. In uw geval wilt u profielen identificeren die uw game afspelen met de Experience Cloud-id en het e-mailadres waarmee ze zich aanmelden bij hun gameconsole. Er zijn veel andere kenmerken beschikbaar om de identiteit van uw persoon te volgen.
Selecteren Apply om dit object aan uw schema toe te voegen.
-
Selecteer de ecid veld in het identificatieobject dat u zojuist hebt toegevoegd, en selecteer Identity en Primary Identity en ECID van de Identity namespace in het rechterdeelvenster.
U geeft de Experience Cloud Identity op als de primaire identiteit die de Adobe Experience Platform Identity-service kan gebruiken om het gedrag van profielen te combineren (aan te sluiten) met dezelfde ECID.
Selecteren Apply. U ziet dat er een vingerafdrukpictogram wordt weergegeven in het ecid-kenmerk.
-
Selecteer de email veld in het identificatieobject dat u zojuist hebt toegevoegd, en selecteer Identity en Email van de Identity namespace in de lijst Field Properties deelvenster.
U geeft het e-mailadres op als een andere identiteit die de Adobe Experience Platform Identity-service kan gebruiken om het gedrag van profielen te combineren (naaien).
Selecteren Apply. U ziet dat er een vingerafdrukpictogram wordt weergegeven in het e-mailkenmerk.
Selecteren Save.
-
Selecteer het basiselement van uw schema dat de naam van het schema toont, dan selecteer Profile switch.
U wordt gevraagd het schema in te schakelen voor het profiel. Zodra toegelaten, wanneer het gegeven in datasets wordt opgenomen die op dit schema worden gebaseerd, worden die gegevens samengevoegd in het Real-Time Profiel van de Klant.
Zie Het schema inschakelen voor gebruik in Real-Time Klantprofiel voor meer informatie .
note important IMPORTANT Nadat u een schema hebt opgeslagen dat is ingeschakeld voor profiel, kan het niet meer worden uitgeschakeld voor profiel. 
-
Selecteren Save om uw schema op te slaan.
U hebt een minimaal schema gemaakt dat de gegevens modelleert die u van uw game kunt vastleggen. Met het schema kunnen profielen worden geïdentificeerd aan de hand van de identiteit en het e-mailadres van het Experience Cloud. Door het schema voor profiel in te schakelen, zorgt u ervoor dat de gegevens die zijn vastgelegd in uw consolegame worden toegevoegd aan het Real-Time Klantprofiel.
Naast gedragsgegevens kunt u ook profielkenmerkgegevens vastleggen vanaf uw console (bijvoorbeeld details van profielen die zijn ondertekend in de console).
Als u profielgegevens wilt vastleggen, doet u het volgende:
-
Maak een schema op basis van de klasse Individueel profiel XDM.
-
Voeg de het gebiedsgroep van de Kern van het Profiel v2 aan het schema toe.
-
Voeg een identificatieobject toe op basis van de veldgroep Profile Core v2.
-
Experience Cloud-id definiëren als primaire id en e-mailadres als id.
-
Het schema inschakelen voor profiel
Zie Schema's maken en bewerken in de gebruikersinterface voor meer informatie over het toevoegen en verwijderen van veldgroepen en afzonderlijke velden aan een schema.
Een gegevensset instellen
Met uw schema, hebt u uw gegevensmodel bepaald. U moet nu de constructie bepalen om die gegevens op te slaan en te beheren door datasets te gebruiken.
Uw gegevensset instellen:
-
Selecteer in de gebruikersinterface van Adobe Experience Platform de optie Datasets binnen DATA MANAGEMENT.
-
Selecteren Create dataset.
-
Selecteren Create dataset from schema.
-
Selecteer het eerder gemaakte schema en selecteer Next.
-
Geef uw gegevensset een naam en (optioneel) geef een beschrijving op.
-
Selecteren Finish.
-
Selecteer de Profile switch.
U wordt ertoe aangezet om de dataset voor profiel toe te laten. Zodra toegelaten, verrijkt de dataset klantenprofielen in real time met zijn opgenomen gegevens.
note important IMPORTANT U kunt een dataset voor profiel slechts toelaten wanneer het schema, waaraan de dataset voldoet, ook voor profiel wordt toegelaten. 
Zie UI-gids voor gegevensbestanden voor veel meer informatie over hoe te om, voorproef te bekijken, creeer, schrapt een dataset. En hoe te om een dataset voor het Profiel van de Klant in real time toe te laten.
Een gegevensstroom instellen
Een gegevensstroom vertegenwoordigt de server-zijconfiguratie wanneer het uitvoeren van Adobe Experience Platform Web en Mobiele SDKs en de Server API van het Netwerk van Adobe Experience Platform Edge. Bij het verzamelen van gegevens met de Adobe Experience Platform SDK's en Edge Network Server-API's worden gegevens verzonden naar het Adobe Experience Platform Edge Network. Het is de gegevensstroom die bepaalt aan welke diensten dat de gegevens door:sturen.
In uw opstelling, wilt u de gegevens die u van het spel verzamelt worden verzonden naar uw dataset in Adobe Experience Platform.
Uw gegevensstroom instellen:
-
Selecteer in de gebruikersinterface van Adobe Experience Platform Datastreams van DATA COLLECTION in het linkerspoor.
-
Selecteren New Datastream.
-
Geef een naam en beschrijf de gegevensstroom. Selecteer uw schema in het menu Event Schema lijst.
-
Selecteren Save.
-
Selecteren Add Service.
-
In de Add Service screen:
-
Selecteren Adobe Experience Platform van de Service lijst.
-
Zorgen Enabled is geselecteerd.
-
Selecteer uw gegevensset in het menu Event Dataset lijst.
-
Laat de andere instellingen staan en selecteer Save om de gegevensstroom op te slaan.
-
Uw gegevensstroom is nu geconfigureerd om de gegevens die van uw game zijn verzameld door te sturen naar uw gegevensset in Adobe Experience Platform.
Zie Overzicht gegevensstromen voor meer informatie over hoe te om een gegevensstroom te vormen en hoe te om gevoelige gegevens te behandelen.
Edge Network Server-API gebruiken
Bij de ontwikkeling van uw game kunt u desgewenst relevante aanroepen toevoegen aan de Adobe Experience Platform Edge Network Server-API.
Als u bijvoorbeeld de score van de speler wilt bijwerken, gebruikt u:
curl -X POST "https://server.adobedc.net/ee/v2/interact?dataStreamId={DATASTREAM_ID}"
-H "Authorization: Bearer {TOKEN}"
-H "x-gw-ims-org-id: {ORG_ID}"
-H "x-api-key: {API_KEY}"
-H "Content-Type: application/json"
-d '{
"event": {
"xdm": {
"identityMap": {
"Email_LC_SHA256": [
{
"id": "0c7e6a405862e402eb76a70f8a26fc732d07c32931e9fae9ab1582911d2e8a3b",
"primary": true
}
]
},
"eventType": "game.scoreUpdate",
"{sandbox}": {
"scores": {
"afterMatch": 132391",
}
},
"timestamp": "2021-08-09T14:09:20.859Z"
}
}
}'
In het verzoek van de POST van het voorbeeld, {DATASTREAM_ID} verwijst naar de id van de voorbeeldgegevensstroom die u eerder hebt geconfigureerd. {sandbox} Dit is de unieke naam van de sandbox die het pad identificeert naar de aangepaste veldgroep Blinding Light.
Zie Interactieve gegevensverzameling en Niet-interactieve gegevensverzameling voor meer informatie over het gebruik van de Edge Network Server-API.
Een verbinding instellen
Om de gegevens van Adobe Experience Platform in Customer Journey Analytics te gebruiken, creeert u een verbinding die de gegevens omvat die uit vestiging uw schema, dataset, en werkschema voortvloeien.
Met een verbinding kunt u gegevenssets van Adobe Experience Platform integreren in Workspace. Om over deze datasets te rapporteren, moet u eerst een verband tussen datasets in Adobe Experience Platform en Werkruimte vestigen.
Om uw verbinding tot stand te brengen:
-
Selecteer in de gebruikersinterface van de Customer Journey Analytics de optie Connections in de bovenste navigatie.
-
Selecteren Create new connection.
-
In de Untitled connection scherm:
Geef een naam en beschrijf de verbinding in Connection Settings.
Selecteer de juiste sandbox in het menu Sandbox lijst in Data settings en selecteert u het aantal dagelijkse gebeurtenissen in het menu Average number of daily events lijst.
Selecteren Add datasets.
In de Select datasets stap in Add datasets:
-
Selecteer datasets die u vroeger en/of andere relevante datasets creeerde u in uw verbinding wilt omvatten
-
Selecteren Next.
In de Datasets settings stap in Add datasets:
-
Voor elke gegevensset:
-
Selecteer een Person ID uit de beschikbare identiteiten die zijn gedefinieerd in de gegevenssetschema's in Adobe Experience Platform.
-
Selecteer de juiste gegevensbron in het menu Data source type lijst. Als u Other Voeg vervolgens een beschrijving voor uw gegevensbron toe.
-
Set Import all new data en Dataset backfill existing data volgens uw voorkeuren.
-
-
Selecteren Add datasets.
Selecteren Save.
-
Zie Overzicht van verbindingen voor meer informatie over om een verbinding tot stand te brengen en te beheren en datasets te selecteren en te combineren.
Een gegevensweergave instellen
Een gegevensmening is een container specifiek voor Customer Journey Analytics die u laat bepalen hoe te om gegevens van een verbinding te interpreteren. Hiermee worden alle afmetingen en metriek opgegeven die beschikbaar zijn in Analysis Workspace en de kolommen waarvan die dimensies en metriek hun gegevens verkrijgen. Gegevensweergaven worden gedefinieerd ter voorbereiding op rapportage in Analysis Workspace.
Uw gegevensweergave maken:
-
Selecteer in de gebruikersinterface van de Customer Journey Analytics de optie Data views in de bovenste navigatie.
-
Selecteren Create new data view.
-
In de Configure stap:
Selecteer uw verbinding van Connection lijst.
Naam en (optioneel) beschrijf uw verbinding.
Selecteren Save and continue.
-
In de Components stap:
Voeg schemagebieden en/of standaardcomponent toe die u aan wilt omvatten METRICS of DIMENSIONS deelvakken.
Selecteren Save and continue.
-
In de Settings stap:
De instellingen ongewijzigd laten en selecteren Save and finish.
Zie Overzicht van gegevensweergaven voor meer informatie over het maken en bewerken van een gegevensweergave, welke componenten beschikbaar zijn voor u in de gegevensweergave en hoe u filter- en sessieinstellingen kunt gebruiken.
Een project instellen
Analysis Workspace is een flexibel browserprogramma waarmee u snel analyses kunt maken en inzichten kunt delen op basis van uw gegevens. U gebruikt de projecten van de Werkruimte om gegevenscomponenten, lijsten, en visualisaties te combineren om uw analyse te bundelen en met iedereen in uw organisatie te delen.
Uw project maken:
-
Selecteer in de gebruikersinterface van de Customer Journey Analytics de optie Projects in de bovenste navigatie.
-
Selecteren Projects in de linkernavigatie.
-
Selecteren Create project.
Selecteren Blank project.
-
Selecteer de gegevensweergave in de lijst.
-
Als u uw eerste rapport wilt maken, sleept u de afmetingen en metriek naar het Freeform table in de Panel.
Zie Analysis Workspace-overzicht voor meer informatie over hoe te om projecten tot stand te brengen en uw analyse te bouwen gebruikend componenten, visualisaties, en panelen.