Installare gli SDK di Adobe Experience Platform Mobile
Scopri come implementare l’SDK di Adobe Experience Platform Mobile in un’app mobile.
Prerequisiti
- È stata creata una libreria di tag con le estensioni descritte in lezione precedente.
- ID file dell’ambiente di sviluppo da Istruzioni di installazione per dispositivi mobili.
- Scaricato il vuoto app di esempio.
- Esperienza con Xcode.
Obiettivi di apprendimento
In questa lezione verranno fornite le seguenti informazioni:
- Aggiungi gli SDK richiesti al progetto utilizzando Gestione pacchetti Swift.
- Registra le estensioni.
Gestione pacchetti Swift
Invece di utilizzare CocoaPods e un file Pod (come descritto in Generare istruzioni di installazione SDK), puoi aggiungere singoli pacchetti utilizzando il gestore di pacchetti Swift nativo di Xcode. Nel progetto Xcode sono già state aggiunte tutte le dipendenze dei pacchetti. Xcode Dipendenze pacchetto la schermata dovrebbe avere un aspetto simile a:
{zoomable="yes"}
In Xcode puoi utilizzare File > Aggiungi pacchetti… per aggiungere pacchetti. La tabella seguente fornisce i collegamenti agli URL da utilizzare per aggiungere pacchetti. I collegamenti ti indirizzano anche a ulteriori informazioni su ciascun pacchetto specifico.
Il AEPCore
, AEPServices
, e AEPIdentity
Le estensioni rappresentano le basi dell'SDK di Adobe Experience Platform: ogni app che utilizza l'SDK deve includerle. Questi moduli contengono un set comune di funzionalità e servizi richiesti da tutte le estensioni SDK.
AEPCore
contiene l’implementazione dell’hub eventi. L’hub eventi è il meccanismo utilizzato per la trasmissione degli eventi tra l’app e l’SDK. L’hub eventi viene utilizzato anche per condividere i dati tra le estensioni.AEPServices
fornisce diverse implementazioni riutilizzabili necessarie per il supporto della piattaforma, tra cui rete, accesso al disco e gestione del database.AEPIdentity
implementa l’integrazione con i servizi Adobe Experience Platform Identity.AEPSignal
rappresenta l’estensione Segnale degli SDK di Adobe Experience Platform che consente agli esperti di marketing di inviare un "segnale" alle loro app per inviare dati a destinazioni esterne o per aprire URL.AEPLifecycle
rappresenta l’estensione del ciclo di vita degli SDK di Adobe Experience Platform che consente di raccogliere metriche del ciclo di vita dell’applicazione quali informazioni sull’installazione o l’aggiornamento dell’applicazione, informazioni sull’avvio e sulla sessione dell’applicazione, informazioni sul dispositivo ed eventuali dati contestuali aggiuntivi forniti dallo sviluppatore dell’applicazione.
AEPEdge
) consente di inviare dati ad Adobe Edge Network da un’app mobile. Questa estensione consente di implementare le funzionalità di Adobe Experience Cloud in modo più affidabile, distribuire più soluzioni di Adobe tramite una chiamata di rete e inoltrare simultaneamente queste informazioni a Adobe Experience Platform.L'estensione per dispositivi mobili Edge Network è un'estensione per Adobe Experience Platform SDK e richiede
AEPCore
e AEPServices
estensioni per la gestione degli eventi, nonché AEPEdgeIdentity
estensione per il recupero delle identità, ad esempio ECID.AEPEdgeIdentity
) consente di gestire i dati di identità utente da un’app mobile quando si utilizzano l’SDK di Adobe Experience Platform e l’estensione Edge Network.AEPConsent
) abilita la raccolta delle preferenze di consenso dall’app mobile quando si utilizza l’SDK di Adobe Experience Platform e l’estensione Edge Network.AEPUserProfile
) è un'estensione per gestire i profili utente per l'SDK di Adobe Experience Platform.AEPPlaces
) consente di tenere traccia degli eventi di geolocalizzazione come definito nell’interfaccia Adobe Places e nelle regole tag di raccolta dati di Adobe.AEPMessaging
) consente di inviare al Adobe Experience Platform i token di notifica push e il feedback click-through per la notifica push.AEPOptimize
) fornisce API per abilitare i flussi di lavoro di personalizzazione in tempo reale negli SDK di Adobe Experience Platform Mobile tramite Adobe Target o Adobe Journey Optimizer Offer Decisioning. Richiede AEPCore
e AEPEdge
estensioni per inviare eventi di query di personalizzazione alla rete Experience Edge.AEPAssurance
) per aiutarti a ispezionare, verificare, simulare e convalidare le modalità di raccolta dei dati o di gestione delle esperienze nell’app mobile. Questa estensione abilita l’app per Assurance.Importare estensioni
In Xcode, passa a Luma > Luma > AppDelegate e assicurati che le seguenti importazioni facciano parte di questo file di origine.
// 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
Effettua la stessa operazione per Luma > Luma > Utils > MobileSDK.
Aggiorna AppDelegate
Accedi a Luma > Luma > AppDelegate nel Navigatore progetti Xcode.
-
Sostituisci il
@AppStorage
valoreYOUR_ENVIRONMENT_ID_GOES_HERE
perenvironmentFileId
al valore ID file dell’ambiente di sviluppo recuperato dai tag in Generare istruzioni di installazione SDK.code language-swift @AppStorage("environmentFileId") private var environmentFileId = "YOUR_ENVIRONMENT_ID_GOES_HERE"
-
Aggiungi il seguente codice al
application(_, didFinishLaunchingWithOptions)
funzione.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) })
Il codice di cui sopra esegue le seguenti operazioni:
- Registra le estensioni richieste.
- Configura MobileCore e altre estensioni per utilizzare la configurazione della proprietà tag.
- Abilita la registrazione di debug. Ulteriori dettagli e opzioni sono disponibili nella sezione Documentazione di Adobe Experience Platform Mobile SDK.
- Avvia il monitoraggio del ciclo di vita. Consulta Ciclo di vita per ulteriori dettagli, consulta l’esercitazione.
- Imposta il consenso predefinito su sconosciuto. Consulta Consenso per ulteriori dettagli, consulta l’esercitazione.
MobileCore.configureWith(appId: self.environmentFileId)
con appId
in base al environmentFileId
dall’ambiente di tag per cui stai creando (sviluppo, staging o produzione).Successivo: Configura Assurance