Adobe Experience Platform Mobile SDK's installeren tutorial_install_mobile_sdks
Leer hoe u de Adobe Experience Platform Mobile SDK kunt implementeren in een mobiele app.
Vereisten
- Opvolger bouwde met succes een markeringsbibliotheek met de uitbreidingen die in de vorige lesworden beschreven.
- Identiteitskaart van het Dossier van het Milieu van de ontwikkeling van Mobiele Installatieinstructies.
- Gedownload steekproef app voor iOSof steekproef app voor Android.
- Ervaring met Xcode(iOS) of de Studio van Android(Android)
Leerdoelstellingen
In deze les zult u:
- Voeg de vereiste SDK's toe aan uw project.
- Registreer de extensies.
Swift Package Manager
In plaats van het gebruiken van CocoaPods en een dossier van de Pod (zoals die in worden geschetst produceert SDK installeert instructies), voegt u individuele pakketten toe gebruikend de inheemse Manager van het Pakket van Xcode Swift. Het Xcode-project heeft al alle pakketafhankelijkheden die voor u zijn toegevoegd. Het scherm Xcode Package Dependencies moet er als volgt uitzien:
In Xcode kunt u File > Add Packages… gebruiken om pakketten toe te voegen. De onderstaande tabel bevat koppelingen naar de URL's die u zou gebruiken om pakketten toe te voegen. De koppelingen leiden u ook naar meer informatie over elk specifiek pakket.
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 | |
---|---|
Pakket | Beschrijving |
de Kern van AEP |
De extensies
|
AEP Edge | Met de mobiele extensie Adobe Experience Platform Edge Network (AEPEdge ) kunt u gegevens verzenden naar Adobe Edge Network vanuit een mobiele toepassing. Met deze extensie kunt u Adobe Experience Cloud-mogelijkheden op een robuustere manier implementeren, meerdere Adobe-oplossingen aanbieden via één netwerkaanroep en deze informatie tegelijkertijd doorsturen naar de Adobe Experience Platform.de mobiele uitbreiding van Edge Network is een uitbreiding voor Adobe Experience Platform SDK. De extensie vereist de extensie AEPCore en AEPServices voor gebeurtenisafhandeling en de extensie AEPEdgeIdentity voor het ophalen van de identiteiten, zoals ECID. |
Edge Identiteit van AEP | Met de Adobe Experience Platform Edge Identity Mobile-extensie (AEPEdgeIdentity ) kunnen identiteitsgegevens van gebruikers van een mobiele toepassing worden verwerkt wanneer de Adobe Experience Platform SDK en de Edge Network-extensie worden gebruikt. |
AEP Edge Toestemming | Met de mobiele extensie Adobe Experience Platform Consent Collection Collection (AEPConsent ) kunt u de verzameling met voorkeuren voor toestemming van de mobiele toepassing inschakelen wanneer u de Adobe Experience Platform SDK en de Edge Network-extensie gebruikt. |
het Profiel van de Gebruiker van AEP | De extensie Adobe Experience Platform User Profile Mobile (AEPUserProfile ) is een extensie voor het beheren van gebruikersprofielen voor de Adobe Experience Platform SDK. |
Plaatsen van AEP | Met de extensie Adobe Experience Platform Places ( AEPPlaces ) kunt u gebeurtenissen voor geolocatie bijhouden zoals gedefinieerd in de interface Adobe Places en in de regels van de Adobe-tag voor gegevensverzameling. |
het Overseinen van AEP | Met de Adobe Experience Platform Messaging-extensie (AEPMessaging ) kunt u tokens voor pushberichten en doorklikbewerkingen voor pushmeldingen verzenden naar de Adobe Experience Platform. |
AEP optimaliseren | De Adobe Experience Platform Optimize-extensie (AEPOptimize ) biedt API's waarmee u realtime workflows voor personalisatie kunt inschakelen in de Adobe Experience Platform Mobile SDK's met Adobe Target of Adobe Journey Optimizer Offer Decisioning. Hiervoor zijn AEPCore - en AEPEdge -extensies nodig om verpersoonlijkingsquery-gebeurtenissen naar Experience Edge Network te verzenden. |
AEP Assurance | Adobe Experience Platform Assurance is een product van Adobe Experience Cloud dat u helpt bij het inspecteren, testen, simuleren en valideren van de manier waarop u gegevens verzamelt of ervaringen opdoet in uw mobiele app. |
Extensies importeren
Open het project in Xcode in de map Start van de voorbeeld-app.
Navigeer in Xcode naar Luma > Luma > AppDelegate en controleer of de volgende importbewerkingen deel uitmaken van dit bronbestand.
code language-swift |
---|
|
Doe hetzelfde voor Luma > Luma > Utils > MobileSDK .
AppDelegate bijwerken
Navigeer aan Luma > Luma > AppDelegate in de navigator van het Project van Xcode.
-
Vervang de
@AppStorage
waardeYOUR_ENVIRONMENT_ID_GOES_HERE
voorenvironmentFileId
met de waarde van identiteitskaart van het Dossier van het Milieu die u van markeringen in teruggewonnen produceert SDK installeert instructies.code language-swift @AppStorage("environmentFileId") private var environmentFileId = "YOUR_ENVIRONMENT_ID_GOES_HERE"
-
Voeg de volgende code toe aan de functie
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) })
De bovenstaande code doet het volgende:
- Registreert de vereiste extensies.
- Vormt MobileCore en andere uitbreidingen om uw configuratie van het markeringsbezit te gebruiken.
- Schakelt foutopsporingslogbestand in. Meer details en de opties kunnen in de Mobiele documentatie van SDK van Adobe Experience Platformworden gevonden.
- Start levenscycluscontrole. Zie Levenscyclusstap in het leerprogramma voor meer details.
- Hiermee stelt u de standaardtoestemming in op onbekend. Zie stap 0} van de Toestemming {in het leerprogramma voor meer details.
Zorg ervoor dat u MobileCore.configureWith(appId: self.environmentFileId)
bijwerkt met de appId
op basis van de environmentFileId
-code uit de tagomgeving waarvoor u ontwikkelt (ontwikkelen, opvoeren of produceren).
Gradient
U gebruikt de gebiedsdelen van produceren SDK installeert instructiesom individuele pakketten toe te voegen gebruikend de integratie van de Gradle met Android Studio, heeft het project van Android Studio reeds alle pakketgebiedsdelen die voor u worden toegevoegd.
-
Selecteer
-
Selecteer Android weergave.
-
Selecteer Gradle scripts > build.gradle.kts (Module :app) van de linkerruit. Schuif vervolgens in het rechterdeelvenster totdat u
dependencies
ziet.
In Android Studio kunt u File > Project Structure… gebruiken om moduleafhankelijkheden toe te voegen. Selecteer Dependencies en gebruik dan 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 | |
---|---|
Pakket com.adobe. marketing.mobile: |
Beschrijving |
kern |
De extensies
|
rand | Met de mobiele extensie Adobe Experience Platform Edge Network (AEPEdge ) kunt u gegevens verzenden naar Adobe Edge Network vanuit een mobiele toepassing. Met deze extensie kunt u Adobe Experience Cloud-mogelijkheden op een robuustere manier implementeren, meerdere Adobe-oplossingen aanbieden via één netwerkaanroep en deze informatie tegelijkertijd doorsturen naar de Adobe Experience Platform.de mobiele uitbreiding van Edge Network is een uitbreiding voor Adobe Experience Platform SDK. De extensie vereist de extensies Mobile Core en Services voor gebeurtenisafhandeling. En de extensie Identity for Edge Network voor het ophalen van de identiteiten, zoals ECID. |
edgeidentity | Met de Adobe Experience Platform Edge Identity Mobile-extensie kunt u identiteitsgegevens van gebruikers van een mobiele toepassing verwerken wanneer u de Adobe Experience Platform SDK- en Edge Network-extensie gebruikt. |
edgepermission | Met de mobiele extensie Adobe Experience Platform Consent Collection Collection kunt u de verzameling voorkeuren voor toestemming van de mobiele toepassing inschakelen wanneer u de Adobe Experience Platform SDK en de Edge Network-extensie gebruikt. |
gebruikersprofiel | De extensie Adobe Experience Platform-gebruikersprofiel Mobile is een extensie voor het beheren van gebruikersprofielen voor de Adobe Experience Platform SDK. |
ruimten | Adobe Places Service is een geo-locatieservice waarmee mobiele apps met een herkenbare locatie kunnen werken. En om de locatiecontext te begrijpen door rijke en makkelijk te gebruiken interfaces van SDK vergezeld van een flexibele gegevensbank van belangenpunten (POIs) te gebruiken. Voor meer informatie, zie de Documentatie van de Dienst van Plaatsen. deze dienst is de mobiele uitbreiding van Plaatsen voor Android 2.x Adobe Experience Platform SDK en vereist de uitbreiding van de Kern voor gebeurtenis behandeling. |
overseinen | Met de Adobe Experience Platform Messaging-extensie kunt u pushberichten, in-app berichten en op code gebaseerde ervaringen voor uw mobiele apps inschakelen. Met deze extensie kunt u ook push-tokens van gebruikers verzamelen en interactiemetingen beheren met Adobe Experience Platform-services. |
optimaliseren | De extensie Adobe Experience Platform Optimize biedt API's waarmee u realtime workflows voor personalisatie kunt inschakelen in de SDK's van Adobe Experience Platform met Adobe Target of Adobe Journey Optimizer Offer Decisioning. Het hangt van de Mobiele Kern af en vereist de Uitbreiding van Edge om verpersoonlijkingsvraaggebeurtenissen naar de Ervaring Edge Network te verzenden. |
verzekering | Assurance (alias Griffon-project) is een mobiele extensie voor Adobe Experience Platform die integratie met Adobe Experience Platform Assurance mogelijk maakt. Met de extensie kunt u controleren, testen, simuleren en valideren hoe u gegevens verzamelt of ervaringen opdoet in uw mobiele app. Voor deze extensie is MobileCore vereist. |
Extensies importeren
Navigeer in Android Studio naar app > kotlin+java > com.adobe.luma.tutorial.android > LumaApplication en controleer of de volgende importbewerkingen deel uitmaken van het bronbestand.
code language-kotlin |
---|
|
Doe hetzelfde voor app > kotlin+java > com.adobe.luma.tutorial.android > models > MobileSDK .
LumaApplication bijwerken
Navigeer in de Android -weergave naar app > kotlin+java > com.adobe.luma.tutorial.android > LumaApplication in Android Studio.
-
Vervang
"YOUR_ENVIRONMENT_FILE_ID"
inprivate var environmentFileId = "YOUR_ENVIRONMENT_ID_GOES_HERE"
met de waarde van identiteitskaart van het Dossier van het Milieu die u van markeringen in teruggewonnen produceert SDK installeert instructies.code language-kotlin private var environmentFileId = "YOUR_ENVIRONMENT_ID_GOES_HERE"
-
Voeg de volgende code toe aan de functie
override fun onCreate()
inclass 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) }
De bovenstaande code doet het volgende:
- Registreert de vereiste extensies.
- Vormt MobileCore en andere uitbreidingen om uw configuratie van het markeringsbezit te gebruiken.
- Schakelt foutopsporingslogbestand in. Meer details en de opties kunnen in de Mobiele documentatie van SDK van Adobe Experience Platformworden gevonden.
- Start levenscycluscontrole. Zie Levenscyclusstap in het leerprogramma voor meer details.
- Hiermee stelt u de standaardtoestemming in op onbekend. Zie stap 0} van de Toestemming {in het leerprogramma voor meer details.
Zorg ervoor dat u MobileCore.configureWith(environmentFileId)
bijwerkt met de environmentFileId
op basis van de Omgevingsbestands-id uit de tagomgeving waarvoor u ontwikkelt (ontwikkeling, staging of productie).
Volgende: Opstelling Assurance