Amazon Cognito ユーザープールでの Amazon Pinpoint 分析の使用
Amazon Cognito User Pools は、Amazon Cognito ユーザープールの分析を提供し、Amazon Pinpoint キャンペーンのユーザーデータを強化するために Amazon Pinpoint と統合されています。Amazon Pinpoint は、プッシュ通知を使用するモバイルアプリケーションでのユーザーエンゲージメントを促進するために、分析と的を絞ったキャンペーンを提供します。Amazon Cognito ユーザープールでの Amazon Pinpoint 分析のサポートを使用すると、Amazon Pinpoint コンソールでユーザープールへのサインアップ、サインイン、失敗した認証、デイリーアクティブユーザー数 (DAU)、および月間アクティブユーザー数 (MAU) を追跡できます。デバイスプラットフォーム、デバイスロケール、およびアプリケーションのバージョンなどのデータを異なる日付範囲や属性で表示できます。
AWS Mobile SDK for Android または AWS Mobile SDK for iOS を使用して、アプリケーションに固有のユーザー属性を設定することもできます。これらは、Amazon Pinpoint でユーザーを分割し、的を絞ったプッシュ通知をユーザーに送信するために使用できます。Amazon Cognito コンソールの [Analytics] (分析) タブで、[Share user attribute data with Amazon Pinpoint] (Amazon Pinpoint とユーザー属性データを共有する) を選択すると、ユーザーの E メールアドレスと電話番号用に追加のエンドポイントが作成されます。
Amazon Cognito と Amazon Pinpoint のリージョンマッピングを確認する
以下の表は、Amazon Cognito と Amazon Pinpoint 間のリージョンマッピングを示しています。この表を使用して、Amazon Cognito ユーザープールを作成したリージョンと、対応する Amazon Pinpoint リージョンを確認してください。次に、これらのリージョンを使用して、Amazon Cognito と Amazon Pinpoint プロジェクトを統合します。
Amazon Pinpoint をサポートする Amazon Cognito リージョン | Amazon Pinpoint プロジェクトリージョン |
---|---|
ap-northeast-1 ap-northeast-2 ap-south-1 ap-southeast-1 ap-southeast-2 ca-central-1 eu-central-1 eu-west-1 eu-west-2 us-east-1 us-east-2 us-west-2 |
us-east-1 us-east-1 us-east-1、ap-south-1 us-east-1 us-east-1、ap-southeast-2 us-east-1 us-east-1、eu-central-1 us-east-1、eu-west-1 us-east-1 us-east-1 us-east-1 us-east-1、us-west-2 |
リージョンマッピングの例
-
ap-northest-1 でユーザープールを作成する場合、Amazon Pinpoint プロジェクトは us-east-1 で作成する必要があります。
-
ap-south-1 でユーザープールを作成する場合、Amazon Pinpoint プロジェクトは us-east-1 または ap-south-1 のいずれかで作成する必要があります。
Amazon Pinpoint は、北米、ヨーロッパ、アジア、およびオセアニアにある複数の AWS リージョンで利用できます。この表に記載されている例外を除き、Amazon Cognito はリージョン内での Amazon Pinpoint 統合のみをサポートします。Amazon Pinpoint が Amazon Cognito と同じリージョンで利用できる場合、Amazon Cognito は同じリージョン内の Amazon Pinpoint プロジェクトにイベントを送信します。Amazon Pinpoint が Amazon Cognito のリージョンで使用できない場合、Amazon Cognito は そのリージョンで Amazon Pinpoint が利用可能になるまで Amazon Pinpoint 統合をサポートしません。Amazon Pinpoint の詳細なリージョン情報については、「Amazon Pinpoint エンドポイントとクォータ」を参照してください。
Amazon Pinpoint 分析設定の指定 (AWS Management Console)
現在、Amazon Pinpoint 分析の設定を変更する場合は、元の Amazon Cognito コンソールに移動します。分析の設定は、新しいコンソールの [App clients] タブの [App clients and analytics] の下のアプリクライアントの設定内にあります。
分析の設定を指定する
-
Amazon Cognito コンソール
にサインインします。 -
ナビゲーションペインで [ユーザープールの管理] を選択して、編集するユーザープールを選択します。
-
[Analytics (分析)] タブを選択します。
-
[分析とキャンペーンの追加] を選択します。
-
リストから [Cognito アプリクライアント] を選択します。
-
Amazon Cognito アプリを [Amazon Pinpoint project] (Amazon Pinpoint プロジェクト) にマッピングするには、リストから 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 が Amazon Pinpoint に E メールアドレスと電話番号を送信するようにするには、[Share user attribute data with Amazon Pinpoint] (Amazon Pinpoint とユーザー属性データを共有する) を選択します。アカウントの電話番号と E メールアドレスが検証されると、ユーザーアカウントでそれらを使用できる場合に Amazon Pinpoint のみと共有されます。
注記 エンドポイントは、Amazon Pinpoint でプッシュ通知を送信することができるユーザーデバイスを一意に識別します。エンドポイントの詳細については、Amazon Pinpoint デベロッパーガイドの「エンドポイントの追加」を参照してください。
-
[Save changes] (変更の保存) をクリックします。
-
追加のアプリマッピングを指定するには、[別のアプリマッピングの追加] を選択します。
-
[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 と統合できるオペレーション。ホストされた 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 ユーザープールの分析が表示されないのはなぜですか?
.