Gegevens verzamelen via de Edge Network Server-API
Deze snelstartgids legt uit hoe u de volgende gegevens van apparaten zoals IoT-apparaten, set-top boxes, gameconsoles, bureaubladtoepassingen rechtstreeks in Adobe Experience Platform kunt invoeren met behulp van de Adobe Experience Platform Edge Network Server API en Edge Network. Gebruik die gegevens vervolgens in Customer Journey Analytics.
Hiervoor moet u:
-
opstelling een schema en dataset in Adobe Experience Platform om het model (schema) van de gegevens te bepalen die u wilt verzamelen en waar te om de gegevens (dataset) eigenlijk te verzamelen.
-
opstelling een datastream om de Edge Network van Adobe Experience Platform te vormen om uw verzamelde gegevens aan de dataset te leiden u in Adobe Experience Platform vormde.
-
Server API van het Gebruik om gegevens van uw toepassing of spel direct te verzenden die op een Desktop, gokkenconsole, apparaat IoT, of reeks-hoogste doos aan uw gegevensstroom lopen.
-
stelt en bevestigt op. Zorg voor een omgeving waarin u uw ontwikkeling kunt doorlopen en publiceer deze live op uw productieomgeving als alles is gevalideerd.
-
opstelling een verbinding in Customer Journey Analytics. Deze verbinding zou (minstens) uw dataset van Adobe Experience Platform moeten omvatten.
-
opstelling een gegevensmening in Customer Journey Analytics om metriek en afmeting te bepalen die u in Analysis Workspace wilt gebruiken.
-
opstelling een project 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 within DATA MANAGEMENT in het linkerspoor.
-
Selecteer Create schema .
. -
In Uitgezocht een klassenstap van de Create schematovenaar:
-
Selecteer Experience Event .
note info INFO Een schema van de Gebeurtenis van de Ervaring wordt gebruikt om het gedrag van een profiel (als scènenaam, drukknop te modelleren om aan wagentje toe te voegen). Een individueel schema van het Profiel wordt gebruikt om de profiel attributen (zoals naam, e-mail, geslacht) te modelleren. -
Selecteer Next .
-
-
In het gedeelte Name and review step van de wizard Create schema :
-
Voer een Schema display name in voor uw schema en (optioneel) een Description .
-
Selecteer Finish .
-
-
Op het tabblad Structuur van het voorbeeldschema:
-
Selecteer + Add in Field groups .
Veldgroepen zijn herbruikbare verzamelingen van objecten en kenmerken waarmee u het schema eenvoudig kunt uitbreiden.
-
Selecteer in het dialoogvenster Add fields groups de veldgroep Blinding Light 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, bijvoorbeeld
scores > afterMatch.
Selecteer Back om de voorvertoning te sluiten.
-
Selecteer Add field groups .
-
-
Selecteer + naast de naam van het schema.
-
Typ in het deelvenster Field Properties
identificationals de Field name , Identification als de Display name , selecteer Object als de Type en selecteer 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 creeer een nieuwe gebiedsgroepen voeg nieuwe identiteitsgebieden(als ecid,crmId, en anderen toe u) aan de gebiedsgroep nodig hebt en selecteer die nieuwe gebiedsgroep.
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.
Selecteer Apply om dit object aan uw schema toe te voegen.
-
Selecteer het veld ecid in het identificatieobject dat u net hebt toegevoegd en selecteer Identity en Primary Identity en ECID in de lijst 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.
Selecteer Apply . U ziet dat er een vingerafdrukpictogram wordt weergegeven in het ecid-kenmerk.
-
Selecteer het veld email in het identificatieobject dat u net hebt toegevoegd en selecteer Identity en Email in de lijst Identity namespace in het deelvenster Field Properties .
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).
Selecteer Apply . U ziet dat er een vingerafdrukpictogram wordt weergegeven in het e-mailkenmerk.
Selecteer Save .
-
Selecteer het hoofdelement van het schema met de naam van het schema en selecteer vervolgens de 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 voor gebruik in het Profiel van de Klant in real timevoor meer informatie toelaten.
note important IMPORTANT Nadat u een schema hebt opgeslagen dat is ingeschakeld voor profiel, kan het niet meer worden uitgeschakeld voor profiel. 
-
Selecteer Save om het 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 in UIvoor meer informatie creëren en uitgeven bij het toevoegen van en het verwijderen van gebiedsgroepen en individuele gebieden 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 within DATA MANAGEMENT in het linkerspoor.
-
Selecteer Create dataset .
-
Selecteer Create dataset from schema .
-
Selecteer het schema dat u eerder hebt gemaakt en selecteer Next .
-
Geef uw gegevensset een naam en (optioneel) geef een beschrijving op.
-
Selecteer Finish .
-
Selecteer de Profile schakelaar.
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 {de gids UI van de Datasets van 0} 🔗 voor veel meer informatie over hoe te bekijken, voorproef, tot stand brengen, een dataset schrappen. 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 het Web van Adobe Experience Platform en Mobiele SDKs en de Server API van de Edge Network van Adobe Experience Platform. Wanneer het verzamelen van gegevens met Adobe Experience Platform SDKs en de Server APIs van de Edge Network, worden de gegevens verzonden naar de Edge Network van Adobe Experience Platform. 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 in DATA COLLECTION in de linkertrack.
-
Selecteer New Datastream .
-
Geef een naam en beschrijf de gegevensstroom. Selecteer het schema in de lijst Event Schema .
-
Selecteer Save .
-
Selecteer Add Service .
-
In de lus Add Service screen :
-
Selecteer Adobe Experience Platform in de lijst Service .
-
Zorg ervoor dat Enabled is geselecteerd.
-
Selecteer de gegevensset in de lijst Event Dataset .
-
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 van gegevensstromenvoor 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} richt aan het herkenningsteken van de voorbeeldgegevensstroom u vroeger vormde. {sandbox} is de unieke naam van de sandbox die het pad identificeert naar de aangepaste veldgroep Blinding Light.
Zie Interactieve gegevensinzamelingen Niet-interactieve gegevensinzamelingvoor meer informatie over hoe te om de Server API van de Edge Network te gebruiken.
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 Workspace vestigen.
Om uw verbinding tot stand te brengen:
-
Selecteer Connections in de bovenste navigatie in de gebruikersinterface van de Customer Journey Analytics.
-
Selecteer Create new connection .
-
In het Untitled connection -scherm:
Geef een naam en beschrijf de verbinding in Connection Settings .
Selecteer de juiste sandbox in de lijst Sandbox in Data settings en selecteer het aantal dagelijkse gebeurtenissen in de lijst Average number of daily events .
Selecteer Add datasets .
In de stap Select datasets in Add datasets :
-
Selecteer datasets die u vroeger en/of andere relevante datasets creeerde u in uw verbinding wilt omvatten
-
Selecteer Next .
In de stap Datasets settings in Add datasets :
-
Voor elke gegevensset:
-
Selecteer een Person ID van de beschikbare identiteiten die in de datasetschema's in Adobe Experience Platform worden bepaald.
-
Selecteer de juiste gegevensbron in de lijst Data source type . Als u Other opgeeft, voegt u een beschrijving voor de gegevensbron toe.
-
Stel Import all new data en Dataset backfill existing data in op basis van uw voorkeuren.
-
-
Selecteer Add datasets .
Selecteer Save .
-
Zie Overzicht van Verbindingenvoor 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 Data views in de bovenste navigatie in de gebruikersinterface van de Customer Journey Analytics.
-
Selecteer Create new data view .
-
In de stap Configure :
Selecteer de verbinding in de lijst Connection .
Naam en (optioneel) beschrijf uw verbinding.
Selecteer Save and continue .
-
In de stap Components :
Voeg schemagebieden en/of standaardcomponent toe die u aan de METRICS of DIMENSIONS componentenvakjes wilt omvatten.
Selecteer Save and continue .
-
In de stap Settings :
Laat de instellingen ongewijzigd en selecteer Save and finish .
Zie overzicht van de meningen van Gegevensvoor meer informatie over om een gegevensmening tot stand te brengen en uit te geven, welke componenten voor u aan gebruik in uw gegevensmening en hoe te filter en zittingsmontages te gebruiken beschikbaar zijn.
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 Workspace om gegevenscomponenten, lijsten, en visualisaties te combineren om uw analyse te bundelen en met iedereen in uw organisatie te delen.
Uw project maken:
-
Selecteer Projects in de bovenste navigatie in de gebruikersinterface van de Customer Journey Analytics.
-
Selecteer Projects in de linkernavigatie.
-
Selecteer Create project .
Selecteer Blank project .
-
Selecteer de gegevensweergave in de lijst.
-
Als u uw eerste rapport wilt maken, sleept u de afmetingen en metriek op de Freeform table in de Panel .
Zie overzicht van Analysis Workspacevoor meer informatie over hoe te om projecten tot stand te brengen en uw analyse te bouwen gebruikend componenten, visualisaties, en panelen.