Documentatie Experience Platform Tutorial voor mobiele apps

Optimaliseren en aanpassen met Adobe Target

Laatst bijgewerkt: 14 oktober 2025

Onderwerpen:
A/B-tests

Gemaakt voor:

Beginner
tussenpersoon
Ontwikkelaar

Leer hoe u de ervaringen in uw mobiele apps kunt optimaliseren en aanpassen met Platform Mobile SDK en Adobe Target.

Het doel biedt alles wat u moet aanpassen en aanpassen aan de ervaringen van uw klanten. Met Doel kunt u uw omzet maximaliseren op uw website en mobiele sites, apps, sociale media en andere digitale kanalen. Het doel kan tests A/B, multivariate tests uitvoeren, producten en inhoud, doelinhoud adviseren, inhoud auto-personalize met AI, en veel meer. De nadruk in deze les is op de A/B testfunctionaliteit van Doel. Zie het overzicht van de Test A/B voor meer informatie.

Architectuur

Voordat u A/B-tests kunt uitvoeren met Target, moet u ervoor zorgen dat de juiste configuraties en integratie zijn geïnstalleerd.

OPMERKING

Deze les is optioneel en is alleen van toepassing op Adobe Target-gebruikers die A/B-tests willen uitvoeren.

Vereisten

App met SDK's geïnstalleerd en geconfigureerd met succes gemaakt en uitgevoerd.
Toegang tot Adobe Target met toestemmingen, behoorlijk gevormde rollen, werkruimten, en eigenschappen .

Leerdoelstellingen

In deze les zult u:

Werk uw gegevensstroom bij voor integratie van het Doel.
Werk de eigenschap tag bij met de extensie Offer Decisioning en Target.
Werk uw schema bij om aanvraaggebeurtenissen vast te leggen.
Instellingen valideren in Assurance.
Maak een eenvoudige A/B-test in Doel.
Werk uw app bij om de extensie Optimizer te registreren.
Implementeer de A/B-test in uw app.
Implementatie valideren in Assurance.

Instellen

TIP

Als u opstelling uw app reeds als deel van Journey Optimizer aanbiedingen les hebt, zou u sommige stappen in deze opstellingssectie reeds kunnen reeds uitgevoerd.

Gegevensstroomconfiguratie bijwerken

Adobe Target

Om ervoor te zorgen dat gegevens die u van uw mobiele app naar Experience Platform Edge Network verzendt, naar Adobe Target worden doorgestuurd, moet u de configuratie van de gegevensstroom bijwerken.

Selecteer Datastreams in de gebruikersinterface voor gegevensverzameling en selecteer de gegevensstroom, bijvoorbeeld Luma Mobile App .
Selecteer Add Service en selecteer Adobe Target in de lijst Service .
Als u een Target Premium-klant bent en eigenschapstokens wilt gebruiken, voert u de waarde Target Property Token in die u voor deze integratie wilt gebruiken. Target Standard-gebruikers kunnen deze stap overslaan.

U kunt de eigenschappen vinden in de doelinterface, in Administration > Properties . Selecteer om het bezitstoken voor het bezit te openbaren u wilt gebruiken. De eigenschapstoken heeft een indeling zoals "at_property": "xxxxxxxx-xxxx-xxxxx-xxxx-xxxxxxxxxxxx" ; u moet alleen de waarde xxxxxxxx-xxxx-xxxxx-xxxx-xxxxxxxxxxxx invoeren.

U kunt ook een doel-omgeving-id opgeven. Het doel gebruikt omgevingen om uw sites en pre-productieomgevingen te organiseren voor eenvoudig beheer en afzonderlijke rapportering. De vooraf ingestelde omgevingen zijn onder andere Productie, Staging en Ontwikkeling. Zie Milieu en identiteitskaart van het Milieu van het Doel voor meer informatie.

U kunt desgewenst een naamruimte van een externe doelid opgeven ter ondersteuning van profielsynchronisatie op een naamruimte van een identiteit (bijvoorbeeld CRM-id). Zie identiteitskaart van de Derde van het Doel namespace voor meer informatie.
Selecteer Save.

toe

Adobe Journey Optimizer

Om ervoor te zorgen dat gegevens die u van uw mobiele app naar de Edge Network verzendt, naar Journey Optimizer - Beslissingsbeheer worden doorgestuurd, werkt u de configuratie van uw gegevensstroom bij.

Selecteer Datastreams in de gebruikersinterface voor gegevensverzameling en selecteer de gegevensstroom, bijvoorbeeld Luma Mobile App .
Selecteer voor Experience Platform en selecteer Edit van het contextmenu.
In Datastreams > > Adobe Experience Platform scherm, zorg ervoor dat Offer Decisioning, Edge Segmentation, en Personalization Destinations worden geselecteerd. Als u ook de Journey Optimizer-lessen volgt, selecteert u Adobe Journey Optimizer . Zie {de montages van 0} Adobe Experience Platform voor meer informatie.
Selecteer Save om de configuratie van de gegevensstroom op te slaan.

Offer Decisioning- en Target-tagextensie installeren

Hoewel deze les over tests A/B in Doel is, wordt het resultaat van een test gezien als een aanbieding en in de infrastructuur van Adobe uitgevoerd gebruikend de de markeringen van Adobe Offer Decisioning en van het Doel uitbreiding. Deze extensie werkt met zowel Journey Optimizer- als Target-aanbiedingen.

Navigeer naar Tags , zoek de eigenschap mobile tag en open de eigenschap.
Selecteer Extensions.
Selecteer Catalog.
Zoek naar de extensie Offer Decisioning and Target .
De extensie installeren. Voor de extensie is geen aanvullende configuratie vereist.

Uw schema bijwerken

Navigeer naar de interface voor gegevensverzameling en selecteer Schemas in de linkertrack.
Selecteer Browse in de bovenste balk.
Selecteer het schema om het te openen.
In de schemaredacteur, voegt de uitgezochte toe Add naast Field groups.
Zoek in het dialoogvenster Add field groups naar proposition , selecteer Experience Event - Proposition Interactions en selecteer Add field groups .
Selecteer Save om de wijzigingen in het schema op te slaan.

Instellingen valideren in Assurance

Uw instellingen valideren in Assurance:

Ga naar de gebruikersinterface van Assurance.
Selecteer Configure in linkerspoor en selecteer naast Validate Setup onder OFFER DECISIONING AND TARGET.
Selecteer Save.
Selecteer Validate Setup in het linkerspoor. Zowel de gegevensstroomopstelling wordt bevestigd als de opstelling van SDK in uw toepassing.

Een A/B-test maken

Er zijn vele soorten activiteiten die u kunt maken in Adobe Target en implementeren in een mobiele app, zoals vermeld in de inleiding. Voor deze les, voert u een test A/B uit.

Selecteer in de interface Doel de optie Activities in de bovenste balk.
Selecteer Create Activity en A/B Test in het contextmenu.
Selecteer Create A/B Test Activity als Mobile in het dialoogvenster Type en selecteer een werkruimte in de lijst Choose Workspace . Selecteer uw eigenschap in de lijst Choose property als u een Target Premium-klant bent en een eigenschapstoken hebt opgegeven in de gegevensstroom.
Selecteer Create.

In het Untitled Activity -scherm voert u bij de Experiences -stap het volgende uit:

Voer luma-mobileapp-abtest in Select Location onder Location 1 in. Deze locatienaam (vaak mbox genoemd) wordt later gebruikt in de app-implementatie.
Selecteer naast Content en selecteer Create JSON Offer van het contextmenu.

Plak de volgende JSON in het dialoogvenster Create JSON Offer .

{
    "title": "Luma Anaolog Watch",
    "text": "Designed to stand up to your active lifestyle, this women's Luma Analog Watch features a tasteful brushed chrome finish and a stainless steel, water-resistant construction for lasting durability.",
    "image": "https://luma.enablementadobe.com/content/dam/luma/en/products/gear/watches/Luma_Analog_Watch.jpg"
}

Ervaring A

Selecteer Create.

Selecteer + naast Experiences om toe te voegen Experience B .

Herhaal stap b en c voor Ervaring B, maar gebruik in plaats daarvan Aim Analog Watch als de titel en plak de volgende JSON:

{
    "title": "Aim Analog Watch",
    "text": "The flexible, rubberized strap is contoured to conform to the shape of your wrist for a comfortable all-day fit. The face features three illuminated hands, a digital read-out of the current time, and stopwatch functions.",
    "image": "https://luma.enablementadobe.com/content/dam/luma/en/products/gear/watches/Aim_Watch.jpg"
}

Controleer in de stap Targeting de instelling van uw A/B-test. Beide aanbiedingen worden standaard in gelijke mate toegewezen aan alle bezoekers. Selecteer Next om door te gaan.
In de stap Goals & Settings :
1. Wijzig de naam van de activiteit zonder naam, bijvoorbeeld in Luma Mobile SDK Tutorial - A/B Test Example .
2. Voer bijvoorbeeld Objective in voor de A/B-test A/B Test for Luma mobile app tutorial .
3. Selecteer Conversion , Viewed an mbox in de tegel Goal Metric > MY PRIMARY GOAL en voer de naam van uw locatie (mbox) in, bijvoorbeeld luma-mobileapp-abtest .
4. Selecteer Save & Close.
Terug in het All Activities scherm:
1. Selecteer bij uw activiteit.
2. Selecteer Activate om uw test te activeren A/B.

Doel implementeren in uw app

Zoals in vorige lessen is besproken, biedt het installeren van een extensie voor mobiele tags alleen de configuratie. Vervolgens moet u de Optimize SDK installeren en registreren. Als deze stappen niet duidelijk zijn, herzie installeer SDKs sectie.

NOTE

Als u voltooide installeerde SDKs sectie, dan is SDK reeds geïnstalleerd en u kunt deze stap overslaan.

iOS

In Xcode, zorg ervoor dat AEP optimaliseert aan de lijst van pakketten in de Afhankelijkheden van het Pakket wordt toegevoegd. Zie {de Manager van het Pakket van 0} Swift .
Navigeer naar Luma > Luma > AppDelegate in de Xcode-projectnavigator.
Controleer of AEPOptimize deel uitmaakt van uw lijst met importbewerkingen.

import AEPOptimize

Controleer of Optimize.self deel uitmaakt van de array met extensies die u registreert.

let extensions = [
    AEPIdentity.Identity.self,
    Lifecycle.self,
    Signal.self,
    Edge.self,
    AEPEdgeIdentity.Identity.self,
    Consent.self,
    UserProfile.self,
    Places.self,
    Messaging.self,
    Optimize.self,
    Assurance.self
]

Navigeer naar Luma > Luma > Utils > MobileSDK in de Xcode-projectnavigator. Zoek de functie func updatePropositionAT(ecid: String, location: String) async . Voeg de volgende code toe:
// set up the XDM dictionary, define decision scope and call update proposition API Task { let ecid = ["ECID" : ["id" : ecid, "primary" : true] as [String : Any]] let identityMap = ["identityMap" : ecid] let xdmData = ["xdm" : identityMap] let decisionScope = DecisionScope(name: location) Optimize.clearCachedPropositions() Optimize.updatePropositions(for: [decisionScope], withXdm: xdmData) { data, error in if let error = error { Logger.aepMobileSDK.error("MobileSDK - updatePropositionsAT: Error updating propositions: \(error.localizedDescription)") } } }
Deze functie:
- stelt een XDM-woordenboek xdmData in met de ECID om het profiel te identificeren waarvoor u de A/B-test moet presenteren, en
- definieert een decisionScope , een array met locaties waarop de A/B-test moet worden gepresenteerd.
Dan roept de functie twee APIs: Optimize.clearCachedPropositions en Optimize.updatePropositions . Met deze functies worden alle in de cache opgeslagen voorstellingen gewist en worden de voorstellingen voor dit profiel bijgewerkt. Een voorstel in deze context is de ervaring (aanbieding) die van de activiteit van het Doel (uw test A/B) wordt geselecteerd en die u in creeerde een test A/B .
Navigeer naar Luma > Luma > Views > Personalization > TargetOffersView in de Xcode-projectnavigator. Zoek de functie func onPropositionsUpdateAT(location: String) async { en inspecteer de code van deze functie. Het belangrijkste deel van deze functie is de Optimize.onPropositionsUpdate API vraag, die:
- wint de voorstellen voor het huidige profiel terug dat op het beslissingswerkingsgebied wordt gebaseerd (die de plaats is u in de A/B Test hebt bepaald);
- het aanbod uit het voorstel ophaalt;
- de inhoud van de aanbieding opheft, zodat deze correct in de app kan worden weergegeven, en
- activeert de displayed() -actie op de aanbieding die een gebeurtenis terugstuurt naar Platform Edge Network op de hoogte dat de aanbieding wordt weergegeven.
Nog steeds in TargetOffersView , voeg de volgende code aan de .onFirstAppear bepaling toe. Deze code zorgt ervoor dat callback voor het bijwerken van de aanbiedingen slechts eenmaal wordt geregistreerd.
// Invoke callback for offer updates Task { await self.onPropositionsUpdateAT(location: location) }
Nog steeds in TargetOffersView , voeg de volgende code aan de .task bepaling toe. Met deze code worden de aanbiedingen bijgewerkt wanneer de weergave wordt vernieuwd.
// Clear and update offers await self.updatePropositionsAT(ecid: currentEcid, location: location)

Android

In de Studio van Android, zorg ervoor dat aepsdk-optimize-android deel van de gebiedsdelen in build.gradle.kts in Android > Gradle Scripts uitmaakt. Zie Gradle .
Navigeer naar app > kotlin+java > com.adobe.luma.tutorial.android > MainActivity in de Android Studio-navigator.
Controleer of Optimize deel uitmaakt van uw lijst met importbewerkingen.
import com.adobe.marketing.mobile.optimize.Optimize

Controleer of Optimize.EXTENSION deel uitmaakt van de array met extensies die u registreert.

val extensions = listOf(
   Identity.EXTENSION,
   Lifecycle.EXTENSION,
   Signal.EXTENSION,
   Edge.EXTENSION,
   Consent.EXTENSION,
   UserProfile.EXTENSION,
   Places.EXTENSION,
   Messaging.EXTENSION,
   Optimize.EXTENSION,
   Assurance.EXTENSION
)

Navigeer aan Android > app > kotlin+java > com.adobe.luma.tutorial.android > models > MobileSDK in de navigator van Android Studio. Zoek de functie suspend fun updatePropositionsAT(ecid: String, location: String) . Voeg de volgende code toe:

// set up the XDM dictionary, define decision scope and call update proposition API
withContext(Dispatchers.IO) {
    val ecidMap = mapOf("ECID" to mapOf("id" to ecid, "primary" to true))
    val identityMap = mapOf("identityMap" to ecidMap)
    val xdmData = mapOf("xdm" to identityMap)
    val decisionScope = DecisionScope(location)
    Optimize.clearCachedPropositions()
    Optimize.updatePropositions(listOf(decisionScope), xdmData, null, object :
        AdobeCallbackWithOptimizeError<MutableMap<DecisionScope?, OptimizeProposition?>?> {
        override fun fail(optimizeError: AEPOptimizeError?) {
            val responseError = optimizeError
            Log.i("MobileSDK", "updatePropositionsAT error: ${responseError}")
        }
        override fun call(propositionsMap: MutableMap<DecisionScope?, OptimizeProposition?>?) {
            val responseMap = propositionsMap
            Log.i("MobileSDK", "updatePropositionsOD call: ${responseMap}")
        }
    })
}

Deze functie:

stelt een XDM-woordenboek xdmData in met de ECID om het profiel te identificeren waarvoor u de A/B-test moet presenteren, en
definieert een decisionScope , een array met locaties waarop de A/B-test moet worden gepresenteerd.

Dan roept de functie twee API's: Optimize.clearCachedPropositions en Optimize.updatePropositions . Met deze functies worden alle in de cache opgeslagen voorstellingen gewist en worden de voorstellingen voor dit profiel bijgewerkt. Een voorstel in deze context is de ervaring (aanbieding) die van de activiteit van het Doel (uw test A/B) wordt geselecteerd en die u in creeerde een test A/B .

Navigeer naar app > kotlin+java > com.adobe.luma.tutorial.android > views > TargetOffers.kt in de Android Studio-navigator. Zoek de functie fun onPropositionsUpdateAT(location: String): List<OfferItem> en inspecteer de code van deze functie. Het belangrijkste deel van deze functie is de Optimize.onPropositionsUpdate API vraag, die:
- wint de voorstellen voor het huidige profiel terug dat op het beslissingswerkingsgebied wordt gebaseerd (die de plaats is u in de A/B Test hebt bepaald);
- het aanbod uit het voorstel ophaalt;
- de inhoud van de aanbieding opheft, zodat deze correct in de app kan worden weergegeven, en
- retourneert het voorstel.

Voeg nog steeds in TargetOffers.kt de functie LaunchedEffect toe om ervoor te zorgen dat de aanbiedingen worden vernieuwd wanneer u het tabblad Personalization start.

// recompose the view when the number of received offers changes
LaunchedEffect(offersAT.count()) {
    updatePropositionsAT(currentEcid, MobileSDK.shared.targetLocation.value)
    offersAT = onPropositionsUpdateAT(MobileSDK.shared.targetLocation.value)
}

U kunt extra parameters van het Doel (zoals mbox, profiel, product, of ordeparameters) in een verzoek van de verpersoonlijkingsvraag naar het netwerk van de Ervaring Edge verzenden, door hen in een gegevenswoordenboek toe te voegen wanneer het roepen van Optimize.updatePropositions API. Zie voor meer informatie Parameters van het Doel .

Valideren met de app

iOS

Rebuild en stel app in werking in de simulator of op een fysiek apparaat van Xcode, gebruikend .
Ga naar het tabblad Personalization.
Schuif omlaag naar de onderkant en u ziet een van de twee aanbiedingen die u hebt gedefinieerd in de A/B-test die wordt weergegeven in de TARGET -tegel.

Android

Rebuild en stel app in werking in de simulator of op een fysiek apparaat van de Studio van Android, gebruikend .
Ga naar het tabblad Personalization.
U ziet een van de twee aanbiedingen die u in de A/B-test hebt gedefinieerd, in het onderste vak van de TARGET -tegel worden weergegeven.

Implementatie valideren in Assurance

De A/B-test in Assurance valideren:

Herzie de sectie van opstellingsinstructies om uw simulator of apparaat met Assurance te verbinden.
Selecteer Configure in linkerspoor en selecteer naast Review & Simulate onder OFFER DECSIONING AND TARGET.
Selecteer Save.
Selecteer Review & Simulate in het linkerspoor. Zowel de gegevensstroomopstelling wordt bevestigd als de opstelling van SDK in uw toepassing.
Selecteer Requests op de bovenste balk. Uw Target -aanvragen worden weergegeven.
U kunt de tabbladen Simulate en Event List raadplegen voor extra functionaliteit waarmee u de instellingen van uw doelaanbiedingen kunt valideren.

Volgende stappen

U moet nu over alle gereedschappen beschikken om waar nodig en van toepassing meer A/B-tests of andere doelactiviteiten (zoals Experience Targeting, Multivariate Test) aan uw app toe te voegen. Er is meer diepgaande informatie beschikbaar in de reactie GitHub voor de Optimize uitbreiding waar u een verbinding aan een specifieke leerprogramma op kunt ook vinden hoe te om aanbiedingen van Adobe Target te volgen.

SUCCESS

U hebt de app voor A/B-tests ingeschakeld en de resultaten van een A/B-test met de Offer Decisioning- en Target-extensie voor de Adobe Experience Platform Mobile SDK weergegeven.

Bedankt dat je tijd hebt geïnvesteerd in het leren van Adobe Experience Platform Mobile SDK. Als u vragen hebt, algemene terugkoppelen willen delen, of suggesties over toekomstige inhoud hebben, hen op deze Communautaire besprekingspost van Experience League delen.

Volgende: Conclusie en volgende stappen

recommendation-more-help