Installera Adobe Experience Platform Mobile SDKs tutorial_install_mobile_sdks
Lär dig implementera Adobe Experience Platform Mobile SDK i en mobilapp.
Förhandskrav
- Ett taggbibliotek med tilläggen som beskrivs i föregående lektion har skapats.
- Fil-ID för utvecklingsmiljö från Mobile Install Instructions.
- exempelappen för iOS eller exempelappen för Android hämtades.
- Upplev Xcode (iOS) eller Android Studio (Android)
Utbildningsmål
I den här lektionen kommer du att:
- Lägg till de SDK:er som behövs i ditt projekt.
- Registrera tilläggen.
Swift Package Manager
I stället för att använda CocoaPods och en Pod-fil (enligt anvisningarna i Generera installationsanvisningar för SDK), lägger du till enskilda paket med Xcodes inbyggda Swift Package Manager. Xcode-projektet har redan alla paketberoenden tillagda. Xcode Package Dependencies-skärmen ska se ut så här:
I Xcode kan du använda File > Add Packages… för att lägga till paket. Tabellen nedan innehåller länkar till de URL:er som du skulle använda för att lägga till paket. Länkarna visar även mer information om varje paket.
table 0-row-2 1-row-2 2-row-2 3-row-2 4-row-2 5-row-2 6-row-2 7-row-2 8-row-2 9-row-2 | |
---|---|
Paket | Beskrivning |
AEP Core |
Tilläggen
|
AEP Edge | Med mobiltillägget Adobe Experience Platform Edge Network (AEPEdge ) kan du skicka data till Adobe Edge Network från ett mobilprogram. Med det här tillägget kan du implementera Adobe Experience Cloud-funktioner på ett mer robust sätt, leverera flera Adobe-lösningar via ett enda nätverksanrop och samtidigt vidarebefordra informationen till Adobe Experience Platform.Mobiltillägget för Edge Network är ett tillägg för Adobe Experience Platform SDK. Tillägget kräver tilläggen AEPCore och AEPServices för händelsehantering samt tillägget AEPEdgeIdentity för att hämta identiteter, som ECID. |
AEP Edge Identity | Med mobiltillägget Adobe Experience Platform Edge Identity (AEPEdgeIdentity ) kan du hantera användaridentitetsdata från ett mobilprogram när du använder Adobe Experience Platform SDK och Edge Network. |
AEP Edge Consent | Med mobiltillägget Adobe Experience Platform Consent Collection (AEPConsent ) aktiveras insamling av medgivandeinställningar från mobilprogrammet när Adobe Experience Platform SDK och Edge Network-tillägget används. |
AEP-användarprofil | Tillägget Adobe Experience Platform User Profile Mobile (AEPUserProfile ) är ett tillägg för att hantera användarprofiler för Adobe Experience Platform SDK. |
AEP Platser | Med tillägget Adobe Experience Platform Places (AEPPlaces ) kan du spåra geopositioneringshändelser enligt definitionen i gränssnittet för Adobe Platser och i taggreglerna för Adobe Data Collection. |
AEP Messaging | Med Adobe Experience Platform Messaging-tillägget (AEPMessaging ) kan du skicka push-meddelandetokens och push-meddelanden via klickning till Adobe Experience Platform. |
AEP Optimize | Tillägget Adobe Experience Platform Optimize (AEPOptimize ) innehåller API:er för att aktivera arbetsflöden för personalisering i realtid i Adobe Experience Platform Mobile SDK:er med Adobe Target eller Adobe Journey Optimizer Offer Decisioning. Det krävs AEPCore och AEPEdge tillägg för att skicka personaliseringsfrågehändelser till Experience Edge Network. |
AEP Assurance | Adobe Experience Platform Assurance är en produkt från Adobe Experience Cloud som hjälper er att inspektera, bevisa, simulera och validera hur ni samlar in data eller levererar upplevelser i er mobilapp. |
Importera tillägg
Öppna projektet i Xcode i mappen Start i exempelprogrammet.
I Xcode går du till Luma > Luma > AppDelegate och ser till att följande importer är en del av den här källfilen.
code language-swift |
---|
|
Gör samma sak för Luma > Luma > Utils > MobileSDK.
Uppdatera AppDelegate
Navigera till Luma > Luma > AppDelegate i Xcode Project-navigatorn.
-
Ersätt
@AppStorage
-värdetYOUR_ENVIRONMENT_ID_GOES_HERE
förenvironmentFileId
med det miljöfil-ID som du hämtade från taggar i Generera installationsanvisningar för SDK.code language-swift @AppStorage("environmentFileId") private var environmentFileId = "YOUR_ENVIRONMENT_ID_GOES_HERE"
-
Lägg till följande kod i funktionen
application(_, didFinishLaunchingWithOptions)
.code language-swift // Define extensions 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 ] // Register extensions MobileCore.registerExtensions(extensions, { // Use the environment file id assigned to this application via Adobe Experience Platform Data Collection Logger.aepMobileSDK.info("Luma - using mobile config: \(self.environmentFileId)") MobileCore.configureWith(appId: self.environmentFileId) // set this to false or comment it when deploying to TestFlight (default is false), // set this to true when testing on your device. MobileCore.updateConfigurationWith(configDict: ["messaging.useSandbox": true]) if appState != .background { // only start lifecycle if the application is not in the background MobileCore.lifecycleStart(additionalContextData: nil) } // assume unknown, adapt to your needs. MobileCore.setPrivacyStatus(.unknown) })
Koden ovan gör följande:
- Registrerar nödvändiga tillägg.
- Konfigurerar MobileCore och andra tillägg så att taggegenskapskonfigurationen används.
- Aktiverar felsökningsloggning. Mer information och alternativ finns i Adobe Experience Platform Mobile SDK-dokumentationen.
- Startar livscykelövervakning. Mer information finns i steget Livscykel i självstudiekursen.
- Anger okänt standardsamtycke. Mer information finns i steget Medgivande i självstudiekursen.
Se till att du uppdaterar MobileCore.configureWith(appId: self.environmentFileId)
med appId
baserat på environmentFileId
från den taggmiljö som du skapar för (utveckling, mellanlagring eller produktion).
Gråta
Du använder beroendena från Generera installationsanvisningar för SDK för att lägga till enskilda paket med hjälp av Gradle-integreringen med Android Studio. Android Studio-projektet har redan alla paketberoenden tillagda.
-
Välj
-
Välj vyn Android.
-
Välj Gradle scripts > build.gradle.kts (Module :app) i den vänstra rutan. I den högra rutan rullar du sedan tills du ser
dependencies
.
I Android Studio kan du använda File > Project Structure… för att lägga till modulberoenden. Välj Dependencies och använd sedan Modules
table 0-row-2 1-row-2 2-row-2 3-row-2 4-row-2 5-row-2 6-row-2 7-row-2 8-row-2 9-row-2 | |
---|---|
Package com.adobe. marketing.mobile: |
Beskrivning |
core |
Tilläggen
|
kant | Med mobiltillägget Adobe Experience Platform Edge Network (AEPEdge ) kan du skicka data till Adobe Edge Network från ett mobilprogram. Med det här tillägget kan du implementera Adobe Experience Cloud-funktioner på ett mer robust sätt, leverera flera Adobe-lösningar via ett enda nätverksanrop och samtidigt vidarebefordra informationen till Adobe Experience Platform.Mobiltillägget för Edge Network är ett tillägg för Adobe Experience Platform SDK. Tillägget kräver tilläggen Mobile Core och Services för händelsehantering. Tillägget Identity for Edge Network för att hämta identiteter, t.ex. ECID. |
edgeidentity | Med mobiltillägget Adobe Experience Platform Edge Identity kan man hantera användaridentitetsdata från mobilappar med Adobe Experience Platform SDK och Edge Network. |
edgeconsent | Med mobiltillägget Adobe Experience Platform Consent Collection kan du samla in medgivandeinställningar från mobilprogrammet när du använder Adobe Experience Platform SDK och Edge Network-tillägget. |
userprofile | Tillägget Adobe Experience Platform User Profile Mobile är ett tillägg för hantering av användarprofiler för Adobe Experience Platform SDK. |
platser | Adobe Platser Service är en geolokaliseringstjänst som gör att mobilappar med platsmedvetenhet kan användas. Och för att förstå lokaliseringskontexten genom att använda avancerade och lättanvända SDK-gränssnitt som åtföljs av en flexibel databas med intressepunkter (POI). Mer information finns i dokumentationen för platstjänster. Den här tjänsten är Platser-mobiltillägget för Android 2.x Adobe Experience Platform SDK och kräver Core-tillägget för händelsehantering. |
meddelanden | Tillägget Adobe Experience Platform Messaging hanterar push-meddelanden, meddelanden i appen och kodbaserade upplevelser för era mobilappar. Det här tillägget hjälper dig även att samla in push-tokens för användare och hantera interaktionsmätningar med Adobe Experience Platform tjänster. |
optimera | Tillägget Adobe Experience Platform Optimize innehåller API:er som möjliggör personalisering i realtid i Adobe Experience Platform SDK:er med Adobe Target eller Adobe Journey Optimizer Offer Decisioning. Det är beroende av Mobile Core och kräver att Edge Extension skickar personaliseringshändelser till Experience Edge Network. |
säkring | Assurance (även kallat Griffon-projektet) är ett mobiltillägg för Adobe Experience Platform som gör det möjligt att integrera med Adobe Experience Platform Assurance. Tillägget hjälper er att inspektera, bevisa, simulera och validera hur ni samlar in data eller levererar upplevelser i er mobilapp. Det här tillägget kräver MobileCore. |
Importera tillägg
I Android Studio går du till app > kotlin+java > com.adobe.luma.tutorial.android > LumaApplication och ser till att följande importer är en del av källfilen.
code language-kotlin |
---|
|
Gör samma sak för app > kotlin+java > com.adobe.luma.tutorial.android > models > MobileSDK.
Uppdatera LumaApplication
I vyn Android går du till app > kotlin+java > com.adobe.luma.tutorial.android > LumaApplication i Android Studio.
-
Ersätt
"YOUR_ENVIRONMENT_FILE_ID"
iprivate var environmentFileId = "YOUR_ENVIRONMENT_ID_GOES_HERE"
med det ID-värde för miljöfil som du hämtade från taggar i Generera installationsanvisningar för SDK.code language-kotlin private var environmentFileId = "YOUR_ENVIRONMENT_ID_GOES_HERE"
-
Lägg till följande kod i funktionen
override fun onCreate()
iclass LumaApplication : Application()
.code language-kotlin // Define extensions val extensions = listOf( Identity.EXTENSION, Lifecycle.EXTENSION, Signal.EXTENSION, Edge.EXTENSION, Consent.EXTENSION, UserProfile.EXTENSION, Places.EXTENSION, Messaging.EXTENSION, Optimize.EXTENSION, Assurance.EXTENSION ) // Register extensions MobileCore.registerExtensions(extensions) { // Use the environment file id assigned to this application via Adobe Experience Platform Data Collection Log.i("Luma", "Using mobile config: $environmentFileId") MobileCore.configureWithAppID(environmentFileId) // set this to true when testing on your device, default is false. //MobileCore.updateConfiguration(mapOf("messaging.useSandbox" to true)) // assume unknown, adapt to your needs. MobileCore.setPrivacyStatus(MobilePrivacyStatus.UNKNOWN) }
Koden ovan gör följande:
- Registrerar nödvändiga tillägg.
- Konfigurerar MobileCore och andra tillägg så att taggegenskapskonfigurationen används.
- Aktiverar felsökningsloggning. Mer information och alternativ finns i Adobe Experience Platform Mobile SDK-dokumentationen.
- Startar livscykelövervakning. Mer information finns i steget Livscykel i självstudiekursen.
- Anger okänt standardsamtycke. Mer information finns i steget Medgivande i självstudiekursen.
Se till att du uppdaterar MobileCore.configureWith(environmentFileId)
med environmentFileId
baserat på miljöfil-ID:t från den taggmiljö som du skapar för (utveckling, mellanlagring eller produktion).
Nästa: Konfigurera Assurance