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

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

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

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

Amazon Cognito API で AnalyticsConfiguration をアプリケーションクライアントに適用する際、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. アプリクライアントメニューを選択し、更新するアプリクライアントを選択します。

4. Pinpoint Analytics の Analytics タブで、Enable を選択します。

5. [Pinpoint Region] (Pinpoint リージョン) を選択します。

6. [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 でプロジェクトを作成する」を参照してください。

7. 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 デベロッパーガイドの「エンドポイントの追加」を参照してください。

8. [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 に公開できます。

ローカルユーザー

サードパーティー ID プロバイダー (IdP) を通じてサインインするのではなく、アカウントにサインアップしたユーザー、またはユーザープールで作成されたユーザー。

ユーザープール API

カスタムユーザーインターフェイス (UI) でアプリを使用して AWS SDK と統合できるオペレーション。マネージドログインでサインインするフェデレーティッドユーザーまたはローカルユーザーの分析メタデータを渡すことはできません。ユーザープール 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 Pinpoint ダッシュボードに Amazon Cognito ユーザープールの分析が表示されないのはなぜですか?」を参照してください。