SuperAPI AI 工具集

adcp-governance

营销与增长

查看项目

更新于 10-15 10:04

技能介绍

AdCP Governance Protocol 技能用于与治理代理执行 AdCP 治理协议操作,覆盖四个领域:属性列表(站点级定向)、集合列表(节目级定向)、内容标准(品牌安全规则)和广告活动治理(计划、检查、结果、审计轨迹)。买方侧的基础内容(幂等重放、oneOf 变体、异步 status:'submitted' 轮询、从 adcp_error.issues[] 恢复错误)位于 skills/call-adcp-agent/SKILL.md,本技能仅覆盖各任务的语义。

一、用途与总体结构 治理协议在四个领域提供 21 个标准化任务。

属性列表(Property Lists):create_property_list(创建包含/排除列表,约 1s)、update_property_list(修改列表过滤器/属性,约 1s)、get_property_list(检索列表,可选解析,约 1-5s)、list_property_lists(列出所有可访问列表,约 1s)、delete_property_list(删除列表,约 1s)。

集合列表(Collection Lists):create_collection_list(创建节目级列表,约 1s)、update_collection_list(修改列表,约 1s)、get_collection_list(检索,可选解析,约 1-5s)、list_collection_lists(列出所有可访问列表,约 1s)、delete_collection_list(删除列表,约 1s)。

内容标准(Content Standards):create_content_standards(创建品牌安全规则,约 1s)、get_content_standards(按 ID 检索标准,约 1s)、update_content_standards(修改规则,约 1s)、list_content_standards(列出所有可访问标准,约 1s)、calibrate_content(用测试内容验证标准,约 5-30s)、get_media_buy_artifacts(获取创意用于合规审查,约 5s)、validate_content_delivery(审计投放合规性,约 10-60s)。

广告活动治理(Campaign Governance):sync_plans(推送或更新带预算授权与策略的广告活动计划,约 1s)、check_governance(针对计划验证动作,意图或执行,约 1-5s)、report_plan_outcome(上报已完成动作以推进计划预算状态,约 1s)、get_plan_audit_logs(检索治理状态、预算跟踪与审计轨迹,约 1-5s)。广告活动治理在 3.0 中为实验性功能,可能在 3.x 版本间变化,但会提前至少 6 周通知。卖方必须在 experimental_features 中声明 governance.campaign 才能参与。

二、主要能力与典型工作流 属性列表(站点级):用 create_property_list 创建带基础属性与过滤器的列表;用 get_property_list 配合 resolve: true 查看匹配的属性;用 update_property_list 调整过滤器;在 create_media_buy 定向中引用 list_id 应用。

集合列表(节目级,CTV):用 create_collection_list 创建带分发 ID 或类型过滤器的列表;用 get_collection_list 配合 resolve: true 查看匹配的节目;在 CTV 品牌安全的广告活动定向中引用。

内容标准:用 create_content_standards 创建带规则的标淮;用 calibrate_content 以测试样本验证配置;用 get_media_buy_artifacts + validate_content_delivery 进行持续合规监控。

广告活动治理:通过 sync_governance(位于 Accounts 协议)将治理代理同步到卖方账户;用 sync_plans 注册计划,包含预算授权、渠道分配和已解析的策略 ID;用 check_governance 对意图(预发现)和执行(预购买)验证动作,返回不透明的 governance_context 令牌,卖方在后续检查中回传;用 report_plan_outcome 上报结果以推进已承诺/剩余预算;用 get_plan_audit_logs 按 governance_contexts 过滤,为请求方生成可共享视图。

三、使用方式(任务要点) create_property_list:关键字段 name(必填)、description、base_properties(publisher_tags、publisher_ids 或 identifiers)、filters(countries_all、channels_any、property_types、feature_requirements、exclude_identifiers)、brand。

update_property_list:list_id(必填)、name/description、base_properties、filters。

get_property_list:list_id(必填)、resolve(默认 false)、max_results。

list_property_lists:name_contains、max_results。

delete_property_list:list_id(必填)。

create_collection_list:name(必填)、base_collections(distribution_ids、publisher_collections 或 publisher_genres)、filters(content_ratings_exclude/include、genres_exclude/include、kinds、production_quality)、brand。分发标识类型:imdb_id、gracenote_id、eidr_id。

update_collection_list:list_id(必填)、base_collections、filters。

get_collection_list:list_id(必填)、resolve、max_results。

list_collection_lists:name_contains。

delete_collection_list:list_id(必填)。

create_content_standards:name(必填)、rules(rule_type、action 为 allow/block/flag、value、severity)、brand。

get_content_standards:standards_id。

update_content_standards:standards_id、rules。

list_content_standards:name_contains。

calibrate_content:standards_id(必填)、samples(必填,含 url 和/或 text,可选 expected_result)。

get_media_buy_artifacts:media_buy_id(必填)、sales_agent_url(必填)。

validate_content_delivery:standards_id(必填)、media_buy_id(必填)、sales_agent_url(必填)、date_range(可选)。

sync_plans:plan_id(必填)、plan_version(必填,每次修改递增,检查绑定到版本)、budget.authorized(必填,该计划所有受治理动作的总支出权限)、policies(可选,注册表策略 ID;内联 custom_policies 可增加限制但不能放宽注册表策略)、human_review_required(可选,强制所有动作人工审核;当任何已解析策略的 requires_human_review 为 true 时自动设为 true)。

check_governance:在生命周期中调用两次,一次在意图(预发现),一次在执行(预购买)。卖方必须使用通过 sync_governance 同步的凭据独立调用执行检查。关键字段 purchase_type(必填,media_buy、rights_license、signal_activation 或 creative_services)、governance_context(可选,同一受治理动作后续检查回传)、tool(必填)、payload(必填,完整请求体)。响应状态为 approved、denied 或 conditions;denied 时读取 governance_context.findings[] 定位失败规则并修正 payload。

report_plan_outcome:governance_context(必填)、outcome(必填,completed、cancelled、failed 或 delivery)、committed_budget(completed 时必填)。

get_plan_audit_logs:plan_ids / portfolio_plan_ids / governance_contexts(至少一个)、include_entries(可选,默认 false 仅返回摘要)。生成可共享视图时,将 governance_contexts 过滤为请求方的动作,并在转发前剥离计划级聚合(budget.、channel_allocation.、summary.drift_metrics)。

四、关键概念 属性列表 vs 集合列表:属性列表为站点级定向,作用于发布方域名与属性(网站、应用、CTV 应用),用于广告出现的“位置”;集合列表为节目级定向,作用于节目、剧集与内容节目,使用分发标识(IMDb、Gracenote、EIDR),用于广告出现的“内容”(主要面向 CTV)。

内容标准 vs 属性/集合列表:内容标准是基于规则的内容质量、主题与安全评估,动态评估内容;属性/集合列表是预先计算的已批准或排除库存集合,在广告活动设置时静态应用。

过滤器解析:属性与集合列表将静态选择与动态过滤器结合。在 get 操作中使用 resolve: true 查看最终解析的属性或集合集合。

审计与披露决策的三条不变量:内联策略仅对注册表策略做加法,买方自定义 custom_policies 可增加限制,但不得放宽、覆盖或禁用注册表策略;governance_context 是卖方可见的关联令牌,完整计划/预算数据属于买方侧,卖方只看到被发放的不透明令牌及其范围内的条目,计划级总计(budget.authorized、channel_allocation、drift_metrics)属于买方内部视图,默认不共享;plan_hash 是加密证明面,为 base64url_no_pad(SHA-256(JCS(plan_payload))),作用于检查所评估的计划修订版,任何持有该计划修订版的方可重新计算并逐字节比较。

五、适用场景与限制 适用于广告技术中品牌安全与库存定向管理、CTV 节目级品牌安全、内容合规审查与投放审计,以及广告活动预算授权与治理审计。限制:广告活动治理在 3.0 中为实验性,可能在 3.x 版本间变化(提前至少 6 周通知),卖方须声明 governance.campaign 才能参与;本技能仅覆盖各任务语义,买方侧基础内容见 skills/call-adcp-agent/SKILL.md。