翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。 # ユーザープール分析に Amazon Pinpoint を使用する **注記** **サポート終了通知:** 2026 年 10 月 30 日に、 AWS は Amazon Pinpoint のサポートを終了します。2026 年 10 月 30 日を過ぎると、Amazon Pinpoint コンソールまたは Amazon Pinpoint のリソース (エンドポイント、セグメント、キャンペーン、ジャーニー、分析) にアクセスできなくなります。詳細については、「[Amazon Pinpoint のサポート終了](https://docs.aws.amazon.com/console/pinpoint/migration-guide)」を参照してください。**注:** SMS、音声、モバイルプッシュ、OTP、電話番号の検証に関連する APIs は、この変更の影響を受けず、 AWS エンドユーザーメッセージングでサポートされています。 Amazon Cognito ユーザープールは、Amazon Cognito ユーザープールの分析を提供し、Amazon Pinpoint キャンペーンのユーザーデータを強化するために Amazon Pinpoint と統合されています。Amazon Pinpoint は、プッシュ通知を使用するモバイルアプリケーションでのユーザーエンゲージメントを促進するために、分析と的を絞ったキャンペーンを提供します。Amazon Cognito ユーザープールでの Amazon Pinpoint 分析のサポートを使用すると、Amazon Pinpoint コンソールでユーザープールへのサインアップ、サインイン、失敗した認証、デイリーアクティブユーザー数 (DAU)、および月間アクティブユーザー数 (MAU) を追跡できます。デバイスプラットフォーム、デバイスロケール、およびアプリケーションのバージョンなどのデータを異なる日付範囲や属性で表示できます。 また、アプリケーションにカスタム属性を設定することもできます。これらは、Amazon Pinpoint でユーザーを分割し、的を絞ったプッシュ通知をユーザーに送信するために使用できます。Amazon Cognito コンソールの **[アプリケーションクライアント]** メニューで、アプリケーションクライアントの **[分析]** 設定の **[Amazon Pinpoint とユーザー属性データを共有]** を選択すると、Amazon Pinpoint は、ユーザーの E メールアドレスと電話番号用に追加のエンドポイントを作成します。 Amazon Cognito コンソールを使用してユーザープールの Amazon Pinpoint 分析をアクティブ化すると、Amazon Cognito がユーザープールの Amazon Pinpoint に API リクエストを送信するときに引き継ぐ[サービスにリンクされたロール](https://docs.aws.amazon.com/IAM/latest/UserGuide/using-service-linked-roles.html#service-linked-role-permissions)も作成されます。分析設定を追加する IAM プリンシパルには、[CreateServiceLinkedRole](https://docs.aws.amazon.com/IAM/latest/APIReference/API_CreateServiceLinkedRole.html) 権限が必要です。サービスにリンクされたロールは、[AWSServiceRoleForAmazonCognitoIdp](https://console.aws.amazon.com/iamv2/home?region=us-east-1#/roles/details/AWSServiceRoleForAmazonCognitoIdp) です。詳細については、「[Amazon Cognito のサービスリンクロールの使用](using-service-linked-roles.md)」を参照してください。 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 エンドポイントとクォータ](https://docs.aws.amazon.com/general/latest/gr/pinpoint.html)」を参照してください。 ### Amazon Pinpoint 分析設定の指定 (AWS マネジメントコンソール) Amazon Cognito ユーザープールを設定して、分析データを Amazon Pinpoint に送信できます。Amazon Cognito は、ローカルユーザーの分析データのみを Amazon Pinpoint に送信します。ユーザープールを Amazon Pinpoint プロジェクトに関連付けるように設定したら、API リクエストに `AnalyticsMetadata` を含める必要があります。詳細については、「[アプリを Amazon Pinpoint と統合する](#cognito-user-pools-pinpoint-integration-client)」を参照してください。 **分析の設定を指定する** 1. [Amazon Cognito コンソール](https://console.aws.amazon.com/cognito/home)に移動します。 AWS 認証情報を求められる場合があります。 1. **[User Pools]** (ユーザープール) を選択して、リストから既存のユーザープールを選択します。 1. **[アプリケーションクライアント]** メニューを選択し、更新するアプリケーションクライアントを選択します。 1. **[ピンポイント分析]** の下で **[分析]** タブの **[有効化]** を選択します。 1. **[Pinpoint Region]** (Pinpoint リージョン) を選択します。 1. **[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 でプロジェクトを作成する](https://docs.aws.amazon.com/push-notifications/latest/userguide/mobile-push.html#mobile-push-create-project)」を参照してください。 1. 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 デベロッパーガイド*の「[エンドポイントの追加](https://docs.aws.amazon.com/pinpoint/latest/developerguide/endpoints.html)」を参照してください。 1. **[Save changes]** (変更の保存) をクリックします。 ### Amazon Pinpoint 分析設定の指定 (AWS CLI および AWS API) 以下のコマンドを使用して、ユーザープールの Amazon Pinpoint 分析設定を指定します。 **アプリケーション作成時にユーザープールの既存のクライアントアプリケーションの分析設定を指定する** + AWS CLI: `aws cognito-idp create-user-pool-client` + AWS API: [https://docs.aws.amazon.com/cognito-user-identity-pools/latest/APIReference/API_CreateUserPoolClient.html](https://docs.aws.amazon.com/cognito-user-identity-pools/latest/APIReference/API_CreateUserPoolClient.html) **ユーザープールの既存のクライアントアプリケーションの分析設定を更新する** + AWS CLI: `aws cognito-idp update-user-pool-client` + AWS API: [https://docs.aws.amazon.com/cognito-user-identity-pools/latest/APIReference/API_UpdateUserPoolClient.html](https://docs.aws.amazon.com/cognito-user-identity-pools/latest/APIReference/API_UpdateUserPoolClient.html) **注記** Amazon Cognito は、`ApplicationArn` の使用時にリージョン内の統合をサポートします。 ## アプリを Amazon Pinpoint と統合する *ユーザープール API* の Amazon Cognito *ローカルユーザー*の分析メタデータを Amazon Pinpoint に公開できます。 **ローカルユーザー** サードパーティー ID プロバイダー (IdP) を通じてサインインするのではなく、アカウントにサインアップしたユーザー、またはユーザープールで作成されたユーザー。 **ユーザープール API** カスタムユーザーインターフェイス (UI) でアプリケーションを使用して AWS SDK と統合できるオペレーション。マネージドログインでサインインしたフェデレーションユーザーまたはローカルユーザーの分析メタデータを渡すことはできません。ユーザープール API オペレーションのリストについては、「[Amazon Cognito API リファレンス](https://docs.aws.amazon.com/cognito-user-identity-pools/latest/APIReference/Welcome.html)」を参照してください。 キャンペーンに公開するようにユーザープールを設定すると、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 ユーザープールの分析が表示されないのはなぜですか?](https://aws.amazon.com/premiumsupport/knowledge-center/pinpoint-cognito-user-pool-analytics/)」を参照してください。