トランザクションメッセージの Amazon Pinpoint 分析データをクエリする

Amazon Pinpoint コンソールの分析ページを使用することに加えて、Amazon Pinpoint Analytics API を使用して、プロジェクトに送信されたトランザクションメッセージの配信とエンゲージメントの傾向についてのインサイトを提供する標準メトリクスのサブセットについて分析データをクエリできます。

メトリクスは測定可能な値で、重要業績評価指標 (KPI) とも呼ばれ、トランザクションメッセージのパフォーマンスを監視および評価するのに役立ちます。例えば、メトリクスを使用して、送信した E メールのトランザクション数、送信した SMS メッセージ数、または受取人に配信されたメッセージ数を調べることができます。Amazon Pinpoint は、プロジェクトに送信するすべての E メールのトランザクションおよび SMS メッセージについて、このデータを自動的に収集し、集計します。これは、90 日間データを保存します。

Amazon Pinpoint 分析 API を使用してデータをクエリする場合、クエリの範囲、データ、グループ化、フィルターを定義するさまざまなオプションを選択できます。これを行うには、適用する日付ベースのフィルターに加えて、クエリするプロジェクトとメトリクスを指定するパラメータを使用します。

このトピックでは、これらのオプションを選択し、プロジェクトに関するトランザクションメッセージングデータをクエリする方法の例を説明します。

前提条件

トランザクションメッセージの分析データをクエリする前に、クエリの定義に使用する、次の情報を収集すると役立ちます。

• Project ID – メッセージの送信元のプロジェクトの一意の識別子。Amazon Pinpoint API では、この値は application-id プロパティに保存されます。Amazon Pinpoint コンソールでは、この値は すべてのプロジェクト ページでProject ID として表示されます。

• Date range – オプションで、データを問い合せる日付範囲の最初と最後の日付と時刻。日付範囲は包括的であり、31日以内に制限する必要があります。また、最初の日付と時刻は、現在の日付から 90 日未満である必要があります。日付範囲を指定しない場合、Amazon Pinpoint は過去 31 暦日のデータを自動的にクエリします。

• Metric – クエリするメトリクスの名前。具体的には、メトリクスの kpi-name 値。サポートされているメトリクスの完全なリストと各メトリクスの kpi-name 値については、「プロジェクト、キャンペーン、ジャーニーの標準メトリクス」を参照してください。

また、関連するフィールドでデータをグループ化するかどうかを決定することもできます。する場合、データを自動的にグループ化するように設計されたメトリクスを選択することで、分析とレポート作成を簡素化できます。例えば、Amazon Pinpoint には、受信者に配信されたトランザクション SMS メッセージの数を報告する標準メトリクスがいくつか用意されています。これらのメトリクスの 1 つは、データを日付ごとに自動的にグループ化します (txn-sms-delivered-grouped-by-date)。別のメトリクスでは、データが国またはリージョンによって自動的にグループ化されます (txn-sms-delivered-grouped-by-country)。3 番目のメトリクスは、単純に一つの値、つまり受信者に配信されたメッセージングの数を返します (txn-sms-delivered)。必要な方法でデータをグループ化する標準メトリクスが見つからない場合は、必要なデータを返す一連のクエリを開発できます。その後、クエリ結果を手動で分類したり、デザインするカスタムグループに結合できます。

最後に、クエリするデータにアクセスする権限があることを確認することが重要です。詳細については、「Amazon Pinpoint 分析データのクエリ実行用の IAM ポリシー」を参照してください。