Importera data via Adobe Experience Platform Mobile SDK
Den här snabbstartsguiden förklarar hur du kan importera spårningsdata för mobilappar direkt till Adobe Experience Platform med Adobe Experience Platform Mobile SDK 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 att dirigera dina insamlade data till datauppsättningen som du konfigurerade i Adobe Experience Platform.
-
Använd taggar för att enkelt konfigurera regler och dataelement mot data i ditt mobilprogram. Kontrollera sedan att data skickas till den dataström som är konfigurerad på Adobe Experience Platform Edge Network.
-
Distribuera och validera. Ha en miljö där du kan iterera på taggutvecklingen och när allt har validerats publicerar du det direkt i produktionsmiljön.
-
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 använder din mobilapp, till exempel scennamn och identifiering.
Först måste du definiera ett schema som modellerar dessa data.
Så här konfigurerar du ditt schema:
-
I Adobe Experience Platform-gränssnittet väljer du Schemas i DATA MANAGEMENT till vänster.
-
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 beteendet för en profil (som scennamn, push-knapp som läggs till i kundvagnen). Ett enskilt profilschema används för att modellera profilen attribut (som namn, e-post, kön). -
Välj Next.
-
-
I Name and review step i guiden Create schema:
-
Ange en Schema display name för ditt schema och (valfritt) en Description.
-
Välj Finish.
-
-
På fliken Struktur i exempelschemat:
-
Välj + Add i Field groups.
Fältgrupper är återanvändbara samlingar av objekt och attribut som gör att du enkelt kan utöka ditt schema.
-
I dialogrutan Add fields groups väljer du fältgruppen AEP Mobile SDK ExperienceEvent i listan.
Du kan välja knappen för förhandsgranskning om du vill se en förhandsgranskning av fälten som ingår i den här fältgruppen, till exempel
application > name
.Välj Back om du vill stänga förhandsgranskningen.
-
Välj Add field groups.
-
-
Välj + bredvid schemanamnet på panelen Structure.
-
På panelen Field Properties anger du
identification
som Field name, Identification som Display name, väljer Object som Type och väljer 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
,crmId
och andra som du behöver) i fältgruppen och markera den nya fältgruppen.Identifieringsobjektet lägger till identifieringsfunktioner i ditt schema. I så fall vill du identifiera profiler med din mobilapp med hjälp av Experience Cloud-ID och e-postadress. Det finns många andra attribut som du kan använda för att spåra din persons ID (till exempel kundens ID, lojalitets-ID).
Välj Apply om du vill lägga till det här objektet i ditt schema.
-
Markera fältet ecid i det identifieringsobjekt som du nyss lade till och välj Identity, Primary Identity och ECID i listan 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.
-
Markera fältet email i det identifieringsobjekt som du nyss lade till och välj Identity och Email i listan Identity namespace på panelen Field Properties.
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 växeln Profile.
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.
Mer information finns i Aktivera schemat för användning i kundprofilen i realtid.
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 om du vill spara ditt schema.
Du har skapat ett minimalt schema som modellerar de data du kan hämta från ditt mobilprogram. 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ämtas från mobilappen läggs till i kundprofilen i realtid.
Bredvid beteendedata kan du även hämta profilattributdata från ditt mobilprogram (till exempel information om profiler som prenumererar på ett nyhetsbrev).
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
Mer information om hur du lägger till och tar bort fältgrupper och enskilda fält i ett schema finns i Skapa och redigera scheman i användargränssnittet.
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 i DATA MANAGEMENT till vänster.
-
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 växeln Profile.
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.
Mer information om hur du visar, förhandsgranskar, skapar och tar bort en datauppsättning finns i Användargränssnittshandbok för datauppsättningar. 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. När data samlas in med Adobe Experience Platform SDK: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 mobilappen ska skickas till din datauppsättning i Adobe Experience Platform.
Så här konfigurerar du datastream:
-
I Adobe Experience Platform-gränssnittet väljer du Datastreams från DATA COLLECTION i den vänstra listen.
-
Välj New Datastream.
-
Namnge och beskriv ditt datastream. Välj ditt schema i listan Event Schema.
-
Välj Save.
-
Välj Add Service.
-
I Add Service screen:
-
Välj Adobe Experience Platform i listan Service.
-
Kontrollera att Enabled är markerat.
-
Välj datauppsättningen i listan Event Dataset.
-
Lämna de andra inställningarna och välj Save för att spara dataströmmen.
-
Din datastream är nu konfigurerad för att vidarebefordra data som samlats in från din mobilapp till datauppsättningen i Adobe Experience Platform.
Mer information om hur du konfigurerar ett datastam och hur du hanterar känsliga data finns i Översikt över datastreams.
Använd taggar
Om du vill implementera kod på din webbplats för att samla in data använder du taggfunktionen i Adobe Experience Platform. Med tagghanteringslösningen kan ni driftsätta kod tillsammans med andra taggningskrav. Taggar erbjuder sömlös integrering med Adobe Experience Platform via tillägget Adobe Experience Platform Mobile SDK.
Skapa en tagg
-
I Adobe Experience Platform-gränssnittet väljer du Tags i DATA COLLECTION till vänster.
-
Välj New Property.
Ge taggen ett namn och välj Mobile. Välj Save om du vill fortsätta.
Konfigurera taggen
När du har skapat taggen måste du konfigurera den med rätt tillägg och konfigurera dataelement och regler efter hur du vill spåra webbplatsen och skicka data till Adobe Experience Platform.
Om du vill konfigurera väljer du den nyligen skapade taggen i listan med Tag Properties.
Tillägg
Lägg till tillägget Adobe Platform Edge Network i taggen så att du kan skicka data till Adobe Experience Platform (via din datastream).
Så här skapar och konfigurerar du Adobe Experience Platform Mobile SDK-tillägget:
-
Välj Extensions i den vänstra listen. Du ser att tilläggen Mobile Core och Profile redan är tillgängliga.
-
Välj Catalog i det övre fältet.
-
Sök efter eller bläddra till tillägget Adobe Experience Platform Edge Network och välj Install i den högra rutan för att installera det.
-
Välj din sandlåda och din tidigare skapade datastam för Production Environment och (valfritt) Staging Environment och Development Environment.
-
Ange Edge Network domain under Domain configuration. Använd vanligtvis
<organizationName>.data.adobedc.net
. -
Välj Save.
Mer information finns i Konfigurera tillägget Adobe Experience Platform Edge Network.
Du vill också konfigurera följande tillägg från katalogen:
- Identitet.
- AEP Assurance.
- Godkännande.
Se Konfigurera en taggegenskap i självstudiekursen för mobilappar för Experience-plattformen för mer information om tillägg och deras konfiguration.
Dataelement
Dataelement är byggstenarna för dataordlistan (eller datamappningen). Använd dataelement för att samla in, ordna och leverera data över marknadsförings- och annonseringsteknologier. Du ställer in dataelement i taggen som läser från mobilappsdata eller händelser och kan användas för att leverera data till Adobe Experience Platform.
Du vill till exempel samla in transportföretagsnamnet från mobilappen.
Så här definierar du ett dataelement för transportföretagsnamn:
-
Välj Data Elements i den vänstra listen.
-
Välj Add Data Element.
-
I dialogrutan Create Data Element:
-
Ge dataelementet ett namn, till exempel
Carrier Name
. -
Välj Mobile Core i listan Extension.
-
Välj Carrier Name i listan Data Element Type.
-
Välj Save.
-
Du kan skapa så många dataelement du vill och använda dem i regler.
Regler
Taggar i Adobe Experience Platform följer ett regelbaserat system. De letar efter användarinteraktion och tillhörande data. När villkoren som beskrivs i reglerna är uppfyllda utlöser regeln det tillägg, skript eller den klientkod som du identifierade. Du kan använda regler för att skicka data (som ett XDM-objekt) till Adobe Experience Platform med tillägget Adobe Experience Platform Edge Network.
Du vill till exempel skicka händelsedata när mobilappen används (i förgrunden) och när mobilappen inte används (överförs tillbaka till bakgrunden).
Så här definierar du en regel:
-
Välj Rules i den vänstra listen.
-
Välj Create New Rule.
-
I dialogrutan Create Rule:
-
Namnge regeln, till exempel
Application Status
. -
Välj + Add under Events.
-
I dialogrutan Event Configuration:
-
Välj Mobile Core i listan Extension.
-
Välj Foreground i listan Event Type.
-
Välj Keep Changes.
-
-
Klicka på bredvid Mobile Core - Foreground.
-
Välj Mobile Core i listan Extension.
-
Välj Background i listan Event Type.
-
Välj Keep Changes.
-
-
Klicka på Lägg till under ACTIONS. I dialogrutan Action Configuration:
-
Välj Adobe Experience Platform Edge Network i listan Extension.
-
Välj Forward event to Edge Network i listan Action Type.
-
Välj Keep Changes.
-
-
Regeln ska se ut så här:
-
Välj Save.
-
Ovanstående är bara ett exempel på en regel som skickar XDM-data med programstatus till Adobe Edge-nätverket och till Adobe Experience Platform.
Du kan använda regler på olika sätt i taggen för att hantera variabler (med dataelementen).
Mer information finns i Regler.
Bygg och Publish din tagg
När du har definierat dataelement och regler måste du skapa och publicera taggen. När du skapar en biblioteksversion måste du tilldela den till en miljö. Byggnadens tillägg, regler och dataelement kompileras sedan och placeras i den tilldelade miljön. Varje miljö har en unik inbäddningskod som gör att du kan integrera den tilldelade inbäddningen på din plats.
Så här skapar och publicerar du en tagg:
-
Välj Publishing Flow i den vänstra listen.
-
Välj Select a working library följt av Add Library….
-
I dialogrutan Create Library:
-
Namnge biblioteket.
-
Välj Development (development) i listan Environment.
-
Välj + Add All Changed Resources.
-
Välj Save & Build to Development.
Taggen sparas och byggs för din utvecklingsmiljö. En grön punkt visar att taggen har skapats på utvecklingsmiljön.
-
-
Du kan välja … om du vill återskapa biblioteket eller flytta biblioteket till en staging- eller produktionsmiljö.
Adobe Experience Platform Tags hanterar enkla till komplexa publiceringsflöden som passar er användning av Adobe Experience Platform Edge Network.
Mer information finns i Översikt över publicering.
Hämta din taggkod
Slutligen måste du använda taggen i den mobilapp du vill spåra.
Så här får du kodanvisningar som förklarar hur du konfigurerar din mobilapp och använder taggen i appen:
-
Välj Environments i den vänstra listen.
-
Välj rätt installationsknapp i listan över miljöer.
Välj lämplig plattform (iOS, Android) i dialogrutan Mobile Install Instructions. Använd sedan knappen bredvid vart och ett av de relevanta kodfragmenten som du vill använda för att konfigurera och initiera din mobilapp:
-
Välj Close.
I stället för koden för utvecklingsmiljön kan du ha valt en annan miljö (testmiljö, produktion) baserat på var du håller på att distribuera Adobe Experience Platform Mobile SDK.
Mer information finns i Miljö.
Distribuera och validera
Nu kan du distribuera koden i din mobilapp. När appen distribueras börjar den samla in data till Adobe Experience Platform.
Validera implementeringen, korrigera den där det behövs och installera den sedan korrekt i din staging- och produktionsmiljö med publiceringsarbetsflödesfunktionen i Tags.
Se självstudiekursen Implementera Adobe Experience Cloud i mobilappar för mer detaljerad information.
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 upprätta 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.
-
På skärmen Untitled connection:
Namnge och beskriv din anslutning i Connection Settings.
Välj rätt sandlåda i listan Sandbox i Data settings och välj antalet dagliga händelser i listan Average number of daily events.
Välj Add datasets.
I steget Select datasets i Add datasets:
-
Välj datauppsättningar som du har skapat tidigare och/eller andra relevanta datauppsättningar som du vill inkludera i din anslutning (till exempel data för Push Tracking Experience Events och Push Profile från Adobe Journey Optimizer)
-
Välj Next.
I steget Datasets settings i Add datasets:
-
För varje datauppsättning:
-
Välj en Person ID bland de tillgängliga identiteter som definieras i datauppsättningsscheman i Adobe Experience Platform.
-
Välj rätt datakälla i listan Data source type. Om du anger Other lägger du till en beskrivning för datakällan.
-
Ange Import all new data och Dataset backfill existing data enligt dina inställningar.
-
-
Välj Add datasets.
Välj Save.
-
Mer information om hur du skapar och hanterar en anslutning och hur du väljer och kombinerar datauppsättningar finns i Anslutningsöversikt.
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 steget Configure:
Välj din anslutning i listan Connection.
Namn och (eventuellt) beskrivning av anslutningen.
Välj Save and continue.
-
I steget Components:
Lägg till alla schemafält och/eller standardkomponenter som du vill inkludera i komponentrutorna METRICS eller DIMENSIONS.
Välj Save and continue.
-
I steget Settings:
Låt inställningarna vara som de är och välj Save and finish.
Mer information om hur du skapar och redigerar en datavy finns i Översikt över datavyer, vilka komponenter som är tillgängliga för dig och hur du använder inställningar för filter och sessioner.
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ått på Freeform table i Panel . Du kan till exempel dra
Events
som mått ochPush Title
som dimension, uppdelat efterEvent Type
, för att få en översikt över dina push-meddelanden för din mobilapp och vad som hände med dem.
Mer information om hur du skapar projekt och bygger analyser med komponenter, visualiseringar och paneler finns i Översikt över Analysis Workspace .