サポート終了通知： 2026 年 10 月 30 日に、 AWS は Amazon Pinpoint のサポートを終了します。2026 年 10 月 30 日以降、Amazon Pinpoint コンソールまたは Amazon Pinpoint リソース (エンドポイント、セグメント、キャンペーン、ジャーニー、分析) にアクセスできなくなります。詳細については、Amazon Pinpoint のサポート終了」を参照してください。注： SMS、音声、モバイルプッシュ、OTP、電話番号の検証に関連する APIs は、この変更の影響を受けず、 AWS エンドユーザーメッセージングでサポートされています。
翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。
Amazon Pinpoint 分析キャンペーンデータをクエリする
Amazon Pinpoint コンソールの分析ページを使用することに加えて、Amazon Pinpoint 分析 API を使用して、キャンペーンの配信とエンゲージメントの傾向についてのインサイトを提供する標準メトリクスのサブセットについて分析データをクエリできます。
これらの各メトリクスは測定可能な値で、重要業績評価指標 (KPI) とも呼ばれ、1 つ以上のキャンペーンのパフォーマンスを監視および評価するのに役立ちます。例えば、メトリクスを使用して、キャンペーンメッセージが送信されたエンドポイントの数、または目的のエンドポイントに配信されたメッセージの数を確認できます。
Amazon Pinpoint は、すべてのキャンペーンでこのデータを自動的に収集し、集計します。これは、90 日間データを保存します。 AWS Mobile SDK を使用してモバイルアプリを Amazon Pinpoint と統合した場合、Amazon Pinpoint は、受信者によって開かれたプッシュ通知の割合など、追加のメトリクスを含めるようにこのサポートを拡張します。モバイルアプリケーションの統合については、「Amazon Pinpoint とアプリケーションを統合する」を参照してください
Amazon Pinpoint 分析 API を使用してデータをクエリする場合、クエリの範囲、データ、グループ化、フィルターを定義するさまざまなオプションを選択できます。これを行うには、適用する日付ベースのフィルターに加えて、クエリするプロジェクト、キャンペーン、メトリクスを指定するパラメータを使用します。
このトピックでは、これらのオプションを選択し、1 つ以上のキャンペーンのデータをクエリする方法の例を説明します。
前提条件
1 つ以上のキャンペーンの分析データをクエリする前に、クエリの定義に使用する、次の情報を収集すると役立ちます。
-
Project ID – 1 つまたは複数のキャンペーンに関連付けられたプロジェクトの一意な ID。Amazon Pinpoint API では、この値は
application-idプロパティに保存されます。Amazon Pinpoint コンソールでは、この値はプロジェクト ID ですべてのプロジェクトページで表示されます。 -
Campaign ID – キャンペーンの一意の識別子（1 つのキャンペーンのデータのみをクエリする場合）。Amazon Pinpoint API では、この値は
campaign-idプロパティに保存されます。この値は、コンソールには表示されません。 -
Date range – オプションで、データを問い合せる日付範囲の最初と最後の日付と時刻。日付範囲は包括的であり、31日以内に制限する必要があります。また、最初の日付と時刻は、現在の日付から 90 日未満である必要があります。日付範囲を指定しない場合、Amazon Pinpoint は過去 31 暦日のデータを自動的にクエリします。
-
Metric type – クエリするメトリクスのタイプ。アプリケーションメトリクスとキャンペーンメトリクス の 2 つのタイプがあります。アプリケーションメトリクスは、プロジェクトに関連付けられているすべてのキャンペーンのデータを提供し、アプリケーションとも呼ばれます。キャンペーンメトリクスは、1 つのキャンペーンのみのデータを提供します。
-
Metric – クエリするメトリクスの名前。具体的には、メトリクスの
kpi-name値。サポートされているメトリクスの完全なリストと各メトリクスのkpi-name値については、「プロジェクト、キャンペーン、ジャーニーの標準メトリクス」を参照してください。
また、関連するフィールドでデータをグループ化するかどうかを決定することもできます。する場合、データを自動的にグループ化するように設計されたメトリクスを選択することで、分析とレポート作成を簡素化できます。例えば、Amazon Pinpoint には、キャンペーンの受信者に配信されたメッセージの割合を報告する標準メトリクスがいくつか用意されています。これらのメトリクスの 1 つは、データを日付ごとに自動的にグループ化します (successful-delivery-rate-grouped-by-date)。別のメトリクスでは、データがキャンペーンの実行ごとに自動的にグループ化されます (successful-delivery-rate-grouped-by-campaign-activity)。3 番目のメトリクスは、すべてのキャンペーンの実行によって受信者に配信されたメッセージの割合 (%) を返します (successful-delivery-rate)。
必要な方法でデータをグループ化する標準メトリクスが見つからない場合は、必要なデータを返す一連のクエリを開発できます。その後、クエリ結果を手動で分類したり、デザインするカスタムグループに結合できます。
最後に、クエリするデータにアクセスする権限があることを確認することが重要です。詳細については、「Amazon Pinpoint 分析データのクエリ実行用の IAM ポリシー」を参照してください。
