B站三连广告元数据查询
将以下提示词粘贴到你的 AI 对话框中:
请根据 https://skillhub.cn/install/skillhub.md,安装 @user_b0010d5c/sanlian-ads-metadata。
技能介绍
解决的问题
B站三连广告保存请求里有大量 access_token、advertiser account_id、枚举和资源 ID:推广目的、推广内容、优化目标、定向、落地页、素材都只对特定账户和投放场景有效。如果先猜参数再提交,保存失败或保存成非预期配置都很常见。
工作方式
这是一个只读元数据查询技能,用于在构造保存请求前确认“当前账户此刻能选什么”。调用 MAPI 前先确认 access_token 和广告主 account_id,请求头带 Authorization: Bearer {access_token} 和 X-Call-Source: sanlian-skills。查询应按依赖链进行:
507查询计划可用推广目的512查询单元可用推广内容513/522查询优化目标与二阶段最低出价区间520查询定向维度514、519、518、515、516、517、1697查询应用、游戏、商品、直播、小程序/小游戏等推广对象527查询 legacy 创意投放位置;2.0 的 placement 来自交付模板组端点531、529、530、532~535、1829、537、1887、1942、1722查询稿件、动态、试玩素材、落地页、卖点和稿件组件
每次只查一个端点,检查响应后再继续;同一账户在任务内复用结果,空结果表示账户不可用该资源,不能回退硬编码。公开稿件信息使用 api.bilibili.com/x/web-interface/view,不要求广告主身份,也不自动触发 MAPI 素材查询。
使用场景
- 构造广告保存请求前,查询当前账户可用的推广目的和推广内容枚举值
- 确认账户可投放的直播间、商品、应用等推广对象及其资源 ID
- 配置定向与优化目标前,查询可用定向维度、CPA 目标及二阶段最低出价区间
- 筛选可投放稿件、动态或试玩素材前,查询资源列表并获取对应的 media_id
适合人员
- 对接 B站三连广告 MAPI 的后端工程师,需在保存请求前确认各字段的枚举值和资源 ID
- 负责广告创编配置的运营,需查询当前账户可投放的素材、落地页和定向参数
- 构建广告自动化投放流程的开发者,需按依赖链顺序获取推广目的、内容和推广对象
- 排查广告保存失败原因的工程师,需定位哪个元数据端点返回了空结果或非法值