Amazon Marketing Streamデータのクエリ

Amazon Marketing Streamでは、時間単位で集約されたデータをAWSアカウントに直接送信します。クリックまたはコンバージョンの無効化プロセスの結果としてデータが変更された場合は、差分として別途送信されます。

AWS管理者がソリューションをどのように設計したかに応じて、他のデータベースと同様にAmazon Marketing Streamにクエリを実行できます。

SQSキューを設定し、Amazon Marketing Streamデータセットに登録したら、このドキュメントのサンプルSQLクエリをデータ分析の開始点として使用できます。

サンプルクエリ

以下は、Amazon Marketing Streamデータのクエリに使用できるクエリの例です。

警告

次のクエリは、Amazon Marketing Streamデータがamazon-marketing-stream.sp-trafficという表に保存されていると仮定した構成に基づいています。実際の実装環境では異なるデータベース構造または命名規則が使用されている可能性があるため、これらのクエリを実行する前に必ずWHERE項目を更新してください。

ターゲットのトラフィックデータを取得する

このクエリは、特定の日付のすべてのターゲットのトラフィックデータを取得します。

SELECT *
FROM "amazon-marketing-stream"."sp-traffic"
WHERE DATE(from_iso8601_timestamp(time_window_start)) = date '2021-03-24'
AND match_type IN('TARGETING_EXPRESSION_PREDEFINED','TARGETING_EXPRESSION')

キーワードのトラフィックデータを取得する

このクエリは、指定された日付のすべてのキーワードのトラフィックデータを取得します。

SELECT *
FROM "amazon-marketing-stream"."sp-traffic"
WHERE DATE(from_iso8601_timestamp(time_window_start)) = date '2021-03-24'
AND match_type IN('BROAD','PHRASE','EXACT')

特定のキーワードと時間のトラフィックデータを取得する

このクエリは、特定の時間における特定のキーワードのトラフィックデータ（インプレッション数、クリック数、閲覧数）を返します。

SELECT *
FROM "amazon-marketing-stream"."sp-traffic"
WHERE keyword_id = '12345678'and time_window_start = '2022-02-01T10:00:00-08:00'
ORDER BY day, hour DESC;

よくある質問

ターゲットとキーワードのデータを取得するにはどうすればよいですか？

現在、target_idとkeyword_idの値は両方ともkeyword_idフィールドで渡されます。match_type列を使用して、ターゲットとキーワードを区別できます。

ターゲットの場合、match_typeはTARGETING_EXPRESSION（マニュアルターゲティングキャンペーンの場合）またはTARGETING_EXPRESSION_PREDEFINED（オートターゲティングキャンペーンの場合）に設定されます。

match_typeがTARGETING_EXPRESSIONの場合のkeyword_textの値の例
- category="3764301" （カテゴリーターゲティング）
- asin=“B086PQR1Y3”（ASINターゲティング）
match_typeがTARGETING_EXPRESSION_PREDEFINEDの場合のkeyword_textの値の例
- 大まか一致（オートキーワードターゲティング）
- ほぼ一致（オートキーワードターゲティング）
- 代替商品（オート商品ターゲティング）
- 補完商品（オート商品ターゲティング）

キーワードの場合、match_typeはBROAD、PHRASE、またはEXACTのいずれかに設定されます。keyword_textフィールドには、完全一致キーワードに関する情報が含まれます。

注

sp-conversionsデータセットでは、match_typeとkeyword_textは使用できません。sp-conversionでキーワードとターゲットを見分けるには、keyword_idを使用してsp-conversionデータセットとsp-trafficデータセットを結合する必要があります。

開発者ガイドの概要

Amazon Ads APIの概要