Adobe Experience Platform Mobile SDK 설치

모바일 앱에서 Adobe Experience Platform Mobile SDK를 구현하는 방법을 알아봅니다.

전제 조건

학습 목표

이 단원에서는 다음 작업을 수행합니다.

  • Swift 패키지 관리자를 사용하여 프로젝트에 필요한 SDK를 추가합니다.
  • 확장 등록.
NOTE
모바일 앱 구현에서 "확장" 및 "SDK"라는 용어는 거의 상호 교환 가능합니다.

Swift 패키지 관리자

CocoaPod 및 Pod 파일 사용(설명 참조) 대신 SDK 설치 지침 생성)에서는 Xcode의 기본 Swift 패키지 관리자를 사용하여 개별 패키지를 추가합니다. Xcode 프로젝트에 이미 모든 패키지 종속성이 추가되었습니다. Xcode 패키지 종속성 화면은 다음과 같아야 합니다.

Xcode 패키지 종속성 {zoomable="yes"}

Xcode에서 다음을 사용할 수 있습니다 파일 > 패키지 추가… 패키지를 추가합니다. 아래 표는 패키지를 추가하는 데 사용할 URL에 대한 링크를 제공합니다. 또한 링크는 각 특정 패키지에 대한 자세한 정보를 안내합니다.

패키지
설명
AEP 코어

다음 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 라이프사이클 확장을 나타냅니다.
AEP Edge
Adobe Experience Platform Edge Network 모바일 확장(AEPEdge)를 사용하면 모바일 애플리케이션에서 Adobe Edge 네트워크로 데이터를 보낼 수 있습니다. 이 확장을 사용하면 보다 강력한 방식으로 Adobe Experience Cloud 기능을 구현하고, 하나의 네트워크 호출을 통해 여러 Adobe 솔루션을 제공하고, 동시에 이 정보를 Adobe Experience Platform에 전달할 수 있습니다.
Edge Network 모바일 확장은 Adobe Experience Platform SDK용 확장으로, AEPCoreAEPServices 이벤트 처리를 위한 확장 및 AEPEdgeIdentity id 검색을 위한 확장(예: ECID)
AEP Edge ID
AEP Edge Identity 모바일 확장(AEPEdgeIdentity) Adobe Experience Platform SDK 및 Edge Network 확장을 사용할 때 모바일 애플리케이션에서 사용자 ID 데이터를 처리할 수 있습니다.
AEP Edge 동의
AEP 동의 컬렉션 모바일 확장(AEPConsent)는 Adobe Experience Platform SDK 및 Edge Network 확장을 사용할 때 모바일 애플리케이션에서 동의 환경 설정 수집을 활성화합니다.
AEP 사용자 프로필
Adobe Experience Platform 사용자 프로필 모바일 확장(AEPUserProfile)는 Adobe Experience Platform SDK의 사용자 프로필을 관리하기 위한 확장입니다.
AEP Places
AEP 위치 확장(AEPPlaces)를 사용하면 Adobe 위치 인터페이스 및 Adobe 데이터 수집 태그 규칙에 정의된 대로 지리적 위치 이벤트를 추적할 수 있습니다.
AEP 메시징
AEP 메시징 확장(AEPMessaging)을 사용하면 푸시 알림 토큰을 전송하고 푸시 알림 클릭스루 피드백을 Adobe Experience Platform에 보낼 수 있습니다.
AEP 최적화
AEP 최적화 확장(AEPOptimize)은 Adobe Target 또는 Adobe Journey Optimizer Offer decisioning을 사용하여 Adobe Experience Platform Mobile SDK에서 실시간 개인화 워크플로우를 가능하게 하는 API를 제공합니다. 이를 위해서는 AEPCoreAEPEdge experience Edge 네트워크에 개인화 쿼리 이벤트를 전송하는 확장입니다.
AEP 보증
Assurance(Grifson 프로젝트) 는 새롭고 혁신적인 확장 프로그램입니다(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 업데이트

다음으로 이동 Luma > Luma > AppDelegate 를 입력합니다.

  1. 바꾸기 @AppStorageYOUR_ENVIRONMENT_ID_GOES_HERE 대상 environmentFileId 의 태그에서 검색한 개발 환경 파일 ID 값으로 SDK 설치 지침 생성.

    code language-swift
    @AppStorage("environmentFileId") private var environmentFileId = "YOUR_ENVIRONMENT_ID_GOES_HERE"
    
  2. 에 다음 코드를 추가합니다 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)
    })
    

위의 코드는 다음을 수행합니다.

  1. 필요한 확장을 등록합니다.
  2. 태그 속성 구성을 사용하도록 MobileCore 및 기타 확장을 구성합니다.
  3. 디버그 로깅을 활성화합니다. 자세한 내용 및 옵션은 Adobe Experience Platform Mobile SDK 설명서.
  4. 주기 모니터링을 시작합니다. 다음을 참조하십시오 라이프사이클 자세한 내용은 튜토리얼의 단계를 참조하십시오.
  5. 기본 동의를 알 수 없음으로 설정합니다. 다음을 참조하십시오 동의 자세한 내용은 튜토리얼의 단계를 참조하십시오.
IMPORTANT
다음을 업데이트했는지 확인 MobileCore.configureWith(appId: self.environmentFileId) (으)로 appId 를 기반으로 함 environmentFileId 개발, 스테이징 또는 프로덕션용으로 빌드하고 있는 태그 환경에서.
SUCCESS
이제 자습서의 나머지 부분에서 사용할 필수 Adobe Experience Platform Mobile SDK 확장을 올바르게 등록하기 위해 필요한 패키지를 설치하고 프로젝트를 업데이트했습니다.
Adobe Experience Platform Mobile SDK에 대해 학습하는 데 시간을 투자해 주셔서 감사합니다. 질문이 있거나 일반적인 피드백을 공유하려는 경우 또는 향후 콘텐츠에 대한 제안이 있는 경우 이에 대해 공유하십시오 Experience League 커뮤니티 토론 게시물

다음: 보증 설정

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