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 を介してアプリイベントデータをストリーミングする」を参照してください。

Amazon Pinpoint のメトリクスのコンポーネントとパラメータをクエリする

メトリクスのデータのクエリを実行するには、Amazon Pinpoint API の適切なメトリクスリソースに get リクエストを送信します。リクエストでは、次のクエリコンポーネントでサポートされているパラメータを使用して、クエリを定義します。

クエリを送信すると、Amazon Pinpoint はクエリ結果を JSON レスポンスで返します。レスポンスにおける結果の構造は、クエリしたメトリクスによって異なります。

一部のメトリクスでは、例えばキャンペーンによって配信されたメッセージ数など、1 つの値 — のみが提供されます。その他のメトリクスは、関連するフィールド — によってグループ化された複数の値を提供します。例えば、キャンペーンの実行ごとに配信されたメッセージ数で、キャンペーンの実行ごとグループ化されたものなどが含まれます。メトリクスが複数の値を提供し、グループ化する場合、JSON レスポンスにはデータのグループ化に使用されたフィールドを示すためのフィールドが含まれます。クエリ結果の構造の詳細については、「JSON クエリ結果を使用する」を参照してください。