알림 푸시 push-notifications
중요한 알림을 사용하여 AEM Mobile 앱 사용자에게 즉시 알릴 수 있는 것은 모바일 앱과 마케팅 캠페인의 가치에 중요합니다. 여기서는 앱이 푸시 알림을 받을 수 있도록 해야 하는 단계와 AEM Mobile에서 휴대폰에 설치된 앱으로 푸시를 구성하고 전송하는 방법에 대해 설명합니다. 또한 이 섹션에서는 심층 연결 푸시 알림에 대한 기능.
AEM에서 푸시 알림을 사용하려면 몇 가지 다른 기술이 필요합니다. 먼저 푸시 알림 서비스 공급자를 사용하여 알림 및 장치를 관리해야 합니다(AEM에서는 아직 이렇게 하지 않음). 두 공급자는 AEM을 사용하여 즉시 구성됩니다. Amazon Simple Notification Service (또는 SNS) 및 푸쉬우시. 둘째, 주어진 모바일 OS에 대한 푸시 기술은 iOS 장치에 대한 적절한 서비스(Apple의 푸시 알림 서비스 또는 APNS)를 통과해야 합니다. 및 Android 장치용 Google 클라우드 메시징(또는 GCM)을 사용할 수 있습니다. AEM은 이러한 플랫폼별 서비스와 직접 통신하지 않지만, 이러한 서비스에서 푸시를 실행하려면 알림과 함께 일부 관련 구성 정보를 AEM에서 제공해야 합니다.
설치 및 구성 후에는(아래에 설명된 대로) 다음과 같이 작동합니다.
- 푸시 알림이 AEM에서 생성되어 서비스 공급자(Amazon SNS 또는 Pushwoosh)에게 전송됩니다.
- 서비스 공급자가 이 콘텐츠를 수신하여 핵심 공급자(APNS 또는 GCM)에게 보냅니다.
- 코어 공급자는 알림을 해당 푸시에 등록된 모든 장치에 푸시합니다. 각 장치에 대해 셀룰러 데이터 네트워크 또는 WiFi(현재 장치에서 사용 가능한 것)를 사용합니다.
- 등록된 앱이 실행되고 있지 않은 경우 장치가 알림을 표시합니다. 알림을 탭하면 앱이 시작되고 앱 내에 알림이 표시됩니다. 애플리케이션이 이미 실행 중인 경우 인앱 알림만 표시됩니다.
이 AEM 릴리스는 iOS 및 Android 모바일 장치를 지원합니다.
개요 및 절차 overview-and-procedure
AEM Mobile 앱에서 푸시 알림을 사용하려면 다음 높은 수준의 단계를 수행해야 합니다.
일반적으로 AEM 개발자는 다음을 수행합니다.
- Apple 및 Google 메시징 서비스에 등록
- 푸시 메시지 서비스에 등록하고 구성합니다
- 앱에 푸시 지원 추가
- 테스트 전화 준비
AEM 관리자는 다음을 수행합니다.
- AEM 앱에서 푸시 구성
- 앱 빌드 및 배포
- 푸시 알림 보내기
- 딥 링크 구성 (선택 사항)
1단계: Apple 및 Google 메시징 서비스에 등록 step-register-with-apple-and-google-messaging-services
Apple 푸시 알림 서비스(APNS) 사용 using-the-apple-push-notification-service-apns
Apple 페이지로 이동합니다 여기 Apple 푸시 알림 서비스에 익숙해지도록 했습니다.
APNS를 사용하려면 인증서 파일(.cer 파일), 푸시 개인 키 (a.p12 파일) 및 개인 키 암호 Apple에서 가져옵니다. 방법 지침은 여기.
GCM(Google Cloud Messaging) 서비스 사용 using-the-google-cloud-messaging-gcm-service
Google 페이지로 이동합니다 여기 android용 Google 클라우드 메시징 기능에 익숙해지도록 하기 위해 입니다.
다음 단계를 수행해야 합니다 여기 to Google API 프로젝트 만들기, GCM 서비스 활성화, 및 API 키 가져오기. 다음을 수행해야 합니다. API 키 푸시 알림을 Android 장치로 전송하려면 다음을 수행하십시오. 또한 프로젝트 번호 이라고도 하는 를 GCM 발신자 Id.
다음 단계는 GCM API 키를 만드는 다른 방법을 보여줍니다.
- google에 로그인하고 Google 개발자 페이지.
- 목록에서 앱을 선택하거나 새 앱을 만듭니다.
- Android 패키지 이름에서 앱 ID(예:
com.adobe.cq.mobile.weretail.outdoorsapp
. (작동하지 않는 경우 "test.test"로 다시 시도하십시오.) - 클릭 서비스 선택 및 구성 계속
- 클라우드 메시징 을 선택한 다음 Google 클라우드 메시징 활성화.
- 그러면 새 서버 API 키와 (신규 또는 기존) 발신자 ID가 표시됩니다.
2단계: 푸시 메시지 서비스 등록 및 구성 step-register-and-configure-a-push-messaging-service
AEM은 푸시 알림에 세 가지 서비스 중 하나를 사용하도록 구성되어 있습니다.
- Amazon SNS
- Pushwoosh
- Adobe Mobile Services
Amazon SNS 및 푸쉬우시 구성을 사용하면 AEM screens 내에서 푸시된 항목을 보낼 수 있습니다.
Adobe Mobile Services 구성을 사용하면 Adobe Analytics 계정을 사용하여 Mobile Services 내에서 푸시 알림을 구성하고 전송할 수 있습니다(하지만 AMS 푸시 알림을 활성화하려면 이 구성 세트로 앱을 빌드해야 함).
Amazon SNS 메시징 서비스 사용 using-the-amazon-sns-messaging-service
Amazon SNS를 사용하지 않으려면 이 단계를 건너뛸 수 있습니다.
푸시 알림용 Amazon SNS를 설정하려면 다음 단계를 따르십시오.
-
Amazon SNS에 등록
- 계정 Id를 기록합니다. 형식은 공백 또는 대시가 없는 12자리여야 합니다(예: "123456789012".
- 이후 단계(Identity Pool Creation)에 따라 "미국-동부" 또는 "eu" 지역에 있는지 확인합니다.
- 등록 후 관리 콘솔에 로그인하고 를 선택합니다 SNS (푸시 알림 서비스). "시작하기"가 나타나면 를 클릭합니다.
-
액세스 키 및 ID 만들기
- 화면 오른쪽 상단에 있는 로그인 이름을 클릭하고 메뉴에서 보안 자격 증명을 선택합니다.
- 액세스 키를 클릭하고 아래 스페이스에서 를 클릭합니다. 새 액세스 키 만들기.
- 클릭 액세스 키 표시, 및 Access 키 ID 및 Secret Access 키를 복사하여 저장합니다. 키를 다운로드하는 옵션을 선택하면 동일한 값이 들어 있는 csv 파일이 표시됩니다.
- 다른 보안 관련 인증서 및 기타 다른 인증서는 이 페이지에서 관리할 수 있습니다.
note note NOTE 액세스 키는 여러 앱에 사용할 수 있습니다. "AWS Sandbox" 계정을 사용하는 조직의 경우 이 단계는 매우 유사하며 여기에 요약되어 있습니다.
- 화면 오른쪽 상단에 있는 로그인 이름을 클릭하고 메뉴에서 내 보안 자격 증명을 선택합니다.
- 작업 왼쪽 목록에서 사용자 를 클릭하고 사용자 이름을 선택합니다.
- 보안 자격 증명 탭을 클릭합니다.
- 여기에서 키가 표시되고 새 키가 만들어집니다. 나중에 사용할 수 있도록 키를 저장합니다.
-
주제 만들기
- 클릭 주제 만들기 주제 이름을 선택합니다. 주제 ARN, 주제 소유자, 영역, 표시 이름과 같은 모든 필드를 기록합니다.
- 클릭 기타 항목 작업 > 항목 정책 편집. 아래 이러한 사용자가 이 항목에 가입하도록 허용, 선택 모두
- 클릭 정책 업데이트.
note note NOTE 개발, 테스트, 데모 등과 같은 다양한 시나리오에 대해 여러 주제를 만들 수 있습니다. 나머지 SNS 구성은 그대로 유지될 수 있습니다. 다른 주제를 사용하여 앱을 빌드합니다. 해당 주제에 전송되는 푸시 알림은 해당 주제와 함께 빌드된 앱에서만 수신됩니다. -
플랫폼 애플리케이션 만들기
-
응용 프로그램, 플랫폼 응용 프로그램 만들기를 차례로 클릭합니다. 이름을 선택하고 플랫폼(iOS의 경우 APNS, Android의 경우 GCM)을 선택합니다. 플랫폼에 따라 다른 필드를 입력해야 합니다.
- APNS의 경우 P12 파일, 암호, 인증서 및 개인 키를 모두 입력해야 합니다. 이 정보는 단계에서 얻어야 합니다 Apple 푸시 알림 서비스(APNS) 사용 위에 표시됩니다.
- GCM의 경우 API 키를 입력해야 합니다. 이 값은 단계에서 얻어야 합니다 GCM(Google Cloud Messaging) 서비스 사용 위에 표시됩니다.
-
지원할 각 플랫폼에 대해 위의 단계를 한 번 반복합니다. iOS과 Android를 모두 푸시하려면 두 개의 Platform 애플리케이션을 만들어야 합니다.
-
-
ID 풀 만들기
- 사용 Cognito 인증되지 않은 사용자의 기본 데이터를 저장하는 ID 풀을 만듭니다. 현재 "미국-동부" 및 "eu" 리전만 Amazon Cognito에서 지원합니다.
- 이름을 지정하고 "인증되지 않은 ID에 액세스 활성화" 상자를 선택합니다.
- 다음 페이지에서("Cognito 자격 증명을 사용하려면 리소스에 액세스해야 합니다") 허용 을 클릭합니다.
- 페이지 오른쪽 상단에서 " 링크를 클릭합니다.ID 풀 편집". ID 풀 ID가 표시됩니다. 이 텍스트를 나중에 저장할 수 있습니다.
- 동일한 페이지에서 "인증되지 않은 역할" 옆의 드롭다운을 선택하고 Cognito_ 역할이 있는지 확인합니다.<pool name="">UnauthRole이 선택되었습니다. 변경 사항을 저장합니다.
-
액세스 구성
- 에 로그인합니다. ID 및 액세스 관리 (IAM)
- 역할 선택
- 이전 단계에서 Cognito_ 이라는 역할을 클릭합니다.<youridentitypoolname>Unauth_Role. 표시된 "역할 ARN"을 기록합니다.
- 아직 열려 있지 않으면 "인라인 정책"을 엽니다. 여기에는 oneClick_Cognito_ 와 같은 이름의 정책이 표시됩니다<youridentitypoolname>Unauth_Role_1234567890123.
- "정책 편집"을 클릭합니다. 정책 문서의 컨텐츠를 다음 JSON 코드 조각으로 바꿉니다.
table 0-row-1 html-authored no-header {
"버전": "2012-10-17",
"구문": [
{
"작업": [
"mobileanalytics:PutEvents",
"cognito-sync:*",
"SNS:CreatePlatformEndpoint",
"SNS:가입"
],
"효과": "허용",
"리소스": [
"*"
]
}
]
}
- 클릭 정책 적용
Pushwoosh 메시징 서비스 사용 using-the-pushwoosh-messaging-service
Pushwoosh를 사용하지 않으려면 이 단계를 건너뛸 수 있습니다.
Pushwoosh를 사용하려면
-
Pushwoosh에 등록
- pushwoosh.com으로 이동하여 새 계정을 만듭니다.
-
API 액세스 토큰 만들기
- 푸시 사이트, API 액세스 메뉴 항목으로 이동하여 API 액세스 토큰을 생성합니다. 이 내용을 반드시 기록해야 합니다.
-
새 앱 만들기
- Android 지원의 경우 GCM API 키를 제공해야 합니다.
- 앱을 구성할 때 프레임워크로 Cordova를 선택합니다.
- iOS 지원을 위해 인증서 파일(.cer), 푸시 인증서(.p12) 및 개인 키 암호를 제공해야 합니다. 이 API는 Apple의 APNS 사이트에서 가져와야 합니다. 프레임워크에서 Cordova를 선택합니다.
- Pushwoosh는 해당 앱의 앱 ID를 "XXXXX-XXXXXXX" 형태로 생성합니다. 여기서 각 X는 16진수 값(0~F)입니다.
3단계: 앱에 푸시 지원 추가 step-add-push-support-to-the-app
ContentSync 구성 추가 add-contentsync-configuration
notificationsConfig라는 두 개의 컨텐츠 노드(app-config에 하나, app-config-dev에 하나)를 만듭니다.
- /content/
<your app>
/shell/jcr:content/page-app/app-config-dev/notificationsConfig - /content/
<your app>
/shell/jcr:content/page-app/app-config/notificationsConfig
다음 속성(.content.xml 파일) 사용:
<jcr:root xmlns:jcr=" <span id=" translate="no" />https://www.jcp.org/jcr/1.0🔗" xmlns:nt=" https://www.jcp.org/jcr/nt/1.0"
jcr:primaryType="nt:un구조화되지 않음"
excludeProperties="[appAPIAccessToken]"
경로="…/…/…/…"
targetRootDirectory="www"
type="notificationsconfig"/>
클라이언트 라이브러리 추가 add-client-libraries
푸시 알림 클라이언트 라이브러리를 다음 단계에 따라 앱에 추가해야 합니다.
CRXDE Lite:
- 다음으로 이동 /etc/designs/phonegap/<app name="">/clientlibsall.
- 속성 창에서 포함 섹션을 두 번 클릭합니다.
- 나타나는 대화 상자에서 + 단추를 클릭하여 새 클라이언트 라이브러리를 추가합니다.
- 새 텍스트 필드에서 "cq.mobile.push"를 추가하고 확인을 클릭합니다.
- cq.mobile.push.amazon이라는 이름을 한 개 더 추가하고 확인을 클릭합니다.
- 변경 사항을 저장합니다.
4단계: 테스트 전화 준비 step-prepare-a-phone-for-testing
iOS ios
iOS의 경우 Mac OS 컴퓨터를 사용해야 하며 iOS 개발자 프로그램. 일부 기업은 모든 개발자가 사용할 수 있는 기업 라이센스를 보유하고 있습니다.
XCode 8.1을 사용하면 푸시 알림을 사용하기 전에 프로젝트의 기능 탭으로 이동하여 푸시 알림 토글을 켜십시오.
Android android
CLI를 사용하여 Android 휴대폰에 앱을 설치하려면 다음을 참조하십시오. 6단계 - 앱 빌드 및 배포). 먼저 휴대폰을 "개발자 모드"로 설정해야 합니다. 자세한 내용은 장치 내 개발자 옵션 활성화 자세한 내용은 다음을 참조하십시오.
5단계: AEM 앱에서 푸시 구성 step-configure-push-on-aem-apps
구성된 모바일 장치에 빌드하고 배포하기 전에 사용하도록 결정한 메시징 서비스에 대한 알림 설정을 구성해야 합니다.
- 푸시 알림에 대한 적절한 권한 부여 그룹을 만듭니다.
- 적절한 사용자로 AEM에 로그인하고 앱 탭을 클릭합니다.
- 앱을 클릭합니다.
- Cloud Services 관리 타일을 찾고 연필을 클릭하여 클라우드 구성을 수정합니다.
- 알림 구성으로 Amazon SNS 연결, Pushwoosh 연결 또는 Adobe Mobile Services 를 선택합니다.
- 공급자 속성을 입력하고 제출을 눌러 저장하고 완료 를 클릭합니다. AMS의 경우를 제외하고는 이 단계에서 원격으로 확인되지 않습니다.
- 이제 Cloud Services 관리 타일에 방금 입력한 구성이 표시됩니다.
6단계: 앱 빌드 및 배포 step-build-and-deploy-the-app
참고: 지침 을 참조하십시오 여기 PhoneGap 응용 프로그램 빌드를 참조하십시오.
PhoneGap를 사용하여 앱을 빌드하고 배포하는 방법에는 두 가지가 있습니다.
참고: 푸시 알림 테스트의 경우 푸시 알림은 푸시 공급자(Apple 또는 Google)과 장치 간에 고유한 프로토콜을 사용하기 때문에 에뮬레이터로도 충분하지 않습니다. 현재 Mac/PC 하드웨어 및 에뮬레이터는 이를 지원하지 않습니다.
-
PhoneGap Build 는 PhoneGap에서 제공하는 서비스로, 해당 서버에서 앱을 빌드하고 이를 장치에 직접 다운로드할 수 있습니다. 자세한 내용은 PhoneGap Build 설명서 PhoneGap Build 설정 및 사용 방법을 알아봅니다.
-
PhoneGap 명령줄 인터페이스 (CLI)를 사용하면 명령줄에서 풍부한 PhoneGap 명령 세트를 사용하여 앱을 빌드, 디버그 및 배포할 수 있습니다. 자세한 내용은 PhoneGap 개발자 설명서 PhoneGap CLI를 설정하고 사용하는 방법을 살펴볼 수 있습니다.
7단계: 푸시 알림 보내기 step-send-a-push-notification
새 알림을 만들고 전송하려면 다음 단계를 수행합니다.
-
새 알림 만들기
- AEM Mobile 앱의 대시보드에서 푸시 알림 타일을 찾습니다.
- 오른쪽 위의 메뉴에서 "만들기"를 선택합니다. 클라우드 구성이 처음 설정될 때까지 이 단추를 사용할 수 없습니다.
- 알림 만들기 마법사에서 제목과 메시지를 입력한 다음 "만들기" 단추를 클릭합니다. 이제 알림을 즉시 또는 나중에 보낼 수 있습니다. 편집하고 메시지 및/또는 제목을 변경하거나 저장할 수 있습니다.
-
알림 보내기
- 앱 대시보드에서 푸시 알림 타일을 찾습니다.
- 알림을 선택하거나 오른쪽 하단에 있는 세부 정보 버튼을 클릭합니다(. . .) 나열됩니다. 이 목록에는 알림을 보낼 준비가 되었는지, 이미 전송되었는지 또는 전송 중에 오류가 발생했는지 여부도 표시됩니다.
- 한 알림(전용)에 대한 확인란을 선택하고 목록 위에 있는 "알림 보내기" 단추를 클릭합니다. 표시되는 대화 상자에서 알림을 "취소" 또는 "전송"할 수 있습니다.
-
결과 처리
-
푸시 알림 서비스(Amazon SNS 또는 Pushwoosh)가 전송 요청을 수신하여 이를 유효한지 확인하고 이를 기본 공급자(APNS 및 GCM)에게 성공적으로 보내면 전송 대화 상자가 메시지가 없는 상태로 닫힙니다. 알림 목록에서 해당 알림의 상태가 전송됨으로 나열됩니다.
-
푸시 전송이 실패하면 문제를 나타내는 메시지가 대화 상자에 표시됩니다. 알림 목록에서 해당 알림의 상태가 오류로 나열되지만 문제가 수정되면 알림을 다시 전송할 수 있습니다. 오류가 발생하면 서버 오류 로그에 추가 오류 정보가 표시됩니다.
-
iOS과 Android 푸시 알림 간에는 몇 가지 플랫폼 차이점이 있습니다. 그 중에서:
- CLI로 빌드하면 Android에 배포된 후 앱이 시작됩니다. iOS에서 수동으로 시작해야 합니다. 푸시 등록 단계는 시작 시 발생하므로 iOS 앱은 시작되지 않지만 Android 앱은 즉시 푸시 알림을 받을 수 있습니다.
- Android에서 확인 단추 텍스트는 모든 대문자로 표시되지만(및 인앱 알림에 추가된 다른 모든 단추에서) iOS에서는 그렇지 않습니다.
-
AMS 푸시 알림의 경우 AMS 서버에서 알림을 작성하고 전송해야 합니다. AMS는 AWS 및 Pushwoosh를 사용하여 AEM 알림에서 제공하는 것 외에도 추가 푸시 알림 기능을 제공합니다.
푸시 알림과 함께 딥 링크 구성 configuring-deep-linking-with-push-notifications
딥 링크란 무엇입니까? 푸시 알림 컨텍스트에서 앱의 열기 또는 앱 내의 지정된 위치(열려 있는 경우)로 안내할 수 있는 수단입니다.
어떻게 작동합니까? 푸시 알림 작성자는 선택적으로 단추 레이블(즉, "나를 보여!") 알림 을 선택하고 시각적 경로 브라우저를 통해 알림에 연결할 페이지를 선택합니다. 메시지가 전송되면 인앱 메시지에서 OK 단추가 "해제" 단추로 대체되고 새 단추("표시!")가 지정된 경우를 제외하고 푸시가 정상적으로 발생합니다 이 나타납니다. 새 단추를 클릭하면 앱이 앱 내의 지정된 페이지로 이동합니다. 무시 를 클릭하면 메시지가 무시됩니다.
앱이 열려 있지 않으면 음영이 정상적으로 나타납니다. 갓에서 알림에 대해 작업을 수행하면 앱이 열린 다음 푸시 알림에 구성된 내용에 따라 딥 링크 단추를 사용자에게 표시합니다.
알림을 만들고, 선택적 딥 링크에 대한 단추 텍스트와 링크 경로를 추가합니다.
-
의 오른쪽 위 모서리에 있는 편집 을 클릭합니다. Cloud Services 관리 타일.
-
을(를) 선택합니다 Pushwoosh 연결. 다음 을 클릭합니다.
-
등록 정보의 세부 정보를 입력하고 제출.
구성을 제출하면 푸시 알림 대시보드에 타일이 표시됩니다.
알림 만들기 마법사 create-notification-wizard
한 번 푸시 알림 대시보드에 타일이 표시되면 알림 만들기 마법사를 사용하여 컨텐츠를 추가합니다.
-
오른쪽 상단 모서리에서 추가 기호를 클릭합니다 푸시 알림 타일을 선택하여 열기 알림 마법사 만들기.
-
링크 경로에서 찾아보기 아이콘을 클릭하면 앱의 컨텐츠 구조가 사용자에게 표시됩니다.
경로를 선택하면 확인 아이콘을 클릭합니다.
note note NOTE 링크 단추 텍스트는 20자로 제한됩니다. 최종 사용자에게 최신 버전의 애플리케이션이 없고 연결된 경로를 사용할 수 없는 경우 딥 링크의 작업을 확인하면 사용자가 앱의 기본 페이지로 이동합니다. -
을(를) 입력합니다. 텍스트 세부 사항 에서 알림 마법사 만들기 을(를) 클릭합니다. 만들기.
에서 만든 푸시 알림을 클릭하여 세부 사항을 엽니다 푸시 알림 타일.
속성을 편집하거나, 알림을 보내거나, 알림을 삭제할 수 있습니다.
다음 단계 the-next-steps
앱의 푸시 알림에 대한 세부 사항을 이해하면 다음을 참조하십시오 AEM Mobile 컨텐츠 개인화.