腾讯广告创意管理

解决的问题

在腾讯广告投放中，管理展示广告的动态创意（组件化创意）是一个复杂过程。广告主需要处理多种创意组件（如图片、视频、文案），但面临以下挑战：

• 参数验证繁琐：创意创建涉及必填字段校验、创意数量上限、组件联动约束等，手动操作容易出错。
• 跨平台兼容性：在不同操作系统和终端下传递 JSON 参数时，引号包裹方式各异，导致解析失败。
• 素材管理割裂：上传、查询、授权素材需要多个接口，流程分散。
• 商品模板集成：使用动态商品广告（MPA/DPA）时，需要从商品库生成素材，流程独立但复杂。

该技能旨在通过脚本化工具解决这些问题，提供自动化、标准化的创意管理流程。

技能如何工作

技能基于腾讯广告营销 API v3.0，通过一系列 Node.js 脚本实现核心功能。关键步骤包括：

素材准备

若已有素材（如 image_id、video_id），直接使用；否则，通过脚本上传或查询：

• 上传素材：使用 scripts/upload-image.mjs 或 scripts/upload-video-svp.mjs，支持图片（jpg/png/gif ≤10MB）和视频（mp4/mov/avi ≤100MB）。
• 查询素材：提供两种模式：

- 素材库模式：使用 scripts/get-integrated-media.mjs，支持可用性过滤、报表排序等。
- 组件模式：使用 scripts/get-integrated-components.mjs，按组件粒度查询，可直接获取 component_id。

商品模板生成素材

对于动态商品广告，可从商品库模板生成素材：

• 查询模板：使用 scripts/dynamic-product-templates/get-dynamic-ad-image-templates.mjs 或 get-dynamic-ad-video-templates.mjs。
• 生成素材：使用 generate-dynamic-ad-image.mjs 或 generate-dynamic-ad-video.mjs，返回的 image_id 或 video_id 可用于创意组件。

创建创意

核心流程分三步：

1. 查询广告组上下文：使用 scripts/query-adgroup-context.mjs，获取广告组信息如 marketing_asset_outer_spec。
2. 查询创意形式及约束：使用 scripts/get-creative-templates.mjs 和 scripts/get-component-depends.mjs，确定可用创意模板和组件联动规则。例如，live_promoted_type 的填写依赖于 live_promoted_type_list。
3. 获取并构建组件：通过 scripts/get-component-list.mjs 或 scripts/get-components.mjs 获取 component_id，遵循选择规则（用户指定 > 唯一可用 > 询问用户）。然后使用 scripts/build-creative-params.mjs 预处理参数，最后调用 scripts/create-creative.mjs 创建创意。

其他操作如更新、删除创意，使用对应脚本 update-creative.mjs、delete-creative.mjs。

注意事项

使用该技能需注意：

• 串行执行约束：同一广告组下的创意操作必须串行执行，不可并发，以避免冲突。
• 禁止修改用户意图：用户指定的参数值必须原样传递，若脚本不支持，需明确报错，不得擅自使用默认值。
• 跨平台 JSON 传递：在不同终端（如 Linux、Windows CMD、PowerShell）传递 JSON 参数时，需遵循正确的引号包裹规则，否则会导致解析错误。例如，在 Windows PowerShell 5.x 中必须使用 --% 停止解析符。
• 组件选择规则：获取组件列表后，严禁随机取第一个；必须按用户指定、唯一可用或询问用户决策。
• 可选组件规则：未经用户许可，禁止自行添加 required=false 的组件（如浮层、标签等）。
• 素材授权管理：使用 scripts/grant-assets.mjs 等脚本处理跨账户素材授权，但取消授权不可逆。

该技能适用于需要高效管理腾讯广告动态创意的广告主和运营团队，但需确保环境配置正确（如 Node.js ≥ 20）并理解业务规则。