PPCWISER 琼仁智度 LogoPPCWISER琼仁智度
AWS + Marketing Stream 教程 · 第 5/5 步

第 5 步：确认数据落进 S3，填入中转客户端，报错按表排查

前 4 步做完，链路是否真的通了？先在 S3 里亲眼看到数据文件，再把区域、桶名和只读密钥交给中转客户端。万一报错，本页有一张按官方错误码整理的对照表。

免费试用 30 天返回教程总览
30 天免费试用¥99/月/店铺起凭证只存你自己的电脑
分步演示

先看 S3，再填中转客户端

示例值均为占位，换成你在第 2 步、第 4 步记下的内容。点左侧任一步可单独查看。

示意动画。中转客户端设置页的字段以你安装的版本为准。
图文步骤

验证 Marketing Stream 数据并填入中转：详细步骤

确认 4 个订阅都是 ACTIVE

GET /streams/subscriptions

见 第 3 步。官方建议定期检查订阅状态 [5]。

等有广告活动的小时过去

—

初始点击数据在点击后 12 小时内可得，之后 72 小时内的无效点击调整会自动补推；数据每小时推送一批，不一定在整点 [1]。Firehose 还要缓冲到 5MB 或 300 秒才写文件 [2]。首批文件可能需要等数小时（推断）。

在 S3 里逐层打开分区目录

S3 → General purpose buckets → 桶 → sp-traffic-na/ → year= → month= → day= → hour=

文件名由“流名称-流版本-年-月-日-时-分-秒-随机串”组成 [6]。目录日期是 UTC 到达时间，与广告后台的时区不同 [3]。

中转客户端：选区域、填桶名与前缀

中转客户端本机设置页 → AWS / S3

AWS 区域选 us-east-1（4 个桶共用这一个区域）；4 个数据类型分别填桶名。前缀可留空，系统会自动把桶根下的顶层目录当作前缀；建议明确填写第 2 步的目录名加斜杠，如 sp-traffic-na/。

中转客户端：录入只读密钥，不勾“使用 IAM 角色”

中转客户端本机设置页 → AWS / S3

“使用 IAM 角色”只适用于程序运行在 EC2、Lambda 等 AWS 计算资源上的情况，你的 Windows 电脑应使用访问密钥。安装与录入全流程见 中转客户端安装。

保存，与顾问确认同步

设置页 → 保存

保存后即时生效，无需重启中转。桶名与前缀这类业务标识会同步一份到云端用于计算；访问密钥只加密保存在你的电脑上。

报错对照表

中转读取 S3 报错怎么办？按错误码对照排查

现象 / 错误码可能原因处理方法
AccessDenied（403）策略缺桶上的 s3:ListBucket，或缺“桶/*”上的 s3:GetObject；桶用了 SSE-KMS 却没给 kms:Decrypt对照 第 4 步 的策略补全 [7][8]
InvalidAccessKeyId（403）访问密钥 ID 不存在：填错了或已被删除核对 Access Key ID，必要时重建密钥 [4]
SignatureDoesNotMatch（403）秘密访问密钥填错（多了空格、复制不全）重新粘贴；丢失就删除重建 [4][9]
PermanentRedirect（301）/ AuthorizationHeaderMalformed（400）请求的区域与桶所在区域不一致（推断）中转的 AWS 区域改为桶所在的 us-east-1 [4]
NoSuchBucket（404）桶名填错或桶已删除核对桶名，只填名字本身 [4]
“浏览存储桶”报错或列表为空策略没有 s3:ListAllMyBuckets正常现象，手动输入桶名即可 [10]
桶里一直没有文件Firehose 没收到数据、投递失败、桶被删、投递角色无权写桶查看 Firehose 的 IncomingRecords、DeliveryToS3.Success 指标与错误日志 [11]
订阅 ACTIVE 但仍没数据那几个小时没有广告表现；Firehose 配置或权限问题等有活动的小时；检查 Firehose 状态与权限 [12]
订阅状态异常（FAILED_PROVISIONING 等）亚马逊无法投递到你的 Firehose见 第 3 步 故障排查 [12]

错误码与 HTTP 状态依据 Amazon S3 API 错误码列表 [4]；“区域不一致”一行是按错误码含义推断的常见原因。

数据长什么样

S3 里的数据有负数、有重复，正常吗？

  • 负数是正常的更正：亚马逊剔除无效流量或做计费调整时，会推送负值抵消之前的数值，官方要求聚合时保留 [12]；刚开通的头一两天可能只收到更正、没有原始流量，出现负的汇总值 [13]。
  • 可能重复、不保证顺序：Firehose 与 SQS 一样至少投递一次，可能出现重复 [14]。
  • SB 只包含第 4 版活动：美国站 2023-05-22 前用旧接口创建的 SB 活动不会推送 [15]。
  • 不回填历史：订阅之前的数据不会补发 [14]。
  • 时区：记录里的小时起点是广告主时区 [1]，S3 目录的日期是 UTC 到达时间 [3]，两者本来就不一致。
日常维护

接通之后，定期检查这 5 项

  • 订阅状态：4 个订阅都应是 ACTIVE；变成 SUSPENDED 只能重建 [5]。
  • Ads API 授权：refresh token 自同意之日起 365 天到期 [16]，用同一个亚马逊账号重新授权，才能继续管理原订阅 [12]。
  • 访问密钥：按需轮换，先建新密钥、换进中转、再停用旧密钥 [17]。
  • 生命周期规则：确认 4 个桶都有自动删除旧文件的规则 [18]。
  • 中转电脑：在计算与下发时段保持开机联网。离线期间文件仍留在你的 S3 里，回线后补取，见 电脑关机、断网，广告不失控。
接下来

小时级数据到位，琼仁智度开始按小时替你算账

数据接通后，系统会把每个关键词在每个版位、每个小时的点击、花费与订单汇总起来，用于 168 时段分时出价 和 版位 × 时段分账：高转化的小时和版位保住并加码，低效的格子收缩。所有调整都在你的 广告结构方案 上执行、并记录原因。

还没开通？30 天免费试用，全部功能开放。填写 开通单 时 AWS 一栏选“已配置”，顾问会直接进入中转安装与数据同步环节。

验证与接入常见问题

前缀路径一定要填吗？
可以留空，系统会把桶根下的每个顶层目录当作前缀自动发现。建议明确填写第 2 步的目录名加斜杠（如 sp-traffic-na/），更不容易出错。不要把 year= 之类的日期部分写进前缀。
4 个桶可以建在不同区域吗？
不行。中转设置页只有一个 AWS 区域选项，4 个桶必须都在 us-east-1。这也是 Marketing Stream 北美区域的要求 [19]。
保存后要重启中转客户端吗？
不用，保存后即时生效。
中转电脑关机那几个小时的数据会丢吗？
不会因为关机而丢失：数据文件留在你自己的 S3 里，中转回线后下一轮同步会重新取回。前提是生命周期规则保留的天数足够长。
为什么 S3 目录日期和广告后台对不上？
S3 目录按 UTC 到达时间划分 [3]，而数据里的小时起点是广告主时区 [1]，两者本来就不同，系统按数据里的时间统计。
Marketing Stream 的数字和广告后台略有差异，信谁？
少量差异是正常的：两者的归因窗口、时区、处理延迟与汇总方式可能不同，官方建议拉长时间段对比 [12]。持续的大幅差异再排查订阅与 Firehose 配置。

链路打通，接下来让系统按小时替你出价

PPCWISER 琼仁智度 30 天免费试用，全部功能开放；之后入门版 ¥99/月/店铺（含 10 个产品）。

入门版 ¥99/月/店铺 · 含 10 个产品 · 每增加 1 个产品 +¥10/月
免费试用 30 天看价格与计算器
继续了解

相关功能

AWS 教程

AWS 小时级数据

5 步把亚马逊小时级广告数据接进你自己的 AWS，再交给中转客户端只读读取。

查看 →接入教程

安装中转客户端

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

查看 →AWS 教程 · 4/5

只读 IAM 用户

一条只读策略 + 一个不开控制台的 IAM 用户 + 一对访问密钥，只能看 4 个桶。

查看 →时段与版位

168 时段分时出价

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

查看 →时段与版位

版位 × 时段分账

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

查看 →离线保护

关机断网不失控

离线推迟、回线补做一次、超 2 小时双向提醒，亚马逊上的设置照常生效。

查看 →
REFERENCES

参考资料与权威来源

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

  1. [1]官方Sponsored Products performance datasets — Amazon Ads API Docs · 2026Marketing Stream 的 sp-traffic / sp-conversion 数据集以小时为粒度推送；首批点击数据 12 小时内送达，之后的无效点击修正会自动补推。
  2. [2]官方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 天的错误日志组。
  3. [3]官方Understand custom prefixes for Amazon S3 objects — AWS · 2026自定义前缀可用 !{timestamp:yyyy} 等表达式（遵循 Java DateTimeFormatter），时间取记录的大致到达时间、默认 UTC；前缀含表达式时必须设置含 !{firehose:error-output-type} 的错误输出前缀；官方示例即 year=/month=/day=/hour= 形式。
  4. [4]官方Error（Amazon S3 API Reference） — AWS · 2026S3 错误码：AccessDenied 403；InvalidAccessKeyId 403（访问密钥 ID 不存在）；SignatureDoesNotMatch 403（应检查秘密访问密钥）；NoSuchBucket 404；PermanentRedirect 301（须改用指定端点）；AuthorizationHeaderMalformed 400。
  5. [5]官方Managing Amazon Marketing Stream Subscriptions — Amazon Ads · 2026订阅状态含 PROVISIONING、ACTIVE、ARCHIVED、SUSPENDED 等，SUSPENDED 不能恢复为 ACTIVE；没有删除接口，只能用 PUT 把状态设为 ARCHIVED；同一应用下同一 profile+数据集+目的地只能有 1 个订阅、同一 profile+数据集最多 2 个；应使用同一个 LwA Client ID 管理订阅，并定期检查状态。
  6. [6]官方Configure Amazon S3 object name format — AWS · 2026对象键 = 前缀 + “流名称-流版本-年-月-日-时-分-秒-uuid”；不自定义时默认前缀为 YYYY/MM/dd/HH，时区默认 UTC；流配置每修改一次版本号加 1；指定文件扩展名会覆盖默认扩展名。
  7. [7]官方Troubleshoot access denied (403 Forbidden) errors in Amazon S3 — AWS · 2026S3 返回 403 访问被拒，来自策略中的显式拒绝，或没有任何适用的允许语句（隐式拒绝）；IAM 默认拒绝，所需操作必须被显式允许。
  8. [8]官方Using server-side encryption with AWS KMS keys (SSE-KMS) — AWS · 2026S3 默认对新对象使用 SSE-S3 加密；若改用 SSE-KMS，下载对象还需要该 KMS 密钥的 kms:Decrypt 权限。
  9. [9]官方Manage access keys for IAM users — AWS · 2026访问密钥由访问密钥 ID 与秘密访问密钥组成；秘密密钥只在创建时可取回，丢失只能删除后重建；每个用户最多 2 个访问密钥；不要用根用户创建访问密钥，不要把密钥写进应用文件或项目目录。
  10. [10]官方Amazon S3: Allows read and write access to objects in an S3 Bucket, programmatically and in the console — AWS · 2026需要列出账户中的存储桶时，官方示例把 s3:ListAllMyBuckets 授权在资源 * 上。
  11. [11]官方Troubleshooting Amazon S3（Amazon Data Firehose） — AWS · 2026数据没有投递到 S3 时，检查 IncomingBytes/IncomingRecords 与 DeliveryToS3.Success 指标、错误日志、目标桶是否仍存在、Firehose 的 IAM 角色是否有桶访问权限。
  12. [12]官方Amazon Marketing Stream FAQ — Amazon Ads · 2026FAILED_PROVISIONING 多因 Firehose 目的地的权限或配置问题；订阅与生成 refresh token 的邮箱账号及客户端应用绑定，换邮箱后看不到旧订阅；负数是无效流量等更正，聚合时应保留；ACTIVE 却收不到数据时应检查 Firehose 状态与权限；SQS 订阅须在 2 天内确认。
  13. [13]官方Amazon Marketing Stream onboarding guide — Amazon Ads · 2026广告区域与 AWS 区域一一对应（北美 NA 对应 us-east-1）；订阅时若资源所在区域不受支持会返回 400；多个 profile 需分别订阅；开通头一两天可能只收到更正数据而出现负数汇总。
  14. [14]官方Amazon Marketing Stream and Data Firehose FAQ — Amazon Ads · 2026Firehose 与 SQS 一样至少投递一次、可能重复且不保证顺序；输出到 S3 时强烈建议用 CloudFormation 模板；Marketing Stream 不支持回填历史数据；费用建议用 AWS 价格计算器按自身情况估算；停用订阅是把状态改为 ARCHIVED。
  15. [15]官方Sponsored Brands performance datasets — Amazon Ads · 2026sb-traffic 含 SB 点击、曝光、花费与版位类型，按小时起点记账；只包含第 4 版（多广告组）SB 活动，美国 2023-05-22 前用旧接口创建的 SB 活动不会推送。
  16. [16]官方Refresh tokens — Amazon Ads API Docs · 20262026-07-30 及以后签发的 refresh token 自广告主同意之日起 365 天到期，到期日不因使用而延长，到期后须重新授权；撤销授权、移除应用、修改 LwA 凭证或可疑活动也会使其失效并返回 invalid_grant；建议加密保存并在到期前提醒重新授权。
  17. [17]官方Update access keys — AWS · 2026不中断业务的密钥轮换：旧密钥仍有效时先创建第二个密钥→所有程序改用新密钥→确认旧密钥不再被使用后先停用→观察无误再删除。
  18. [18]官方Setting an S3 Lifecycle configuration on a bucket — AWS · 2026控制台：General purpose buckets→选桶→Management→Create lifecycle rule→选择范围→Expire current versions of objects→填写对象创建后的天数；规则对已有和新增对象都生效；删除异步进行可能延后，但计费在规则满足时即变化。
  19. [19]官方Amazon Data Firehose getting started guide — Amazon Ads · 2026官方 CloudFormation 模板只支持 S3 输出，会自动创建 1 个 S3 桶、1 个 Firehose 流和 3 个 IAM 角色；开始前须登录到与广告区域对应的 AWS 区域（NA 为 us-east-1）；提交前须勾选允许创建带自定义名称的 IAM 资源。