Agent Skills
返回列表
B站三连广告元数据查询

B站三连广告元数据查询

企业运营 更新于 2026.08.30

将以下提示词粘贴到你的 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
  • 负责广告创编配置的运营,需查询当前账户可投放的素材、落地页和定向参数
  • 构建广告自动化投放流程的开发者,需按依赖链顺序获取推广目的、内容和推广对象
  • 排查广告保存失败原因的工程师,需定位哪个元数据端点返回了空结果或非法值