Metadata

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.jpg

2. 创建广告系列

python scripts/create_campaign.py "广告系列名称" conversions PAUSED

3. 创建广告组

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 参考。

meta_ad

安装技能