Ad Context Protocol (AdCP) 广告技能

概述

利用AI自动化您的广告活动。此技能使OpenClaw智能体能够通过自然语言命令，发现广告库存、启动广告活动、管理创意素材，并优化展示、视频、联网电视（CTV）、音频等多种渠道的广告表现。

无需使用仪表盘。无需填写表单。无需广告平台专业知识。

功能概览

• 🎯数分钟内启动广告活动- "创建一个针对加利福尼亚州科技专业人士的1万美元展示广告活动"
• 🔍即时发现广告库存- "为奢侈品牌寻找优质视频广告位"
• 🎨轻松上传广告素材- "将这些横幅图片作为创意素材上传"
• 📊实时追踪投资回报率- "按创意素材展示广告活动表现和点击率"
• 🎛️自动优化广告支出- "将预算重新分配给表现最佳的广告组合"
• 🌐精准定位- 人口统计特征、行为、兴趣、地理位置、设备、时间

完美适用于

营销团队运行Facebook广告、Google广告和多渠道营销活动
媒体采购人员管理跨发布商的程序化广告支出
广告代理商自动化客户活动管理和报告
电子商务品牌推出产品广告和再营销活动
初创公司利用AI驱动的自动化进行精益营销

为何选择此功能？

跳过学习曲线- 无需掌握复杂的广告平台
节省时间- 5分钟快速启动，无需数小时手动设置
更明智地支出- AI自动将预算优化至表现最佳的渠道
加速规模化进程- 通过简单指令管理无限量广告活动
无风险测试- 包含公共测试代理，无需设置

AdCP官方代码库：https://github.com/adcontextprotocol/adcp
AdCP官方文档：https://docs.adcontextprotocol.org
完整文档索引：https://docs.adcontextprotocol.org/llms.txt

使用本技能的时机

当用户询问以下内容时触发本技能：

广告活动管理

• "创建展示广告活动"
• "为我的产品投放Facebook广告"
• "设置5000美元的视频广告活动"
• "暂停表现不佳的广告活动"

广告发现与媒体购买

• "为奢侈品牌寻找广告库存"
• "展示主要城市的联网电视广告位"
• "有哪些展示广告选项可用？"
• "为一家科技初创公司购买媒体资源"

创意管理

• "上传这些横幅图片"
• "哪个创意表现最佳？"
• "向我的广告系列中添加视频广告"
• "管理我的广告库"

效果与优化

• "我的广告系列效果如何？"
• "按渠道展示投资回报率"
• "优化我的广告支出"
• "将预算重新分配给表现最佳的广告"
• "跟踪展示次数和点击率"

定向与受众

• "定向加利福尼亚州的专业人士"
• "设置人口统计定向"
• "创建一个重定向广告系列"
• "按设备类型和一天中的时间定向"

快速开始

启动你的首个推广活动（5分钟）

无需任何设置。使用内置的测试代理来尝试所有功能：

步骤一：探索可用资源

"Show me advertising capabilities"

浏览可用的渠道、发布者和广告格式。

步骤二：寻找广告库存

"Find display ads for a tech startup, budget $5000"

人工智能搜索并显示匹配的产品及其定价。

步骤三：启动推广活动

"Create campaign with Product prod_123, $5000 budget, targeting California tech professionals"

推广活动立即上线。

步骤四：上传你的广告

"Upload these banner images as creatives"

拖放文件，即刻获取创意ID。

步骤五：监控表现

"Show campaign metrics and ROI"

实时展示量、点击量、点击率、花费。

实际使用示例

快速启动推广活动：

User: "I need to run display ads for my SaaS product"
Agent: [Discovers products] "Found 5 display packages. Want details?"
User: "Create campaign with Product 1, $10k budget, target CTOs"
Agent: [Creates campaign] "Campaign live! ID: mb_abc123"

表现优化：

User: "How are my video ads performing?"
Agent: [Shows metrics] "Package A: 2.3% CTR, Package B: 0.8% CTR"
User: "Move $5k from B to A"
Agent: [Reallocates] "Budget updated. Package A now $15k"

多渠道推广活动：

User: "Launch omnichannel campaign: display in CA, video in NYC, $50k total"
Agent: [Creates packages] "3 packages created across display and video"

工作原理

自然语言理解

自然对话。该技能能够理解：

• 预算："5000美元"，"五千美元"，"5千预算"
• 地点："加利福尼亚州"，"美国主要城市"，"纽约和洛杉矶"
• 受众："科技专业人士"，"年龄25-45岁"，"高收入人群"
• 目标："品牌知名度"，"促进转化"，"增加销售额"

渐进式工作流程

1. 探索阶段

"Find video advertising for luxury brands"

↓ 代理搜索库存 ↓ 展示匹配产品及定价 ↓ 解释定向投放和广告格式

2. 广告活动创建

"Create campaign with Product 1, $25k, target professionals"

↓ 代理创建媒体购买方案 ↓ 设置定向叠加层 ↓ 返回广告活动ID和状态

3. 创意素材管理

"Upload my banner ads"

↓ 代理同步创意素材 ↓ 分配给广告活动 ↓ 返回创意素材ID

4. 监测与优化

"Show performance"

↓ 代理获取投放数据
↓ 按套餐/创意展示指标
↓ 提出优化建议

核心操作

创建广告活动

const campaign = await testAgent.createMediaBuy({
  buyer_ref: 'campaign-2026-q1',
  brand_manifest: { url: 'https://acme.com' },
  packages: [{ product_id: 'premium_display', budget: 10000 }]
});

上传创意素材

await testAgent.syncCreatives({
  creatives: [{ 
    buyer_ref: 'banner-300x250',
    url: 'https://cdn.acme.com/banner.jpg'
  }]
});

监控效果

const delivery = await testAgent.getMediaBuyDelivery({
  media_buy_id: 'mb_abc123'
});
console.log(`CTR: ${delivery.totals.ctr}%, Spend: $${delivery.totals.spend}`);

请参阅REFERENCE.md获取完整的API文档，并参考EXAMPLES.md了解详细工作流程。

核心概念

八大媒体购买任务

AdCP为完整的广告生命周期提供了8项标准化任务。了解更多信息，请查阅媒体购买协议文档。

1. get_adcp_capabilities- 发现代理功能和作品集（约1秒）
2. get_products- 使用自然语言查找广告资源（约60秒）
3. list_creative_formats- 查看创意素材规格（约1秒）
4. create_media_buy- 启动广告活动（几分钟到几天，可能需要审批）
5. update_media_buy- 修改广告活动（耗时数分钟至数天）
6. sync_creatives- 上传创意素材（耗时数分钟至数天）
7. list_creatives- 查询创意库（约1秒）
8. get_media_buy_delivery- 跟踪投放效果（约60秒）

完整任务参考:https://docs.adcontextprotocol.org/docs/media-buy/task-reference/

品牌信息清单

品牌信息可通过两种方式提供：

URL 引用（推荐方式 - 代理自动获取品牌信息）：

{
  "brand_manifest": {
    "url": "https://brand.com"
  }
}

内联清单（完整的品牌详细信息）：

{
  "brand_manifest": {
    "name": "Brand Name",
    "url": "https://brand.com",
    "tagline": "Brand tagline",
    "colors": { "primary": "#FF0000" },
    "logo": { "url": "https://cdn.brand.com/logo.png" }
  }
}

定价模式

产品支持多种定价模式：

• CPM（每千次展示成本）- 每1000次展示的固定价格
• CPM-竞价- 基于竞价的展示定价
• CPCV（每次完成观看成本）- 视频完成观看
• 固定费用- 固定的广告活动成本
• CPP（每收视点成本）- 覆盖受众的百分比

对于拍卖定价，请在您的套餐中包含出价。

异步操作

AdCP 是非实时协议。操作可能需要：

• 约1秒- 简单查询（格式、创意列表）
• 约60秒- AI/推理操作（产品发现）
• 数分钟至数天- 需要人工批准的操作（广告活动创建）

请始终检查响应中的状态字段：

• 已完成- 操作成功完成
• 待处理- 等待批准或处理中
• 失败- 操作失败（请检查错误详情）

定向能力

为广告活动应用定向叠加层：

{
  targeting_overlay: {
    geo: {
      included: ['US-CA', 'US-NY'],  // DMA codes or regions
      excluded: ['US-TX']
    },
    demographics: {
      age_ranges: [{ min: 25, max: 44 }],
      genders: ['M', 'F']
    },
    behavioral: {
      interests: ['technology', 'gaming'],
      purchase_intent: ['consumer_electronics']
    },
    contextual: {
      keywords: ['innovation', 'design'],
      categories: ['IAB19'] // Technology & Computing
    }
  }
}

常见工作流程

工作流程 1：从广告活动发现到启动

// 1. Discover capabilities
const caps = await agent.getAdcpCapabilities({});

// 2. Find products
const products = await agent.getProducts({
  brief: 'Q1 2026 brand awareness campaign for tech startup',
  brand_manifest: { url: 'https://startup.com' },
  filters: { channels: ['display', 'video'] }
});

// 3. Check creative formats
const formats = await agent.listCreativeFormats({
  format_types: ['display', 'video']
});

// 4. Create campaign
const campaign = await agent.createMediaBuy({
  buyer_ref: 'q1-2026-awareness',
  brand_manifest: { url: 'https://startup.com' },
  packages: [
    {
      buyer_ref: 'pkg-001',
      product_id: products.products[0].product_id,
      pricing_option_id: 'cpm-standard',
      budget: 15000
    }
  ],
  start_time: { type: 'asap' },
  end_time: '2026-03-31T23:59:59Z'
});

// 5. Upload creatives
await agent.syncCreatives({
  creatives: [...], // Your creative assets
  assignments: {
    'creative_001': ['pkg-001']
  }
});

// 6. Monitor performance
const delivery = await agent.getMediaBuyDelivery({
  media_buy_id: campaign.media_buy_id
});

工作流程 2：更新运行中的广告活动

// Pause, adjust budget, and resume campaign
await agent.updateMediaBuy({
  media_buy_id: 'mb_abc123',
  updates: {
    status: 'paused',
    budget_change: 5000, // Add $5000
    end_time: '2026-04-30T23:59:59Z'
  }
});

// Resume after adjustments
await agent.updateMediaBuy({
  media_buy_id: 'mb_abc123',
  updates: { status: 'active' }
});

更多工作流程示例：请参阅EXAMPLES.md以获取完整的广告活动场景，包括创意管理、多渠道广告活动和优化工作流程。

测试代理

用于开发和测试，请使用公共测试代理：

代理 URL：https://test-agent.adcontextprotocol.org/mcp
认证令牌：1v8tAhASaUYYp4odoQ1PnMpdqNaMiTrCRqYo9OJp6IQ

import { testAgent } from '@adcp/client/testing';

// No authentication needed for test agent
const result = await testAgent.getProducts({
  brief: 'Test campaign',
  brand_manifest: { url: 'https://example.com' }
});

交互式测试可在以下网址进行：testing.adcontextprotocol.org

错误处理

常见错误模式：

400 错误请求- 参数无效：

{
  "error": {
    "code": "VALIDATION_ERROR",
    "message": "budget must be greater than 0",
    "field": "packages[0].budget"
  }
}

401 未授权- 认证信息缺失或无效：

{
  "error": {
    "code": "UNAUTHORIZED",
    "message": "Invalid authentication token"
  }
}

404 未找到- ID引用无效：

{
  "error": {
    "code": "NOT_FOUND",
    "message": "Product not found",
    "resource": "product_id: premium_video_30s"
  }
}

处理响应前务必检查错误：

if (result.error) {
  console.error(`Error: ${result.error.message}`);
  return;
}

最佳实践

1. 始终从查询能力开始

调用get_adcp_capabilities接口，先了解代理支持的功能再进行其他请求。

2. 使用清晰的买家标识

使用具有描述性的buyer_ref值以便追踪：

• 推荐示例：'campaign-2026-q1-tech-launch'
• 避免使用：'c1','test','abc'

3. 处理异步操作

检查状态字段，并对挂起的操作实施轮询：

let status = 'pending';
while (status === 'pending') {
  await sleep(5000); // Wait 5 seconds
  const update = await agent.getMediaBuyDelivery({
    media_buy_id: campaign.media_buy_id
  });
  status = update.status;
}

4. 撰写详细简报

更好的简报能带来更匹配的产品：

• 良好示例：'为面向主要都市区35-54岁高收入专业人士的豪华汽车品牌提供优质视频广告位。专注于品牌知名度，要求完成率高于70%。'
• 避免示例：'视频广告','需要广告'

5. 验证创意格式

上传前务必检查list_creative_formats，以确保您的创意素材符合要求。

6. 监控预算进度

定期检查投放指标，确保广告活动按计划推进：

const delivery = await agent.getMediaBuyDelivery({
  media_buy_id: campaign.media_buy_id
});

const pacing = delivery.delivery.spend / delivery.delivery.budget;
console.log(`Budget pacing: ${(pacing * 100).toFixed(1)}%`);

其他资源

AdCP官方文档

• 主文档：https://docs.adcontextprotocol.org
• 完整索引：https://docs.adcontextprotocol.org/llms.txt
• 媒体购买协议：https://docs.adcontextprotocol.org/docs/media-buy/
• 快速参考：https://docs.adcontextprotocol.org/docs/media-buy/quick-reference
• 任务参考：https://docs.adcontextprotocol.org/docs/media-buy/task-reference/
• 快速入门指南：https://docs.adcontextprotocol.org/docs/quickstart

本技能文档

• REFERENCE.md- 完整的API参考和模式定义
• EXAMPLES.md- 真实世界广告活动示例
• PROTOCOLS.md- MCP与A2A协议详情
• TARGETING.md- 高级定向策略
• CREATIVE.md- 创意素材管理指南

关键提醒

1. AdCP是异步的- 操作可能需要几分钟到几天
2. 可能需要人工审批- 检查待处理状态
3. 从获取能力开始- 务必先调用get_adcp_capabilities品牌背景很重要
4. - 提供详细的品牌清单以获得更好的结果- Provide detailed brand manifests for better results
5. 定向是叠加的- 产品定向 + 您的叠加层 = 最终定向
6. 创意格式要求严格- 务必根据格式规范进行验证
7. 监控投放效果- 定期进行投放检查以确保广告活动成功

支持

如需AdCP帮助：

• 官方仓库：https://github.com/adcontextprotocol/adcp
• 文档：https://docs.adcontextprotocol.org
• 交互式测试：https://testing.adcontextprotocol.org
• 完整API文档：https://docs.adcontextprotocol.org/llms.txt