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

Leerdoelstellingen

In deze les zult u:

  • Voeg de vereiste SDK's toe aan uw project.
  • Registreer de extensies.
NOTE
In een mobiele app implementatie, zijn de termijnen uitbreidingen en SDKs bijna onderling verwisselbaar.
iOS

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:

Afhankelijkheden van het Pakket Xcode {modal="regular"}

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 AEPCore , AEPServices en AEPIdentity vertegenwoordigen de basis van de Adobe Experience Platform SDK. Elke toepassing die de SDK gebruikt, moet deze bevatten. Deze modules bevatten een gemeenschappelijke reeks functionaliteit en de diensten die alle uitbreidingen van SDK vereisen.

  • AEPCore bevat implementatie van de gebeurtenishub. De hub van de Gebeurtenis is het mechanisme dat voor het leveren van gebeurtenissen tussen app en SDK wordt gebruikt. De hub van de Gebeurtenis wordt ook gebruikt voor het delen van gegevens tussen uitbreidingen.
  • AEPServices biedt verschillende herbruikbare implementaties die nodig zijn voor platformondersteuning, zoals netwerken, schijftoegang en databasebeheer.
  • AEPIdentity implementeert de integratie met Adobe Experience Platform Identity-services.
  • AEPSignal staat voor de Adobe Experience Platform SDK's Signal-extensie waarmee marketers een "signaal" naar hun apps kunnen sturen om gegevens naar externe doelen te verzenden of om URL's te openen.
  • AEPLifecycle vertegenwoordigt de Levenscyclusuitbreiding van SDK van Adobe Experience Platform die helpt metriek van de toepassingslevenscyclus zoals toepassingsinstallatie of verbeteringsinformatie, toepassingslancering en zittingsinformatie, apparateninformatie, en om het even welke extra contextgegevens te verzamelen die door de toepassingsontwikkelaar worden verstrekt.
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
// import AEP MobileSDK libraries
import AEPCore
import AEPServices
import AEPIdentity
import AEPSignal
import AEPLifecycle
import AEPEdge
import AEPEdgeIdentity
import AEPEdgeConsent
import AEPUserProfile
import AEPPlaces
import AEPMessaging
import AEPOptimize
import AEPAssurance

Doe hetzelfde voor Luma > Luma > Utils > MobileSDK .

AppDelegate bijwerken

Navigeer aan Luma > Luma > AppDelegate in de navigator van het Project van Xcode.

  1. Vervang de @AppStorage waarde YOUR_ENVIRONMENT_ID_GOES_HERE voor environmentFileId 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"
    
  2. 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:

  1. Registreert de vereiste extensies.
  2. Vormt MobileCore en andere uitbreidingen om uw configuratie van het markeringsbezit te gebruiken.
  3. Schakelt foutopsporingslogbestand in. Meer details en de opties kunnen in de Mobiele documentatie van SDK van Adobe Experience Platformworden gevonden.
  4. Start levenscycluscontrole. Zie Levenscyclusstap in het leerprogramma voor meer details.
  5. 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).

Android

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.

  1. Selecteer FolderOutline als hulpmiddel.

  2. Selecteer Android weergave.

  3. Selecteer Gradle scripts > build.gradle.kts (Module :app) van de linkerruit. Schuif vervolgens in het rechterdeelvenster totdat u dependencies ziet.

    Android de Afhankelijkheden van de Gradle {modal="regular"}

In Android Studio kunt u File > Project Structure… gebruiken om moduleafhankelijkheden toe te voegen. Selecteer Dependencies en gebruik dan Modules toevoegen om modules toe te voegen. De onderstaande tabel bevat koppelingen naar de URL's die u zou gebruiken om afhankelijkheidsmodules toe te voegen. De verbindingen leiden u ook aan meer informatie over elke specifieke module.

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 MobileCore en Identity vertegenwoordigen de basis van de Adobe Experience Platform SDK. Elke toepassing die de SDK gebruikt, moet deze opnemen. Deze modules bevatten een algemene set functies en services die alle SDK-extensies nodig hebben.

  • MobileCore bevat de implementatie van de gebeurtenishub. De hub van de Gebeurtenis is het mechanisme dat voor het leveren van gebeurtenissen tussen app en SDK wordt gebruikt. De hub van de Gebeurtenis wordt ook gebruikt voor het delen van gegevens tussen uitbreidingen en verstrekt verscheidene herbruikbare implementaties nodig voor platformsteun, met inbegrip van voorzien van een netwerk, schijftoegang, en gegevensbestandbeheer.
  • Identity implementeert de integratie met Adobe Experience Platform Identity-services.
  • Signal staat voor de Adobe Experience Platform SDK Signal-extensie waarmee marketers een "signaal" naar hun apps kunnen sturen om gegevens naar externe bestemmingen te verzenden of URL's te openen.
  • Lifecycle vertegenwoordigt de Adobe Experience Platform SDK Lifecycle-extensie die helpt bij het verzamelen van gegevens over de levenscyclus van toepassingen, zoals installatie- of upgrademaatgegevens van toepassingen, het starten en de sessie van toepassingen, apparaatgegevens en eventuele aanvullende contextgegevens die door de ontwikkelaar van de toepassing worden verstrekt.
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
import com.adobe.marketing.mobile.Assurance
import com.adobe.marketing.mobile.Edge
import com.adobe.marketing.mobile.Lifecycle
import com.adobe.marketing.mobile.LoggingMode
import com.adobe.marketing.mobile.Messaging
import com.adobe.marketing.mobile.MobileCore
import com.adobe.marketing.mobile.MobilePrivacyStatus
import com.adobe.marketing.mobile.Places
import com.adobe.marketing.mobile.Signal
import com.adobe.marketing.mobile.UserProfile
import com.adobe.marketing.mobile.edge.consent.Consent
import com.adobe.marketing.mobile.edge.identity.Identity
import com.adobe.marketing.mobile.optimize.Optimize

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.

  1. Vervang "YOUR_ENVIRONMENT_FILE_ID" in private 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"
    
  2. Voeg de volgende code toe aan de functie override fun onCreate() in class 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:

    1. Registreert de vereiste extensies.
    2. Vormt MobileCore en andere uitbreidingen om uw configuratie van het markeringsbezit te gebruiken.
    3. Schakelt foutopsporingslogbestand in. Meer details en de opties kunnen in de Mobiele documentatie van SDK van Adobe Experience Platformworden gevonden.
    4. Start levenscycluscontrole. Zie Levenscyclusstap in het leerprogramma voor meer details.
    5. 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).

SUCCESS
U hebt nu de benodigde pakketten geïnstalleerd en uw project bijgewerkt om de vereiste Adobe Experience Platform Mobile SDK-extensies te registreren die u voor de rest van de zelfstudie gaat gebruiken.
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 Leaguedelen

Volgende: Opstelling Assurance

recommendation-more-help
9fed61f5-c338-47ad-8005-0b89a5f4af8b