Gegevens verzamelen via de Adobe Experience Platform Mobile SDK
In deze snelstartgids wordt uitgelegd hoe u gegevens voor het bijhouden van mobiele apps rechtstreeks in Adobe Experience Platform kunt opnemen met de Adobe Experience Platform Mobile SDK 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.
-
Tags gebruiken om regels en gegevenselementen eenvoudig te configureren op basis van de gegevens in uw mobiele toepassing. Vervolgens zorgt u ervoor dat de gegevens worden verzonden naar de gegevensstroom die op het Adobe Experience Platform Edge-netwerk is geconfigureerd.
-
Implementeren en valideren. Zorg voor een omgeving waarin u de ontwikkeling van tags kunt doorlopen en publiceer deze live in 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 van profielen bijhouden met uw mobiele app, bijvoorbeeld scènenaam en -identificatie.
U moet eerst een schema bepalen 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 AEP Mobile SDK ExperienceEvent veldgroep in de lijst.
U kunt de voorvertoningsknop selecteren om een voorvertoning weer te geven van de velden die deel uitmaken van deze veldgroep, zoals
application > name
.Selecteren Back om de voorvertoning te sluiten.
-
Selecteren Add field groups.
-
-
Selecteren + naast de naam van het schema in het dialoogvenster Structure deelvenster.
-
In de Field Properties paneel, enter
identification
als 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 met uw mobiele app aan de hand van de Experience Cloud-id en het e-mailadres. Er zijn vele andere eigenschappen beschikbaar om de identificatie van uw persoon te volgen (bijvoorbeeld klant identiteitskaart, loyalty identiteitskaart).
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 minimumschema gemaakt dat de gegevens modelleert die u van uw mobiele toepassing kunt vangen. 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 gegevens die zijn vastgelegd vanuit uw mobiele toepassing, worden toegevoegd aan het realtime-klantprofiel.
Naast gedragsgegevens kunt u ook profielkenmerkgegevens vastleggen vanuit uw mobiele toepassing (bijvoorbeeld gegevens over profielen die zijn geabonneerd op een nieuwsbrief).
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 het Web van Adobe Experience Platform en Mobiele SDKs. Bij het verzamelen van gegevens met de SDK's van Adobe Experience Platform 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 mobiele app 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 zijn verzameld in uw mobiele app 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.
Tags gebruiken
Als u code op uw site wilt implementeren om gegevens te verzamelen, gebruikt u de functie Codes in Adobe Experience Platform. Met deze oplossing voor tagbeheer kunt u code naast andere coderingsvereisten implementeren. Tags bieden naadloze integratie met Adobe Experience Platform met de Adobe Experience Platform Mobile SDK-extensie.
Uw tag maken
-
Selecteer in de gebruikersinterface van Adobe Experience Platform de optie Tags binnen DATA COLLECTION.
-
Selecteren New Property.
Geef de tag een naam, selecteer Mobile. Selecteren Save om door te gaan.
Uw tag configureren
Nadat u de tag hebt gemaakt, moet u deze configureren met de juiste extensies en gegevenselementen en -regels configureren op basis van de manier waarop u uw site wilt bijhouden en gegevens naar Adobe Experience Platform wilt verzenden.
Als u de nieuwe tag wilt configureren, selecteert u deze in de lijst met Tag Properties.
Extensies
Voeg de Adobe Platform Edge Network-extensie toe aan uw tag om ervoor te zorgen dat u gegevens naar Adobe Experience Platform kunt verzenden (via uw gegevensstroom).
U kunt als volgt de extensie Adobe Experience Platform Mobile SDK maken en configureren:
-
Selecteren Extensions in het linkerspoor. U ziet dat de extensies Mobiele kern en Profiel al beschikbaar zijn.
-
Selecteren Catalog in de bovenste balk.
-
Zoeken naar of schuiven naar Adobe Experience Platform Edge Network extensie en selecteren Install in het rechterdeelvenster om het te installeren.
-
Selecteer uw sandbox en uw eerder gemaakte datastream voor uw Production Environment en (optioneel) Staging Environment en Development Environment.
-
Voer uw Edge Network domain ondergronds Domain configuration. Doorgaans gebruiken
<organizationName>.data.adobedc.net
. -
Selecteren Save.
Zie De extensie Adobe Experience Platform Edge Network configureren voor meer informatie .
U wilt ook de volgende extra extensies instellen vanuit de catalogus:
- Identiteit.
- AEP-betrouwbaarheid.
- Toestemming.
Zie Een eigenschap voor een tag configureren in de Mobile App Tutorial for Experience-platform voor veel meer informatie over extensies en hun configuratie.
Gegevenselementen
Gegevenselementen zijn de bouwstenen voor uw gegevenswoordenboek (of gegevenskaart). Gebruik gegevenselementen om gegevens te verzamelen, te organiseren en te leveren over marketing- en advertentietechnologie. U stelt gegevenselementen in uw tag in die gegevens of gebeurtenissen van mobiele apps lezen en die kunnen worden gebruikt om gegevens naar Adobe Experience Platform te verzenden.
U wilt bijvoorbeeld de naam van de provider verzamelen van de mobiele app.
Een gegevenselement met de naam van een drager definiëren:
-
Selecteren Data Elements in het linkerspoor.
-
Selecteren Add Data Element.
-
In de Create Data Element dialoogvenster:
-
Geef uw gegevenselement bijvoorbeeld een naam
Carrier Name
. -
Selecteren Mobile Core van de Extension lijst.
-
Selecteren Carrier Name van de Data Element Type lijst.
-
Selecteren Save.
-
U kunt zoveel gegevenselementen maken als u wilt en deze gebruiken in regels.
Regels
Tags in Adobe Experience Platform volgen een op regels gebaseerd systeem. Zij zoeken gebruikersinteractie en bijbehorende gegevens. Wanneer aan de criteria die in uw regels worden geschetst wordt voldaan, teweegbrengt de regel de uitbreiding, het manuscript, of cliënt-zijcode in werking u identificeerde. U kunt regels gebruiken om gegevens (zoals een XDM-object) naar Adobe Experience Platform te verzenden met de Adobe Experience Platform Edge Network-extensie.
U wilt bijvoorbeeld gebeurtenisgegevens verzenden wanneer de mobiele app wordt gebruikt (op de voorgrond) en wanneer de mobiele app niet wordt gebruikt (teruggeduwd naar de achtergrond).
Een regel definiëren:
-
Selecteren Rules in het linkerspoor.
-
Selecteren Create New Rule.
-
In de Create Rule dialoogvenster:
-
Geef de regel een naam, bijvoorbeeld
Application Status
. -
Selecteren + Add ondergronds Events.
-
In de Event Configuration dialoogvenster:
-
Selecteren Mobile Core van de Extension lijst.
-
Selecteren Foreground van de Event Type lijst.
-
Selecteren Keep Changes.
-
-
Klikken naast Mobile Core - Foreground.
-
Selecteren Mobile Core van de Extension lijst.
-
Selecteren Background van de Event Type lijst.
-
Selecteren Keep Changes.
-
-
Klikken Onder toevoegen ACTIONS. In de Action Configuration dialoogvenster:
-
Selecteren Adobe Experience Platform Edge Network van de Extension lijst.
-
Selecteren Forward event to Edge Network van de Action Type lijst.
-
Selecteren Keep Changes.
-
-
Uw regel moet er als volgt uitzien:
-
Selecteren Save.
-
Het bovenstaande is slechts een voorbeeld van het definiëren van een regel die XDM-gegevens met toepassingsstatus naar het Adobe Edge-netwerk en naar Adobe Experience Platform verzendt.
U kunt regels op verschillende manieren in uw tag gebruiken om variabelen te bewerken (met behulp van uw gegevenselementen).
Zie Regels voor meer informatie .
Uw tag maken en publiceren
Nadat u gegevenselementen en regels hebt gedefinieerd, moet u de tag maken en publiceren. Wanneer u een bibliotheek maakt, moet u deze toewijzen aan een omgeving. De uitbreidingen, de regels, en de gegevenselementen van de bouwstijl worden dan gecompileerd en in het toegewezen milieu geplaatst. Elke omgeving bevat een unieke insluitcode waarmee u de toegewezen build in uw site kunt integreren.
Om uw markering te bouwen en te publiceren:
-
Selecteren Publishing Flow van de linkerspoorstaaf.
-
Selecteren Select a working library, gevolgd door Add Library….
-
In de Create Library dialoogvenster:
-
Geef de bibliotheek een naam.
-
Selecteren Development (development) van de Environment lijst.
-
Selecteren + Add All Changed Resources.
-
Selecteren Save & Build to Development.
Uw tag wordt opgeslagen en gebouwd voor uw ontwikkelomgeving. Een groene stip geeft aan dat uw tag met succes is opgebouwd in uw ontwikkelomgeving.
-
-
U kunt … om de bibliotheek opnieuw op te bouwen of de bibliotheek naar een testomgeving of productieomgeving te verplaatsen.
Adobe Experience Platform-tags bieden ondersteuning voor eenvoudige tot complexe publicatieworkflows die geschikt zijn voor uw implementatie van het Adobe Experience Platform Edge Network.
Zie Overzicht van publicatie voor meer informatie .
De tagcode ophalen
Tot slot moet u uw tag gebruiken in de mobiele app die u wilt bijhouden.
U kunt als volgt code-instructies opvragen waarin wordt uitgelegd hoe u uw mobiele app instelt en uw tag in de app gebruikt:
-
Selecteren Environments in het linkerspoor.
-
Selecteer de juiste installatie in de lijst met omgevingen knop.
In de Mobile Install Instructions selecteert u het juiste platform (iOS, Android). Gebruik vervolgens de kopie naast elk relevant codefragment dat u wilt gebruiken voor het instellen en initialiseren van uw mobiele app:
-
Selecteren Close.
In plaats van de code voor de ontwikkelomgeving, had u een andere omgeving (staging, productie) kunnen selecteren op basis van waar u bezig bent met het implementeren van de Adobe Experience Platform Mobile SDK.
Zie Omgevingen voor meer informatie .
Implementeren en valideren
U kunt de code nu implementeren in uw mobiele app. Wanneer deze wordt geïmplementeerd, begint uw mobiele app gegevens te verzamelen in Adobe Experience Platform.
Valideer uw implementatie, verbeter het waar nodig, en zodra correct, stel het in uw het opvoeren en productiemilieu gebruikend de het publiceren werkschemafunctie van Markeringen op.
Zie Zelfstudie Adobe Experience Cloud implementeren in mobiele apps voor veel gedetailleerdere informatie.
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 eerder hebt gemaakt en/of andere relevante datasets die u wilt opnemen in uw verbinding (bijvoorbeeld Gegevens van gebeurtenissen voor het bijhouden van push-ervaringen en gegevens van het pushprofiel uit Adobe Journey Optimizer)
-
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 . Als voorbeeld sleept u
Events
als metriek enPush Title
als dimensie, uitgesplitst naarEvent Type
voor een overzicht van uw pushberichten voor uw mobiele app en wat er met hen is gebeurd.
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.