---
metadata:
  - name: generator
    content: Diplodoc Platform v5.64.0
alternate:
  - https://boost.yandex.com/doc/en/analytics/content/push/marketing.md
  - https://boost.yandex.com/doc/ru/analytics/content/push/marketing.md
  - https://boost.yandex.com/doc/zh/analytics/content/push/marketing.md
  - href: https://boost.yandex.com/doc/zh/analytics/content/push/marketing.md
    type: text/markdown
    title: Markdown version
  - href: https://boost.yandex.com/doc/zh/llms.txt?revision=r21738064
    rel: describedby
---
> **Documentation Index:** Fetch the complete configuration index at https://boost.yandex.com/doc/zh/llms.txt?revision=r21738064

# 启动推送营销

在创建推送营销活动之前，请确保已配置推送通知并集成了AppMetrica Push SDK。 要了解更多信息，请查看[推送通知](https://boost.yandex.com/doc/zh/analytics/content/push/index.md)。

要在 Analytics module 中创建推送活动，请前往 **推送活动** 部分。 点击页面左上角的**创建推送**。 请完成下面的步骤。

## 步骤 1. 选择受众 {#audience}

1. 输入广告活动名称，然后在下拉列表中选择应用。
2. 启用“静默推送”选项以发送[静默推送通知](*silent-push)。
3. 使用[标准段](https://boost.yandex.com/doc/zh/analytics/content/mobile-reports/segmentation.md)来定义您计划发送通知的受众。 在分段菜单下，你可以看到按平台和语言分组的将收到通知的用户数。
   在推送营销设置中显示的用户数可能与所选段中活跃用户数不同。

   {% cut "为什么数字不匹配" %}

   Analytics module 使用设备的推送令牌来发送推送通知。 当应用启动时，AppMetrica Push SDK（[Android](https://boost.yandex.com/doc/zh/analytics/content/sdk/android/push/quick-start.md) | [iOS](https://boost.yandex.com/doc/zh/analytics/content/sdk/ios/push/quick-start.md)）会将推送令牌发送到服务器。

   这意味着该段包含已安装集成AppMetricaPush SDK 库的应用版本的用户，并且至少启动过应用一次。 用户也可以在应用中关闭推送通知。 这些用户不包含在推送广告的受众中。

   {% endcut %}

4. 点击 **Composer** 继续到下一步。

## 步骤 2. 创建推送通知 {#notification}

使用**Composer**创建推送通知。 要为某个平台创建通知，请在平台名称旁将设置改为 **开启**。

{% note warning "" %}

在创建通知时，请特别注意[限制](#restrictions)。

{% endnote %}

所有平台通用的字段：

- **标题** — 推送消息的标题。 它支持[表情符号](https://en.wikipedia.org/wiki/Emoji)。
- **文本** — 如果需要，您可以输入多种语言的文本。 语言列表是根据用户设备上设置的语言数据生成的。 通知文本支持[表情符号](https://en.wikipedia.org/wiki/Emoji)。
- **默认语言** — 如果用户设备设置的语言没有对应的通知文本，将使用的语言。 例如，向设置为土耳其语的设备发送推送通知，但**文本**字段中没有土耳其语内容。 在这种情况下，您可以将默认语言设置为英语，用户将收到英文通知。
- **操作** — 当通知被打开时要执行的操作。 有几种选项：
   - **打开应用程序**（默认）。
   - **URL** — 在浏览器中打开指定的URL。
   - **深链** — 打开一个[深链](*deeplink*)，直接跳转到应用中的特定屏幕。 您可以使用已在应用设置中定义的深链，或者通过点击**新链接**按钮创建一个新的深链。
- 在设备上测试 — 将配置的推送消息发送到指定的测试设备。 从列表中选择测试设备或创建新设备，然后点击 **测试**。
   另请注意每个平台特有的额外字段：

{% cut "Android" %}

- **图标资源 ID** — 应用程序图标在标准 `/res/drawable` 目录中的资源名称。 图标显示在通知栏中。 如果你不填写此字段，将使用标准应用图标。
- 图标背景 — 图标的颜色。 它以字符串形式指定，格式为[十六进制代码](https://ru.wikipedia.org/wiki/Цвета_HTML) `#AARRGGBB`. 默认情况下，图标背景是透明的。
- Image URL — 您可以在通知文本旁边显示一张图片。 指定您想显示的图像链接（例如，`http://example.com/image/pic1.png`）。
- 大广告横幅图片 — 通知的全尺寸（全宽）图片。 如果从上往下拖动通知，它会垂直展开。 指定要显示的图像链接（例如，`http://example.com/image/pic1.png`）。
- Push notification sound — 当消息送达用户设备时播放的音效。 可能的值：
   - **默认** — 音效将根据设备设置的模式播放。
   - **音量已关闭** — 通知将发送到设备，但没有声音。
- **震动** — 启用或禁用收到通知时的震动。
- **LED指示灯** — LED的颜色。 它以字符串形式指定，格式为[十六进制代码](https://ru.wikipedia.org/wiki/Цвета_HTML) `#RRGGBB`.
- **推送通知优先级** — 推送通知的优先级。 平台会根据消息的优先级确定处理方式：中断用户（在屏幕上显示消息），或者不通知用户。 在不同设备上，优先级的解释方式不同。
- **过期时间** — 继续尝试将通知送达用户设备的时长。 如果此时间已过且设备仍不可用（例如没有网络连接），通知将不会被送达。 默认情况下，时间没有限制。
- **渠道** — 推送通知渠道。 如果未指定通道，将使用默认通道。 适用于 Android 8 或更高版本。 要了解有关通道的更多信息，请参见[Android 文档](https://developer.android.com/training/notify-user/channels)。

{% endcut %}

{% cut "iOS" %}

- **标签** — 当收到通知时，会显示在桌面应用图标上的数字。
- **过期时间** — 继续尝试将通知送达用户设备的时长。 如果此时间已过而设备仍不可用（例如没有网络连接），通知将不会被送达。 默认情况下，时间没有限制。
- **推送通知声音** — 当消息送达用户设备时播放的声音。 可能的值：
   - **默认** — 音效将根据设备设置的模式播放。
   - **音量已关闭** — 通知将发送到设备，但没有声音。
- **跟踪推送通知的送达** — 启用/禁用跟踪 push 通知的送达。 默认启用。 如果你禁用跟踪，报告中送达的推送通知数量将等于打开的消息数量。

   {% note warning %}

   要跟踪配送，需要设置推送通知的统计收集。

   {% endnote %}

{% endcut %}

在**附加数据**字段中，您可以传输任何必要的数据作为字符串值。 您可以通过使用适当的 AppMetrica Push SDK 方法（[Android](https://boost.yandex.com/doc/zh/analytics/content/sdk/android/push/quick-start.md) | [iOS](https://boost.yandex.com/doc/zh/analytics/content/sdk/ios/push/quick-start.md)）来处理数据字符串。

### 限制 {#restrictions}

请注意以下关于推送通知的限制：

- Android 和 iOS：整个推送消息的内容不应超过 3968 字节。
- Windows：标题大小不应超过256字节，文本大小不应超过512字节。

{% note info "" %}

根据编码不同，1 个字符可能占用 1 到 4 个字节。

{% endnote %}

### AB 测试 {#ab-testing}

Analytics module 让您在启动推送营销时执行 **AB 测试**。 这种测试类型可以帮助你评估单一活动中不同类型通知的效果，从而决定哪种通知能带来最佳转化率。 您可以创建最多四个假设。

其中一个假设可以是*控制组*（对它不会发送推送通知）。 控制组用于比较未收到通知的用户与收到通知的所有用户的行为。

测试结果的统计数据可以在推送广告报告中查看。

## 步骤 3. 测试你的推送通知 {#test}

测试功能适用于 Android 和 iOS 设备。

在推送广告前，我们建议您在测试设备上检查通知的显示效果。 要测试通知：

1. 从下拉列表中选择可用的测试设备。 如果列表为空，请添加设备。

   {% cut "添加新设备" %}

   1. 点击新设备。
   2. 请指定设备 ID：Google AID、Apple IDFA、IDFV、Huawei OAID 或 AppMetrica 设备 ID。

      {% cut "如何获取 Google AID" %}

      在设备上打开“Google 设置”应用，然后在菜单中选择**广告**。 Google AID 显示在屏幕上（**你的广告识别码**）。

      {% endcut %}

      {% cut "如何获取 Apple IDFA" %}

      1. 在设备上安装应用 [The Identifiers](https://itunes.apple.com/us/app/the-identifiers/id564618183)。
      2. 在应用中打开 **原始** 标签。 您的设备的 IDFA 显示在 **广告标识符** 中。

      {% note alert %}

      从 iOS 14.5 开始，应用程序无法再访问 Apple 的 IDFA。 我们建议使用 AppMetrica 设备 ID 代替。

      {% endnote %}

      {% endcut %}

      {% cut "如何获取IDFV" %}

      1. 在测试设备上安装您的应用
      2. 转到 **数据导出** → **导出到文件**，然后导出设置，包含 `ios_ifv` 参数。 导出时使用过滤条件（例如按 **app_version_name** 过滤）。
      3. 复制 **ios_ifv** 字段中的 ID。

      {% endcut %}

      {% cut "如何获取 Huawei OAID" %}

      1. 在使用 EMUI 的手机上，前往 **设置** → **隐私** → **广告和隐私** → **更多信息**。
      2. 在“**您的广告 ID**”标题下找到 ID。 复制它。

      {% endcut %}

      {% cut "如何获取AppMetrica 设备 ID" %}

      1. 在测试设备上安装您的应用
      2. 在中，转到**报告** → **个人资料列表**。
      3. 找到您的个人资料。 在搜索时，使用分段（例如按构建号或设备属性）。
      4. 打开个人卡片，复制 `appmetrica_device_id`。

      {% note alert %}

      你不能再使用 AppMetrica 移动应用获取 AppMetrica 设备 ID 了。 使用它代替。

      {% endnote %}

      {% endcut %}

   3. 点击**添加**。 设备显示在下拉列表中。

   {% endcut %}

2. 点击**测试**。 通知将发送到测试设备。

{% note info "对于 iOS 设备" %}

在调试版本中可能收不到推送通知：来自**生产环境**部分的证书在这里无法使用。 因此，我们建议在发布版本中测试通知。

{% endnote %}

如果测试成功，点击**提交页面**继续下一步。

## 第4步。 检查信息并发送推送通知 {#send}

在提交推送通知的页面上，您可以看到将要发送的消息的所有通用信息。 请确认所有内容正确。

要发送推送通知：

1. 要延迟发送消息，请前往**发送计划**部分。
   点击 **稍后**，然后在日历中选择日期和时间。 如果你想调整发送时间以使用设备的时区，请启用**使用设备时区**选项。

2. 要启动广告投放，点击 **向用户发送推送**。

<!-- source: zh/analytics/content/_includes/feedback-button.md -->
如果您没有找到所需答案，可以通过反馈表单提交您的问题。 请尽可能详细地描述问题。 如果可能，请附上截图。

<a href="../troubleshooting/feedback-new">
  <span class="button">联系支持</span>
</a>

<a href="../troubleshooting/feedback-docs">
  <span class="button">为文档提出改进建议</span>
</a>
<!-- endsource: zh/analytics/content/_includes/feedback-button.md -->

[*silent-push]: 静默推送是在后台处理而不向用户显示的消息。 您可以通过静默推送消息向应用传输附加数据，或检查通知的送达情况。

[*deeplink]: 深链是打开设备上已安装应用并向其传输指定数据的链接。 其一般格式为 myapp://some_data。