PPCWISER 琼仁智度 LogoPPCWISER琼仁智度
接入教程 · AWS + Amazon Marketing Stream

亚马逊 Marketing Stream 接入教程:用你自己的 AWS 接收小时级广告数据

广告报表按天汇总,你只知道“这一天花了多少、出了几单”。Amazon Marketing Stream 按小时把关键词 × 版位的流量与转化推送到你自己的 AWS 账号——这是按 168 个时段、按版位 × 时段出价的数据地基。本系列 5 步带你配好,每一步都附 AWS 与 Amazon Ads 官方出处。

30 天免费试用¥99/月/店铺起凭证只存你自己的电脑
为什么需要小时级数据

亚马逊广告为什么要按小时看数据?

亚马逊允许卖家按星期几和一天中的时段设置出价规则,规则挂在广告系列上,并叠加在版位加价与竞价策略之上 [4];官方也建议配合小时粒度的数据来调整这些规则 [5]。问题是:日报表只告诉你“这一天”,看不出“周二晚上 9 点、首页首位”这一格到底赚不赚钱。

Marketing Stream 的 sp-traffic 数据集带有关键词、匹配方式、版位和小时起点(按广告主时区),sp-conversion 按归因点击发生的那个小时记账 [2]。把它们拼起来,才能得到“每个词 × 每个版位 × 每个小时”的证据。

琼仁智度的 168 时段分时出价 与 版位 × 时段分账 就建立在这份证据上。不接 Marketing Stream 也能开通,但这两类机制没有小时级证据可用,只能退回到按天的粗粒度判断。

示意图。热力图颜色为演示数据,不对应任何真实店铺。
整体架构

数据从亚马逊到琼仁智度,经过哪几段?

每一段都在你自己的账号或你自己的电脑上,琼仁智度只在最后一段读取。

① Amazon Marketing Stream(亚马逊侧)
你订阅数据集后,亚马逊近实时地把增量数据推送出来,不需要你反复调用报告接口 [1]。
② Amazon Data Firehose(你的 AWS)
亚马逊通过它自己的 SNS 主题把数据交给你的 Firehose,再由 Firehose 写入数据输出位置 [6]。Firehose 原名 Kinesis Data Firehose,2024 年更名,接口与指标不变 [7]。
③ Amazon S3 桶(你的 AWS)
数据文件按到达时间分区存放。用官方模板时,路径是“目录名/year=/month=/day=/hour=/”[8]。
④ 中转客户端(你的电脑)
用你创建的只读访问密钥在本机签名、从你自己的网络下载文件。密钥不上传云端,详见 凭证永不离开你的电脑。
⑤ 琼仁智度云端
在你店铺独立的数据空间里汇总小时级流量与转化,用于时段与版位的出价计算。
硬要求

琼仁智度读取你的数据,有这 6 条硬要求

照本系列教程用官方模板配置,前 5 条自动满足;手动配置的卖家请逐条核对。

要求怎么满足不满足会怎样
AWS 区域为 us-east-1(北美)控制台右上角选 US East (N. Virginia);模板参数 StreamRealm 选 NA订阅时报 400 区域不支持 [9];模板直接拒绝创建 [8]
只订阅 4 个数据集sp-traffic、sp-conversion、sb-traffic、sb-conversion 各一套 [10]系统只读这 4 个,订阅其他数据集只会多花 AWS 费用
Firehose 不压缩官方模板默认不压缩;手动时压缩选“不压缩”系统不解压 gzip 文件,数据读不出来
路径按 year= / month= / day= 分区用官方模板;手动时按 第 2 步 填自定义前缀Firehose 默认前缀是 YYYY/MM/dd/HH [11],系统找不到文件
路径里含数据集名,一个数据集一个目录顶层目录名如 sp-traffic-na,只写本数据集的名字不同数据集可能被混淆识别
一个桶只放一个广告账户(profile)的数据只为本店的美国站 profile 订阅;其他店铺或站点另建一套系统按桶读取,别的店铺或站点的数据会混进来

琼仁智度目前支持亚马逊北美站点(以美国站为主),本系列教程按 us-east-1 编写。

费用

接入 Marketing Stream 要花多少钱?只看计费维度

我们不替 AWS 报价——价格会变,以你账单为准。下面是会产生费用的维度。

项目怎么计费说明
Marketing Stream不向广告主收费费用只来自你使用的 AWS 资源 [1]
Firehose 数据摄入按摄入 GB 计费,每条记录按 5KB 向上取整计量格式转换、动态分区、VPC 投递是额外计费项,本教程都不开 [12]
S3 存储按存储量(GB·月)计费用生命周期规则自动删除旧文件,控制存储量 [13][14]
S3 请求写入/列出一档、读取一档,删除请求免费中转同步会产生列出与读取请求 [13]
S3 数据流出流出到互联网按量计费,每月前 100GB 在所有服务与区域合计免费中转在中国境内从美国区下载,属于流出到互联网(按计费维度推断)[13]
CloudWatch 日志按 CloudWatch Logs 标准计费官方模板会建一个保留 30 天的错误日志组 [8]

官方建议用 AWS 价格计算器按你的数据量估算 [3]。新账户的起步抵扣额度与计划规则以 AWS 页面为准。

有没有小时级数据,差在哪

只用日报表 vs 加上 Marketing Stream

对比项只用 Ads API 日报表加上 Marketing Stream(琼仁智度建议)
数据粒度— 按天汇总✓ 按小时汇总 [1]
关键词 × 版位 × 小时✕ 看不到✓ sp-traffic 带版位与小时起点 [2]
168 时段分时出价— 只能凭经验设时段规则✓ 按每个小时的真实证据分配
获取方式— 反复请求、等待报告生成✓ 推送到你自己的 AWS,无需轮询 [1]
历史数据✓ 报告可查历史— 不支持回填,订阅后才开始积累 [3]
额外成本✓ 无— AWS 按用量计费(Stream 本身免费)

两者不是二选一:琼仁智度同时使用报告数据与小时级流数据。

数据接好之后

小时级数据接好以后,琼仁智度能帮你做什么?

  • 168 时段分时出价:把一周 168 个小时按转化证据分档,高转化时段抢量、低效时段让价,并落成亚马逊官方的时段出价规则。见 168 时段分时出价。
  • 版位 × 时段分账:首页首位、其余搜索、商品页面在不同小时的表现分开算账,好格子保住、坏格子收缩。见 版位 × 时段分账。
  • 日内高峰与低谷:在转化集中的小时定点加码,见 高转化时段定点抢量。

这些机制都按广告系列结构设计,因为亚马逊的版位加价与时段规则是系列级设置 [4]。接入时你需要在 方案 A 重构现有系列 / 方案 B 保留原系列另建 之间二选一。

订阅要用 Ads API 凭证第 3 步需要你的 Amazon Ads API 凭证。还没申请的,可以按 Ads API 申请教程 自行申请,也可以请我们 协助申请(¥499/次)。

关于 Marketing Stream 接入的常见问题

不接 Marketing Stream,能用琼仁智度吗?
能开通,但不建议。168 时段分时出价、版位 × 时段分账需要小时级证据,缺少时这些机制只能按天粗略判断。Marketing Stream 以小时粒度提供流量与转化 [1],而且不能回填历史 [3],越早接入越好。
我不会写代码,能自己配好吗?
AWS 部分(注册、建模板堆栈、建只读用户)都是在控制台点选,本教程逐步截取了真实路径。订阅那一步需要调用 Ads API,官方也说明至少初期需要开发人员来建立订阅连接 [1];可以用官方的 Postman 图形工具完成 [15]。拿不准的,可以在 开通单 里勾选“需要指导”。
数据放在谁那里?琼仁智度能看到我的 AWS 吗?
数据落在你自己的 AWS 账号里。琼仁智度只拿到你创建的只读访问密钥,而且这把密钥只录入你电脑上的中转客户端、加密保存在本机,云端从不接收。中转取回的数据文件会进入你店铺独立的数据空间用于计算。你随时可以在 AWS 里停用这把密钥。
我有多家店铺,可以共用一套吗?
不可以。一个桶只能放一个广告账户(profile)的数据,否则会混进别家店铺的数据。建议每家店铺使用独立的 AWS 账号各配一套;中转客户端也是一店一机,见 一店一机一出口。
欧洲站、日本站能按这个教程配吗?
琼仁智度目前只支持亚马逊北美站点(以美国站为主)。官方对欧洲、远东另有对应的 AWS 区域 [1],但不在本系统支持范围内。
订阅后多久能在 S3 里看到数据?
没有固定时长。官方说明流量数据首批在点击后 12 小时内可得、之后每小时推送一批 [2];Firehose 还会先缓冲再写文件 [8];没有广告活动的小时不会有数据。按 第 5 步 的方法检查即可。

数据地基打好,再让系统按小时替你出价

30 天免费试用,全部功能开放。Ads API 可按教程自行申请,也可以请我们协助(¥499/次)。

入门版 ¥99/月/店铺 · 含 10 个产品 · 每增加 1 个产品 +¥10/月
继续了解

相关功能

AWS 教程 · 1/5

注册 AWS 账号

advanced 方式注册全球区账号、选 Paid 计划、根用户开 MFA、不建根用户密钥。

查看 →
AWS 教程 · 2/5

S3 与 Firehose

官方模板 ×4:自动建桶、Firehose 与 IAM 角色,默认不压缩、按 year=/month=/day= 分区。

查看 →
AWS 教程 · 3/5

订阅 4 个数据集

为本店 profile 调 4 次订阅接口,填 3 个 ARN,Firehose 无需确认,ACTIVE 即成功。

查看 →
接入教程

安装中转客户端

Windows 电脑双击安装、配对码上线,在本机设置页录入全部凭证,凭证不离开这台电脑。

查看 →
时段与版位

168 时段分时出价

按 168 个时段的出单证据算时段加价,自动写成亚马逊官方时段规则。

查看 →
时段与版位

版位 × 时段分账

把每个关键词拆成版位 × 时段的格子分别算账:赚钱的保住,亏钱的收缩。

查看 →
REFERENCES

参考资料与权威来源

本页所有涉及亚马逊规则、行业数据与方法论的表述均标注来源。链接指向官方文档、同行评审论文、专利或法律法规原文;访问日期 2026-09。

  1. [1]官方Amazon Marketing Stream overview — Amazon Ads API Docs · 2026Amazon Marketing Stream 以推送方式近实时提供小时级广告流量与转化数据。
  2. [2]官方Sponsored Products performance datasets — Amazon Ads API Docs · 2026Marketing Stream 的 sp-traffic / sp-conversion 数据集以小时为粒度推送;首批点击数据 12 小时内送达,之后的无效点击修正会自动补推。
  3. [3]官方Amazon Marketing Stream and Data Firehose FAQ — Amazon Ads · 2026Firehose 与 SQS 一样至少投递一次、可能重复且不保证顺序;输出到 S3 时强烈建议用 CloudFormation 模板;Marketing Stream 不支持回填历史数据;费用建议用 AWS 价格计算器按自身情况估算;停用订阅是把状态改为 ARCHIVED。
  4. [4]官方Schedule bid rules (Sponsored Products) — Amazon Ads API Docs · 2026SP 时段出价规则可按星期与一天中的时段提高出价,规则关联到广告活动,并叠加在版位调整与竞价策略之上。
  5. [5]官方Bidding rules for Sponsored Products — Amazon Ads Support Center · 2026控制台时段出价规则可按时段、星期、日期范围自动提高出价;官方建议配合小时粒度报告调整规则。
  6. [6]官方Introduction to Amazon Data Firehose(Amazon Marketing Stream) — Amazon Ads · 2026Firehose 链路:Marketing Stream → Amazon Ads 侧的 SNS 主题 → 你的 Firehose → 数据输出(如 S3);不使用 Firehose 时数据只能投递到 SQS。
  7. [7]官方Introducing Amazon Data Firehose, formerly known as Amazon Kinesis Data Firehose — AWS · 20242024-02-09 Kinesis Data Firehose 更名为 Amazon Data Firehose,服务端点、API、CLI、IAM 策略与 CloudWatch 指标均不变。
  8. [8]官方amzn/ads-advanced-tools-docs · amazon_marketing_stream(Stream_Firehose_CF_Template.yaml) — Amazon(GitHub) · 2025官方模板参数为 S3Storage、StreamDatasetId、StreamDestinationFirehose、StreamRealm;Firehose 为 Direct PUT、缓冲 5MB/300 秒、不压缩,前缀为“目录名/year=/month=/day=/hour=/”(年份占位符写作大写 YYYY);区域与 StreamRealm 不一致时拒绝创建;另建一个保留 30 天的错误日志组。
  9. [9]官方Amazon Marketing Stream onboarding guide — Amazon Ads · 2026广告区域与 AWS 区域一一对应(北美 NA 对应 us-east-1);订阅时若资源所在区域不受支持会返回 400;多个 profile 需分别订阅;开通头一两天可能只收到更正数据而出现负数汇总。
  10. [10]官方Amazon Marketing Stream data guide — Amazon Ads · 2026官方数据集清单:sp-traffic、sp-conversion、sb-traffic、sb-conversion 等 SP/SB 数据集都通过 POST /streams/subscriptions 订阅,北美、欧洲、远东区域均可用。
  11. [11]官方Configure Amazon S3 object name format — AWS · 2026对象键 = 前缀 + “流名称-流版本-年-月-日-时-分-秒-uuid”;不自定义时默认前缀为 YYYY/MM/dd/HH,时区默认 UTC;流配置每修改一次版本号加 1;指定文件扩展名会覆盖默认扩展名。
  12. [12]官方Amazon Data Firehose pricing — AWS · 2026Direct PUT 按摄入的 GB 计费,每条记录按 5KB 向上取整计量;格式转换、动态分区、VPC 投递为额外计费项。
  13. [13]官方Amazon S3 pricing — AWS · 2026S3 按存储、请求与数据检索、数据传输等维度计费;流出到互联网的数据每月前 100GB(所有服务与区域合计)免费;DELETE 请求免费。
  14. [14]官方Setting an S3 Lifecycle configuration on a bucket — AWS · 2026控制台:General purpose buckets→选桶→Management→Create lifecycle rule→选择范围→Expire current versions of objects→填写对象创建后的天数;规则对已有和新增对象都生效;删除异步进行可能延后,但计费在规则满足时即变化。
  15. [15]官方Quickstart guide: Getting started using the Amazon Ads API Postman collection — Amazon Ads · 2026官方 Postman 集合内置授权脚本与预置请求,可在图形界面里调用 Ads API;官方订阅管理页也推荐用它测试 Marketing Stream 接口。