连接 Meta 广告

连接 Meta 广告后，StoreClaw 可以在授权范围内读取和分析您的 Facebook 与 Instagram 广告数据，包括广告账户、广告系列、广告组、广告、花费、展示、点击、转化和 ROAS 等指标，并帮助您完成广告表现诊断、异常排查和优化建议。

在当前版本中，Meta 广告连接器通过对应的插件进行管理。请先安装 Meta 广告插件，再使用 Meta 系统用户 Access Token 连接广告账户。

适合的工作流

• 查看广告账户、广告系列、广告组和广告层级的表现。
• 分析花费、展示、覆盖人数、点击率、CPC、CPM、转化和 ROAS。
• 对比不同广告系列、受众和素材的表现，定位异常波动。
• 生成广告文案、素材方向和预算优化建议。

连接完成后，您可以使用 StoreClaw 进行：

• Meta 广告账户发现与数据查询。
• 广告系列、广告组和广告表现分析。
• Facebook 与 Instagram 广告素材对比。
• 广告文案优化和 A/B 测试建议。
• 低效广告、异常花费和转化问题排查。

安全说明： 当前版本的 StoreClaw Meta Ads 插件仅支持资产发现、广告数据读取、离线报表分析、诊断和只读规划，不会创建、编辑、暂停或删除广告，也不会修改预算、出价或受众。

连接前准备

开始连接前，请确认以下条件：

• 您可以正常登录 StoreClaw。
• 您已经登录 Facebook、Meta Business Suite 和 Meta 开发者后台。
• 当前 Facebook 账号对目标业务资产组合拥有完全控制权。
• 目标业务资产组合中已经存在可用的 Meta 广告账户。
• 系统用户已被授予目标广告账户的访问权限。
• 您可以创建 Meta 应用并生成系统用户 Access Token。

安全说明： Access Token 相当于账户密钥。请勿将 Token 粘贴到 StoreClaw 对话、聊天工具、邮件、工单或公开文档中。Token 只能填写到 StoreClaw 的 Meta Ads 连接表单中。

连接流程

完成 Meta 广告连接通常需要 4 个阶段：

1. 创建并配置 Meta 应用。
2. 创建系统用户，并分配目标广告账户。
3. 为系统用户生成 Access Token。
4. 在 StoreClaw 中填写 Token 并完成连接。

第一阶段：创建 Meta 应用

第一步：进入应用管理页面

1. 打开 https://business.facebook.com/settings/，选择需要连接的业务资产组合。
2. 在左侧菜单中选择 账户 → 应用。
3. 点击右上角或页面中间的 添加。

第二步：创建新的应用编号

点击 添加 按钮，在弹窗中选择 创建新的应用编号。

第三步：填写应用信息

1. 输入便于识别的应用名称，例如 StoreClaw Meta Ads。
2. 填写长期有效、可正常接收邮件的应用联系邮箱。
3. 点击 下一页。

第四步：选择应用用例

针对 StoreClaw Meta 广告连接，建议至少选择以下用例：

• 用市场营销 API 创建和管理广告。
• 用市场营销 API 衡量广告表现数据。

潜在客户、移动应用广告、Audience Network、目录 API 等用例，请仅在您确实需要对应能力时选择。

说明： Meta 的用例名称和数量可能随页面版本变化。请优先选择包含 市场营销 API / 管理广告 / 衡量广告表现 的用例。

第五步：绑定业务资产组合

1. 选择目标广告账户所属的业务资产组合。
2. 确认应用名称、联系邮箱、用例和业务资产组合无误。
3. 阅读并同意 Meta 开放平台条款与开发者政策，然后完成应用创建。

第二阶段：创建系统用户并分配广告账户

第一步：创建系统用户

1. 返回 Meta 业务设置。
2. 在左侧菜单中选择 用户 → 系统用户。
3. 点击 添加。
4. 输入系统用户名称，例如 StoreClaw System User。
5. 根据页面提示选择管理员或具有足够权限的系统用户角色。

如果 添加 按钮不可用，请优先检查：

• Meta 开发者账号是否注册完成。
• 当前业务资产组合中是否已经添加 Meta 应用。
• 当前 Facebook 账号是否拥有业务资产组合完全控制权。
• Meta 是否要求完成双重验证或公司验证。

第二步：将 Meta 应用分配给系统用户

1. 在系统用户列表中选中刚创建的系统用户。

2. 点击右上角的 … 按钮，然后选择 分配资产。

   

3. 在 选择资产类型 中选择 应用（Apps）。

4. 选择第一阶段创建的 Meta 应用。

5. 在 完全控制（Full access） 下开启 管理应用（Manage app）。

6. 点击 分配资产（Assign assets） 完成设置。

   

7. 返回系统用户详情页，确认该 Meta 应用已经成功分配给当前系统用户。

重要： 如果没有将 Meta 应用分配给系统用户，后续生成口令时可能无法选择对应应用。

第三步：给系统用户分配广告账户

1. 选中刚创建的系统用户。
2. 点击 添加资产。
3. 选择 广告账户。
4. 选择需要连接到 StoreClaw 的目标广告账户。
5. 按照当前连接表单要求，为目标广告账户开启管理广告系列或完全控制，以便系统用户生成包含 ads_management 的 Token。当前 StoreClaw Meta Ads 插件仍为只读能力，不会调用广告写入操作。
6. 保存资产分配。
7. 返回系统用户详情后，应能在已分配的资产中看到对应广告账户。

重要： Token 可以使用哪些广告数据，取决于系统用户被分配了哪些资产。即使 Token 生成成功，如果没有给系统用户分配目标广告账户，StoreClaw 仍无法读取该账户的数据。

第三阶段：生成 Meta Access Token

第一步：点击生成口令

在系统用户详情页确认广告账户已分配后，点击右上角的 生成口令。

第二步：选择应用

在生成口令向导中，选择第一阶段创建并绑定到该业务资产组合的 Meta 应用，然后点击 下一页。

如果下拉框中没有可选应用，请检查：

• 应用是否已经创建成功。
• 应用是否绑定到当前业务资产组合。
• 当前选择的系统用户和应用是否属于同一个业务资产组合。

第三步：设置 Token 到期日

如果页面提供到期日选项，建议选择 永不过期 或 Never，以避免 StoreClaw 因 Token 到期而断开连接。

如果 Meta 只提供有限有效期，请选择页面允许的最长有效期，并在 Token 到期前重新生成和连接。

第四步：选择权限

StoreClaw 连接表单明确要求 Token 至少包含：

权限	用途
ads_read	读取广告账户、广告系列、广告组、广告及广告表现数据
ads_management	当前连接表单要求 Token 包含的权限范围，用于完成 Meta 侧授权与资产访问。StoreClaw 当前版本不会利用该权限创建或修改广告

权限与产品能力说明： Token 包含 ads_management 只表示 Meta 颁发的凭证具备这一权限范围，不代表 StoreClaw 连接器已经实现广告写入操作。根据当前 https://www.storeclaw.ai/app/plugins/metaads 的能力说明，插件仅提供资产发现、数据查询、离线报表分析、诊断和只读规划。

如果需要使用公共主页、Instagram 或商品目录相关能力，还可以按需勾选：

• business_management
• read_insights
• pages_show_list
• pages_read_engagement
• pages_manage_ads
• instagram_basic
• catalog_management

选择权限后，点击 生成口令。

第五步：复制并保存 Token

Token 生成成功后：

1. 点击 Token 右侧的 复制。
2. 将 Token 临时保存在安全的密码管理工具中。
3. 不要关闭页面后再依赖历史记录查找，Meta 可能不会再次显示完整 Token。
4. 不要截图、转发或将 Token 发给其他人。

安全说明： 如果 Token 曾经出现在截图、聊天记录或公开文档中，请立即返回系统用户页面点击 撤销口令，然后重新生成。

第四阶段：在 StoreClaw 中完成连接

第一步：打开 Meta 广告连接器

1. 登录 https://www.storeclaw.ai/。
2. 在左侧导航栏点击 插件。
3. 在营销分类中找到 Meta 广告。
4. 点击卡片右侧的 +，或进入插件详情页后点击 安装插件。
5. 在连接器区域找到 Meta Ads，点击 连接 并选择 使用 Meta Ads 继续。

第二步：填写 Access Token

在连接页面的 Access Token 输入框中，粘贴刚刚生成的完整 Token。

确认无误后，点击 Connect Account。

第三步：确认连接状态

连接成功后，页面会返回 StoreClaw。请在 Meta 广告插件详情页确认连接器显示为 已连接。

建议新建一个 StoreClaw 会话并测试：

请列出当前 Meta Token 可以访问的广告账户，并汇总最近 7 天的花费、展示、点击、CTR、CPC、转化和 ROAS。

如果可以正常返回目标广告账户和指标，说明 Meta 广告连接已经完成。

连接失败排查

无法注册 Meta 开发者账号

如果开发者注册页面收不到短信验证码：

• 检查国家代码和手机号码格式。
• 检查手机垃圾短信及安全软件拦截。
• 避免连续多次点击重新发送，以免触发频率限制。
• 联系运营商确认是否支持接收国际企业短信。
• 必要时更换另一家运营商的真实手机号。

添加系统用户 按钮不可用

请检查 Meta 开发者账号是否完成注册、业务资产组合中是否已有应用，以及当前账号是否具有完全控制权。Meta 也可能要求双重验证或公司验证。

生成口令时没有可选应用

请确认应用已经绑定到当前业务资产组合。仅在开发者后台创建应用，但未绑定业务资产组合时，系统用户可能无法选择该应用生成 Token。

Token 生成成功，但 StoreClaw 无法读取广告账户

通常是系统用户未获得目标广告账户权限。请返回 系统用户 → 已分配的资产，确认目标广告账户已经分配，并具有读取或管理广告所需的权限。

StoreClaw 提示 Token 无效或权限不足

请检查：

• Token 是否复制完整，前后是否包含空格或换行。
• Token 是否已过期或被撤销。
• 是否至少包含 ads_read 和 ads_management。
• 系统用户是否仍然拥有目标广告账户权限。
• 生成 Token 时选择的应用是否仍处于可用状态。

可以连接自有广告账户，但不能访问客户广告账户

如果应用只管理当前业务拥有的广告账户，通常使用基础访问层级和对应权限即可。如果需要管理其他企业或客户的广告账户，Meta 可能要求业务验证、应用审核以及更高的 Marketing API Access Tier。

常见问题 (FAQ)