腾讯营销投放-智投
将以下提示词粘贴到你的 AI 对话框中:
请根据 https://skillhub.cn/install/skillhub.md,安装 @tencent-adm/tencentads-delivery-smart-create。
技能介绍
背景与问题
在腾讯广告平台手动创建一条智投广告涉及多个相互依赖的字段与枚举值,包括场景识别、四元组匹配、资产关联、转化目标选择及出价策略。其中,rules_json 返回的嵌套结构、不同账号的准入限制以及跨平台参数传递的差异,使得自动化创建过程充满陷阱。错误的字段选择会引发 API 报错,而低效的轮询或重试策略则可能耗尽执行轮次。
核心能力与工作流程
该技能通过一个强制顺序执行的七步流程,将智投广告创建过程结构化、脚本化。
- 脚本化 API 交互:所有 API 调用(如
get-rules.mjs、get-assets.mjs)均由专用脚本封装,脚本负责处理路由、数据裁剪和格式转换。Agent 专注于基于返回结果的业务决策,例如从多个组合中选择正确的四元组。 - 不可跳过的前三步:
步骤1(确定场景):根据用户意图匹配 smart_delivery_platform 枚举,例如小游戏推广对应 SMART_DELIVERY_PLATFORM_EDITION_MINI_GAME_PROMOTION。
步骤2(获取四元组):调用 get-rules.mjs 获取当前账号可选的 marketing_goal、marketing_sub_goal、marketing_target_type、marketing_carrier_type 组合。严禁猜测,必须从返回的 combinations 列表中按优先级(如通过资产ID反推、用户意图关键词)选定唯一组合。
* 步骤3(获取推广产品+营销载体):基于选定的 marketing_target_type,调用 get-assets.mjs 获取可用资产列表。最终输出一个 flat_params 对象,其字段(如 asset_id, carrier_id)将直接透传给最终创建脚本。
- 关键决策点:在后续步骤中,Agent 需根据用户输入(如ROI系数、出价金额、转化来源)和系统返回(如
site_set列表、conversion_id列表)做出选择。例如,conversion_id只能来自查询结果或用户明确提供。 - 严格的执行协议:
步骤间强依赖:进入下一步前,必须确认所需数据来源于上一步的输出或用户明确输入,不可使用自然语言描述替代结构化字段。
错误处理与重试限制:每个脚本调用最多重试 1 次。若两次尝试均失败,则跳过该步骤并用已有数据继续,避免陷入死循环。
* 显式证据白名单:仅步骤4-6的查询子动作,在用户明确给出完整ID或已在当前会话获取时才允许跳过,步骤1-3 无此豁免。
适用边界与注意点
- 前置依赖:执行前必须安装
tencentads-cli(Node.js ≥ 20)。 - 跨平台兼容:脚本调用格式
node scripts/.mjs ''在不同终端有差异,需遵循文档中的转义规则,尤其注意 Windows PowerShell 5.x 的--%停止解析符。 - 场景与枚举强关联:场景枚举名可能与中文业务名不一致(如
SINGLE_PRODUCT对应“短直双开”),务必参考步骤1的表格进行精确匹配。 - 决策透明性:进入步骤7前,必须能回溯每个关键字段(如
conversion_id、asset_id)的来源(用户提供或前序步骤脚本返回),禁止凭空编造。
使用场景
- 需要为新的微信小游戏推广项目,在腾讯广告平台创建一条从0开始的、符合平台最新规则的智投广告,并确保所有参数(四元组、资产、转化目标)配置正确。
- 接到一个临时推广需求,需要快速搭建并测试多组智投广告计划,使用脚本批量执行创建流程,避免在复杂的手动界面中出错或浪费时间。
- 准备将一条现有的、基于旧规则或手动设置的智投广告进行迁移或重建,需要按照最新的7步执行协议,系统性地获取并填充所有必要参数。
- 在进行跨平台(如从Windows切换到macOS)开发或部署时,需要调用智投广告创建脚本,并严格遵守不同终端下的JSON参数转义规则以避免报错。
适合人员
- 负责多个腾讯广告账户日常投放与优化的广告优化师,需要快速、准确地搭建和调整智投广告计划,减少手动操作失误。
- 营销技术或增长团队的工程师,需要将广告创建流程自动化、标准化,并集成到内部的投放管理系统或工作流中。
- 没有专门投放团队的中小企业主或项目负责人,需要亲自上手操作广告后台,创建符合业务目标的智投广告并控制成本。
- 在不同操作系统环境下(如Windows、Linux)进行广告相关脚本开发或执行的技术人员,需要处理跨平台的命令行调用问题。