首页 AI Claude 自动生成 TikTok 广告日报与异常诊断(2026):report_integrated_get、官方诊断代理与归因窗口怎么用

Claude 自动生成 TikTok 广告日报与异常诊断(2026):report_integrated_get、官方诊断代理与归因窗口怎么用

让 Claude 通过 TikTok 官方 MCP 自动出日报:report_integrated_get 报表参数、30 天日维度上限、异步报表、tiktok_ads_diagnosis_agent 官方诊断代理与归因窗口对比,附只读 claude -p 定时任务和诊断提示词。

最后更新:2026-11-16(TikTok API for Business v1.3、TikTok for Business MCP Server、Anthropic、OpenAI 官方文档均于当天查阅)

投手每天最花时间的,往往不是调广告,而是拉数、对比、找异常。通过 TikTok 官方的 TikTok for Business MCP Server,Claude 可以直接调用报表工具和官方诊断代理,把这部分工作自动化(MCP 概览)。本文只讲只读部分:看数、诊断、提建议,不改任何东西。全流程见 Claude 操作 TikTok 广告投放全流程自动化。

报表工具怎么选

  • report_integrated_get:同步报表,对应 /report/integrated/get/,适合日报、周报。
  • report_task_create + report_task_check + report_task_download:异步报表,适合大数据量;异步创建接口在所有级别都是 2 QPS、60 QPM(
  • Rate limits
  • )。
  • creative_report_get、report_video_performance_get:素材与视频表现。
  • gmv_max_report_get:GMV Max 系列请用专用报表,普通报表不覆盖。

同步报表的关键参数

参数含义注意
report_type报表类型,如 BASIC受众、商品等用其他类型
data_level数据层级,如 AUCTION_CAMPAIGN/AUCTION_ADGROUP/AUCTION_AD按需要的粒度选
dimensions分组维度,如 campaign_id + stat_time_day按天(stat_time_day)时最长 30 天
metrics指标,如 spend、impressions、clicks、ctr、cpc、conversion不传时默认 spend、impressions
start_date / end_date日期范围按帐户时区
page / page_size分页page_size 1–1000
TikTok 同步报表 report/integrated/get 主要参数表

官方说明:同步报表最多支持 20,000 条广告的数据;按 stat_time_day 拆天时日期范围最长 30 天;响应头里的 X-Tt-Ads-Throttle 会提示限流(Run a synchronous report)。

官方诊断代理:tiktok_ads_diagnosis_agent

TikTok MCP 里有两个不直接对应 API 接口的工具。其中 tiktok_ads_diagnosis_agent 是官方的帐户优化分数(AOS)诊断代理,以 A2A(代理对代理)方式被调用,可诊断非 GMV Max 帐户、系列或广告组的效果问题,用自然语言输出结论,Claude 可以把它当成「第二意见」(工具清单)。

异常 → 先查什么

异常信号Claude 先查什么可能原因建议动作(人工确认)
花费突然下降系列/广告组状态、审核信息广告被拒、预算用完、帐户余额查 ad_review_info_get,补素材或余额
CPA 上涨按广告组和素材拆分、频次素材疲劳、定向过窄换素材、放宽定向
CTR 下降素材维度报表前 3 秒钩子变弱用创意测试代理做 A/B
转化掉零像素/事件、落地页事件断流、页面故障查事件管理与落地页
归因差异大1 天点击 vs 7 天点击对比决策周期长按归因窗口对比列复盘
TikTok 广告常见异常信号与 Claude 诊断顺序表

归因窗口对比是 2026 年 11 月 Ads Manager 的新功能,详见 TikTok 广告归因窗口对比上线:38 个新指标;搜索广告展示份额见 TikTok 搜索广告展示份额与关键词包;GMV Max 不投放的状态排查见 GMV Max 不投放怎么办?9 种素材状态。

诊断提示词模板

# 适合交给 Claude 的 TikTok 指令示例(先读后写)
1. 列出我能访问的广告主,以及每个帐户昨天的花费、点击和转化。
2. 用 tiktok_ads_diagnosis_agent 诊断广告主 <ID> 下 CPA 上涨最多的 3 个广告组,给出原因。
3. 为新品写 Smart+ 网站转化系列方案:命名、预算、素材清单;先不要创建。
4. 方案确认后,用 smart_plus_campaign_create 以 DISABLE 状态创建,并把返回的 ID 列出来。

第 3、4 条涉及写入,日报任务里不要放;需要建系列时按 Claude 操作 TikTok 广告投放全流程自动化 的权限设置走。

定时只读日报

用 claude -p 加 --allowedTools 只放行读工具,结果输出为 JSON 再推送给投手(headless 模式):

# read-only daily summary, only read tools allowed
claude -p "Use tiktok-ads to pull yesterday's spend, impressions, clicks, CTR, CPC and \
conversions by campaign for advertiser <ADVERTISER_ID> with report_integrated_get. \
Compare with the previous 7 days, flag anomalies, propose (do not apply) changes." \
  --allowedTools "mcp__tiktok-ads__report_integrated_get,mcp__tiktok-ads__campaign_get" \
  --output-format json > tiktok-summary.json

如果你的团队更习惯脚本 + 模型总结,可以用 Codex 写拉数脚本,见 用 Codex 写 TikTok Marketing API 报表脚本与限流处理。

三个容易出错的地方

  • 授权过期:MCP 授权 30 天有效,定时任务突然失败先看是否需要重新授权。
  • 工具找不到:用 layer 版时报表类工具可能需要按需发现;或 Claude 未加载全部工具,刷新工具列表即可,见
  • Claude 连接 TikTok 广告常见问题排查
  • 。
  • 口径不一致:帐户时区、归因窗口、币种不同,跨帐户汇总前先统一口径。

熊猫出海如何用 Claude、Codex 和 TikTok 广告帐户帮客户提升投放效率

这篇讲的是 Claude,但在实际服务中,熊猫出海会把 Claude、Codex 和 TikTok 广告帐户组合起来,帮出海企业更快跑完「开户与像素/事件 → 搭 Smart+ 系列 → 素材上传与预审 → 看报表与诊断 → 调预算与规则」这套重复工作,让投手把时间花在素材策略、出价判断和放量节奏上。

  • 广告帐户:使用企业自有的 TikTok 海外户;需要行业准入的(如游戏、金融等)按 TikTok 政策申请加白户;也可通过授权代理商开通海外代理户。所有帐户以企业真实主体开通、归企业使用,不出租、不共享,多帐户通过企业自己的商务中心(BC)管理。
  • Claude:通过 TikTok 官方 TikTok for Business MCP Server 用自然语言查报表、调用官方诊断代理、整理素材与 Smart+ 建系列方案,写入类工具一律先确认再执行。
  • Codex:写和维护 Marketing API v1.3 的 Python 脚本(报表拉取、限流重试、Smart+ 以 DISABLE 状态批量创建、request_id 幂等),在沙盒里运行并接入定时任务。
  • 人工把关:开启投放、提预算、改出价都由投手审核后执行;素材与落地页是否符合 TikTok 广告政策由人工最终确认。

这是一项服务能力说明,不涉及任何价格或返点承诺;我们也不是 TikTok、Anthropic 或 OpenAI 的官方合作伙伴。开户与代投流程请看 TikTok 广告开户与投放(熊猫出海服务页)。

常见问题

Claude 看数会不会改到我的广告?

只要像本文这样只放行读工具(allowedTools 只写 report 与 get 类工具),Claude 无法调用写入工具。

能看 GMV Max 的数据吗?

可以,但要用 gmv_max_report_get;官方诊断代理也不覆盖 GMV Max。GMV Max 实操见 GMV Max 投放实操:授权、建计划与 ROI 目标。

报表数据和后台不一致?

先核对时区、归因窗口和 data_level;同一时间段按天拆分时最长 30 天。

多帐户怎么一起看?

用同一个 TikTok for Business 用户授权,并在企业自己的 BC 里给这个用户分配需要的帐户。

合规说明:本文所有自动化都应只用于企业自有或已获正式授权的 TikTok 广告帐户(含商务中心 BC 下分配给你的帐户),通过 TikTok 官方 TikTok API for Business、TikTok for Business MCP Server 或 TikTok 广告管理平台接入,遵守 TikTok 广告政策、行业准入要求与 API 限流,并在任何会产生花费的动作前保留人工审核。TikTok 海外户、加白户、海外代理户都应由广告主以真实主体和资质开通、归广告主使用;熊猫出海不出售、出租、共享或转让广告帐户、BC 或 API 凭据,不协助规避广告审核、行业准入、地区限制或身份验证,也不是 TikTok、Anthropic 或 OpenAI 的官方合作伙伴。Claude 与 OpenAI 服务仅向其支持国家/地区的客户提供,中国大陆与香港不在列表中,请由在支持地区合法设立并真实经营的主体开通并负责。

相关阅读

联系熊猫出海:TikTok 广告开户 + AI 自动化投放

告诉我们公司主体所在地、行业(是否需要行业准入/加白)、目标国家、落地页/App/TikTok Shop 链接和预计月预算,以及你想先自动化哪一段(报表、素材、Smart+ 建系列还是规则)。我们先做资质与素材预审,再协助企业合规开通 TikTok 海外户、加白户或海外代理户,并把 Claude / Codex 接入你的投放流程。

WhatsApp:+852 5904 8602Telegram:@PANDA0134微信:szcwh99

熊猫出海微信二维码 szcwh99

官方来源

以上官方页面均于 2026-11-16 查阅。API 版本、工具名称与权限要求会变化,请以官方页面为准。

本文来自网络,不代表熊猫出海立场。转载请注明出处: https://www.pandawm.com/blog/claude-tiktok-ads-reporting-diagnosis-agent-2026.html
上一篇
下一篇

作者: 熊猫出海编辑团队

熊猫出海(PandaWM)编辑团队,来自香港出海服务商熊猫出海,专注 Facebook、TikTok、Google 等海外广告开户与代投,以及 GEO/AI 搜索优化、多语言独立站建设。有Facebook白名单牌照户、TikTok加白户、Google G2认证户等核心资源 。

为您推荐

发表回复

联系我们

联系我们

工作时间:周一至周五,9:00-17:30,节假日休息

关注微信
微信扫一扫关注我们

微信扫一扫关注我们

关注微博
返回顶部