ユーザープール分析に Amazon Pinpoint を使用する

Amazon Cognito ユーザープールは、Amazon Cognito ユーザープールの分析を提供し、Amazon Pinpoint キャンペーンのユーザーデータを強化するために Amazon Pinpoint と統合されています。Amazon Pinpoint は、プッシュ通知を使用するモバイルアプリケーションでのユーザーエンゲージメントを促進するために、分析と的を絞ったキャンペーンを提供します。Amazon Cognito ユーザープールでの Amazon Pinpoint 分析のサポートにより、Amazon Pinpoint コンソールでユーザープールのサインアップ、サインイン、認証の失敗、毎日のアクティブユーザー (DAUs）、および毎月のアクティブユーザー (MAUs) を追跡できます。 Amazon Pinpoint デバイスプラットフォーム、デバイスロケール、およびアプリケーションのバージョンなどのデータを異なる日付範囲や属性で表示できます。

また、アプリケーションにカスタム属性を設定することもできます。これらは、Amazon Pinpoint でユーザーを分割し、的を絞ったプッシュ通知をユーザーに送信するために使用できます。Amazon Cognito コンソールの [Analytics] (分析) タブで、[Share user attribute data with Amazon Pinpoint] (Amazon Pinpoint とユーザー属性データを共有する) を選択すると、Amazon Pinpoint は、ユーザーの E メールアドレスと電話番号用に追加のエンドポイントを作成します。

Amazon Cognito コンソールを使用してユーザープールで Amazon Pinpoint 分析をアクティブ化すると、Amazon Cognito がユーザープールの Amazon Pinpoint にリクエストを行うときに Amazon Cognito が引き受けるサービスにリンクされたロールも作成されます。 API Amazon Pinpoint 分析設定を追加するIAMプリンシパルには、 アクセスCreateServiceLinkedRole許可が必要です。サービスにリンクされたロールは ですAWSServiceRoleForAmazonCognitoIdp。詳細については、「Amazon Cognito のサービスリンクロールの使用」を参照してください。

Amazon Cognito でアプリクライアントAnalyticsConfigurationに を適用するとAPI、Amazon Pinpoint のカスタムIAMロールと、ロールを引き受ける外部 ID を割り当てることができます。ロールは cognito-idp サービスプリンシパルを信頼している必要があり、ロール信頼ポリシーで外部 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 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 でユーザープールを作成する場合、Amazon Pinpoint プロジェクトは us-east-1 で作成する必要があります。

• ap-south-1 でユーザープールを作成する場合、Amazon Pinpoint プロジェクトは us-east-1 または ap-south-1 のいずれかで作成できます。

注記

上記の表 AWS リージョン を除くすべての について、Amazon Cognito はユーザープールと同じリージョンの Amazon Pinpoint プロジェクトのみを使用できます。ユーザープールを構築したリージョンで Amazon Pinpoint が利用できず、表にも記載されていない場合、Amazon Cognito はそのリージョンで Amazon Pinpoint 分析をサポートしません。詳細な AWS リージョン 情報については、「Amazon Pinpoint エンドポイントとクォータ」を参照してください。

Amazon Pinpoint 分析設定の指定 (AWS Management Console)

Amazon Cognito ユーザープールを設定して、分析データを Amazon Pinpoint に送信できます。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 文字の文字列です。これは Amazon Pinpoint コンソールにリストされています。

   複数の Amazon Cognito アプリケーションを単一の Amazon Pinpoint プロジェクトにマッピングできますが、各 Amazon Cognito アプリは 1 つの Amazon Pinpoint プロジェクトにしかマップできません。

   Amazon Pinpoint では、各プロジェクトを単一のアプリにする必要があります。例えば、ゲームデベロッパーが 2 つのゲームを持っている場合、両方のゲームが同じ Amazon Cognito ユーザープールを使用しているとしても、各ゲームを個別の Amazon Pinpoint プロジェクトにする必要があります。Amazon Pinpoint プロジェクトの詳細については、「Amazon Pinpoint でプロジェクトを作成する」を参照してください。

8. Amazon Cognito が E メールアドレスと電話番号を Amazon Pinpoint に送信し、ユーザー用の追加のエンドポイントを作成する場合は、[User data sharing] (ユーザーデータの共有) で [Share user data with Amazon Pinpoint] (Amazon Pinpoint でユーザーデータを共有する) を選択します。ユーザーが E メールアドレスと電話番号を確認した後、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 と統合する

ユーザープール API内の Amazon Cognito ローカルユーザーの分析メタデータを Amazon Pinpoint に発行できます。 Amazon Cognito

ローカルユーザー

サードパーティー 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 Cognito ユーザープール分析が Amazon Pinpoint ダッシュボードに表示されないのはなぜですか？」を参照してください。