微信小店广告素材矩阵

适用场景

当商品视频准备进入微信小店直购广告或全域投放流程，需要把视频、单图、多图和横版素材映射到计划版位时使用。它把官方投放流程中的授权、选商品、创意和落地页准备整理成可复核矩阵。

输入与输出

• - 输入：脱敏商品 ID、授权状态、目标版位和素材元数据；素材含 asset_id、kind、aspect_ratio、product_id。
• 输出：JSON 与 Markdown 版位矩阵，含覆盖情况、缺口、阻断原因和人工提交锁。

执行规则

先确认商品授权为 true，再按目标版位所需的素材类型和长宽比匹配素材。默认参考矩阵为视频号竖版 9:16、朋友圈单图 1:1、公众号横版 16:9；多图版位要求 image_count 达到策略值。未知版位进入 review，不猜测平台当前规格。

安装与执行

仅需 Python 3.9+ 标准库：python scripts/build_asset_matrix.py examples/input.json --output asset_matrix.json --markdown asset_matrix.md。

错误恢复

补齐授权登记或对应版位素材后重跑；平台规格变化时更新目标矩阵。通过本地检查也不等于广告后台已保存、审核通过或开始投放。

权限与隐私

脚本只处理脱敏商品、授权和素材标签，不联网、不读取账号、支付、客户或订单资料。发起授权、上传素材、创建广告和预算设置必须由有权限人员人工完成。

验收

示例应输出 pass 且 platform_submit_required=true；授权为假、商品 ID 错配或版位素材缺失时应输出非零退出码。