사용자 풀 분석에 Amazon Pinpoint 사용

Amazon Cognito 사용자 풀은 Amazon Pinpoint와 통합되어 Amazon Cognito 사용자 풀에 대한 분석을 제공하고 Amazon Pinpoint 캠페인을 위한 사용자 데이터를 보강합니다. Amazon Pinpoint는 분석 및 표적화된 캠페인을 제공하여 푸시 알림을 사용하는 모바일 앱에서 사용자 참여를 유도합니다. Amazon Cognito 사용자 풀에서 Amazon Pinpoint 분석 지원을 사용하면 Amazon Pinpoint 콘솔에서 사용자 풀 가입, 로그인, 인증 실패, 일일 활성 사용자(DAUs) 및 월간 활성 사용자(MAUs)를 추적할 수 있습니다. 디바이스 플랫폼, 디바이스 로캘 및 앱 버전과 같은 다양한 날짜 범위 또는 속성에 대한 데이터를 자세히 확인할 수 있습니다.

앱의 사용자 지정 속성을 설정할 수도 있습니다. 그런 다음 Amazon Pinpoint에서 사용자를 세분화하고 대상 푸시 알림에 전송하는데 이를 사용할 수 있습니다. Amazon Cognito 콘솔의 Analytics(분석) 탭에서 Share user attribute data with Amazon Pinpoint(Amazon Pinpoint와 사용자 속성 데이터 공유)를 선택하면, Amazon Pinpoint는 사용자 이메일 주소와 전화 번호에 대한 추가 엔드포인트를 생성합니다.

Amazon Cognito 콘솔을 사용하여 사용자 풀에서 Amazon Pinpoint 분석을 활성화하면 사용자 풀에 대해 Amazon Pinpoint에 API 요청할 때 Amazon Cognito가 수임하는 서비스 연결 역할도 생성됩니다. 분석 구성을 추가하는 IAM 보안 주체에는 CreateServiceLinkedRole 권한이 있어야 합니다. 서비스 연결 역할은 입니다AWSServiceRoleForAmazonCognitoIdp. 자세한 내용은 Amazon Cognito에 서비스 연결 역할 사용 단원을 참조하십시오.

Amazon Cognito 의 AnalyticsConfiguration 앱 클라이언트에 를 적용할 때 Amazon Pinpoint에 대한 사용자 지정 IAM 역할과 외부 ID를 할당하여 역할을 수임할 API수 있습니다. 역할은 cognito-idp 서비스 보안 주체를 신뢰해야 하며, 역할 신뢰 정책에 외부 ID가 필요한 경우, 해당 ID가 AnalyticsConfiguration과 일치해야 합니다. Amazon Pinpoint 프로젝트를 위한 역할 cognito-idp:Describe* 권한 및 다음 권한을 부여해야 합니다.

• mobiletargeting:UpdateEndpoint

• mobiletargeting:PutEvents

Amazon Cognito 및 Amazon Pinpoint 리전 가용성

다음 표에는 다음 조건 중 하나를 충족하는 Amazon Cognito와 Amazon Pinpoint 간의 AWS 리전 매핑이 나와 있습니다.

• Amazon Pinpoint 프로젝트는 미국 동부(버지니아 북부)(us-east-1) 리전에서만 사용할 수 있습니다.

• Amazon Pinpoint 프로젝트는 동일한 리전이나 미국 동부(버지니아 북부)(us-east-1) 리전에서만 사용할 수 있습니다.

기본적으로 Amazon Cognito는 동일한 AWS 리전에 있는 Amazon Pinpoint 프로젝트에만 분석을 전송할 수 있습니다. 다음 표에 나오는 지역과 Amazon Pinpoint를 사용할 수 없는 지역에는 이 규칙이 적용되지 않습니다.

다음 리전에서 Amazon Pinpoint를 사용할 수 없습니다. 이러한 리전에 있는 Amazon Cognito 사용자 풀은 분석을 지원하지 않습니다.

• 유럽(밀라노)

• 중동(바레인)

• 아시아 태평양(오사카)

• 이스라엘(텔아비브)

• 아프리카(케이프타운)

• 아시아 태평양(자카르타)

이 표에서는 Amazon Cognito 사용자 풀을 구축한 리전과 Amazon Pinpoint에 있는 대응하는 리전 간의 관계를 확인할 수 있습니다. Amazon Pinpoint 프로젝트를 Amazon Cognito와 통합하려면 사용 가능한 리전에서 Amazon Pinpoint 프로젝트를 구성해야 합니다.

Amazon Cognito 사용자 풀 리전	Amazon Pinpoint 프로젝트용 리전
ap-northeast-1	us-east-1
ap-northeast-2	us-east-1
ap-south-1	us-east-1, ap-south-1
ap-southeast-1	us-east-1
ap-southeast-2	us-east-1, ap-southeast-2
ca-central-1	us-east-1
eu-central-1	us-east-1, eu-central-1
eu-west-1	us-east-1, eu-west-1
eu-west-2	us-east-1
us-east-1	us-east-1
us-east-2	us-east-1
us-west-2	us-east-1, us-west-2

리전 매핑 예

• ap-northeast-1에 사용자 풀을 생성하는 경우 us-east-1에 Amazon Pinpoint 프로젝트를 생성할 수 있습니다.

• ap-south-1에 사용자 풀을 생성하는 경우 us-east-1 또는 ap-south-1에 Amazon Pinpoint 프로젝트를 생성할 수 있습니다.

참고

이전 테이블의 프로젝트를 AWS 리전 제외한 모든 에 대해 Amazon Cognito는 사용자 풀과 동일한 리전의 Amazon Pinpoint 프로젝트만 사용할 수 있습니다. 사용자 풀을 구축한 리전에서 Amazon Pinpoint를 사용할 수 없다면, Amazon Cognito는 해당 리전에서 Amazon Pinpoint 분석을 지원하지 않습니다. 자세한 AWS 리전 정보는 Amazon Pinpoint 엔드포인트 및 할당량을 참조하세요.

Amazon Pinpoint 분석 설정 지정(AWS Management Console)

분석 데이터를 Amazon Pinpoint로 보내도록 Amazon Cognito 사용자 풀을 구성할 수 있습니다. Amazon Cognito는 로컬 사용자에 대한 분석 데이터만 Amazon Pinpoint로 전송합니다. Amazon Pinpoint 프로젝트와 연결하도록 사용자 풀을 구성한 후에는 API 요청에 AnalyticsMetadata 를 포함해야 합니다. 자세한 내용은 앱을 Amazon Pinpoint와 통합 단원을 참조하십시오.

분석 설정을 지정하려면

1. Amazon Cognito 콘솔로 이동합니다. AWS 자격 증명을 입력하라는 메시지가 나타날 수 있습니다.

2. User Pools(사용자 풀)을 선택하고 목록에서 기존 사용자 풀을 선택합니다.

3. [앱 통합(App integration)] 탭을 선택합니다.

4. App clients and analytics(앱 클라이언트 및 분석)의 목록에서 기존 App client name(앱 클라이언트 이름)을 선택합니다.

5. Pinpoint analytics(Pinpoint 분석)에서 Enable(활성화)을 선택합니다.

6. Pinpoint Region(Pinpoint 리전)을 선택합니다.

7. Amazon Pinpoint project(Amazon Pinpoint 프로젝트)를 선택하거나 Create Amazon Pinpoint project(Amazon Pinpoint 프로젝트 생성)를 선택합니다.

   참고

   Amazon Pinpoint 프로젝트 ID는 Amazon Pinpoint 프로젝트에 대해 고유한 32자 문자열입니다. 이 ID는 Amazon Pinpoint 콘솔에 나열됩니다.

   Amazon Pinpoint 프로젝트에 여러 Amazon Cognito 앱을 매핑할 수 있습니다. 그러나 각 Amazon Cognito 앱은 하나의 Amazon Pinpoint 프로젝트에만 매핑될 수 있습니다.

   Amazon Pinpoint에서 각 프로젝트는 단일 앱이어야 합니다. 예를 들어, 게임 개발자에게 두 개의 게임이 있고 두 게임 모두 동일한 Amazon Cognito 사용자 풀을 사용한다 하더라도 각 게임은 개별 Amazon Pinpoint 프로젝트입니다. Amazon Pinpoint 프로젝트에 대한 자세한 내용은 Amazon Pinpoint에서 프로젝트 생성을 참조하세요.

8. Amazon Cognito에서 이메일 주소와 전화 번호를 Amazon Pinpoint로 보내 사용자를 위한 추가 엔드포인트를 생성하게 하고 싶다면, User data sharing(사용자 데이터 공유)에서 Share user data with Amazon Pinpoint(Amazon Pinpoint와 사용자 데이터 공유)를 선택합니다. 사용자가 자신의 이메일 주소와 전화 번호를 확인하면, Amazon Cognito는 사용자 계정에 사용할 수 있는 경우에만 이를 Amazon Pinpoint와 공유합니다.

   참고

   엔드포인트는 Amazon Pinpoint를 사용하여 푸시 알림이 전송될 수 있는 사용자 디바이스를 고유하게 식별합니다. 엔드포인트에 대한 자세한 내용은 Amazon Pinpoint 개발자 가이드에서 엔드포인트 추가를 참조하세요.

9. Save changes(변경 사항 저장)를 선택합니다.

Amazon Pinpoint 분석 설정 지정(AWS CLI 및 AWS API)

다음 명령을 사용하여 사용자 풀에 대한 Amazon Pinpoint 분석 설정을 지정합니다.

앱 생성 시간에 사용자 풀의 기존 클라이언트 앱에 대한 분석 설정을 지정하는 방법

• AWS CLI: aws cognito-idp create-user-pool-client

• AWS API: CreateUserPoolClient

사용자 풀의 기존 클라이언트 앱에 대한 분석 설정을 업데이트하는 방법

• AWS CLI: aws cognito-idp update-user-pool-client

• AWS API: UpdateUserPoolClient

참고

Amazon Cognito는 ApplicationArn을 사용하는 경우 리전 내 통합을 지원합니다.

앱을 Amazon Pinpoint와 통합

분석 메타데이터를 사용자 풀 의 Amazon Cognito 로컬 사용자용 Amazon Pinpoint에 게시할 수 있습니다. Amazon Cognito API

로컬 사용자

계정에 가입했거나 서드 파티 ID 제공업체(idP)를 통해 로그인하는 대신 사용자 풀에서 생성된 사용자입니다.

사용자 풀 API

사용자 지정 사용자 인터페이스(UI)가 있는 앱을 AWS SDK사용하여 와 통합할 수 있는 작업입니다. 호스팅 UI를 통해 로그인하는 페더레이션 또는 로컬 사용자에 대한 분석 메타데이터를 전달할 수 없습니다. 사용자 풀 API 작업 목록은 Amazon Cognito API 참조를 참조하세요.

캠페인에 게시하도록 사용자 풀을 구성한 후 Amazon Cognito는 다음 API 작업을 위해 메타데이터를 Amazon Pinpoint에 전달합니다.

• AdminInitiateAuth

• AdminRespondToAuthChallenge

• ConfirmForgotPassword

• ConfirmSignUp

• ForgotPassword

• InitiateAuth

• ResendConfirmationCode

• RespondToAuthChallenge

• SignUp

사용자 세션에 대한 메타데이터를 Amazon Pinpoint 캠페인에 전달하려면 API 요청의 AnalyticsMetadata 파라미터에 AnalyticsEndpointId 값을 포함하세요. 예를 JavaScript 들어 AWS 지식 센터 의 Amazon Amazon Pinpoint Pinpoint 대시보드에 Amazon Cognito 사용자 풀 분석이 표시되지 않는 이유는 무엇입니까?를 참조하세요.