- name
- meta-ads-creator
- description
- This skill automates the creation of Meta (Facebook/Instagram) ads using the Marketing API. It handles campaign setup, audience targeting, media upload, and ad creation in a streamlined workflow. Use this skill when users want to create Meta ads programmatically, manage ad campaigns via API, or automate their advertising workflow.
Meta Ads Creator
自动化创建 Meta (Facebook/Instagram) 广告的 Skill，通过 Marketing API 实现从素材上传到广告发布的完整流程。
适用场景
当用户需要以下功能时触发此 Skill：
- 通过 API 自动创建 Meta 广告
- 批量创建广告系列、广告组、广告
- 程序化管理广告投放
- 自动化广告素材上传
前置要求
1. Meta 开发者账号
- 访问 https://developers.facebook.com 注册开发者账号
- 创建应用并添加 Marketing API 产品
- 生成 User Access Token
2. 配置信息
运行配置脚本获取所需信息：
cd .workbuddy/skills/meta-ads-creator/scripts
python config_manager.py需要的信息：
- Access Token: Meta API 访问令牌
- Ad Account ID: 广告账户 ID (格式: act_123456789)
- App ID (可选): 应用 ID
- App Secret (可选): 应用密钥
3. 主页权限
创建广告需要 Facebook 主页 ID，确保你的账号有该主页的管理员权限。
使用方法
方式一：一键创建完整广告
使用 create_full_ad.py 脚本，通过 JSON 配置文件创建完整的广告结构：
python scripts/create_full_ad.py ad_config.json配置文件示例 (ad_config.json):
{
"product_name": "夏季连衣裙",
"daily_budget": 50,
"campaign_name": "夏季促销2024",
"objective": "conversions",
"status": "PAUSED",
"targeting": {
"countries": ["US"],
"age_min": 25,
"age_max": 45,
"genders": [2]
},
"ad": {
"page_id": "YOUR_PAGE_ID",
"message": "限时优惠！夏季新款连衣裙5折起，快来选购！",
"headline": "夏季大促",
"images": ["image1.jpg", "image2.jpg"],
"link_url": "https://yourstore.com/summer-sale",
"call_to_action": "SHOP_NOW"
}
}生成示例配置文件：
python scripts/create_full_ad.py --example方式二：分步创建
如需更精细控制，可分步创建：
1. 上传素材
python scripts/upload_media.py image1.jpg image2.jpg2. 创建广告系列
python scripts/create_campaign.py "广告系列名称" conversions PAUSED3. 创建广告组
python scripts/create_adset.py <campaign_id> "广告组名称" 5000 '{"countries":["US"],"age_min":25,"age_max":45,"genders":[2]}'4. 创建广告
python scripts/create_ad.py <adset_id> "广告名称" '<creative_json>'方式三：在代码中使用
from scripts.create_full_ad import create_full_ad
result = create_full_ad(
product_name="产品名称",
daily_budget=50,
targeting_config={
"countries": ["US"],
"age_min": 25,
"age_max": 45,
"genders": [2]
},
ad_config={
"page_id": "YOUR_PAGE_ID",
"message": "广告文案",
"images": ["image1.jpg"],
"link_url": "https://example.com",
"call_to_action": "SHOP_NOW"
}
)配置参数说明
广告目标 (Objective)
conversions- 转化量 (默认)traffic- 流量awareness- 品牌知名度engagement- 互动率app_installs- 应用安装lead_generation- 潜在客户开发
受众定位 (Targeting)
| 参数 | 类型 | 说明 |
|---|---|---|
countries | array | 国家代码，如 ["US", "CA"] |
age_min | int | 最小年龄 |
age_max | int | 最大年龄 |
genders | array | [1]=男, [2]=女, [1,2]=全部 |
interests | array | 兴趣标签 ID 列表 |
CTA 按钮
SHOP_NOW- 立即购买LEARN_MORE- 了解更多SIGN_UP- 注册DOWNLOAD- 下载GET_OFFER- 获取优惠
脚本说明
| 脚本 | 功能 |
|---|---|
config_manager.py | 管理 API 配置 (Token、账户ID) |
meta_api.py | API 基础模块，包含通用请求方法 |
upload_media.py | 上传图片/视频素材 |
create_campaign.py | 创建广告系列 |
create_adset.py | 创建广告组 (受众、预算) |
create_ad.py | 创建广告 (文案、素材) |
create_full_ad.py | 一键创建完整广告 |
测试 API 连接
配置完成后，测试 API 连接：
python scripts/meta_api.py成功后会显示：
- Token 有效性
- 广告账户信息
- 现有广告系列列表
注意事项
- 默认暂停: 所有创建的广告默认状态为
PAUSED，请在 Meta 广告管理器中审核后手动启用 - 预算单位: API 中预算以"分"为单位，如 $50 需传入
5000 - 素材复用: 相同图片上传后会获得相同 hash，避免重复上传
- 错误处理: 脚本会输出详细的错误信息，请根据提示检查配置
参考文档
查看本 Skill 的 references/meta_api.md 获取更详细的 API 参考。