Documentatie Customer Journey Analytics Handleiding voor Customer Journey Analytics

Gegevens verzamelen via de Edge Network Server-API

Laatst bijgewerkt: 5 mei 2025

Onderwerpen:
Basisprincipes

Gemaakt voor:

Beheerder

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:

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 Adobe Experience Platform Edge Network 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.

OPMERKING

Deze handleiding voor snel starten is een vereenvoudigde gids voor het opnemen van gegevens die zijn verzameld bij een toepassing of game die op een IoT-apparaat, set-top box, gameconsole of desktop in Adobe Experience Platform wordt uitgevoerd en in Customer Journey Analytics wordt gebruikt. Het wordt ten zeerste aanbevolen de aanvullende informatie te bestuderen wanneer deze wordt vermeld.

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:
1. Selecteer Experience Event .
  
  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.
2. Selecteer Next .
In het gedeelte Name and review step van de wizard Create schema :
1. Voer een Schema display name in voor uw schema en (optioneel) een Description .
2. Selecteer Finish .
Op het tabblad Structuur van het voorbeeldschema:
1. Selecteer + Add in Field groups .
  
  toe
  
  Veldgroepen zijn herbruikbare verzamelingen van objecten en kenmerken waarmee u het schema eenvoudig kunt uitbreiden.
2. 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.
3. Selecteer Add field groups .
Selecteer + naast de naam van het schema.
Typ in het deelvenster Field Properties identification als de Field name , Identification als de Display name , selecteer Object als de Type en selecteer ExperienceEvent Core v2.1 als de Field Group .

OPMERKING
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 die uw game afspelen identificeren aan de hand van de Experience Cloud-id en het e-mailadres dat ze gebruiken om u aan te melden 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 met dezelfde ECID te combineren (aansluiten).

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.

BELANGRIJK
Nadat u een schema hebt opgeslagen dat is ingeschakeld voor profiel, kan het niet meer worden uitgeschakeld voor profiel.

toe
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. In het schema kunnen profielen worden geïdentificeerd met Experience Cloud Identity en e-mailadres. 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.

BELANGRIJK
U kunt een dataset voor profiel slechts toelaten wanneer het schema, waaraan de dataset voldoet, ook voor profiel wordt toegelaten.

toe

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 Adobe Experience Platform Edge Network. Bij het verzamelen van gegevens met de SDK's van Adobe Experience Platform en de API's van Edge Network Server worden gegevens verzonden naar de 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 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 :
1. Selecteer Adobe Experience Platform in de lijst Service .
2. Zorg ervoor dat Enabled is geselecteerd.
3. Selecteer de gegevensset in de lijst Event Dataset .
4. 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 voorbeeld POST-verzoek verwijst {DATASTREAM_ID} naar de id van de voorbeeldgegevensstroom die u eerder hebt geconfigureerd. {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 Edge Network te gebruiken.

Een verbinding instellen

Als u de Adobe Experience Platform-gegevens in Customer Journey Analytics wilt gebruiken, maakt u een verbinding die de gegevens bevat die het resultaat zijn van het instellen van het schema, de gegevensset en de workflow.

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 in de gebruikersinterface van Customer Journey Analytics de optie Connections (optioneel in Data management ) in het bovenste menu.
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 gegevensweergave is een container specifiek voor Customer Journey Analytics waarmee u kunt bepalen hoe gegevens van een verbinding moeten worden geïnterpreteerd. 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 Customer Journey Analytics de optie Data views (optioneel in Data management ) in het bovenste menu.
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 segment 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 in de gebruikersinterface van Customer Journey Analytics de optie Projects in het bovenste menu.
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.

SUCCESS

U hebt alle stappen uitgevoerd. Eerst definieert u welke gegevens u wilt verzamelen (schema) en waar u deze wilt opslaan (dataset) in Adobe Experience Platform. U vormde een gegevensstroom op de Edge Network om ervoor te zorgen dat de gegevens aan die dataset kunnen door:sturen. Vervolgens hebt u de Edge Network Server-API gebruikt om die gegevens naar uw gegevensstroom te verzenden. U hebt een verbinding in Customer Journey Analytics gedefinieerd om uw spelgegevens en andere gegevens te gebruiken. Met de definitie van uw gegevensweergave kunt u opgeven welke dimensie en metriek u wilt gebruiken en hebt u uiteindelijk uw eerste project gemaakt waarmee u uw gamegegevens kunt visualiseren en analyseren.

recommendation-more-help