kein-s-meta-ads-report

在聊天中监控 Meta（Facebook/Instagram）广告花费、转化与 CAC，并发现可用转化事件名称。

## 概述（中文）

在聊天中监控 Meta（Facebook/Instagram）广告花费、转化与 CAC，并发现可用转化事件名称。

## 技能正文

# Meta 广告分析与事件发现

强大的工具包，通过聊天直接监控 Meta（Facebook/Instagram）广告表现。包含分析报告与事件发现工具，确保准确追踪。

## 🚀 能力

1.  **广告表现报告：**
    * 计算 **花费**、**转化** 与 **CAC（获客成本）**。
    * 按 **广告组** 细分数据。
    * 支持自然语言日期范围（如「昨天」「上月」「过去 7 天」）。

2.  **事件发现工具：**
    * 列出广告账户中当前活跃的所有原始事件名称（如 `offsite_conversion.custom...`）。
    * 帮助找到用于转化追踪的精确事件名称。

---

## ⚙️ 配置（.env）

在 OpenClaw 设置中配置以下环境变量：

| 变量 | 说明 | 必填 | 默认 |
| :--- | :--- | :--- | :--- |
| `META_ACCESS_TOKEN` | Meta 开发者用户访问令牌 | **是** | - |
| `META_AD_ACCOUNT_ID` | 广告账户 ID（必须以 `act_` 开头） | **是** | - |
| `META_EVENT_NAME` | 要追踪的特定转化事件 | 否 | `offsite_conversion.fb_pixel_custom` |

---

## 🔑 如何获取凭证

### 1. 获取访问令牌
1.  前往 [Meta Graph API Explorer](https://developers.facebook.com/tools/explorer/)。
2.  选择你的应用。
3.  添加权限：`ads_read`、`read_insights`。
4.  点击 **Generate Access Token** 并复制字符串。

### 2. 获取广告账户 ID
1.  前往 [Facebook Ads Manager](https://adsmanager.facebook.com/)。
2.  在 URL 中查找 `act=12345678`。
3.  你的 ID 为 `act_12345678`（不要忘记 `act_` 前缀）。

---

## 💬 示例命令

### 查看分析
> "Show me yesterday's ad performance"
> "Calculate CAC for the last 7 days"
> "How were the ads from 2026-02-01 to 2026-02-10?"
> "Report ad spend for this month"

### 查找正确事件名称
> "List all ad events"
> "Show me available meta events"

---

## ⚠️ 故障排查

**问：转化数为 0，但我有销售。**
**答：** 默认事件为 `offsite_conversion.fb_pixel_custom`。你的像素可能使用不同名称如 `purchase`、`lead` 或 `start_trial`。
1.  向机器人请求：**"List all ad events"**。
2.  从列表复制精确原始名称。
3.  用该名称更新 `META_EVENT_NAME` 变量。