Metadata

name: yufluentcn-ad-optimize
description: Cross-border paid ads optimization coach across five dimensions (targeting, creatives, bidding, landing page, analytics) via Yufluent cloud Harness. Use for 广告投放优化、Meta/TikTok/Google 广告、ROAS、受众定向、素材测试、落地页、Pixel 归因.
version: 1.1.2
author: 元畅 · Yufluent
metadata: {"category":"ecommerce","tags":["ads","meta","facebook","instagram","tiktok","google","roas","yufluent","b2b"],"billing":"yufluent","languages":["zh","en","es","de","fr","ja"],"homepage":"https://claw.changzhiai.com","license":"MIT","openclaw":"{\"requires\":{\"env\":[\"TOKENAPI_KEY\"]},\"primaryEnv\":\"TOKENAPI_KEY\",\"install\":[{\"id\":\"deps\",\"kind\":\"pip\",\"label\":\"Install requests\",\"packages\":[\"requests>=2.31.0\"]}]}"}

广告投放优化

跨境 Meta / TikTok / Google 广告投放五维优化教练。ClawHub / OpenClaw 用户使用云端模式 — Harness 在 Yufluent 服务端执行，本机只需 TOKENAPI_KEY（tk-*）与 requests。

快速开始（3 步，60 秒）

注册获取 API 密钥 → https://claw.changzhiai.com/login （新用户即送体验积分，无需绑卡）
设置环境变量：export TOKENAPI_KEY=*** 或写入 .env 文件
运行：参照下方 Examples 示例执行 python scripts/run.py ...

还没注册？前往 https://claw.changzhiai.com/login 免费获取密钥。

OpenClaw 与 Yufluent（必读）

OpenClaw 对话与技能调用共用同一 tk-*。接入见 https://claw.changzhiai.com/app/openclaw 。

层	走哪里	干什么
OpenClaw 对话	Yufluent `/v1/chat/completions`（同一 tk-*）	理解意图、选维度/渠道、调 `run.py`、整理回复
优化方案正式输出	`POST /v1/skills/ad-optimize/run`（同一 tk-*）	Harness + 五维策略 → 优化方案正文

Agent 硬性规则：

禁止用对话模型自行撰写完整投放优化方案（受众表、素材矩阵、预算表、A/B 方案等长文）。
必须通过 python scripts/run.py ...（或 POST /v1/skills/ad-optimize/run）获取输出。
对话模型仅用于：确认渠道与维度、收集 metrics / market / context、解释结果、建议下一步。
只需 TOKENAPI_KEY，不要要求用户另配厂商 LLM Key。

Instructions（Agent 工作流）

确认渠道：meta（Facebook/Instagram）/ tiktok / google / multi（跨渠道）。
选择 dimension（见下表）；未说明时根据 message 推断（如 ROAS 低 → bidding 或 analytics；素材疲劳 → creatives）。
收集上下文：
- message（必填）
- product：产品或品类
- market：目标市场（如 Vietnam、美国）
- metrics：ROAS、CTR、CPC、CPA、花费等快照
- context：账户阶段、预算、近期已尝试动作

调用（必须 — 云端）：

python scripts/run.py \
  --dimension bidding \
  --platform meta \
  -m "ROAS 从 2.1 降到 1.4，请给预算重组建议" \
  --product "宠物牵引绳" \
  --market "Vietnam" \
  --metrics "7d spend $800, ROAS 1.4, CPA $12" \
  --lang zh

计费：402 余额不足；401 密钥无效。

五维优化（dimension）

dimension	核心问题	典型输出
`targeting`	找对人	受众分层、再营销、Lookalike、排除清单
`creatives`	说对话	素材测试矩阵、文案变体、版位 brief
`bidding`	出对价	出价策略、预算倾斜、时段系数
`landing`	接住人	落地页审计表、速度/一致性/结账检查
`analytics`	做对决策	Pixel 检查、A/B backlog、归因与周复盘

与其他技能联动

需求	技能
落地页产品文案	`yufluentcn-ecommerce-listing`
落地页 SEO 关键词	`yufluentcn-seo-pro`
评论洞察驱动素材	`yufluentcn-review-intel`
独立站全店运营	`yufluentcn-shopify-operator`

本技能不直连 Ads Manager、不自动改出价、不代投。

环境变量

变量	必填	说明
`TOKENAPI_KEY`	是	`tk-*`
`TOKENAPI_BASE_URL`	否	默认 `http://localhost:8080/v1`

触发词

"广告投放优化"
"Facebook 广告 ROAS 低"
"TikTok 素材怎么测"
"再营销受众怎么设"
"落地页转化差"
"Pixel 转化追踪"
"越南市场投放时段"
"A/B 测试方案"

Examples

定向 — Meta 再营销

python scripts/run.py \
  --dimension targeting \
  --platform meta \
  -m "加购未下单用户很多，请给再营销分层方案" \
  --market "Vietnam" \
  --lang zh

素材 — TikTok 本土化

python scripts/run.py \
  --dimension creatives \
  --platform tiktok \
  -m "CTR 下滑，请给 4 周素材轮换测试表" \
  --product "美妆套装" \
  --market "Vietnam" \
  --lang zh

数据 — 跨渠道归因

python scripts/run.py \
  --dimension analytics \
  --platform multi \
  -m "FB 和 Google 都在投，如何看归因和分配预算？" \
  --metrics "FB ROAS 1.8, Google ROAS 3.2, MER 2.1" \
  --lang zh

合规声明

方案需人工审核后在广告平台执行
遵守各平台广告政策与目标市场法规
不虚构投放数据或已修改账户状态

版本记录

版本	日期	变更
v1.1.0	2026-06-14	SKILL.md added quickstart registration guide; 401/402 error messages now in Chinese with register links
v0.1.0	2026-05-28	初始五维广告投放优化技能

Yufluent Clawhub Publish Yufluentcn Ad Optimize

安装技能