腾讯常规广告创建指南

腾讯广告的常规广告组创建是一个多步骤、强依赖的流程。每一步的输出都是下一步的输入，从“四元组”的确定到最终的广告组创建，涉及多个 API 交互和业务判断。直接使用原生 API 或 CLI 命令会面临参数组合验证、跨平台脚本调用格式差异等复杂问题。

## 核心流程与脚本化执行

本技能将整个流程封装为 7 个顺序执行的步骤。核心能力在于使用专用脚本（基于 tencentads-cli）来处理所有 API 调用、数据格式转换和业务规则校验，让 Agent 专注于从业务数据中做出决策。

1. 步骤 1（获取四元组）：这是流程的起点。通过 get-rules.mjs 脚本查询当前账号下所有可用的四元组组合（marketing_goal, marketing_sub_goal, marketing_target_type, marketing_carrier_type）。Agent 需要根据用户描述的营销意图（如“电商推广”、“线索收集”）从返回的组合中筛选出正确的一组。禁止猜测，必须基于脚本返回的枚举值。
2. 步骤 1A（资产反推，可选）：当四元组无法唯一确定，但用户提供了推广产品名称或 ID 时，此步骤可通过 get-assets-by-rules.mjs 查询账户下的资产列表，通过资产反向匹配来精确锁定四元组，避免向用户进行确认交互。
3. 步骤 2（获取推广产品与载体）：调用 get-assets.mjs 获取具体的资产 ID（asset_id）和载体 ID（carrier_id）。脚本会自动处理不同资产类型（如 ONEID、商品库）的路由。
4. 后续步骤（3-6）：包括版位设置、转化目标配置（根据出价方式 CPC/CPM 或 oCPM/oCPC 走不同路径）、定向设置，以及最终调用 create-adgroup.mjs 创建广告组。每一步都可能需要根据上一步的结果进行业务选择。

## 关键规则与适用边界

遵循本技能有几条铁律，违反会导致流程中断或错误：

• 严格顺序执行：步骤 1、2 是基础，必须首先完成。后续步骤严重依赖前序输出，不可跳步。
• 出价方式决定路径：CPC/CPM 出价可以简化步骤 3（直接开启自动版位）和跳过步骤 4 中的转化查询；而 oCPM/oCPC 则需完整执行步骤 3 和 4。
• 参数传递的跨平台陷阱：脚本调用格式 node scripts/.mjs '' 在不同操作系统终端（Bash, CMD, PowerShell）下，JSON 参数的引号处理规则完全不同。技能文档已明确列出各种场景的正确写法，尤其是 Windows PowerShell 5.x 环境需要特殊处理。
• 错误处理：每个脚本调用最多重试 1 次。如果两次仍失败，必须跳过该步骤，用已有数据继续推进，避免陷入重试循环。

本技能适用于需要规范化、可重复创建腾讯常规广告组的场景。它不适合用于智投（AIM+）广告（标识和参数结构不同），也不适合需要跳过标准流程进行快速或特殊设置的场景。所有 API 操作均被封装在脚本中，不应绕过脚本直接使用 tencentads-cli api 进行调用。