**サポート終了通知:** 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 Pinpoint 分析データをクエリする
Amazon Pinpoint コンソールの分析ページの使用に加えて、 Analytics API を使用して、ユーザーエンゲージメント、キャンペーンアウトリーチなどに関連する傾向についてのインサイトを提供する、標準メトリクスのサブセットの分析データをクエリします。*重要業績評価指標 (KPI)* とも呼ばれるこれらのメトリクスは、プロジェクト、キャンペーン、およびジャーニーのパフォーマンスを監視および評価する際に役立つ測定可能な値です。
API を使用して分析データのクエリを実行する場合、お客様が選択したレポート作成ツールを使用してデータを分析することができます。その場合、Amazon Pinpoint コンソールにサインインしたり、Amazon Kinesis Streams などのソースからの未加工のイベントデータを分析したりすることが不要になります。例えば、毎週のキャンペーン結果の表示またはキャンペーンの配信率に関する詳細分析を提供する、カスタムダッシュボードを作成することができます。
Amazon Pinpoint REST API、 AWS Command Line Interface (AWS CLI)、または AWS SDK を使用してデータをクエリできます。データのクエリは、Amazon Pinpoint API にリクエストを送信し、サポートされているパラメータを使用して、必要なデータと適用したいフィルターを指定します。クエリを送信すると、Amazon Pinpoint はクエリ結果を JSON レスポンスで返します。その後、結果を別のサービスまたはアプリケーションに渡して、より詳細な分析、保存、またはレポートを作成できます。
Amazon Pinpoint は、お客様のすべてのプロジェクト、キャンペーン、およびジャーニーにおいてサポートされているすべてのメトリクスのデータを、自動的に収集して集計します。さらに、データは継続的に更新されるため、データのレイテンシー期間は、約 2 時間に制限されています。ただし、特定のメトリクスに対して追加のデータレイテンシーが発生する場合があることに注意してください。これは、一部のメトリクスのデータが、受取人の E メールプロバイダーから受け取った情報に基づいているためです。プロバイダーによっては、この情報を直ちに当社に送信するものもあれば、あまり頻繁には送信しないものもあります。
Amazon Pinpoint は 90 日間データを保存します。90 日を超えたデータの保存や、未加工の分析データへのリアルタイムのアクセスは、イベントデータを Amazon Kinesis Data Streams または Amazon Data Firehose にストリーミングするように、Amazon Pinpoint プロジェクトを設定することで可能となります。イベントストリームの設定方法については、「[Amazon Pinpoint を使用して Kinesis と Firehose を介してアプリイベントデータをストリーミングする](event-streams.md)」を参照してください。
## Amazon Pinpoint のメトリクスのコンポーネントとパラメータをクエリする
メトリクスのデータのクエリを実行するには、Amazon Pinpoint API の適切なメトリクスリソースに `get` リクエストを送信します。リクエストでは、次のクエリコンポーネントでサポートされているパラメータを使用して、クエリを定義します。
+ **Project** – `application-id` パラメータの値としてプロジェクト ID を入力して、プロジェクトを指定します。このパラメータは、すべてのメトリクスに必須です。
+ **Campaign** – `campaign-id` パラメータの値としてキャンペーン ID を入力して、キャンペーンを指定します。このパラメータは、キャンペーンメトリクスにのみ必要です。
+ **Journey** – `journey-id` パラメータの値としてジャーニー ID を指定して、ジャーニーを指定します。このパラメータは、ジャーニーのエンゲージメントと実行メトリクス、およびジャーニーアクティビティ実行メトリクスにのみ必要です。
+ **Journey activity** – `journey-activity-id` パラメータの値としてジャーニーアクティビティ ID を指定して、ジャーニーアクティビティを指定します。このパラメータは、ジャーニーアクティビティ実行メトリクスにのみ必要です。
+ **Date range** – データを日付範囲でフィルタリングするには、サポートされている開始時刻と終了時刻パラメータを使用して、日付範囲の最初と最後の日時を指定します。値は拡張 ISO 8601 形式で、協定世界時（UTC）を使用する必要があります (例：`2019-07-19T20:00:00Z` は、2019年7月19日午後8時 (UTC) )。
日付範囲は包括的であり、31 日以内に制限する必要があります。また、最初の日付と時刻は、現在の日付から 90 日未満である必要があります。日付範囲を指定しない場合、Amazon Pinpoint は過去 31 暦日のデータを返します。日付範囲パラメータは、ジャーニー実行メトリクスおよびジャーニーアクティビティ実行メトリクスを除くすべてのメトリクスでサポートされます。
+ **Metric** – `kpi-name` パラメータの値としてメトリクス名を提供することで、メトリクスを指定します。この値は、関連するメトリクスを記述し、ハイフンで区切られた小文字の英数字で構成される 2 つ以上の用語で構成されます。例は、`email-open-rate` および `successful-delivery-rate` です。このパラメータは、ジャーニー実行メトリクスおよびジャーニーアクティビティ実行メトリクスを除くすべてのメトリクスに必要です。サポートされているすべてのメトリクスと各メトリクスに使用する `kpi-name` 値については、「[プロジェクト、キャンペーン、ジャーニーの標準メトリクス](analytics-standard-metrics.md)」を参照してください。
クエリを送信すると、Amazon Pinpoint はクエリ結果を JSON レスポンスで返します。レスポンスにおける結果の構造は、クエリしたメトリクスによって異なります。
一部のメトリクスでは、例えばキャンペーンによって配信されたメッセージ数など、1 つの値 — のみが提供されます。その他のメトリクスは、関連するフィールド — によってグループ化された複数の値を提供します。例えば、キャンペーンの実行ごとに配信されたメッセージ数で、キャンペーンの実行ごとグループ化されたものなどが含まれます。メトリクスが複数の値を提供し、グループ化する場合、JSON レスポンスにはデータのグループ化に使用されたフィールドを示すためのフィールドが含まれます。クエリ結果の構造の詳細については、「[JSON クエリ結果を使用する](analytics-query-results.md)」を参照してください。