Assurance 설정

일반적인 SDK 설치 외에 iOS에서 앱에 대한 Assurance 세션을 시작하려면 다음 추가 코드가 필요합니다.

1. Xcode의 프로젝트 탐색기에서 Luma > Luma > SceneDelegate(으)로 이동합니다.

2. func scene(_ scene: UIScene, openURLContexts URLContexts: Set<UIOpenURLContext>에 다음 코드를 추가합니다.

   code language-swift
   // Called when the app in background is opened with a deep link. if let deepLinkURL = URLContexts.first?.url { // Start the Assurance session Assurance.startSession(url: deepLinkURL) }

   이 코드는 앱이 백그라운드에 있고 딥링크를 사용하여 열리면 보증 세션을 시작합니다.

일반적인 SDK 설치 외에 Android에서 앱에 대한 Assurance 세션을 시작하려면 다음 추가 코드가 필요합니다.

1. Android Studio의 Android 보기에서 앱 > kotlin+java > com.adobe.luma.tutorial.android > LumaApplication ​으로 이동합니다.

2. fun handleDeeplink(deeplink: String?)에 다음 코드를 추가합니다.

   code language-kotlin
   // Called when the app in background is opened with a deep link. if (deeplink.isNullOrEmpty()) { Log.w("Luma", "Deeplink is null or empty") return } Log.i("Luma", "Handling deeplink: $deeplink") Assurance.startSession(deeplink)

   이 코드는 앱이 백그라운드에 있고 딥링크를 사용하여 열리면 보증 세션을 시작합니다.

1. Xcode에서 프로젝트를 엽니다.
2. Project 탐색기에서 Luma ​을(를) 선택합니다.
3. Luma 대상을 선택하십시오.
4. 서명 및 기능 탭을 선택합니다.
5. 번들 식별자 ​를 정의합니다.

각 번들 식별자가 고유해야 하므로 unique 번들 식별자를 사용하고 com.adobe.luma.tutorial.swiftui 번들 식별자를 바꾸십시오. 일반적으로 com.organization.brand.uniqueidentifier과(와) 같은 번들 ID 문자열에 역방향 DNS 형식을 사용합니다. 이 자습서의 완성된 버전은 com.adobe.luma.tutorial.swiftui을(를) 사용합니다.

{modal="regular"}

1. Android Studio에서 프로젝트를 엽니다.
2. 탐색기에서 build.gradle.kts(모듈 :app) ​을(를) 선택합니다.
3. unique 번들 식별자를 사용하고 com.adobe.luma.tutorial.android의 namespace에 대한 android 값을 바꾸십시오.
4. 동일한 unique 번들 식별자를 사용하고 com.adobe.luma.tutorial.android의 applicationId에서 defaultConfig에 대한 android을(를) 바꾸십시오.

일반적으로 com.organization.brand.uniqueidentifier과(와) 같은 번들 ID 문자열에 역방향 DNS 형식을 사용합니다. 이 자습서의 완성된 버전은 com.adobe.luma.tutorial.android을(를) 사용합니다.

{modal="regular"}

1. Xcode에서 프로젝트로 이동합니다.

2. Project 탐색기에서 Luma ​을(를) 선택합니다.

3. Luma 대상을 선택하십시오.

4. 정보 탭을 선택합니다.

5. 기본 URL을 추가하려면 URL 형식(으)로 아래로 스크롤하고 + 단추를 선택하세요.

6. Identifier ​을(를) 선택한 번들 식별자로 설정하고 URL 체계 ​를(를) 선택하십시오.

   {modal="regular"}

각 번들 식별자가 고유해야 하므로 unique 번들 식별자를 사용하고 com.adobe.luma.tutorial.swiftui 번들 식별자를 바꾸십시오. 일반적으로 com.organization.brand.uniqueidentifier과(와) 같은 번들 ID 문자열에 역방향 DNS 형식을 사용합니다. 번들 식별자 정의에서 사용한 것과 동일한 번들 식별자를 사용할 수 있습니다.
마찬가지로 고유한 URL 체계를 사용하고 이미 제공된 lumatutorialswiftui을(를) 고유한 URL 체계로 바꾸십시오.

iOS의 URL 체계에 대해 자세히 알아보려면 Apple의 설명서를 검토하십시오.

Assurance은 브라우저나 QR 코드를 통해 URL을 열어 작동합니다. 해당 URL은 앱을 열고 추가 매개 변수를 포함하는 기본 URL로 시작합니다. 이러한 고유한 매개 변수는 세션을 연결하는 데 사용됩니다. 예제 앱에서 딥링크는 lumatutorialswiftui://입니다.

1. Android Studio에서 프로젝트의 Android 보기로 이동합니다.

2. 네비게이터에서 앱 > 매니페스트 > AndroidManifest.xml ​을(를) 선택합니다.

3. manifest > application > activity XML 요소의 모양이 다음과 같은지 확인합니다.

   code language-xml

   <activity android:name=".MainActivity" android:exported="true" android:theme="@style/Theme.LumaAndroid"> <intent-filter> <action android:name="android.intent.action.MAIN" /> <category android:name="android.intent.category.LAUNCHER" /> </intent-filter> <intent-filter android:label="@string/app_name"> <action android:name="android.intent.action.VIEW" /> <category android:name="android.intent.category.DEFAULT" /> <category android:name="android.intent.category.BROWSABLE" /> <data android:scheme="lumatutorialandroid" android:host="default" /> </intent-filter> </activity>

android:scheme을(를) 지정하십시오(예: ). lumatutorialandroid)과(와) android:host(예: default)(으)로 기본 URL을 정의합니다.

Android의 딥링크에 대한 자세한 내용은 앱 콘텐츠에 대한 딥링크 만들기를 참조하십시오.

Assurance은 브라우저나 QR 코드를 통해 URL을 열어 작동합니다. 해당 URL은 기본 URL로 시작하며, 기본 URL은 앱을 열고 추가 매개 변수를 포함합니다. 이러한 고유한 매개 변수는 세션을 연결하는 데 사용됩니다. 예제 앱에서 딥링크는 lumatutorialandroid://default입니다.

Xcode에서:

1. 을 사용하여 시뮬레이터 또는 Xcode의 실제 장치에서 앱을 빌드하거나 다시 빌드하고 실행합니다.

   선택적으로, 특히 예기치 않은 결과가 표시될 때 빌드를 정리 ​할 수 있습니다. Xcode Product 메뉴에서 빌드 폴더 정리… ​를 선택합니다.

2. Luma 앱에서 사용자의 위치를 사용할 수 있도록 허용 대화 상자에서 앱을 사용하는 동안 허용 ​을 선택합니다.

   {width="300"}

3. "Luma 앱"에서 알림을 보내려고 합니다 대화 상자에서 허용 ​을 선택합니다.

   {width="300"}

4. 앱에서 활동을 추적할 수 있도록 하려면 계속… ​을(를) 선택하십시오.

   {width="300"}

5. 다른 회사의 앱과 웹 사이트에서 사용자의 활동을 추적할 수 있도록 "Luma 앱" 허용 대화 상자에서 허용 ​을 선택합니다.

   {width="300"}

6. 계속 ​을 선택하세요.

브라우저에서:

1. 데이터 수집 UI로 이동합니다.

2. 왼쪽 레일에서 Assurance ​을(를) 선택합니다.

3. 새 세션 만들기 ​와 옵션 딥링크 연결 ​을 선택합니다.

4. 시작 ​을 선택하세요.

5. 과(와) 같은 ​세션 이름Luma Mobile App Session과(와) Xcode에 입력한 URL 체계인 기본 URL ​을(를) 제공한 다음 ://을(를) 제공하십시오(예: lumatutorialswiftui://).

6. 다음 ​을 선택합니다.
   {modal="regular"}

7. 새 세션 만들기 모달 대화 상자에서:

   실제 장치를 사용하는 경우:

   • QR 코드 스캔 ​을 선택합니다. 앱을 열려면 실제 장치의 카메라를 사용하여 QR 코드를 스캔하고 링크를 탭합니다.

     {modal="regular"}

   시뮬레이터를 사용하는 경우:

   1. 링크 복사 ​를 선택합니다.

   2. 를 사용하여 딥링크를 복사하고 딥링크를 사용하여 시뮬레이터에서 Safari가 있는 앱을 엽니다.

      {modal="regular"}

8. 앱이 로드되면 7단계에 표시된 PIN을 입력하라는 모달 대화 상자가 표시됩니다.

   {width="300"}

   PIN을 입력하고 연결 ​을 선택하세요.

9. 연결에 성공하면 다음을 볼 수 있습니다.

   • 앱 위에 떠 있는 Assurance 아이콘.

     {width="300"}

   • Assurance UI에서 제공되는 Experience Cloud 업데이트는 다음을 표시합니다.

     1. 앱에서 들어오는 경험 이벤트.

     2. 선택한 이벤트에 대한 세부 정보.

     3. 장치 및 타임라인.

        {modal="regular"}

10. 홈 화면으로 이동하려면 계속 ​을 선택합니다.

Android Studio에서:

1. 을 사용하여 시뮬레이터 또는 Android Studio의 실제 장치에서 앱을 빌드하거나 다시 빌드하고 실행합니다.

   선택적으로, 특히 예기치 않은 결과가 표시될 때 빌드를 정리 ​할 수 있습니다. Android Studio 빌드 메뉴에서 프로젝트 정리 ​를 선택합니다.

2. Luma Android에서 알림을 보내도록 허용 대화 상자에서 허용 ​을 선택합니다.

   {width="300"}

3. 권한 대화 상자 표시 ​를 선택합니다.

   {width="300"}

4. Luma Android에서 이 장치의 위치에 액세스할 수 있도록 허용하시겠습니까?…

   {width="300"}

   • 정확한 ​을(를) 선택하십시오.
   • 앱을 사용하는 동안 ​을(를) 선택합니다.

5. 소개 앱 화면으로 돌아가서 장치 설정 열기 ​를 선택합니다.

6. 위치 권한 화면에서 항상 허용 ​을 선택합니다. ← ​을(를) 선택하여 소개 앱 화면으로 돌아갑니다.

   {width="300"}

7. 홈 화면으로 이동하려면 계속 ​을 선택합니다.

브라우저에서:

1. 데이터 수집 UI로 이동합니다.

2. 왼쪽 레일에서 Assurance ​을(를) 선택합니다.

3. 새 세션 만들기 ​와 옵션 딥링크 연결 ​을 선택합니다.

4. 시작 ​을 선택하세요.

5. 과(와) 같은 ​세션 이름Luma Mobile App Session과(와) Android Studio의 AndroidManifest.xml ​에서 정의한 android:scheme 및 android:host인 기본 URL ​을(를) ://(으)로 구분하여 제공하십시오. 예: lumatutorialandroid://default

6. 다음 ​을 선택합니다.
   {modal="regular"}

7. 새 세션 만들기 모달 대화 상자에서:

   실제 장치를 사용하는 경우:

   • QR 코드 스캔 ​을 선택합니다. 앱을 열려면 실제 장치의 카메라를 사용하여 QR 코드를 스캔하고 링크를 탭합니다.

     {modal="regular"}

   시뮬레이터를 사용하는 경우:

   1. 링크 복사 ​를 선택합니다.
   2. 를 사용하여 딥링크를 복사하고 딥링크를 사용하여 시뮬레이터에서 Chrome이 있는 앱을 엽니다.

   {modal="regular"}

   Chrome에서 Luma Android으로 계속 ​하라는 메시지가 표시되면 계속 ​을 선택합니다.

8. 앱이 로드되면 7단계에 표시된 PIN을 입력하라는 모달 대화 상자가 표시됩니다.

   {width="300"}

   PIN을 입력하고 연결 ​을 선택하세요.

9. 연결에 성공하면 다음을 볼 수 있습니다.

   • 앱 위에 떠 있는 Assurance 아이콘.

     {width="300"}

   • Assurance UI에서 제공되는 Experience Cloud 업데이트는 다음을 표시합니다.

     1. 앱에서 들어오는 경험 이벤트.

     2. 선택한 이벤트에 대한 세부 정보.

     3. 장치 및 타임라인.

        {modal="regular"}

{modal="regular"}

확장 버전(예: 메시징 및 최적화)을 업데이트하려면 패키지 종속성(예: AEPMessaging)에서 패키지(확장)를 선택하고 컨텍스트 메뉴에서 패키지 업데이트 ​를 선택합니다. Xcode는 패키지 종속성을 업데이트합니다.

{modal="regular"}

오래된 확장이 표시되면 프로젝트에 대한 종속성 모듈을 업데이트하는 방법에 대한 Android Studio 설명서를 참조하세요.