Importera data via Adobe Experience Platform Edge Network Server API
Den här snabbstartsguiden förklarar hur du kan importera spårningsdata från enheter som IoT-enheter, digitalboxar, spelkonsoler och datorprogram direkt till Adobe Experience Platform med Adobe Experience Platform Edge Network Server API och Edge Network. Använd sedan dessa data i Customer Journey Analytics.
För att uppnå detta måste du:
-
Konfigurera ett schema och en datauppsättning i Adobe Experience Platform för att definiera modellen (schemat) för de data som du vill samla in och var data (datauppsättningen) ska samlas in.
-
Konfigurera en datastream för att konfigurera Adobe Experience Platform Edge Network så att insamlade data dirigeras till datauppsättningen som du konfigurerade i Adobe Experience Platform.
-
Använd server-API för att skicka data direkt från programmet eller spelet som körs på en stationär dator, spelkonsol, IoT-enhet eller digitalbox till din datastam.
-
Distribuera och validera. Ha en miljö där du kan iterera på utvecklingen och publicera den live i produktionsmiljön när allt har validerats.
-
Konfigurera en anslutning i Customer Journey Analytics. Den här anslutningen bör (åtminstone) innehålla din Adobe Experience Platform-datauppsättning.
-
Konfigurera en datavy i Customer Journey Analytics för att definiera mått och dimensioner som du vill använda i Analysis Workspace.
-
Konfigurera ett projekt i Customer Journey Analytics för att skapa rapporter och visualiseringar.
Konfigurera ett schema och en datauppsättning
Om du vill importera data till Adobe Experience Platform måste du först definiera vilka data du vill samla in. Alla data som hämtas in till Adobe Experience Platform måste överensstämma med en standardiserad, normaliserad struktur för att de ska kunna identifieras och hanteras av funktioner och funktioner längre fram i kedjan. Experience Data Model (XDM) är standardramverket som tillhandahåller en struktur i form av scheman.
När du har definierat ett schema använder du en eller flera datauppsättningar för att lagra och hantera datainsamlingen. En datauppsättning är en lagrings- och hanteringskonstruktion för en datamängd (vanligtvis en tabell) som innehåller ett schema (kolumner) och fält (rader).
Alla data som importeras till Adobe Experience Platform måste överensstämma med ett fördefinierat schema innan de kan sparas som en datauppsättning.
Konfigurera ett schema
Du vill spåra minimala data från profiler som spelar ditt spel på en konsol, till exempel identifiering, bakgrundsmusik, förlopp och annan information.
Du måste först definiera ett schema som modellerar dessa data.
Så här konfigurerar du ditt schema:
-
I Adobe Experience Platform-gränssnittet väljer du Schemas inom DATA MANAGEMENT.
-
Välj Create schema. .
-
I steget Välj en klass i guiden Skapa schema:
-
Välj Experience Event.
note info INFO Ett Experience Event-schema används för att modellera beteende för en profil (som scennamn, tryck på knappen för att lägga till i kundvagnen). Ett enskilt profilschema används för att modellera profilen attributes (som namn, e-post, kön). -
Välj Next.
-
-
I Name and review step i Create schema guide:
-
Ange en Schema display name för ditt schema och (valfritt) en Description.
-
Välj Finish.
-
-
På fliken Struktur i exempelschemat:
-
Välj + Add in Field groups.
Fältgrupper är återanvändbara samlingar av objekt och attribut som gör att du enkelt kan utöka ditt schema.
-
I Add fields groups väljer du Blinding Light fältgrupp från listan. Den här fältgruppen skapas för att spåra användarförloppet i ett fiktivt spel med namnet Blinding Light på en konsol.
Du kan välja knappen Förhandsgranska om du vill se en förhandsgranskning av fälten som är en del av den här fältgruppen, som
scores > afterMatch.
Välj Back för att stänga förhandsgranskningen.
-
Välj Add field groups.
-
-
Välj + bredvid schemanamnet.
-
I Field Properties panel, ange
identificationsom Field name, Identification som Display name, markera Object som Type och markera ExperienceEvent Core v2.1 som Field Group.note note NOTE Om fältgruppen inte är tillgänglig söker du efter en annan fältgrupp som innehåller identitetsfält. eller skapa en ny fältgrupp och lägg till nya identitetsfält (som ecid,crmIdoch andra som du behöver) till fältgruppen och markera den nya fältgruppen.
Identifieringsobjektet lägger till identifieringsfunktioner i ditt schema. I så fall vill du identifiera profiler som spelar ditt spel med hjälp av det Experience Cloud-ID och den e-postadress de använder för att logga in på spelkonsolen. Det finns många andra attribut för att spåra din persons identifiering.
Välj Apply om du vill lägga till det här objektet i ditt schema.
-
Välj ecid fält i det identifieringsobjekt som du just lade till, och markera Identity och Primary Identity och ECID från Identity namespace i den högra panelen.
Du anger Experience Cloud Identity som den primära identitet som Adobe Experience Platform Identity-tjänsten kan använda för att kombinera (sy ihop) beteendet hos profiler med samma ECID.
Välj Apply. En fingeravtrycksikon visas i attributet ecid.
-
Välj email fält i det identifieringsobjekt som du just lade till, och markera Identity och Email från Identity namespace listan i Field Properties -panelen.
Du anger e-postadressen som en annan identitet som kan användas av tjänsten Adobe Experience Platform Identity för att kombinera (sammanfoga) beteendet för profiler.
Välj Apply. En fingeravtrycksikon visas i e-postattributet.
Välj Save.
-
Markera rotelementet i schemat som visar schemats namn och välj sedan Profile byt.
Du uppmanas att aktivera schemat för profilen. När data har aktiverats, när data har importerats till datauppsättningar som baseras på detta schema, sammanfogas dessa data i kundprofilen i realtid.
Se Aktivera schemat för användning i kundprofilen i realtid för mer information.
note important IMPORTANT När du har sparat ett schema som är aktiverat för profilen kan det inte längre inaktiveras för profilen. 
-
Välj Save för att spara ditt schema.
Du har skapat ett minimalt schema som modellerar de data du kan hämta från ditt spel. Schemat gör det möjligt att identifiera profiler med hjälp av Experience Cloud-identitet och e-postadress. Genom att aktivera schemat för profilen ser du till att data som hämtats från ditt konsolspel läggs till i kundprofilen i realtid.
Bredvid beteendedata kan du även hämta profilattributdata från konsolen (t.ex. information om profiler som har loggats in i konsolen).
Så här hämtar du profildata:
-
Skapa ett schema baserat på klassen XDM Individual Profile.
-
Lägg till fältgruppen Profilkärna v2 i schemat.
-
Lägg till ett identifieringsobjekt baserat på fältgruppen Profile Core v2.
-
Definiera Experience Cloud-ID som primär identifierare och e-post som identifierare.
-
Aktivera schemat för profilen
Se Skapa och redigera scheman i användargränssnittet om du vill ha mer information om hur du lägger till och tar bort fältgrupper och enskilda fält i ett schema.
Konfigurera en datauppsättning
Med ditt schema har du definierat din datamodell. Nu måste du definiera konstruktionen för att lagra och hantera data med hjälp av datauppsättningar.
Så här konfigurerar du datauppsättningen:
-
I Adobe Experience Platform-gränssnittet väljer du Datasets inom DATA MANAGEMENT.
-
Välj Create dataset.
-
Välj Create dataset from schema.
-
Markera schemat som du skapade tidigare och välj Next.
-
Ge datauppsättningen ett namn och (valfritt) ge en beskrivning.
-
Välj Finish.
-
Välj Profile byt.
Du uppmanas att aktivera datauppsättningen för profilen. När datauppsättningen är aktiverad berikas kundprofiler i realtid med inkapslade data.
note important IMPORTANT Du kan bara aktivera en datauppsättning för profilen när schemat, som datauppsättningen följer, också är aktiverat för profilen. 
Se Användargränssnittshandbok för datauppsättningar om du vill ha mer information om hur du visar, förhandsgranskar, skapar, tar bort en datauppsättning. Och hur man aktiverar en datauppsättning för kundprofil i realtid.
Konfigurera en datastream
En datastream representerar konfigurationen på serversidan när Adobe Experience Platform Web och Mobile SDK implementeras och API:t för Adobe Experience Platform Edge Network Server. När data samlas in med Adobe Experience Platform SDK:er och Edge Network Server API:er skickas data till Adobe Experience Platform Edge Network. Det är datastream som avgör vilka tjänster som data vidarebefordras till.
I din konfiguration vill du att de data du samlar in från spelet ska skickas till din datauppsättning i Adobe Experience Platform.
Så här konfigurerar du datastream:
-
I användargränssnittet för Adobe Experience Platform väljer du Datastreams från DATA COLLECTION till vänster.
-
Välj New Datastream.
-
Namnge och beskriv ditt datastream. Välj ditt schema från Event Schema lista.
-
Välj Save.
-
Välj Add Service.
-
I Add Service screen:
-
Välj Adobe Experience Platform från Service lista.
-
Säkerställ Enabled är markerat.
-
Välj din datauppsättning på Event Dataset lista.
-
Lämna de andra inställningarna och välj Save för att spara datastream.
-
Din datastream är nu konfigurerad för att vidarebefordra data som samlats in från ditt spel till datauppsättningen i Adobe Experience Platform.
Se Översikt över datastreams om du vill ha mer information om hur du konfigurerar ett datastam och hur du hanterar känsliga data.
Använd Edge Network Server API
Under spelets utveckling kan du lägga till relevanta anrop till Adobe Experience Platform Edge Network Server API där det är lämpligt.
Om du till exempel vill uppdatera spelarens musikspår använder du:
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"
}
}
}'
I exempelbegäran om POST {DATASTREAM_ID} pekar på identifieraren för exempeldatastream som du konfigurerade tidigare. {sandbox} är det unika namnet på sandlådan som identifierar sökvägen till den anpassade fältgruppen Ljus lutning.
Se Interaktiv datainsamling och Icke-interaktiv datainsamling om du vill ha mer information om hur du använder API:t för Edge Network Server.
Konfigurera en anslutning
Om du vill använda Adobe Experience Platform-data i Customer Journey Analytics skapar du en anslutning som innehåller de data som är resultatet av konfigurationen av ditt schema, din datauppsättning och ditt arbetsflöde.
Med en anslutning kan du integrera datauppsättningar från Adobe Experience Platform i Workspace. För att kunna rapportera om dessa datauppsättningar måste du först skapa en anslutning mellan datauppsättningar i Adobe Experience Platform och Workspace.
Så här skapar du en anslutning:
-
I användargränssnittet för Customer Journey Analytics väljer du Connections i den övre navigeringen.
-
Välj Create new connection.
-
I Untitled connection skärm:
Namnge och beskriva anslutningen i Connection Settings.
Välj rätt sandlåda i dialogrutan Sandbox lista i Data settings och välj antalet dagliga händelser i dialogrutan Average number of daily events lista.
Välj Add datasets.
I Select datasets stega in Add datasets:
-
Välj datauppsättningar som du har skapat tidigare och/eller andra relevanta datauppsättningar som du vill inkludera i anslutningen
-
Välj Next.
I Datasets settings stega in Add datasets:
-
För varje datauppsättning:
-
Välj en Person ID från de tillgängliga identiteter som definieras i datauppsättningsscheman i Adobe Experience Platform.
-
Välj rätt datakälla på menyn Data source type lista. Om du anger Other lägger du sedan till en beskrivning av datakällan.
-
Ange Import all new data och Dataset backfill existing data enligt dina önskemål.
-
-
Välj Add datasets.
Välj Save.
-
Se Anslutningar - översikt för mer information om hur du skapar och hanterar en anslutning och hur du väljer och kombinerar datauppsättningar.
Konfigurera en datavy
En datavy är en behållare som är specifik för Customer Journey Analytics och som gör att du kan avgöra hur data från en anslutning ska tolkas. Här anges alla mått och mätvärden som är tillgängliga i Analysis Workspace och vilka kolumner som måtten och mätvärdena hämtar data från. Datavyer definieras som förberedelser för rapportering i Analysis Workspace.
Så här skapar du en datavy:
-
I användargränssnittet för Customer Journey Analytics väljer du Data views i den övre navigeringen.
-
Välj Create new data view.
-
I Configure steg:
Välj din anslutning på menyn Connection lista.
Namn och (eventuellt) beskrivning av anslutningen.
Välj Save and continue.
-
I Components steg:
Lägg till alla schemafält och/eller standardkomponenter som du vill inkludera i METRICS eller DIMENSIONS komponentrutor.
Välj Save and continue.
-
I Settings steg:
Låt inställningarna vara som de är och välj Save and finish.
Se Översikt över datavyer för mer information om hur du skapar och redigerar en datavy, vilka komponenter som är tillgängliga för dig och hur du använder filter- och sessionsinställningar.
Konfigurera ett projekt
Analysis Workspace är ett flexibelt webbläsarverktyg som gör att du snabbt kan skapa analyser och dela insikter baserat på dina data. Du använder Workspace-projekt för att kombinera datakomponenter, tabeller och visualiseringar för att skapa analyser och dela dem med vem som helst i organisationen.
Så här skapar du ditt projekt:
-
I användargränssnittet för Customer Journey Analytics väljer du Projects i den övre navigeringen.
-
Välj Projects i den vänstra navigeringen.
-
Välj Create project.
Välj Blank project.
-
Välj datavyn i listan.
-
Om du vill skapa din första rapport börjar du dra och släppa dimensioner och mätvärden på Freeform table i Panel.
Se Analysis Workspace - översikt om du vill ha mer information om hur du skapar projekt och bygger din analys med hjälp av komponenter, visualiseringar och paneler.