푸시 알림 구성 및 전송

Apple 개발자 포털에서 키(으)로 이동합니다.

키를 만들려면 + ​을(를) 선택합니다.

키 이름 ​을 입력하십시오.

Apple 푸시 알림 서비스 (APNs) 확인란을 선택하십시오.

계속 ​을 선택하세요.

구성을 검토하고 등록 ​을 선택하세요.

.p8 개인 키를 다운로드합니다. 이 메서드는 이 단원의 뒷부분에서 앱 표면 구성에 사용됩니다.

키 ID ​을(를) 메모하세요. 앱 표면 구성에서 사용됩니다.

팀 ID ​를 메모하세요. 앱 표면 구성에서 사용됩니다.

데이터 수집 인터페이스의 왼쪽 패널에서 앱 표면 ​을 선택합니다.

구성을 만들려면 앱 표면 만들기 ​를 선택하십시오.

구성에 대한 이름 ​을(를) 입력하십시오(예: Luma App Tutorial ).

모바일 응용 프로그램 구성 ​에서 Apple iOS ​을(를) 선택합니다.

앱 ID(iOS 번들 ID) 필드에 모바일 앱 번들 ID를 입력합니다. 예: com.adobe.luma.tutorial.swiftui.

자격 증명을 추가하려면 자격 증명 푸시 토글을 켜십시오.

.p8 Apple 푸시 알림 인증 키 파일을 끌어서 놓습니다.

p8 인증 키를 만드는 동안 할당된 10자 문자열인 키 ID ​을(를) 제공하십시오. Apple 개발자 포털 페이지의 인증서, 식별자 및 프로필 페이지에 있는 키 탭에서 찾을 수 있습니다. 개인 키 만들기도 참조하세요.

팀 ID ​를 제공하십시오. 팀 ID는 멤버십 탭이나 Apple 개발자 포털 페이지의 맨 위에서 찾을 수 있는 값입니다. 개인 키 만들기도 참조하세요.

저장 ​을 선택합니다.

데이터 수집 UI에서 데이터스트림 ​을(를) 선택하고 데이터스트림(예: Luma Mobile App)을 선택합니다.

Experience Platform ​에 대해 를 선택하고 상황에 맞는 메뉴에서 편집 ​을 선택합니다.

데이터스트림 > > Adobe Experience Platform 화면에서 다음을 수행합니다.

1. 아직 선택하지 않은 경우 프로필 데이터 세트 ​에서 AJO 푸시 프로필 데이터 세트 ​을(를) 선택하십시오. 푸시 알림에 대한 고유 식별자(푸시 식별자)가 사용자 프로필의 일부로 저장되도록 하는 MobileCore.setPushIdentifier API 호출(푸시 알림에 대한 장치 토큰 등록 참조)을 사용할 때 이 프로필 데이터 세트가 필요합니다.

2. Adobe Journey Optimizer ​을(를) 선택했습니다. 자세한 내용은 Adobe Experience Platform 설정을 참조하세요.

3. 데이터스트림 구성을 저장하려면 저장 ​을 선택합니다.

태그 > 확장 > 카탈로그(으)로 이동합니다.

속성을 엽니다(예: Luma Mobile App Tutorial).

카탈로그 ​를 선택하십시오.

Adobe Journey Optimizer 확장을 검색합니다.

확장을 설치합니다.

확장 설치 대화 상자에서

1. 환경을 선택하십시오(예: 개발).

2. 이벤트 데이터 세트 목록에서 AJO 푸시 추적 경험 이벤트 데이터 세트 데이터 세트를 선택합니다.

3. 라이브러리 및 빌드에 저장 ​을 선택합니다.

   

설치 지침 섹션을 검토하여 시뮬레이터 또는 장치를 Assurance에 연결하십시오.

Assurance UI에서 구성 ​을 선택합니다.

디버그 푸시 옆에 있는 를 선택합니다.

저장 ​을 선택합니다.

왼쪽 탐색에서 디버그 푸시 ​를 선택합니다.

설정 유효성 검사 탭을 선택합니다.

클라이언트 목록에서 장치를 선택하십시오.

오류가 발생하지 않는지 확인합니다.

테스트 푸시 보내기 탭을 선택합니다.

(선택 사항) 제목 및 본문 ​에 대한 기본 세부 정보를 변경합니다

테스트 푸시 알림 보내기 ​를 선택합니다.

테스트 결과 ​를 확인하세요.

앱에 테스트 푸시 알림이 표시되는 것을 확인해야 합니다.

{width="300"}

Xcode에서 앱으로 이동합니다.

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

Luma 대상을 선택하십시오.

서명 및 기능 탭을 선택합니다.

서명 자동 관리, 팀 및 번들 식별자 ​를 구성하거나 특정 Apple 개발 프로비저닝 세부 정보를 사용합니다.

{modal="regular"}

Xcode의 TARGETS 목록에서 Luma ​을(를) 선택하고, 서명 및 기능 탭을 선택하고, + 기능 버튼을 선택한 다음 푸시 알림 ​을 선택합니다. 이렇게 하면 앱에서 푸시 알림을 받을 수 있습니다.

그런 다음 앱에 알림 확장 기능을 추가해야 합니다. General 탭으로 돌아가서 TARGETS 섹션 아래쪽의 + 아이콘을 선택하십시오.

새 타겟에 대한 템플릿을 선택하라는 메시지가 표시됩니다. 알림 서비스 확장 ​을 선택한 다음 다음 ​을 선택합니다.

다음 창에서 확장 이름으로 NotificationExtension을(를) 사용하고 마침 단추를 클릭합니다.

Xcode에서 AEP Messaging이(가) 패키지 종속성의 패키지 목록에 추가되어 있는지 확인하십시오. Swift 패키지 관리자를 참조하세요.

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

AEPMessaging이(가) 가져오기 목록의 일부인지 확인하십시오.

import AEPMessaging

Messaging.self이(가) 등록 중인 확장 배열의 일부인지 확인하십시오.

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
]

MobileCore.setPushIdentifier API를 func application(_ application: UIApplication, didRegisterForRemoteNotificationsWithDeviceToken deviceToken: Data) 함수에 추가합니다.

// Send push token to Mobile SDK
MobileCore.setPushIdentifier(deviceToken)

이 함수는 앱이 설치된 장치에 고유한 장치 토큰을 검색합니다. 그런 다음 설정한 구성을 사용하여 푸시 알림 전달을 위한 토큰을 설정하고 Apple의 APNs(푸시 알림 서비스)를 사용합니다.

Journey Optimizer UI의 왼쪽 레일에서 스키마 ​를 선택합니다.

탭 표시줄에서 찾아보기 ​를 선택합니다.

스키마를 열려면 스키마(예: Luma Mobile App Event Schema)를 선택하십시오.

스키마 편집기에서:

1. eventType 필드를 선택합니다.

2. 필드 속성 창에서 아래로 스크롤하여 이벤트 유형에 사용할 수 있는 값 목록을 확인합니다. 행 추가 ​를 선택하고 application.test을(를) 값(으)로, Test event for push notification을(를) DISPLAY NAME(으)로 추가합니다.

3. 적용 ​을 선택합니다.

4. 저장 ​을 선택합니다.

   

Journey Optimizer UI의 왼쪽 레일에서 구성 ​을 선택합니다.

대시보드 화면의 이벤트 타일에서 관리 단추를 선택합니다.

이벤트 화면에서 이벤트 만들기 ​를 선택합니다.

이벤트 편집1 창에서:

1. 이벤트의 이름(으)로 LumaTestEvent을(를) 입력하십시오.

2. 설명(예: Test event to trigger push notifications in Luma app)을 입력하십시오.

3. 스키마 목록에서 XDM 스키마 만들기에서 이전에 만든 모바일 앱 경험 이벤트 스키마를 선택합니다(예: Luma Mobile App Event Schema v.1).

4. 필드 목록 옆의 을(를) 선택합니다.

   

   필드 대화 상자에서 항상 선택된 기본 필드(_id, id, 타임스탬프) 위에 다음 필드가 선택되어 있는지 확인하십시오. 드롭다운 목록을 사용하여 선택됨, 모두 ​와(과) 기본 사이를 전환하거나 필드를 사용할 수 있습니다.

   • 식별된 응용 프로그램(id),
   • 이벤트 유형(eventType),
   • 기본(기본).

   

   그런 다음 확인 ​을 선택합니다.

5. 이벤트 ID 조건 필드 옆에 있는 을 선택합니다.

   1. 이벤트 ID 조건 추가 대화 상자에서 이벤트 유형(eventType) ​을(를) 여기에 요소 끌어다 놓기 ​로 끌어다 놓습니다.

   2. 팝오버에서 아래쪽으로 스크롤하여 application.test(스키마 업데이트🔗의 일부로 이벤트 유형 목록에 이전에 추가한 이벤트 유형)을 선택합니다. 그런 다음 위로 스크롤하여 확인 ​을 선택합니다.

   3. 확인 ​을 선택하여 조건을 저장합니다.

      

6. 네임스페이스 목록에서 ECID(ECID) ​을(를) 선택합니다. 자동으로 프로필 식별자 필드가 맵 identityMap에 대한 키 ECID의 첫 번째 요소의 ID(으)로 채워집니다.

7. 저장 ​을 선택합니다.

   

Journey Optimizer UI의 왼쪽 레일에서 여정 ​을(를) 선택합니다.

여정 만들기 ​를 선택합니다.

여정 속성 패널에서:

1. 여정의 이름(예: Luma - Test Push Notification Journey)을 입력하십시오.

2. 여정에 대한 설명 ​을(를) 입력하십시오(예: Journey for test push notifications in Luma mobile app).

3. 다시 입력 허용 ​을 선택하고 다시 입력 대기 기간 ​을 30 초(으)로 설정하십시오.

4. 확인 ​을 선택합니다.

   

여정 캔버스로 돌아가서 EVENTS ​에서 LumaTestEvent ​을(를) 캔버스에 끌어다 놓습니다. 캔버스에는 시작 이벤트 또는 대상자 읽기 활동 선택 ​이 표시됩니다.

• 이벤트: LumaTestEvent 패널에서 레이블(예: Luma Test Event)을(를) 입력하십시오.

ACTIONS 드롭다운에서 LumaTestEvent 활동의 오른쪽에 나타나는 에서 Push ​을(를) 끌어서 놓습니다. 작업: 푸시 창에서:

1. 레이블(예: Luma Test Push Notification)을 제공하고 설명(예: Test push notification for Luma mobile app)을 제공하고 범주 목록에서 트랜잭션 ​을(를) 선택한 다음 푸시 표면 ​에서 Luma ​을(를) 선택합니다.

2. 실제 푸시 알림의 편집을 시작하려면 콘텐츠 편집 ​을(를) 선택하십시오.

   

   푸시 알림 편집기에서:

   1. 제목(예: Luma Test Push Notification)을 입력하고 본문(예: Test push notification for Luma mobile app)을 입력하십시오.

   2. 미디어 추가 ​에서 이미지(.png 또는 .jpg)에 대한 링크를 입력할 수도 있습니다. 그렇게 하면 이미지가 푸시 알림의 일부가 됩니다.

   3. 저장하고 편집기에서 나가려면 을(를) 선택합니다.

      

3. 푸시 알림 정의를 저장하고 완료하려면 확인 ​을 선택하세요.

여정은 다음과 같아야 합니다. 여정을 게시하고 활성화하려면 Publish ​을(를) 선택하십시오.

Xcode 프로젝트 탐색기에서 Luma > Luma > 모델 > XDM > TestPushPayload(으)로 이동하여 코드를 검사합니다.

import Foundation

// MARK: - TestPush
struct TestPushPayload: Codable {
   let application: Application
   let eventType: String
}

// MARK: - Application
struct Application: Codable {
   let id: String
}

이 코드는 테스트 푸시 알림 여정을 트리거하기 위해 전송할 다음의 간단한 페이로드를 나타냅니다

{
   "eventType": string,
   "application" : [
       "id": string
   ]
}

Xcode 프로젝트 탐색기에서 Luma > Luma > Utils > MobileSDK(으)로 이동하여 func sendTestPushEvent(applicationId: String, eventType: String)에 다음 코드를 추가합니다.

// Create payload and send experience event
Task {
    let testPushPayload = TestPushPayload(
        application: Application(
            id: applicationId
        ),
        eventType: eventType
    )
    // send the final experience event
    await sendExperienceEvent(
        xdm: testPushPayload.asDictionary() ?? [:]
    )
}

이 코드는 함수(applicationId 및 eventType)에 제공된 매개 변수를 사용하여 testPushPayload 인스턴스를 만든 다음 페이로드를 사전으로 변환하는 동안 sendExperienceEvent을(를) 호출합니다. 이 코드는 이번에는 await 및 async을(를) 기반으로 하는 Swift의 동시성 모델을 사용하여 Adobe Experience Platform SDK를 호출하는 비동기적인 측면도 고려합니다.

Xcode 프로젝트 탐색기에서 Luma > Luma > Views > General > ConfigView(으)로 이동합니다. 푸시 알림 단추 정의에서 다음 코드를 추가하여 테스트 푸시 알림 경험 이벤트 페이로드를 전송하여 해당 단추를 누를 때마다 여정을 트리거합니다.

// Setting parameters and calling function to send push notification
Task {
    let eventType = testPushEventType
    let applicationId = Bundle.main.bundleIdentifier ?? "No bundle id found"
    await MobileSDK.shared.sendTestPushEvent(applicationId: applicationId, eventType: eventType)
}

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

설정 탭으로 이동합니다.

푸시 알림 ​을 누릅니다. 앱에 푸시 알림이 표시되는 것을 볼 수 있습니다.

{width="300"}