Installera Adobe Experience Platform Mobile SDKs

Lär dig hur du implementerar Adobe Experience Platform Mobile SDK i en mobilapp.

Förhandskrav

Utbildningsmål

I den här lektionen kommer du att:

  • Lägg till önskade SDK:er i projektet med Swift Package Manager.
  • Registrera tilläggen.
NOTE
I en mobilappsimplementering är termerna "extensions" och "SDKs" nästan utbytbara.

Swift Package Manager

I stället för att använda CocoaPods och en Pod-fil (som beskrivs 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:

Xcode-paketberoenden

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.

Paket
Beskrivning
AEP Core

Tilläggen AEPCore, AEPServices och AEPIdentity utgör grunden för Adobe Experience Platform SDK - alla program som använder SDK måste innehålla dem. Dessa moduler innehåller en gemensam uppsättning funktioner och tjänster som krävs av alla SDK-tillägg.

  • AEPCore innehåller implementering av händelsehubben. Händelsehubben är den mekanism som används för att leverera händelser mellan appen och SDK:n. Händelsehubben används också för att dela data mellan tillägg.
  • AEPServices innehåller flera återanvändbara implementeringar som krävs för plattformsstöd, inklusive nätverk, diskåtkomst och databashantering.
  • AEPIdentity implementerar integreringen med Adobe Experience Platform Identity Services.
  • AEPSignal representerar signeringstillägget för Adobe Experience Platform SDK:er som gör att marknadsförarna kan skicka en signal till sina appar för att skicka data till externa mål eller öppna URL:er.
  • AEPLifecycle representerar Adobe Experience Platform SDKs Lifecycle-tillägget som hjälper till att samla in livscykelvärden för program, som installations- eller uppgraderingsinformation för program, information om programstart och session, enhetsinformation och eventuella ytterligare kontextdata från programutvecklaren.
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 nätverksanrop och samtidigt vidarebefordra informationen till Adobe Experience Platform.
Mobiltillägget Edge Network är ett tillägg för Adobe Experience Platform SDK och kräver AEPCore och AEPServices för händelsehantering samt AEPEdgeIdentity-tillägget för hämtning av identiteter, till exempel ECID.
AEP Edge Identity
Med mobiltillägget AEP Edge Identity (AEPEdgeIdentity) kan du hantera användaridentitetsdata från ett mobilprogram när du använder Adobe Experience Platform SDK och tillägget Edge Network.
AEP Edge-samtycke
Mobiltillägget AEP Consent Collection (AEPConsent) aktiverar insamling av medgivandeinställningar från mobilprogrammet när du använder Adobe Experience Platform SDK och tillägget Edge Network.
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 AEP-platser (AEPPlaces) kan du spåra geopositioneringshändelser enligt definitionen i gränssnittet Adobe Platser och i taggreglerna för Adobe-datainsamling.
AEP-meddelanden
Med AEP Messaging-tillägget (AEPMessaging) kan du skicka push-meddelandetokens och push-meddelanden via-feedback till Adobe Experience Platform.
AEP-optimering
Tillägget AEP 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-nätverket.
AEP Assurance
Assurance (alias project Griffon) är ett nytt, innovativt tillägg (AEPAssurance) som hjälper dig att inspektera, granska, simulera och validera hur du samlar in data eller levererar upplevelser i din mobilapp. Det här tillägget aktiverar din app för Assurance.

Importera tillägg

I Xcode går du till Luma > Luma > AppDelegate och ser till att följande importer ingår i den här källfilen.

// 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

Gör samma sak för Luma > Luma > Utils > MobileSDK.

Uppdatera AppDelegate

Navigera till Luma > Luma > AppDelegate i Xcode Project-navigatorn.

  1. Ersätt @AppStorage-värdet YOUR_ENVIRONMENT_ID_GOES_HERE för environmentFileId med det fil-ID för utvecklingsmiljö som du hämtade från taggar i Skapa installationsanvisningar för SDK.

    code language-swift
    @AppStorage("environmentFileId") private var environmentFileId = "YOUR_ENVIRONMENT_ID_GOES_HERE"
    
  2. 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:

  1. Registrerar nödvändiga tillägg.
  2. Konfigurerar MobileCore och andra tillägg så att taggegenskapskonfigurationen används.
  3. Aktiverar felsökningsloggning. Mer information och alternativ finns i dokumentationen för Adobe Experience Platform Mobile SDK.
  4. Startar livscykelövervakning. Mer information finns i steget Livscykel i självstudiekursen.
  5. Anger okänt standardsamtycke. Mer information finns i steget Medgivande i självstudiekursen.
IMPORTANT
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).
SUCCESS
Du har nu installerat de nödvändiga paketen och uppdaterat projektet för att korrekt registrera de Adobe Experience Platform Mobile SDK-tillägg som du kommer att använda för resten av kursen.
Tack för att du lade ned din tid på att lära dig om Adobe Experience Platform Mobile SDK. Om du har frågor, vill dela allmän feedback eller har förslag på framtida innehåll kan du dela dem i det här Experience League-diskussionsinlägget

Nästa: Konfigurera försäkring

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