Adobe Experience Platform Mobile SDK 설치
모바일 앱에서 Adobe Experience Platform Mobile SDK를 구현하는 방법을 알아봅니다.
전제 조건
학습 목표
이 단원에서는 다음 작업을 수행합니다.
- Swift 패키지 관리자를 사용하여 프로젝트에 필요한 SDK를 추가합니다.
- 확장 등록.
Swift 패키지 관리자
SDK 설치 지침 생성에 설명된 대로 CocoaPod 및 Pod 파일을 사용하는 대신 Xcode의 기본 Swift 패키지 관리자를 사용하여 개별 패키지를 추가합니다. Xcode 프로젝트에 이미 모든 패키지 종속성이 추가되었습니다. Xcode 패키지 종속성 화면은 다음과 같아야 합니다.
{modal="regular"}
Xcode에서는 파일 > 패키지 추가… 를 사용하여 패키지를 추가할 수 있습니다. 아래 표는 패키지를 추가하는 데 사용할 URL에 대한 링크를 제공합니다. 또한 링크는 각 특정 패키지에 대한 자세한 정보를 안내합니다.
AEPCore
, AEPServices
및 AEPIdentity
확장은 Adobe Experience Platform SDK의 기초를 나타냅니다. SDK를 사용하는 모든 앱에는 확장명이 포함되어야 합니다. 이러한 모듈에는 모든 SDK 확장에 필요한 일반적인 기능 및 서비스 집합이 포함되어 있습니다.
AEPCore
에 이벤트 허브의 구현이 포함되어 있습니다. 이벤트 허브는 앱과 SDK 간에 이벤트를 전달하는 데 사용되는 메커니즘입니다. 이벤트 허브는 확장 간에 데이터를 공유하는 데에도 사용됩니다.AEPServices
은(는) 네트워킹, 디스크 액세스 및 데이터베이스 관리를 포함하여 플랫폼 지원에 필요한 몇 가지 재사용 가능한 구현을 제공합니다.AEPIdentity
이(가) Adobe Experience Platform ID 서비스와의 통합을 구현합니다.AEPSignal
은(는) 마케터가 데이터를 외부 대상으로 보내거나 URL을 열기 위해 앱에 "신호"를 보낼 수 있는 Adobe Experience Platform SDK 신호 확장을 나타냅니다.AEPLifecycle
은(는) 응용 프로그램 설치 또는 업그레이드 정보, 응용 프로그램 시작 및 세션 정보, 장치 정보 및 응용 프로그램 개발자가 제공한 추가 컨텍스트 데이터와 같은 응용 프로그램 라이프사이클 지표를 수집하는 데 도움이 되는 Adobe Experience Platform SDK 라이프사이클 확장을 나타냅니다.
AEPEdge
)을 사용하면 모바일 애플리케이션에서 Adobe Edge 네트워크로 데이터를 보낼 수 있습니다. 이 확장을 사용하면 보다 강력한 방식으로 Adobe Experience Cloud 기능을 구현하고, 하나의 네트워크 호출을 통해 여러 Adobe 솔루션을 제공하고, 동시에 이 정보를 Adobe Experience Platform에 전달할 수 있습니다.Edge Network 모바일 확장은 Adobe Experience Platform SDK용 확장이며 이벤트 처리를 위해
AEPCore
및 AEPServices
확장과 ECID와 같은 ID를 검색하기 위한 AEPEdgeIdentity
확장이 필요합니다.AEPEdgeIdentity
)을 사용하면 Adobe Experience Platform SDK 및 Edge Network 확장을 사용할 때 모바일 애플리케이션에서 사용자 ID 데이터를 처리할 수 있습니다.AEPConsent
)은 Adobe Experience Platform SDK 및 Edge Network 확장을 사용할 때 모바일 애플리케이션에서 동의 환경 설정을 수집할 수 있도록 합니다.AEPUserProfile
)은 Adobe Experience Platform SDK에 대한 사용자 프로필을 관리하기 위한 확장입니다.AEPPlaces
)을 사용하면 위치 Adobe 인터페이스 및 Adobe 데이터 수집 태그 규칙에 정의된 대로 지리적 위치 이벤트를 추적할 수 있습니다.AEPMessaging
)을 사용하면 푸시 알림 토큰과 푸시 알림 클릭스루 피드백을 Adobe Experience Platform에 보낼 수 있습니다.AEPOptimize
)은 Adobe Target 또는 Adobe Journey Optimizer Offer decisioning을 사용하여 Adobe Experience Platform Mobile SDK에서 실시간 개인화 워크플로우를 사용할 수 있도록 API를 제공합니다. 개인화 쿼리 이벤트를 Experience Edge 네트워크로 전송하려면 AEPCore
및 AEPEdge
확장이 필요합니다.AEPAssurance
)입니다. 이 확장 기능을 사용하면 앱을 보증 용도로 사용할 수 있습니다.확장 가져오기
Xcode에서 Luma > Luma > AppDelegate(으)로 이동하여 다음 가져오기가 이 소스 파일의 일부인지 확인하십시오.
// 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
Luma > Luma > Utils > MobileSDK 에 대해서도 동일한 작업을 수행합니다.
AppDelegate 업데이트
Xcode 프로젝트 탐색기에서 Luma > Luma > AppDelegate(으)로 이동합니다.
-
environmentFileId
에 대한@AppStorage
값YOUR_ENVIRONMENT_ID_GOES_HERE
을(를) SDK 설치 지침 생성의 태그에서 검색한 개발 환경 파일 ID 값으로 바꿉니다.code language-swift @AppStorage("environmentFileId") private var environmentFileId = "YOUR_ENVIRONMENT_ID_GOES_HERE"
-
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) })
위의 코드는 다음을 수행합니다.
- 필요한 확장을 등록합니다.
- 태그 속성 구성을 사용하도록 MobileCore 및 기타 확장을 구성합니다.
- 디버그 로깅을 활성화합니다. 자세한 내용 및 옵션은 Adobe Experience Platform Mobile SDK 설명서에서 확인할 수 있습니다.
- 주기 모니터링을 시작합니다. 자세한 내용은 자습서의 주기 단계를 참조하십시오.
- 기본 동의를 알 수 없음으로 설정합니다. 자세한 내용은 자습서에서 동의 단계를 참조하십시오.
environmentFileId
을(를) 기반으로 MobileCore.configureWith(appId: self.environmentFileId)
을(를) appId
(으)로 업데이트하십시오.다음: 보증 설정