推送记录
成片推送任务、广告账户结果、失败原因、网关认领和重新推送说明。
功能定位
推送记录 用于追踪成片从平台推送到外部平台的执行结果。它不是普通日志页,而是业务人员排查“这条成片到底推到哪些账户、成功了几个、失败原因是什么”的入口。
推送能力依赖成片库、广告账户、本地网关和外部平台授权。
当前系统已经不再由云端直接执行成片推送,而是统一改为本地网关认领和执行。因此,推送记录本质上是“云端业务状态 + 本地网关执行结果”的组合视图。
如果业务涉及平台卡审,推送记录还要和成片库里的平台卡审状态一起看。内部审核通过只代表企业内部交付通过,不代表外部平台审核一定通过。
推送上传模式
本地网关认领推送任务后,会从共享盘读取成片文件,并按云端下发的上传上下文选择执行方式:
| 模式 | 行为 | 适用场景 |
|---|---|---|
| 云端代理 | 本地网关把文件流式上传到云端,由云端继续调用平台上传接口 | 默认兼容链路,平台 token 不下发到地区机器 |
| 本地直传 | 本地网关向云端换取本次上传 token 后,直接调用巨量等平台素材上传接口 | 大文件、跨公网代理不稳定或需要减少云端中转时 |
两种模式都不改变业务记录入口。业务人员仍然从成片库发起推送,在推送记录里看结果。
列表重点字段
- 视频名称:确认推送的是哪条成片。
- 平台:当前推送目标平台。
- 区域:用于区分不同区域或环境的推送链路。
- 广告账户:本次推送涉及的广告主或账户。
- 账户数、成功数、失败数:判断批量推送结果。
- 任务状态:待处理、已认领、处理中、部分成功、成功、失败。
- 平台卡审:外部平台侧审核卡住或未通过时的后续跟进状态。
- 提交人、创建时间、完成时间:用于追溯操作人和处理时效。
详情里看什么
推送详情会展示任务状态、认领网关、重试次数、失败原因和账户明细。
账户明细里要重点看:
- 广告主 ID 和账户名称。
- 单账户推送状态。
- 平台视频 ID 或平台素材 ID。
- 失败原因。
- 外部平台返回的响应载荷。
- 上传模式、重试次数、平台素材 ID 和网关回写的原始错误摘要。
标准处理流程
- 在成片库对审核通过的成片发起推送。
- 推送任务进入记录列表。
- 本地网关认领任务并执行推送。
- 外部平台返回每个账户的结果。
- 云端汇总成功数、失败数和最终状态。
- 失败时进入详情查看原因,必要时重新推送。
什么时候可以重新推送
建议只在明确失败原因后重新推送:
- 授权过期:先刷新或重新授权广告账户。
- 账户不可用:先确认广告主状态。
- 平台卡审:先确认外部平台审核原因、账户资质和素材规格,不要盲目重复推送。
- 网关异常:先恢复网关和推送执行器。
- 外部平台临时错误:确认不是参数问题后再重试。
常见异常
一直待处理
优先检查本地网关推送心跳是否正常,是否有网关认领任务。
部分成功
进入详情看账户明细。通常是部分广告账户授权、资质、平台规则或素材参数不满足要求。
推送失败但成片没问题
成片本身通过审核只代表内部质量达标,外部平台还可能因为账户授权、平台卡审、素材规格或接口限制失败。
云端显示已创建但长时间没人认领
优先检查目标地区网关是否在线、推送共享密钥是否一致,以及该区域是否允许当前任务被认领。
频率超限或请求过于频繁
巨量等平台可能返回 429、频率超限、请求过于频繁、too many requests 或 rate limit。当前网关会对这类临时错误做退避重试,但如果批量账户过多,仍建议降低并发、拉开推送间隔,或分批处理。
平台素材 ID 显示异常
平台返回的大整数 ID 应按字符串保存和展示。若看到科学计数法、尾号不对或平台 ID 无法复制核对,优先检查推送回调和前端展示是否把 ID 当成普通数字处理。
继续阅读
- 网关依赖:读 本地网关协同
- 任务来源:读 视频成片库页面
- 账号依赖:读 广告账户与投放账号体系