翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。
Amazon Cognito ユーザープールは、Amazon Cognito ユーザープールの分析を提供し、Amazon Pinpoint キャンペーンのユーザーデータを強化するために 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 は、ユーザーの E メールアドレスと電話番号用に追加のエンドポイントを作成します。
Amazon Cognito コンソールを使用してユーザープールで Amazon Pinpoint 分析を有効にすると、ユーザープールの Amazon Pinpoint にAPIリクエストを行うときに Amazon Cognito が引き受けるサービスにリンクされたロールも作成されます。分析設定を追加するIAMプリンシパルにはアクセスCreateServiceLinkedRole許可が必要です。サービスにリンクされたロールは ですAWSServiceRoleForAmazonCognitoIdp
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 と統合する」を参照してください。
分析の設定を指定する
-
Amazon Cognito コンソール
に移動します。 AWS 認証情報を求められる場合があります。 -
[User Pools] (ユーザープール) を選択して、リストから既存のユーザープールを選択します。
-
[App integration] (アプリケーションの統合) タブを選択します。
-
[App clients and analytics] (アプリケーションクライアントと分析) で、リストから既存の [App client name] (アプリケーションクライアント名) を選択します。
-
[Pinpoint analytics] (Pinpoint 分析) で [Enable] (有効化) を選択します。
-
[Pinpoint Region] (Pinpoint リージョン) を選択します。
-
[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 でプロジェクトを作成する」を参照してください。
-
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 デベロッパーガイドの「エンドポイントの追加」を参照してください。
-
[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 Amazon Pinpoint に発行できます。
- ローカルユーザー
-
サードパーティー 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 Pinpoint ダッシュボードに Amazon Cognito ユーザープール分析が表示されないのはなぜですか?Amazon Pinpoint