開発者ガイドの概要

Amazon Ads APIの概要

Amazon Marketing Streamデータガイド

Amazon Marketing Streamは、広告主が登録して取得できるデータセットをサポートしています。現在、Amazon Marketing Streamでは3つのデータセットがサポートされていますが、今後さらに増える予定です。データセットごとに異なるパフォーマンス指標とキャンペーンメタデータがサポートされます。

登録する各データセットについては、SQSで登録を確認するを参照してください。

この資料では、利用可能なデータセットと各データセットでサポートされる指標の詳細について説明します。

利用可能なデータセット

スポンサープロダクト広告トラフィック(sp-traffic)

sp-trafficデータセットには、スポンサープロダクト広告キャンペーンに関連するクリック、インプレッション、コストのデータが含まれています。

スキーマ

このデータセットは、以下のフィールドと指標をサポートしています。

フィールド名 タイプ 説明
idempotency_id String レコードの重複排除に使用できるID。
dataset_id String データセット(この場合はsp-traffic)を識別するために使用されるID。
marketplace_id String アカウントに関連付けられているマーケットプレイスID
currency String このプロフィールのエンティティのすべての金額に使用される通貨。
advertiser_id String 広告主に関連付けられたID。このIDは、GET v2/profilesエンドポイントを使用して取得できます。この値は固有ではありません。通常はマーケットプレイスをまたいで同じ値です。注: 出品者以外のアカウントでは、このadvertiser_idにはエンティティIDが設定されます。
campaign_id String キャンペーンを表す固有の数値ID。
ad_group_id String 広告グループを表す固有の数値ID。
ad_id String 広告を表す固有の数値ID。
keyword_id String 入札に使用されたキーワードのID。
keyword_text String 入札に使用されたキーワードまたはフレーズのテキスト。
match_type String 入札に使用されたキーワードまたはフレーズのマッチタイプ。
placement String ページに広告が表示された位置。
time_window_start String パフォーマンスデータが属する期間の開始時間(ISO 8601の日時形式)。
clicks Long 広告の合計クリック数。
impressions Long 広告の合計インプレッション数。
cost Double 全クリック数の合計コスト。現地通貨で表されます。

リソースベースのIAMポリシー

このデータセットを登録して取得するには、マーケットプレイスに基づいて、適切なIAMポリシーをSQSキューに追加してください。

NA

{
  "Version": "2008-10-17",
  "Id": "{REPLACE_WITH_ANY_VALUE}",
  "Statement": [
    {
      "Sid": "{REPLACE_WITH_ANY_VALUE}",
      "Effect": "Allow",
      "Principal": {
        "Service": "sns.amazonaws.com"
      },
      "Action": "SQS:SendMessage",
      "Resource": "{REPLACE WITH ARN Of SQS DESTINATION QUEUE}",
      "Condition": {
        "ArnEquals": {
          "aws:SourceArn": "arn:aws:sns:us-east-1:906013806264:*"
        }
      }
    },
    {
      "Sid": "{REPLACE_WITH_ANY_VALUE}",
      "Effect": "Allow",
      "Principal": {
        "AWS": "arn:aws:iam::926844853897:role/ReviewerRole"
      },
      "Action": "SQS:GetQueueAttributes",
      "Resource": "*"
    }
  ]
}

EU

{
  "Version": "2008-10-17",
  "Id": "{REPLACE_WITH_ANY_VALUE}",
  "Statement": [
    {
      "Sid": "{REPLACE_WITH_ANY_VALUE}",
      "Effect": "Allow",
      "Principal": {
        "Service": "sns.amazonaws.com"
      },
      "Action": "SQS:SendMessage",
      "Resource": "{REPLACE WITH ARN Of SQS DESTINATION QUEUE}",
      "Condition": {
        "ArnEquals": {
          "aws:SourceArn": "arn:aws:sns:eu-west-1:668473351658:*"
        }
      }
    },
    {
      "Sid": "{REPLACE_WITH_ANY_VALUE}",
      "Effect": "Allow",
      "Principal": {
        "AWS": "arn:aws:iam::926844853897:role/ReviewerRole"
      },
      "Action": "SQS:GetQueueAttributes",
      "Resource": "*"
    }
  ]
}

FE

{
  "Version": "2008-10-17",
  "Id": "{REPLACE_WITH_ANY_VALUE}",
  "Statement": [
    {
      "Sid": "{REPLACE_WITH_ANY_VALUE}",
      "Effect": "Allow",
      "Principal": {
        "Service": "sns.amazonaws.com"
      },
      "Action": "SQS:SendMessage",
      "Resource": "{REPLACE WITH ARN Of SQS DESTINATION QUEUE}",
      "Condition": {
        "ArnEquals": {
          "aws:SourceArn": "arn:aws:sns:us-west-2:074266271188:*"
        }
      }
    },
    {
      "Sid": "{REPLACE_WITH_ANY_VALUE}",
      "Effect": "Allow",
      "Principal": {
        "AWS": "arn:aws:iam::926844853897:role/ReviewerRole"
      },
      "Action": "SQS:GetQueueAttributes",
      "Resource": "*"
    }
  ]
}

データの鮮度

広告がクリックされてから12時間以内に最初のクリックデータが表示されます。トラフィック検証プロセスの一環として、この最初の報告から次の72時間の間、クリックを無効化することができます。Amazon Marketing Streamは、自動的にキューを調整します。データは1時間おきにキューに一括送信されます。必ずしも正時ではありませんが、1時間に1回送信されます

スポンサープロダクト広告のコンバージョン(sp-conversion)

sp-conversionデータセットには、スポンサープロダクト広告キャンペーンに起因するコンバージョンのデータが含まれています。

警告

Amazon Marketing Streamには既知のバグがあり、他の広告プログラムのレコードが、対応するレコードがsp-trafficデータにないにもかかわらず、ほんの数件ですがsp-conversionデータに表示されることがあります。このような不要なデータがコンバージョンレコード全体に占める割合はごくわずかであるため、分析が重大な影響を受けることはありません。この問題が解決されるまで、そのようなレコードがデータセットに含まれていても無視してください。

スキーマ

フィールド名 フィールドタイプ 説明
idempotency_id String レコードの重複排除に使用できるID。
dataset_id String データセットの識別に使用されるID(この場合はsp-conversion)。
marketplace_id String アカウントに関連付けられているマーケットプレイスID
currency String このプロフィールのエンティティのすべての金額に使用される通貨。
advertiser_id String 広告主に関連付けられたID。このIDは、GET v2/profilesエンドポイントを使用して取得できます。この値は固有ではありません。通常はマーケットプレイスをまたいで同じ値です。注: 出品者以外のアカウントでは、このadvertiser_idにはエンティティIDが設定されます。
campaign_id String キャンペーンを表す固有の数値ID。
ad_group_id String 広告グループを表す固有の数値ID。
ad_id String 広告を表す固有の数値ID。
keyword_id String 入札に使用されたキーワードのID。
placement String ページに広告が表示された位置。
time_window_start String パフォーマンスデータが属する期間の開始時間(ISO 8601の日時形式)。
attributed_conversions_1d Long 広告のクリックから24時間以内に発生した広告起因のコンバージョンイベント数。
attributed_conversions_7d Long 広告のクリックから7日以内に発生した広告起因のコンバージョンイベント数。
attributed_conversions_14d Long 広告のクリックから14日以内に発生した広告起因のコンバージョンイベント数。
attributed_conversions_30d Long 広告のクリックから30日以内に発生した広告起因のコンバージョンイベント数。
attributed_conversions_1d_same_sku Long 購入されたSKUと広告を掲載されたSKUが同じで、広告のクリックから24時間以内に発生した広告起因のコンバージョンイベント数。
attributed_conversions_7d_same_sku Long 購入されたSKUと広告を掲載されたSKUが同じで、広告のクリックから7日以内に発生した広告起因のコンバージョンイベント数。
attributed_conversions_14d_same_sku Long 購入されたSKUと広告を掲載されたSKUが同じで、広告のクリックから14日以内に発生した広告起因のコンバージョンイベント数。
attributed_conversions_30d_same_sku Long 購入されたSKUと広告を掲載されたSKUが同じで、広告のクリックから30日以内に発生した広告起因のコンバージョンイベント数。
attributed_sales_1d Double 広告のクリックから24時間以内に発生した売上の合計金額。
attributed_sales_7d Double 広告のクリックから7日以内に発生した売上の合計金額。
attributed_sales_14d Double 広告のクリックから14日以内に発生した売上の合計金額。
attributed_sales_30d Double 広告のクリックから30日以内に発生した売上の合計金額。
attributed_sales_1d_same_sku Double 購入されたSKUと広告を掲載されたSKUが同じで、広告のクリックから24時間以内に発生した売上の合計金額。
attributed_sales_7d_same_sku Double 購入されたSKUと広告を掲載されたSKUが同じで、広告のクリックから7日以内に発生した売上の合計金額。
attributed_sales_14d_same_sku Double 購入されたSKUと広告を掲載されたSKUが同じで、広告のクリックから14日以内に発生した売上の合計金額。
attributed_sales_30d_same_sku Double 購入されたSKUと広告を掲載されたSKUが同じで、広告のクリックから30日以内に発生した売上の合計金額。
attributed_units_ordered_1d Long 広告のクリックから24時間以内に注文された商品の合計点数。
attributed_units_ordered_7d Long 広告のクリックから7日以内に注文された商品の合計点数。
attributed_units_ordered_14d Long 広告のクリックから14日以内に注文された商品の合計点数。
attributed_units_ordered_30d Long 広告のクリックから30日以内に注文された商品の合計点数。
attributed_units_ordered_1d_same_sku Long 購入されたSKUと広告を掲載されたSKUが同じで、広告のクリックから24時間以内に注文された商品の合計点数。
attributed_units_ordered_7d_same_sku Long 購入されたSKUと広告を掲載されたSKUが同じで、広告のクリックから7日以内に注文された商品の合計点数。
attributed_units_ordered_14d_same_sku Long 購入されたSKUと広告を掲載されたSKUが同じで、広告のクリックから14日以内に注文された商品の合計点数。
attributed_units_ordered_30d_same_sku Long 購入されたSKUと広告を掲載されたSKUが同じで、広告のクリックから30日以内に注文された商品の合計点数。

リソースベースのIAMポリシー

このデータセットを登録して取得するには、マーケットプレイスに基づいて、適切なIAMポリシーをSQSキューに追加してください。

NA

{
  "Version": "2008-10-17",
  "Id": "{REPLACE_WITH_ANY_VALUE}",
  "Statement": [
    {
      "Sid": "{REPLACE_WITH_ANY_VALUE}",
      "Effect": "Allow",
      "Principal": {
        "Service": "sns.amazonaws.com"
      },
      "Action": "SQS:SendMessage",
      "Resource": "{REPLACE WITH ARN Of SQS DESTINATION QUEUE}",
      "Condition": {
        "ArnEquals": {
          "aws:SourceArn": "arn:aws:sns:us-east-1:802324068763:*"
        }
      }
    },
    {
      "Sid": "{REPLACE_WITH_ANY_VALUE}",
      "Effect": "Allow",
      "Principal": {
        "AWS": "arn:aws:iam::926844853897:role/ReviewerRole"
      },
      "Action": "SQS:GetQueueAttributes",
      "Resource": "*"
    }
  ]
}

EU

{
  "Version": "2008-10-17",
  "Id": "{REPLACE_WITH_ANY_VALUE}",
  "Statement": [
    {
      "Sid": "{REPLACE_WITH_ANY_VALUE}",
      "Effect": "Allow",
      "Principal": {
        "Service": "sns.amazonaws.com"
      },
      "Action": "SQS:SendMessage",
      "Resource": "{REPLACE WITH ARN Of SQS DESTINATION QUEUE}",
      "Condition": {
        "ArnEquals": {
          "aws:SourceArn": "arn:aws:sns:eu-west-1:562877083794:*"
        }
      }
    },
    {
      "Sid": "{REPLACE_WITH_ANY_VALUE}",
      "Effect": "Allow",
      "Principal": {
        "AWS": "arn:aws:iam::926844853897:role/ReviewerRole"
      },
      "Action": "SQS:GetQueueAttributes",
      "Resource": "*"
    }
  ]
}

FE

{
  "Version": "2008-10-17",
  "Id": "{REPLACE_WITH_ANY_VALUE}",
  "Statement": [
    {
      "Sid": "{REPLACE_WITH_ANY_VALUE}",
      "Effect": "Allow",
      "Principal": {
        "Service": "sns.amazonaws.com"
      },
      "Action": "SQS:SendMessage",
      "Resource": "{REPLACE WITH ARN Of SQS DESTINATION QUEUE}",
      "Condition": {
        "ArnEquals": {
          "aws:SourceArn": "arn:aws:sns:us-west-2:622939981599:*"
        }
      }
    },
    {
      "Sid": "{REPLACE_WITH_ANY_VALUE}",
      "Effect": "Allow",
      "Principal": {
        "AWS": "arn:aws:iam::926844853897:role/ReviewerRole"
      },
      "Action": "SQS:GetQueueAttributes",
      "Resource": "*"
    }
  ]
}

データの鮮度

スポンサープロダクト広告キャンペーンのコンバージョンは、そのキャンペーンに起因するクリックが発生した時間に基づいて報告されます。コンバージョンデータは毎日、毎週、毎月報告され、最初のクリックから最大で60日後までコンバージョンデータの補正を受け取ります。データは1時間おきにキューに一括送信されます。必ずしも正時ではありませんが、1時間に1回送信されます

スポンサー広告の予算使用状況(budget-usage)

budget-usageデータセットは、スポンサー広告(スポンサープロダクト広告、スポンサーディスプレイ広告、スポンサーブランド広告)のキャンペーンとポートフォリオの予算使用状況(支出と予算の比較)を示します。広告主は、5%間隔で予算の消費状況の通知を受け取ります。

スキーマ

このデータセットは、以下のフィールドと指標をサポートしています。

| フィールド名 | フィールドタイプ | フィールドの説明 | |--- |--- |--- | | advertiser_id | String | 広告主に関連付けられたID。このIDは、GET v2/profilesエンドポイントを使用して取得できます。この値は固有ではありません。通常はマーケットプレイスをまたいで同じ値です。注: 出品者以外のアカウントでは、このadvertiser_idにはエンティティIDが設定されます。 | | marketplace_id | String | アカウントが関連付けられているマーケットプレイスのID。 | | dataset_id | String | 特定のデータセットを一意に識別するために使用されるID。 | | budget_scope_id | String | 予算使用率を取得したキャンペーンまたはポートフォリオの固有のID。 | | budget_scope_type | String | 予算範囲のタイプ。現在サポートされている値: CAMPAIGNまたはPORTFOLIO。 | | advertising_product_type | String | 広告プロダクトのタイプ:sp(スポンサープロダクト広告)、sb(スポンサーブランド広告)、sd(スポンサーディスプレイ広告)。 | | budget | Double | budget_scope_idの予算額。いずれかの予算ルールが優先されている場合は、ルールベースの予算になります。そうでない場合は、広告主が設定した予算になります。 | | budget_usage_percentage | Double | 予算使用率(支出を予算で割った値)。 | | usage_updated_timestamp | String | 予算使用状況の最終評価時間。 |

リソースベースのIAMポリシー

このデータセットを登録して取得するには、マーケットプレイスに基づいて、適切なIAMポリシーをSQSキューに追加してください。

NA

{
  "Version": "2008-10-17",
  "Id": "{REPLACE_WITH_ANY_VALUE}",
  "Statement": [
    {
      "Sid": "{REPLACE_WITH_ANY_VALUE}",
      "Effect": "Allow",
      "Principal": {
        "Service": "sns.amazonaws.com"
      },
      "Action": "SQS:SendMessage",
      "Resource": "{REPLACE WITH ARN Of SQS DESTINATION QUEUE}",
      "Condition": {
        "ArnEquals": {
          "aws:SourceArn": "arn:aws:sns:us-east-1:055588217351:*"
        }
      }
    },
    {
      "Sid": "{REPLACE_WITH_ANY_VALUE}",
      "Effect": "Allow",
      "Principal": {
        "AWS": "arn:aws:iam::926844853897:role/ReviewerRole"
      },
      "Action": "SQS:GetQueueAttributes",
      "Resource": "*"
    }
  ]
}

EU

{
  "Version": "2008-10-17",
  "Id": "{REPLACE_WITH_ANY_VALUE}",
  "Statement": [
    {
      "Sid": "{REPLACE_WITH_ANY_VALUE}",
      "Effect": "Allow",
      "Principal": {
        "Service": "sns.amazonaws.com"
      },
      "Action": "SQS:SendMessage",
      "Resource": "{REPLACE WITH ARN Of SQS DESTINATION QUEUE}",
      "Condition": {
        "ArnEquals": {
          "aws:SourceArn": "arn:aws:sns:eu-west-1:675750596317:*"
        }
      }
    },
    {
      "Sid": "{REPLACE_WITH_ANY_VALUE}",
      "Effect": "Allow",
      "Principal": {
        "AWS": "arn:aws:iam::926844853897:role/ReviewerRole"
      },
      "Action": "SQS:GetQueueAttributes",
      "Resource": "*"
    }
  ]
}

FE

{
  "Version": "2008-10-17",
  "Id": "{REPLACE_WITH_ANY_VALUE}",
  "Statement": [
    {
      "Sid": "{REPLACE_WITH_ANY_VALUE}",
      "Effect": "Allow",
      "Principal": {
        "Service": "sns.amazonaws.com"
      },
      "Action": "SQS:SendMessage",
      "Resource": "{REPLACE WITH ARN Of SQS DESTINATION QUEUE}",
      "Condition": {
        "ArnEquals": {
          "aws:SourceArn": "arn:aws:sns:us-west-2:100899330244:*"
        }
      }
    },
    {
      "Sid": "{REPLACE_WITH_ANY_VALUE}",
      "Effect": "Allow",
      "Principal": {
        "AWS": "arn:aws:iam::926844853897:role/ReviewerRole"
      },
      "Action": "SQS:GetQueueAttributes",
      "Resource": "*"
    }
  ]
}

データの鮮度

Amazon Marketing Streamは、予算使用状況の更新をほぼリアルタイムでプッシュします。予算使用率が5%に達すると、すぐに通知が届きます。Amazonのトラフィック検証プロセスにより、同じ通知が2回届く可能性があります。たとえば、クリックが無効にされた場合は、予算使用率がしきい値の5%を下回る可能性があります。

スポンサーディスプレイ広告トラフィック(sd-traffic)

sd-traffiデータセットには、スポンサーディスプレイ広告キャンペーンに関連するクリック、インプレッション、コストデータが含まれています。

スキーマ

| フィールド名 | タイプ | 説明 | |--- |--- |--- | | idempotency_id | String | レコードの重複排除に使用できるID。 | | dataset_id | String | データセット(この場合はsd-traffic)を識別するために使用されるID。 | | marketplace_id | String | アカウントに関連付けられているマーケットプレイスID。 | | currency | String | このプロフィールのエンティティのすべての金額に使用される通貨。 | | advertiser_id | String | 広告主に関連付けられたID。このIDは、GET v2/profilesエンドポイントを使用して取得できます。この値は固有ではありません。通常はマーケットプレイスをまたいで同じ値です。注: 出品者以外のアカウントでは、このadvertiser_idにはエンティティIDが設定されます。 | | campaign_id | String | キャンペーンを表す固有の数値ID。 | | ad_group_id | String | 広告グループを表す固有の数値ID。 | | ad_id | String | 広告を表す固有の数値ID。 | | target_id | Integer | ターゲティングエクスプレッションのID。 | | targeting_text | String | ターゲティングエクスプレッションで使用されるテキスト。 | | time_window_start | String | パフォーマンスデータが属する期間の開始時間(ISO 8601の日時形式)。 | | clicks | Long | 広告の合計クリック数。 | | impressions | Long | 広告の合計インプレッション数。 | | view_impressions | Long | 広告ビューアブルインプレッション合計数(vCPMキャンペーンのみ)。 | | cost | Double | すべてのクリック(CPC)あるいはクリックまたは閲覧(vCPM)の合計コスト。現地通貨で表されます。 |

リソースベースのIAMポリシー

このデータセットを登録して取得するには、マーケットプレイスに基づいて、適切なIAMポリシーをSQSキューに追加してください。

NA

{
  "Version": "2008-10-17",
  "Id": "{REPLACE_WITH_ANY_VALUE}",
  "Statement": [
    {
      "Sid": "{REPLACE_WITH_ANY_VALUE}",
      "Effect": "Allow",
      "Principal": {
        "Service": "sns.amazonaws.com"
      },
      "Action": "SQS:SendMessage",
      "Resource": "{REPLACE WITH ARN Of SQS DESTINATION QUEUE}",
      "Condition": {
        "ArnEquals": {
          "aws:SourceArn": "arn:aws:sns:us-east-1:370941301809:*"
        }
      }
    },
    {
      "Sid": "{REPLACE_WITH_ANY_VALUE}",
      "Effect": "Allow",
      "Principal": {
        "AWS": "arn:aws:iam::926844853897:role/ReviewerRole"
      },
      "Action": "SQS:GetQueueAttributes",
      "Resource": "*"
    }
  ]
}

EU

{
  "Version": "2008-10-17",
  "Id": "{REPLACE_WITH_ANY_VALUE}",
  "Statement": [
    {
      "Sid": "{REPLACE_WITH_ANY_VALUE}",
      "Effect": "Allow",
      "Principal": {
        "Service": "sns.amazonaws.com"
      },
      "Action": "SQS:SendMessage",
      "Resource": "{REPLACE WITH ARN Of SQS DESTINATION QUEUE}",
      "Condition": {
        "ArnEquals": {
          "aws:SourceArn": "arn:aws:sns:eu-west-1:947153514089:*"
        }
      }
    },
    {
      "Sid": "{REPLACE_WITH_ANY_VALUE}",
      "Effect": "Allow",
      "Principal": {
        "AWS": "arn:aws:iam::926844853897:role/ReviewerRole"
      },
      "Action": "SQS:GetQueueAttributes",
      "Resource": "*"
    }
  ]
}

FE

{
  "Version": "2008-10-17",
  "Id": "{REPLACE_WITH_ANY_VALUE}",
  "Statement": [
    {
      "Sid": "{REPLACE_WITH_ANY_VALUE}",
      "Effect": "Allow",
      "Principal": {
        "Service": "sns.amazonaws.com"
      },
      "Action": "SQS:SendMessage",
      "Resource": "{REPLACE WITH ARN Of SQS DESTINATION QUEUE}",
      "Condition": {
        "ArnEquals": {
          "aws:SourceArn": "arn:aws:sns:us-west-2:310605068565:*"
        }
      }
    },
    {
      "Sid": "{REPLACE_WITH_ANY_VALUE}",
      "Effect": "Allow",
      "Principal": {
        "AWS": "arn:aws:iam::926844853897:role/ReviewerRole"
      },
      "Action": "SQS:GetQueueAttributes",
      "Resource": "*"
    }
  ]
}

データの鮮度

広告がクリックされてから12時間以内に最初のクリックデータが表示されます。トラフィック検証プロセスの一環として、この最初の報告から次の72時間の間、クリックを無効化することができます。Amazon Marketing Streamは、自動的にキューを調整します。

スポンサーディスプレイ広告コンバージョン(sd-conversion)

sd-conversionデータセットには、スポンサーディスプレイ広告キャンペーンに起因するコンバージョンデータが含まれています。

スキーマ

| フィールド名 | タイプ | 説明 | |--- |--- |--- | | idempotency_id | String | レコードの重複排除に使用できるID。 | | dataset_id | String | データセットの識別に使用されるID(この場合はsd-conversion)。 | | marketplace_id | String | アカウントに関連付けられているマーケットプレイスID。 | | currency | String | このプロフィールのエンティティのすべての金額に使用される通貨。 | | advertiser_id | String | 広告主に関連付けられたID。このIDは、GET v2/profilesエンドポイントを使用して取得できます。この値は固有ではありません。通常はマーケットプレイスをまたいで同じ値です。注: 出品者以外のアカウントでは、このadvertiser_idにはエンティティIDが設定されます。 | | campaign_id | String | キャンペーンを表す固有の数値ID。 | | ad_group_id | String | 広告グループを表す固有の数値ID。 | | ad_id | String | 広告を表す固有の数値ID。 | | target_id | Integer | ターゲティングエクスプレッションのID。 | | time_window_start | String | パフォーマンスデータが属する期間の開始時間(ISO 8601の日時形式)。 | | attributed_conversions_1d | Long | 広告のクリックから24時間以内に発生した広告起因のコンバージョンイベント数。 | | attributed_conversions_7d | Long | 広告のクリックから7日以内に発生した広告起因のコンバージョンイベント数。 | | attributed_conversions_14d | Long | 広告のクリックから14日以内に発生した広告起因のコンバージョンイベント数。 | | view_attributed_conversions_14d | Long | 広告のクリックまたは閲覧から14日以内に発生した広告起因のコンバージョンイベント数(vCPMキャンペーンのみ)。 | | attributed_conversions_30d | Long | 広告のクリックから30日以内に発生した広告起因のコンバージョンイベント数。 | | attributed_conversions_1d_same_sku | Long | 購入されたSKUと広告を掲載されたSKUが同じで、広告のクリックから24時間以内に発生した広告起因のコンバージョンイベント数。 | | attributed_conversions_7d_same_sku | Long | 購入されたSKUと広告を掲載されたSKUが同じで、広告のクリックから7日以内に発生した広告起因のコンバージョンイベント数。 | | attributed_conversions_14d_same_sku | Long | 購入されたSKUと広告を掲載されたSKUが同じで、広告のクリックから14日以内に発生した広告起因のコンバージョンイベント数。 | | attributed_conversions_30d_same_sku | Long | 購入されたSKUと広告を掲載されたSKUが同じで、広告のクリックから30日以内に発生した広告起因のコンバージョンイベント数。 | | attributed_sales_1d | Double | 広告のクリックから24時間以内に発生した売上の合計金額。 | | attributed_sales_7d | Double | 広告のクリックから7日以内に発生した売上の合計金額。 | | attributed_sales_14d | Double | 広告のクリックから14日以内に発生した売上の合計金額。 | | view_attributed_sales_14d | Double | 広告のクリックまたは閲覧から14日以内に発生した売上の合計金額(vCPMキャンペーンのみ)。 | | attributed_sales_30d | Double | 広告のクリックから30日以内に発生した売上の合計金額。 | | attributed_sales_1d_same_sku | Double | 購入されたSKUと広告を掲載されたSKUが同じで、広告のクリックから24時間以内に発生した売上の合計金額。 | | attributed_sales_7d_same_sku | Double | 購入されたSKUと広告を掲載されたSKUが同じで、広告のクリックから7日以内に発生した売上の合計金額。 | | attributed_sales_14d_same_sku | Double | 購入されたSKUと広告を掲載されたSKUが同じで、広告のクリックから14日以内に発生した売上の合計金額。 | | attributed_sales_30d_same_sku | Double | 購入されたSKUと広告を掲載されたSKUが同じで、広告のクリックから30日以内に発生した売上の合計金額。 | | attributed_units_ordered_1d | Long | 広告のクリックから24時間以内に注文された商品の合計点数。 | | attributed_units_ordered_7d | Long | 広告のクリックから7日以内に注文された商品の合計点数。 | | attributed_units_ordered_14d | Long | 広告のクリックから14日以内に注文された商品の合計点数。 | | view_attributed_units_ordered_14d | Long | 広告のクリックまたは閲覧から14日以内に注文された商品の合計点数(vCPMキャンペーンのみ)。 | | attributed_units_ordered_30d | Long | 広告のクリックから30日以内に注文された商品の合計点数。 | | attributed_orders_new_to_brand_14d | Long | 広告のクリックから14日以内に発生した注文の合計数。 | | attributed_sales_new_to_brand_14d | Double | 広告のクリックから14日以内に発生した新規顧客による売上の合計金額。 | | attributed_units_ordered_new_to_brand_14d | Long | 広告のクリックから14日以内に発生した新規顧客による注文商品の合計点数。 | | view_attributed_orders_new_to_brand_14d | Long | 広告のクリックまたは閲覧から14日以内に発生した注文の合計数(vCPMキャンペーンのみ)。 | | view_attributed_sales_new_to_brand_14d | Double | 広告のクリックまたは閲覧から14日以内に発生した新規顧客による売上の合計金額(vCPMキャンペーンのみ)。 | | view_attributed_units_ordered_new_to_brand_14d | Long | 広告のクリックまたは閲覧から14日以内に発生した新規顧客による注文商品の合計点数(vCPMキャンペーンのみ)。 |

リソースベースのIAMポリシー

このデータセットを登録して取得するには、マーケットプレイスに基づいて、適切なIAMポリシーをSQSキューに追加してください。

NA

{
  "Version": "2008-10-17",
  "Id": "{REPLACE_WITH_ANY_VALUE}",
  "Statement": [
    {
      "Sid": "{REPLACE_WITH_ANY_VALUE}",
      "Effect": "Allow",
      "Principal": {
        "Service": "sns.amazonaws.com"
      },
      "Action": "SQS:SendMessage",
      "Resource": "{REPLACE WITH ARN Of SQS DESTINATION QUEUE}",
      "Condition": {
        "ArnEquals": {
          "aws:SourceArn": "arn:aws:sns:us-east-1:877712924581:*"
        }
      }
    },
    {
      "Sid": "{REPLACE_WITH_ANY_VALUE}",
      "Effect": "Allow",
      "Principal": {
        "AWS": "arn:aws:iam::926844853897:role/ReviewerRole"
      },
      "Action": "SQS:GetQueueAttributes",
      "Resource": "*"
    }
  ]
}

EU

{
  "Version": "2008-10-17",
  "Id": "{REPLACE_WITH_ANY_VALUE}",
  "Statement": [
    {
      "Sid": "{REPLACE_WITH_ANY_VALUE}",
      "Effect": "Allow",
      "Principal": {
        "Service": "sns.amazonaws.com"
      },
      "Action": "SQS:SendMessage",
      "Resource": "{REPLACE WITH ARN Of SQS DESTINATION QUEUE}",
      "Condition": {
        "ArnEquals": {
          "aws:SourceArn": "arn:aws:sns:eu-west-1:664093967423:*"
        }
      }
    },
    {
      "Sid": "{REPLACE_WITH_ANY_VALUE}",
      "Effect": "Allow",
      "Principal": {
        "AWS": "arn:aws:iam::926844853897:role/ReviewerRole"
      },
      "Action": "SQS:GetQueueAttributes",
      "Resource": "*"
    }
  ]
}

FE

{
  "Version": "2008-10-17",
  "Id": "{REPLACE_WITH_ANY_VALUE}",
  "Statement": [
    {
      "Sid": "{REPLACE_WITH_ANY_VALUE}",
      "Effect": "Allow",
      "Principal": {
        "Service": "sns.amazonaws.com"
      },
      "Action": "SQS:SendMessage",
      "Resource": "{REPLACE WITH ARN Of SQS DESTINATION QUEUE}",
      "Condition": {
        "ArnEquals": {
          "aws:SourceArn": "arn:aws:sns:us-west-2:818973306977:*"
        }
      }
    },
    {
      "Sid": "{REPLACE_WITH_ANY_VALUE}",
      "Effect": "Allow",
      "Principal": {
        "AWS": "arn:aws:iam::926844853897:role/ReviewerRole"
      },
      "Action": "SQS:GetQueueAttributes",
      "Resource": "*"
    }
  ]
}

データの鮮度

スポンサーディスプレイ広告キャンペーンのコンバージョンは、そのキャンペーンに起因するクリックが発生した時間に基づいて報告されます。コンバージョンデータは毎日、毎週、毎月報告され、最初のクリックから最大で60日後までコンバージョンデータの補正を受け取ります。

スポンサー広告キャンペーンの推奨事項(sponsored-ads-campaign-diagnostics-recommendations)

このデータセットには、スポンサー広告ポートフォリオのパフォーマンスを向上させるための既存の広告キャンペーンの最適化や、広告キャンペーンの新規作成に関する推奨事項が含まれています。以下の表に、このデータセットで提供される推奨事項の種類を示します。

| 広告プロダクト | 説明 | |--- |--- | | スポンサーブランド広告、スポンサープロダクト広告 | 予算使用率が50%を超えるキャンペーンで、近々特別なイベントの影響を受けるであろうもの。予算ルールを使用すると、トラフィックのピーク時にキャンペーンが予算切れになるのを防ぐ役に立ちます。推奨された予算を適用してください。 | | スポンサーブランド広告 | 過去14日間のインプレッションが1回以上で、ROASが3以下である、パフォーマンスの低いスポンサーブランド広告キャンペーン。パフォーマンスを向上させるために推奨入札額を適用してください。 | | スポンサーディスプレイ広告 | 広告費が広告主のキャンペーンの上位50%に入っている、パフォーマンスの低いスポンサーディスプレイ広告キャンペーン。パフォーマンスを向上させるために推奨入札額を適用してください。 | | スポンサーディスプレイ広告 | 広告主がスポンサーディスプレイ広告オーディエンスを積極的に使用していません。スポンサーディスプレイ広告キャンペーンを作成して再度オーディエンスにはたらきかけ、逃した販売機会の確保やブランドロイヤルティのさらなる向上を促進してください。 | | スポンサーディスプレイ広告 | 広告主がスポンサーディスプレイ広告CPCキャンペーンには積極的に取り組んでいますが、リーチ入札額最適化を積極的に使用していません。リーチ入札額最適化を使用すると、Amazon内外で商品の認知度を高めることができます。認知度を高めるために、リーチに合わせて最適化されたスポンサーディスプレイ広告キャンペーンを作成してください。 | | スポンサーディスプレイ広告 | 広告主がスポンサーディスプレイ広告コンテキストターゲティングを積極的に使用していません。スポンサーディスプレイ広告キャンペーンを作成し、Amazonの商品詳細ページにある特定の商品やカテゴリーをターゲットにして、検討および売上の促進に役立ててください。 | | スポンサーディスプレイ広告 | これらのASINは、今後90日間で高い売上が見込まれますが、広告には掲載されていません。パフォーマンスの高いASIN向けのスポンサーディスプレイ広告コンテキストキャンペーンを作成してください。 | | スポンサーディスプレイ広告 | 有効化されたスポンサーディスプレイ広告キャンペーンの広告費とクリック数がゼロです。クリックが発生しないキャンペーンでは、広告起因の注文も発生しません。パフォーマンスを向上させるために、推奨ASIN、ターゲット、入札額を使用して、これらのキャンペーンに新しい広告グループを追加することをおすすめします。 | | スポンサープロダクト広告 | キャンペーンのROASが5を超えています。インプレッション数と売上を伸ばすために入札額を最適化することを広告主におすすめします。 | | スポンサープロダクト広告 | ROASが3を超え、先週の予算使用率が80%を超える、パフォーマンスの高いキャンペーン。この状況は、売上とクリック数を獲得する機会を逃していると推定されます。推奨された予算を適用してください。 | | スポンサープロダクト広告 | 広告主には、広告未実施で、広告準備が完了したASINがあります。広告準備が完了したASINは、広告を実施した場合、クリックされる可能性が16倍高くなります。クリック数を増やすには、広告準備が完了したASINでキャンペーンを作成してください。 | | スポンサープロダクト広告 | 広告主は、広告未実施で、セールが今後7〜14日以内に開始されるASINを持っています。インプレッション数やクリック数を増やすには、セールでASINの広告を掲載してください。 | | スポンサープロダクト広告 | これらのASINは、今後90日間で高い売上が見込まれますが、広告には掲載されていません。スポンサープロダクト広告マニュアルキャンペーンを作成して、パフォーマンスの高いASINの広告を掲載してください。 | | スポンサープロダクト広告 | 有効化されたスポンサープロダクト広告オートターゲティングキャンペーンの広告費がゼロです。クリック数が発生しないキャンペーンでは、広告起因の注文も発生しません。パフォーマンスを向上させるために、推奨ASIN、ターゲット、入札額を使用して、これらのキャンペーンに新しい広告グループを作成することをおすすめします。 | | スポンサープロダクト広告 | 有効化されたスポンサープロダクト広告のマニュアルターゲティングキャンペーンの広告費とクリック数がゼロです。クリックが発生しないキャンペーンでは、広告起因の注文も発生しません。パフォーマンスを向上させるために、推奨ASIN、ターゲット、入札額を使用して、これらのキャンペーンに新しい広告グループを追加することをおすすめします。 | | スポンサープロダクト広告 | 過去14日間のインプレッションが1回以上で、ROASが3以下である、パフォーマンスの低いスポンサープロダクト広告キャンペーン。パフォーマンスを向上させるために推奨入札額を適用してください。 |

スキーマ

このデータセットにはネストされたオブジェクトが含まれています。

| フィールド名 | タイプ | 説明 | |--- |--- |--- | | recommendation_id | String | このデータセットの各推奨事項を表す固有のID。 | | advertiser_id | String | 広告主に関連付けられたID。このIDは、GET v2/profilesエンドポイントを使用して取得できます。この値は固有ではありません。通常はマーケットプレイスをまたいで同じ値です。注: 出品者以外のアカウントでは、このadvertiser_idにはエンティティIDが設定されます。 | | marketplace_id | String | アカウントに関連付けられているマーケットプレイスID。 | | dataset_id | String | データセットを識別するために使用されるID(この場合はsponsored-ads-campaign-diagnostics-recommendations)。 | | group_id | String | 同じadvertiser_id / marketplace_id / campaign_idの組み合わせに対して複数の推奨事項が提案された場合に、推奨事項のグループを示すID。 | | apply_endpoint | String | この推奨事項を1回の呼び出しで適用するためのAPIエンドポイント。ユーザーはこのAPIを呼び出し、APIリクエスト本文にrecommendation_idを指定してこの推奨事項を採用することができます。APIリファレンス。 | | type | String | 推奨事項のタイプ。現在サポートされているタイプ:CAMPAIGN_BUDGET、KEYWORD_BID、NEW_CAMPAIGN、CAMPAIGN_BUDGET_RULE、NEW_CAMPAIGN_BUDGET_RULE、PRODUCT_TARGETING_BID、AUDIENCE_TARGETING_BID | | published_date | String | この推奨事項が公開された日付。 | | expiry_date | String | この推奨事項の有効期限が切れる日付。 | | explanation | Object | このキャンペーンの変更を推奨する理由が入ったオブジェクト。詳しくは、説明オブジェクトを参照してください。 | | campaign_name | String | 推奨事項が生成されているキャンペーンの名前。 | | campaign_id | String | キャンペーンを表す固有の数値ID。 | | ad_product | String | キャンペーンの広告プロダクト。(次のいずれか: SP、SB、SD)。 | | current_campaign_settings | Object | キャンペーンで現在使用されている設定。詳しくは、CampaignSettingsオブジェクトを参照してください。 | | recommended_campaign_settings | Object | キャンペーンの推奨設定。詳しくは、CampaignSettingsオブジェクトを参照してください。 |

説明オブジェクト

| フィールド名 | タイプ | 説明 | |--- |--- |--- | | description | String | この変更を提案する理由をユーザーにわかりやすく提供します。 | | missed_opportunities | Object | 推奨予算を採用した場合にキャンペーンで得られる可能性がある付加的なインプレッション数、クリック数、および売上の推定値が入ったオブジェクト。これらは過去のウェブサイトのトラフィックと過去のキャンペーンパフォーマンスに基づく推定値であり、実際のインプレッション数、クリック数、売上を保証するものではありません。 | | missed_opportunities.impressions | Object | 推奨予算を採用した場合にキャンペーンで得られる可能性がある付加的なインプレッション数の推定値が入ったオブジェクト。これらは過去のウェブサイトのトラフィックと過去のキャンペーンパフォーマンスに基づく推定値であり、実際のインプレッション数を保証するものではありません。 | | missed_opportunities.impressions.upper_bound | Integer | 機会を逃したインプレッション数の上限値。 | | missed_opportunities.impressions.lower_bound | Integer | 機会を逃したインプレッション数の下限値。 | | missed_opportunities.clicks | Object | 推奨予算を採用した場合にキャンペーンで得られる可能性がある付加的なクリック数の推定値が入ったオブジェクト。これらは過去のウェブサイトのトラフィックと過去のキャンペーンパフォーマンスに基づく推定値であり、実際のクリック数を保証するものではありません。 | | missed_opportunities.clicks.upper_bound | Integer | 機会を逃したクリック数の上限値。 | | missed_opportunities.clicks.lower_bound | Integer | 機会を逃したクリック数の下限値。 | | missed_opportunities.conversions | Object | 推奨予算を採用した場合にキャンペーンで得られる可能性がある付加的な売上の推定値が入ったオブジェクト。これらは過去のウェブサイトのトラフィックと過去のキャンペーンパフォーマンスに基づく推定値であり、実際の売上を保証するものではありません。 | | missed_opportunities.conversions.upper_bound | Integer | 機会を逃したコンバージョン数の上限値。 | | missed_opportunities.conversions.lower_bound | Integer | 機会を逃したコンバージョン数の下限値。 | | missed_opportunities.time_period | String | missed_opportunitiesの計算に使用された期間。 |

キャンペーン設定オブジェクト

| フィールド名 | タイプ | 説明 | |--- |--- |--- | | campaign_targeting | String | キャンペーンのターゲットタイプ(次のいずれか: MANUAL、AUTO)。 | | bidding_strategy | String | キャンペーンの入札戦略(次のいずれか: LEGACY_FOR_SALES、AUTO_FOR_SALES、MANUAL)。 | | start_date | String | キャンペーンの開始日。 | | end_date | String | キャンペーンの終了日。 | | ad_groups | Array | キャンペーンに関連付けられている広告グループを含む配列。 | | ad_groups.adgroup_id | String | 広告グループのID。 | | ad_groups.adgroup_name | String | 広告グループの名前。 | | ad_groups.asins | Array | 広告グループに関連付けられているASIN。 | | ad_groups.bid | Decimal | 広告グループに関連付けられている入札。 | | ad_groups.bid_optimization | String | 広告グループの入札最適化戦略。 | | ad_groups.target_type | String | 広告グループに関連付けられているターゲティングタイプ。 | | ad_groups.targets | Array | 広告グループに関連付けられているターゲットが入った配列。 | | ad_groups.targets.bid | Decimal | ターゲットに関連付けられている入札。 | | ad_groups.targets.text | String | キーワードのテキスト。 | | ad_groups.targets.match_type | String | キーワードターゲットのマッチタイプ。 | | ad_groups.targets.targeting | String | 入札のターゲティング。 | | ad_groups.targets.category | Object | ターゲティングエクスプレッションに関連付けられているカテゴリー。 | | ad_groups.targets.category.id | Integer | カテゴリーのID。 | | ad_groups.targets.category.name | String | カテゴリーの名前。 | | ad_groups.targets.category.path | String | カテゴリーのパス。 | | ad_groups.targets.expressions | Array | ターゲティングエクスプレッションの配列。 | | ad_groups.targets.expressions.type | String | ターゲティングエクスプレッションのタイプ。 | | ad_groups.targets.expressions.value | String | ターゲティングエクスプレッションの値。 | | ad_groups.targets.audience_target_type | String | オーディエンスターゲティングの場合、ターゲットのタイプ。 | | budget | Object | キャンペーンの予算の詳細が入ったオブジェクト。 | | budget.budget_rules | Array | キャンペーンに関連付けられている予算ルールの配列。 | | budget.budget_rules.rule_name | String | ルールに関連付けられている名前。 | | budget.budget_rules.type | String | 予算ルールのタイプ。 | | budget.budget_rules.start_date | String | 予算ルールの開始日。 | | budget.budget_rules.end_date | String | 予算ルールの終了日。 | | budget.budget_rules.event_id | String | 予算ルールに関連付けられているイベントID。 | | budget.budget_rules.event_name | String | 予算ルールに関連付けられているイベント名。 | | budget.budget_rules.increase_by | String | 予算の増額単位。 | | budget.budget_rules.performance_measure_condition | Object | 予算ルールが有効になる条件。 | | budget.budget_rules.performance_measure_condition.metric_name | String | 条件で使用する指標。 | | budget.budget_rules.performance_measure_condition.comparison_operator | String | 条件の比較演算子。 | | budget.budget_rules.performance_measure_condition.threshold | Decimal | 条件で使用する値。 | | budget.budget_rules.recurrence | Object | 予算ルールの繰り返し設定。 | | budget.budget_rules.recurrence.recurrence_type | String | 繰り返しのタイプ。 | | budget.budget_rules.recurrence.days_of_week | Array | 予算ルールが有効になる曜日。 |

リソースベースのIAMポリシー

このデータセットを登録して取得するには、マーケットプレイスに基づいて、適切なIAMポリシーをSQSキューに追加してください。

NA

{
  "Version": "2008-10-17",
  "Id": "{REPLACE_WITH_ANY_VALUE}",
  "Statement": [
    {
      "Sid": "{REPLACE_WITH_ANY_VALUE}",
      "Effect": "Allow",
      "Principal": {
        "Service": "sns.amazonaws.com"
      },
      "Action": "SQS:SendMessage",
      "Resource": "{REPLACE WITH ARN Of SQS DESTINATION QUEUE}",
      "Condition": {
        "ArnEquals": {
          "aws:SourceArn": "arn:aws:sns:us-east-1:084590724871:*"
        }
      }
    },
    {
      "Sid": "{REPLACE_WITH_ANY_VALUE}",
      "Effect": "Allow",
      "Principal": {
        "AWS": "arn:aws:iam::926844853897:role/ReviewerRole"
      },
      "Action": "SQS:GetQueueAttributes",
      "Resource": "*"
    }
  ]
}

EU

{
  "Version": "2008-10-17",
  "Id": "{REPLACE_WITH_ANY_VALUE}",
  "Statement": [
    {
      "Sid": "{REPLACE_WITH_ANY_VALUE}",
      "Effect": "Allow",
      "Principal": {
        "Service": "sns.amazonaws.com"
      },
      "Action": "SQS:SendMessage",
      "Resource": "{REPLACE WITH ARN Of SQS DESTINATION QUEUE}",
      "Condition": {
        "ArnEquals": {
          "aws:SourceArn": "arn:aws:sns:eu-west-1:059061853903:*"
        }
      }
    },
    {
      "Sid": "{REPLACE_WITH_ANY_VALUE}",
      "Effect": "Allow",
      "Principal": {
        "AWS": "arn:aws:iam::926844853897:role/ReviewerRole"
      },
      "Action": "SQS:GetQueueAttributes",
      "Resource": "*"
    }
  ]
}

FE

{
  "Version": "2008-10-17",
  "Id": "{REPLACE_WITH_ANY_VALUE}",
  "Statement": [
    {
      "Sid": "{REPLACE_WITH_ANY_VALUE}",
      "Effect": "Allow",
      "Principal": {
        "Service": "sns.amazonaws.com"
      },
      "Action": "SQS:SendMessage",
      "Resource": "{REPLACE WITH ARN Of SQS DESTINATION QUEUE}",
      "Condition": {
        "ArnEquals": {
          "aws:SourceArn": "arn:aws:sns:us-west-2:489995134625:*"
        }
      }
    },
    {
      "Sid": "{REPLACE_WITH_ANY_VALUE}",
      "Effect": "Allow",
      "Principal": {
        "AWS": "arn:aws:iam::926844853897:role/ReviewerRole"
      },
      "Action": "SQS:GetQueueAttributes",
      "Resource": "*"
    }
  ]
}

データの鮮度

当社は広告主のキャンペーンを毎週診断して推奨事項を提案しますが、毎週すべてのキャンペーンについて、対応する推奨事項が提案されるわけではありません。また、当社は、広告主様の活動を学習し、既存の推奨事項の採用とその成果に基づいて、今後の推奨事項についての方針を修正するフィードバックループを構築しています。

推奨事項の適用

Streamから受け取った推奨事項を行動に移すために、Tactical Recommendations API(推奨施策API)を使用することができます。詳細については、ユーザーガイドを参照してください。