用途:该技能提供 Meta Ads API(Facebook/Instagram 广告)的调用方式,用于管理页面、广告账户、广告系列、广告组、广告及成效数据。用户提及 Meta Ads、Facebook Ads、Instagram Ads 或广告活动时可使用。
前置条件:需在 Zero 的 Settings > Connectors > Meta Ads 中连接 Meta Ads;请求需 META_ADS_TOKEN;调用广告账户端点时账户 ID 通常使用 act_<account-id> 格式。
认证:普通连接器请求使用 Authorization: Bearer $META_ADS_TOKEN。由于 Graph API 由多个 Zero 连接器共用,Graph API 调用需带 X-VM0-Connector-Intent: meta-ads 作为路由提示。不要把 META_ADS_TOKEN 作为 access_token 查询参数或放在请求体中,否则可能触发无效令牌错误。例外:Graph API 返回的 Page access token 是真实二级令牌,/{page-id}/ads_posts 等仅需 Page 令牌的端点应先用连接器令牌获取 Page access token,再用 Authorization: Bearer $page_token 请求。
主要能力:可列出页面与广告账户,查看账户详情;列出、查看、创建、更新、删除广告系列;列出与查看广告组、创建广告组;列出与查看广告;查询账户级、广告系列级成效数据,支持时间范围、每日细分、年龄与性别细分;列出自定义受众。
排障:请求失败时可运行 zero doctor check-connector --env-name META_ADS_TOKEN 或 zero doctor check-connector --url https://graph.facebook.com/v22.0/me/adaccounts --method GET。
限制与注意:所有金额为账户货币最小单位;创建广告系列应先用 PAUSED 状态,审核后再激活;目标须为 OUTCOME_AWARENESS、OUTCOME_ENGAGEMENT、OUTCOME_LEADS、OUTCOME_SALES、OUTCOME_TRAFFIC、OUTCOME_APP_PROMOTION 之一;date_preset 可用 today、yesterday、last_7d、last_30d、this_month、last_month、maximum;存在分页时需跟随 paging.next;有速率限制,遇到 code 17 或 32 应等待后重试。