> ## Documentation Index
> Fetch the complete documentation index at: https://docs.ycloud.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Messenger 营销

> 关联您的 Facebook 公共主页，构建受众群体，并通过 YCloud 发送 Messenger 营销活动。

Messenger 营销消息是从您的 Facebook 公共主页发送的 **付费消息** 。在 Messenger 营销活动中，您可以设置 **总预算** 来控制活动总花费，也可以选择设置 **单日预算** 来控制日均花费。

利用 YCloud 中的 Messenger 集成功能上传客户列表，让 Meta 将您的客户匹配为受众，并创建和排期发送您的消息。随后您可以在 YCloud 中追踪营销活动的成效。

## 开始之前

请确保您具备以下条件：

* 在您的 YCloud 工作区中拥有**Messenger 渠道管理权限** 。
* 拥有具备授权所需 Facebook 公共主页权限的 Facebook 账户。
* 一份已获得授权用于营销并上传至 Meta 的客户列表。

您的 Facebook 公共主页必须位于 **欧洲经济区 (EEA)、英国、日本、韩国和中国大陆** **境外** 。Messenger 的 Marketing Message API 仅适用于 Web 应用程序。

YCloud 会统一管理用于这些营销活动的广告账户。您只需授权您的 Facebook 公共主页即可。

## 1. 关联您的 Facebook 公共主页

1. 打开 **集成**，找到 **Messenger**，然后点击 **安装**。如果该集成已启用，请点击 **详情** 或从侧边栏打开 **Messenger** 。

   <Frame caption="Open the Messenger marketing integration.">
     <img src="https://mintcdn.com/lchnan/M-de3mJtttRJZA8_/product-assets/messenger-marketing/integrations.png?fit=max&auto=format&n=M-de3mJtttRJZA8_&q=85&s=dfc09717a87616644f4e94cede0274db" alt="高亮显示 Messenger 营销卡片的集成页面" width="2918" height="1568" data-path="product-assets/messenger-marketing/integrations.png" />
   </Frame>

2. 在 Messenger 中，打开 **指南** 并点击 **关联主页**。

   <Frame caption="Use the Guide to connect a Page, prepare an audience, and launch a campaign. Matching can take up to 6 hours; the 24-hour estimate shown in this screenshot is outdated.">
     <img src="https://mintcdn.com/lchnan/M-de3mJtttRJZA8_/product-assets/messenger-marketing/guide.png?fit=max&auto=format&n=M-de3mJtttRJZA8_&q=85&s=1ff5cc7fd45d3d78b3285b0f55ce537f" alt="展示发布营销活动三个步骤的 Messenger 指南" width="2922" height="1582" data-path="product-assets/messenger-marketing/guide.png" />
   </Frame>

   您也可以打开 **Facebook 公共主页** 并点击 **关联 Facebook 公共主页**。

   <Frame caption="Connect a Facebook Page or review your authorized Pages.">
     <img src="https://mintcdn.com/lchnan/M-de3mJtttRJZA8_/product-assets/messenger-marketing/facebook-pages.png?fit=max&auto=format&n=M-de3mJtttRJZA8_&q=85&s=cb03d2bc00ea98caa4d91be9a3226843" alt="高亮显示“关联 Facebook 公共主页”的 Facebook 公共主页列表" width="2928" height="1570" data-path="product-assets/messenger-marketing/facebook-pages.png" />
   </Frame>

3. 完成 Meta 授权流程。选择要关联的业务资产组合和 Facebook 公共主页，并授予所请求的权限。

   <Frame caption="Follow the Meta onboarding flow to authorize your Facebook Page.">
     <img src="https://mintcdn.com/lchnan/M-de3mJtttRJZA8_/product-assets/messenger-marketing/meta-authorization.png?fit=max&auto=format&n=M-de3mJtttRJZA8_&q=85&s=d5adc88633531ba56004e0effdeed12e" alt="用于将业务账户关联到 YCloud 的 Facebook 企业登录对话框" width="2918" height="1574" data-path="product-assets/messenger-marketing/meta-authorization.png" />
   </Frame>

4. 返回 YCloud。检查该主页是否显示在 **Facebook 公共主页** 下，并显示其主页 ID、业务资产组合以及 **已授权** 状态。

如果授权失败，请检查您对所选主页的访问权限，然后重试。

## 2. 创建并上传受众

自定义受众将客户列表与 Facebook 公共主页关联起来。Meta 会将上传的客户信息与可能符合接收营销活动条件的用户进行匹配。

### 创建受众

1. 打开 **受众列表** 并点击 **创建自定义受众**。
2. 输入 **受众名称** 和选填的 **描述**。
3. 选择已关联的 **Facebook 公共主页**。
4. 点击 **创建受众** 以继续进入 **上传客户列表**。

<Frame caption="Enter an audience name, an optional description, and the connected Facebook Page.">
  <img src="https://mintcdn.com/lchnan/M-de3mJtttRJZA8_/product-assets/messenger-marketing/create-audience.png?fit=max&auto=format&n=M-de3mJtttRJZA8_&q=85&s=1f6eb825fd39bb360124a71c4c58b6db" alt="包含受众详情和 Facebook 公共主页字段的“创建自定义受众”对话框" width="2920" height="1552" data-path="product-assets/messenger-marketing/create-audience.png" />
</Frame>

<Note>
  受众创建后，关联的 Facebook 公共主页即被固定。使用此受众的营销活动将沿用同一主页。若要使用其他主页，请创建另一个受众。
</Note>

### 上传客户列表

在上传对话框中点击 **下载导入示例 (.xlsx)** ，并使用该模板准备您的文件。模板仅包含两列：`phone` 和 `email`。

| 列 | 包含内容 |
| - | - |
| `phone` | 客户的电话号码，包含国家代码。 |
| `email` | 客户的邮箱地址。 |

每一行代表 **一位客户**。您可以仅提供电话号码、仅提供邮箱地址，或同时提供两者。如果您只有一种标识，请将另一个单元格留空。如果两者都提供，电话号码和邮箱地址必须属于 **同一个人**。

Meta 使用您提供的电话号码和/或邮箱地址将客户与其用户进行匹配。每行必须至少填写这两个字段中的一个。

选择 `.xlsx` 或 `.xls` 文件并点击 **确认**。每个文件最大可达 **15 MB** ，最多包含 **1,000,000 行**。若列表规模更大，请将其拆分为较小的文件。

如果上传失败，请在上传对话框中修正问题并重试。该受众已有 ID，因此您无需再创建另一个受众。

### 检查匹配状态

匹配过程最多可能需要 **6 小时**。在 **受众列表**中检查受众的状态：

| 状态 | 含义 | 下一步操作 |
| - | - | - |
| **Matching** | Meta 正在处理客户名单。 | 您可以准备并提交营销活动。发送将在受众准备就绪后进行。 |
| **Ready** | 匹配的受众可用于营销活动。 | 创建营销活动并设置其投放时间。 |
| **Below threshold** | 匹配的受众规模过小，无法使用。 | 点击 **Upload more** 并添加更多符合条件的客户。目前该受众尚无法用于营销活动。 |

<Frame caption="Review uploaded customer counts and estimated audience sizes in Audience lists.">
  <img src="https://mintcdn.com/lchnan/M-de3mJtttRJZA8_/product-assets/messenger-marketing/audience-lists.png?fit=max&auto=format&n=M-de3mJtttRJZA8_&q=85&s=d3ed77e5959cb41d4c4e82d716a1ef5c" alt="包含受众概览卡片和客户匹配信息的受众名单页面" width="2910" height="1572" data-path="product-assets/messenger-marketing/audience-lists.png" />
</Frame>

**Uploaded** 显示已上传的客户数量。 **Estimated audience size** 以区间形式显示预估的匹配受众规模。这两个数字均不保证最终送达的消息数量。

如需后续添加客户，请点击 **Upload more**。这会将客户追加到现有受众中。如果有任何 **Active** 营销活动正在使用该受众，请在上传更多客户之前暂停所有使用它的有效营销活动。

## 3. 设置营销活动

打开 **Campaigns** 并点击 **Create campaign**。编辑器包含三个步骤： **Campaign setup**、 **Message template** 和 **Review**。

<Frame caption="Click Create campaign to start a Messenger marketing campaign.">
  <img src="https://mintcdn.com/lchnan/M-de3mJtttRJZA8_/product-assets/messenger-marketing/campaigns.png?fit=max&auto=format&n=M-de3mJtttRJZA8_&q=85&s=5f02891994390081a21077c4eb27f3e9" alt="突出显示了“Create campaign”按钮的 Campaigns 页面" width="2924" height="1568" data-path="product-assets/messenger-marketing/campaigns.png" />
</Frame>

在 **Campaign setup** 中，填写以下字段：

| 字段 | 填写内容 |
| - | - |
| **Campaign name** | 便于在营销活动报告中识别的名称。 |
| **Custom Audience** | 状态为 **Ready** 或 **Matching** 的受众。 |
| **Facebook Page** | 根据受众自动填充，无法在此处修改。 |
| **Start time** 和 **End time** | 营销活动时间表。结束时间必须晚于开始时间。时间采用您计算机的本地时区。 |
| **Lifetime budget** | 营销活动总预算（USD）。必填项且必须大于零。 |
| **Daily budget** | 可选的平均每日预算（USD）。如果设置，则必须大于零。 |

<Frame caption="Choose your audience, set the schedule, and configure lifetime and daily budgets.">
  <img src="https://mintcdn.com/lchnan/M-de3mJtttRJZA8_/product-assets/messenger-marketing/campaign-setup.png?fit=max&auto=format&n=M-de3mJtttRJZA8_&q=85&s=a04794ddfafedca82e2a0e7d92c90dba" alt="包含受众、时间表、总预算、每日预算和 Messenger 预览的营销活动设置表单" width="2904" height="1572" data-path="product-assets/messenger-marketing/campaign-setup.png" />
</Frame>

点击 **Next** 编写您的消息。

<Note>
  每日预算代表平均每日支出；切勿将其视为严格的每日支出上限。请使用总预算来规划营销活动的总支出。
</Note>

## 4. 编写并预览您的消息

使用 **Generic message editor** 撰写消息。预览会在您编辑时同步更新。

| 字段 | 使用方法 |
| - | - |
| **Greeting** | 可选的问候文本。 |
| **Title** | 消息必填的主标题。 |
| **Subtitle** | 可选的补充说明文本。 |
| **Media** | 选择 **None**、 **Image** 或 **Video**。 |
| **+ Visit website button** | 可选添加带有标签和 HTTPS 网站 URL 的按钮。 |
| **Deep link** | 可选启用应用深层链接。如果启用，请同时提供 Android 和 iOS 链接。 |

问候语、标题和副标题支持纯文本。不支持个性化变量。

### 添加媒体

* **None:** 发送不包含图片或视频的消息。
* **Image:** 上传 **1–6 张 JPG 或 PNG 图片**，每张大小在 **2 MB** 以内。选择一张图片作为 **主图**。如果上传多张图片，接收者可以轮播浏览。建议使用 **450 × 450 像素** 的正方形图片。使用预览箭头检查每张图片。
* **Video:** 上传一个 **MP4** 文件。

### 消息示例

对于季节性促销，您可以使用：

| 字段 | 示例 |
| - | - |
| **Greeting** | 我们的秋季系列现已上市。 |
| **Title** | 发现您的日常新宠 |
| **副标题** | 探索本季全新配色与风格。 |
| **按钮标签** | 选购系列商品 |
| **网站 URL** | `https://www.example.com/autumn` |

保持标题聚焦于单一优惠，选择契合主题的媒体，并确保按钮跳转目标与消息内容一致。继续操作前请检查预览效果。

## 5. 审核并提交

1. 点击 **下一步** 打开 **审核**。
2. 检查 Facebook 公共主页、受众、预计覆盖人数、排期和预算。
3. 查看消息预览，包括每张图片和按钮跳转目标。
4. 点击 **提交**。

成功提交后，活动将显示在 **营销活动** 中。受众就绪的活动状态为 **已排期**。如果受众仍在匹配中，活动将显示 **等待受众匹配** ，并在受众就绪后根据其排期自动推进。

如果提交返回错误，您输入的内容仍会保留。修正高亮标记的字段或按照错误提示进行调整，然后重新提交。

## 6. 管理活动并跟踪成效

在 **营销活动** 中使用活动名称搜索和状态筛选器查找活动。点击活动名称可查看详情，或刷新列表以获取最新结果。

| 活动状态 | 可用操作 |
| - | - |
| **已排期** | **编辑** 或 **取消**。 |
| **等待受众匹配** | 在匹配完成前可 **编辑** 或 **取消** 。 |
| **投放中** | **暂停**，然后确认操作。 |
| **已暂停** | 点击 **启用** 恢复投放。已暂停的活动无法编辑。 |
| **已结束** 或 **已取消** | 查看活动及其成效。已取消的活动无法恢复。 |

活动详情包括公共主页、受众、排期、预算、花费金额、消息预览以及成效指标。

| 指标 | 说明 |
| - | - |
| **花费金额** | Meta 报告的活动花费。 |
| **已送达** | 覆盖的人数。百分比以预估受众规模的下限为分母计算。 |
| **已读** | 已读消息数。百分比按已送达消息数计算。 |
| **已点击** | 报告的点击次数。百分比按已送达消息数计算。 |

<Note>
  送达报告仅为汇总数据。您可以查看有多少人收到了您的消息，但无法确定上传的受众中具体哪些客户收到了消息。系统不提供单个收件人的送达记录。
</Note>

指标更新可能需要一些时间。破折号（`—`）表示数值不可用或无法计算百分比；这并不一定意味着零互动。

## 初次开展活动的建议

* **为每个活动添加“访问网站”按钮。** 链接到相关的着陆页，并配合使用活动跟踪参数（例如 UTM 标签）以及网站分析中的转化跟踪，以衡量购买或注册等业务成效。该按钮提供了前往网站的路径；仅添加按钮本身不会自动跟踪转化。
* **尽早准备受众。** 在预定开始时间前预留最多 6 小时的匹配时间。
* **从明确的目标客群开始。** 使用精准的客户标识符，并针对该群组发送高度相关的内容。
* **先用适度预算进行测试。** 在增加未来活动的投入之前，先查看送达数、已读数、点击数和实际花费。
* **检查时区。** 活动排期使用的是您电脑的本地时区。
* **提交前审核内容。** 处于已排期或等待匹配状态时支持编辑。暂停投放中的活动并不会使其变为可编辑状态。

## 故障排除

| 问题 | 解决步骤 |
| - | - |
| “集成”中缺少 Messenger。 | 请联系您的工作区管理员检查您的 Messenger 渠道管理权限。 |
| 授权后未显示您的主页。 | 请检查您是否选择了正确的主页，并授予了所请求的 Meta 权限。 |
| 客户文件被拒绝。 | 请检查文件类型、大小、行数，以及每行是否包含电话号码或电子邮箱地址。 |
| 受众低于阈值。 | 请上传更多符合条件的客户，并等待匹配完成。 |
| **上传更多** 不可用。 | 请暂停使用该受众的所有正在运行的营销活动，然后重试。 |
| 营销活动正在等待匹配。 | 请检查受众状态。匹配最长可能需要 6 小时。 |


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.