开发人员指南概述

亚马逊广告 API 概览

Amazon Marketing Stream 数据指南

Amazon Marketing Stream 支持广告主可订阅的数据集。目前，Amazon Marketing Stream 支持三种数据集，未来将陆续支持更多数据集。每个数据集都支持不同的绩效指标和广告活动元数据。

对于您订阅的每个数据集，请确保在 SQS 中确认订阅。

在本文档中，您可以详细了解可用的数据集和每个数据集支持的指标。

可用数据集

商品推广流量（sp-traffic）

sp-traffic 数据集包含与商品推广活动相关的点击量、展示量和成本数据。

架构

此数据集支持以下字段和指标：

字段名称 类型 描述
idempotency_id String 可用于删除记录中的重复数据的标识符。
dataset_id String 用于标识数据集（在本例中为 sp-traffic）的标识符。
marketplace_id String 与账户关联的站点标识符。
currency String 用于体现配置文件下的实体的所有货币价值的货币。
advertiser_id String 与广告主关联的 ID。您可以使用 GET v2/profiles 接口检索此 ID。此值并不是唯一的，可能在各个站点都使用这一相同的值。注意： 对于非卖家账户，此 advertiser_id 被设置为实体（entity）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 将自动向您的队列发送任何调整。数据将会每小时以突发方式传递到您的队列中。虽然不一定在整点，但每小时会传递一次。

商品推广转化（sp-conversion）

sp-conversion 数据集包含归因于商品推广活动的转化数据。

警告

Amazon Marketing Stream 中存在已知错误，可能导致少量来自其他广告方案的记录出现在 sp-conversion 数据中，而在 sp-traffic 数据中没有相应的记录。我们已经确认，此类不需要的数据在总转化记录中所占的比例很小，不会对您的分析造成任何重大影响。在我们解决此问题之前，您可以忽略数据集中的这些记录。

架构

字段名称 字段类型 描述
idempotency_id String 可用于删除记录中的重复数据的标识符。
dataset_id String 用于标识数据集（在本例中为 sp-conversion）的标识符。
marketplace_id String 与账户关联的站点标识符。
currency String 用于体现配置文件下的实体的所有货币价值的货币。
advertiser_id String 与广告主关联的 ID。您可以使用 GET v2/profiles 接口检索此 ID。此值并不是唯一的，可能在各个站点都使用这一相同的值。注意： 对于非卖家账户，此 advertiser_id 被设置为实体（entity）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 点击广告后 24 小时内发生的归因转化事件的数量，其中购买的 SKU 与推广的 SKU 相同。
attributed_conversions_7d_same_sku Long 点击广告后 7 天内发生的归因转化事件的数量，其中购买的 SKU 与推广的 SKU 相同。
attributed_conversions_14d_same_sku Long 点击广告后 14 天内发生的归因转化事件的数量，其中购买的 SKU 与推广的 SKU 相同。
attributed_conversions_30d_same_sku Long 点击广告后 30 天内发生的归因转化事件的数量，其中购买的 SKU 与推广的 SKU 相同。
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 点击广告后 24 小时内发生的销售总价值，其中购买的 SKU 与推广的 SKU 相同。
attributed_sales_7d_same_sku Double 在点击广告后的 7 天内发生的销售总价值，其中购买的 SKU 与推广的 SKU 相同。
attributed_sales_14d_same_sku Double 点击广告后 14 天内发生的销售总价值，其中购买的 SKU 与推广的 SKU 相同。
attributed_sales_30d_same_sku Double 点击广告后 30 天内发生的销售总价值，其中购买的 SKU 与推广的 SKU 相同。
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 点击广告后 24 小时内订购的商品总数，其中购买的 SKU 与推广的 SKU 相同。
attributed_units_ordered_7d_same_sku Long 点击广告后 7 天内订购的商品总数，其中购买的 SKU 与推广的 SKU 相同。
attributed_units_ordered_14d_same_sku Long 点击广告后 14 天内订购的商品总数，其中购买的 SKU 与推广的 SKU 相同。
attributed_units_ordered_30d_same_sku Long 点击广告后 30 天内订购的商品总数，其中购买的 SKU 与推广的 SKU 相同。

基于资源的 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 天内收到转化数据的修订。数据将会每小时以突发方式传递到您的队列中。虽然不一定在整点，但每小时会传递一次。

搜索广告预算使用情况（budget-usage）

“budget-usage” 数据集提供了搜索广告（商品推广、展示型推广或品牌推广）活动和广告组合的预算状态（支出与预算的对比）。广告主在每隔 5% 的预算消耗间隔就会收到通知。

架构

此数据集支持以下字段和指标：

| 字段名称 | 字段类型 | 字段描述 | |--- |--- |--- | | advertiser_id | String | 与广告主关联的 ID。您可以使用 GET v2/profiles 接口检索此 ID。此值并不是唯一的，可能在各个站点都使用这一相同的值。注意： 对于非卖家账户，此 advertiser_id 被设置为实体（entity）ID。 | | marketplace_id | String | 账户所关联的站点的标识符。 | | dataset_id | String | 用于唯一标识特定数据集的标识符。 | | budget_scope_id | String | 用于表示预算使用比例的广告活动或广告组合的唯一标识符。 | | budget_scope_type | String | 预算范围的类型。当前支持的值： CAMPAIGN 或 PORTFOLIO。 | | advertising_product_type | String | 广告产品类型：sp（商品推广）、sb（品牌推广）或sd（展示型推广） | | budget | Double | Value of budget for 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% 后，您应该会很快收到通知。由于亚马逊的流量验证流程，您可能会收到两次相同的通知。例如，如果点击被无效化处理，则可能会将您的预算使用量降低到 5% 的阈值以下。

展示型推广流量（sd-traffic）

sd-traffic 数据集包含了与展示型推广活动相关的点击量、展示量和成本数据。

架构

| 字段名称 | 类型 | 描述 | |--- |--- |--- | | idempotency_id | String | 可用于删除记录中的重复数据的标识符。 | | dataset_id | String | 用于标识数据集（在本例中为“sd-traffic”）的标识符。 | | marketplace_id | String | 与账户关联的站点标识符。 | | currency | String | 用于体现配置文件下的实体的所有货币价值的货币。 | | advertiser_id | String | 与广告主关联的 ID。您可以使用 GET v2/profiles 接口检索此 ID。此值并不是唯一的，可能在各个站点都使用这一相同的值。注意： 对于非卖家账户，此 advertiser_id 被设置为实体（entity）ID。 | | campaign_id | String | 广告活动的唯一数字 ID。 | | ad_group_id | String | 广告组的唯一数字 ID。 | | ad_id | String | 广告的唯一数字 ID。 | | target_id | Integer | 投放表达式的标识符。 | | 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 | 可用于删除记录中的重复数据的标识符。 | | dataset_id | String | 用于标识数据集（在本例中为“sd-conversion”）的标识符。 | | marketplace_id | String | 与账户关联的站点标识符。 | | currency | String | 用于体现配置文件下的实体的所有货币价值的货币。 | | advertiser_id | String | 与广告主关联的 ID。您可以使用 GET v2/profiles 接口检索此 ID。此值并不是唯一的，可能在各个站点都使用这一相同的值。注意： 对于非卖家账户，此 advertiser_id 被设置为实体（entity）ID。 | | campaign_id | String | 广告活动的唯一数字 ID。 | | ad_group_id | String | 广告组的唯一数字 ID。 | | ad_id | String | 广告的唯一数字 ID。 | | target_id | Integer | 投放表达式的标识符。 | | 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 | 点击广告后 24 小时内发生的归因转化事件的数量，其中购买的 SKU 与推广的 SKU 相同。 | | attributed_conversions_7d_same_sku | Long | 点击广告后 7 天内发生的归因转化事件的数量，其中购买的 SKU 与推广的 SKU 相同。 | | attributed_conversions_14d_same_sku | Long | 点击广告后 14 天内发生的归因转化事件的数量，其中购买的 SKU 与推广的 SKU 相同。 | | attributed_conversions_30d_same_sku | Long | 点击广告后 30 天内发生的归因转化事件的数量，其中购买的 SKU 与推广的 SKU 相同。 | | 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 | 点击广告后 24 小时内发生的销售总价值，其中购买的 SKU 与推广的 SKU 相同。 | | attributed_sales_7d_same_sku | Double | 在点击广告后的 7 天内发生的销售总价值，其中购买的 SKU 与推广的 SKU 相同。 | | attributed_sales_14d_same_sku | Double | 点击广告后 14 天内发生的销售总价值，其中购买的 SKU 与推广的 SKU 相同。 | | attributed_sales_30d_same_sku | Double | 点击广告后 30 天内发生的销售总价值，其中购买的 SKU 与推广的 SKU 相同。 | | 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 天内至少获得了一次展示且广告投资回报率（ROAS）小于或等于 3。应用建议竞价来提升绩效。 | | 展示型推广 | 展示型推广活动绩效不佳，其支出在广告主广告活动的前 50%。应用建议竞价来提升绩效。 | | 展示型推广 | 广告主未主动使用展示型推广受众。创建展示型推广活动再次吸引受众，帮助确保获得错失的销售机会或进一步培养品牌忠诚度。 | | 展示型推广 | 广告主开展了采用点击付费（CPC）模式的展示型推广活动，但未使用针对触达进行竞价优化的方案，这可以提高亚马逊站内及站外的商品知名度。创建经过优化的展示型推广活动来触达受众，进而提高认知度。 | | 展示型推广 | 广告主未主动使用展示型推广内容相关投放。创建展示型推广活动来投放亚马逊商品详情页上的特定商品和品类，帮助提升购买意向和销量。 | | 展示型推广 | 预测这些 ASIN 将在接下来的 90 天内获得高销量，但并未进行推广。为绩效优异的 ASIN 创建采用内容相关投放的展示型推广活动。 | | 展示型推广 | 已启动的展示型推广活动的广告支出或点击量为零。未产生点击量的广告活动也不会产生归因于广告活动的订单。建议在这些广告活动中添加新的广告组，使用建议的 ASIN、投放和竞价来提升绩效。 | | 商品推广 | 广告活动的广告投资回报率（ROAS）大于 5。建议广告主优化竞价来提高展示量和销量。 | | 商品推广 | 广告活动绩效优异，广告投资回报率（ROAS）大于 3，上周的预算利用率超过 80%。我们估计这导致了错失销售和点击机会。应用建议的预算。 | | 商品推广 | 广告主具有可以推广但未进行推广的 ASIN。如果推广具备推广条件的 ASIN，获得点击的可能性要高出 16 倍。使用具备推广条件的 ASIN 创建广告活动，提高点击量。 | | 商品推广 | 广告主具有未推广但将在接下来的 7-14 天内参与促销的 ASIN。推广参与促销的 ASIN 来提高展示量和点击量。 | | 商品推广 | 预测这些 ASIN 将在接下来的 90 天内获得高销量，但并未进行推广。创建手动投放商品推广活动，推广效果优异的 ASIN。 | | 商品推广 | 已启动的自动投放商品推广活动的广告支出为零。未产生点击量的广告活动也不会产生归因于广告活动的订单。建议在这些广告活动中创建新的广告组，使用建议的 ASIN、投放目标和竞价，以便提升效果。 | | 商品推广 | 已启动的手动投放商品推广活动的广告支出或点击量为零。未产生点击量的广告活动也不会产生归因于广告活动的订单。建议在这些广告活动中添加新的广告组，使用建议的 ASIN、投放和竞价来提升绩效。 | | 商品推广 | 商品推广活动绩效不佳，在过去 14 天内至少获得了一次展示且广告投资回报率（ROAS）小于或等于 3。应用建议竞价来提升绩效。 |

架构

注意

此数据集包含嵌套对象。

| 字段名称 | 类型 | 描述 | |--- |--- |--- | | recommendation_id | String | 此数据集中每项建议的唯一标识符。 | | advertiser_id | String | 与广告主关联的 ID。您可以使用 GET v2/profiles 接口检索此 ID。此值并不是唯一的，可能在各个站点都使用这一相同的值。注意： 对于非卖家账户，此 advertiser_id 被设置为实体（entity）ID。 | | marketplace_id | String | 与账户关联的站点标识符。 | | dataset_id | String | 用于标识数据集的标识符（在本例中为 sponsored-ads-campaign-diagnostics-recommendations）。 | | group_id | String | 如果针对同一个 “advertiser_id / marketplace_id / campaign_id” 组合提出多项建议，则用于建议对建议进行分组的标识符。 | | apply_endpoint | String | 用于在一次调用中应用此建议的 API 接口。用户可以调用此 API 并提供 remmancation_id，以供 API 请求体（request body）采用此建议。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 | 广告活动所使用的广告产品。（以下其中一项： 商品推广、品牌推、展示型推广）。 | | 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 的时间段。 |

CampaignSettings 对象

| 字段名称 | 类型 | 描述 | |--- |--- |--- | | 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 获取的建议采取行动，您可以使用策略性建议 API。如果您希望进一步了解，请参阅用户指南。

Amazon Advertising logo