> ## Documentation Index
> Fetch the complete documentation index at: https://documentation.onesignal.com/llms.txt
> Use this file to discover all available pages before exploring further.
# 应用内消息概览
> 开始使用 OneSignal 应用内消息：如何设置、设计、触发和测试应用内活动来有效地吸引您的移动用户。
应用内消息 (IAM) 是在您的移动应用内显示的可自定义、有针对性的消息。它们使您能够：
* 提示用户操作，如订阅推送通知或更新他们的位置。
* 向目标用户推广新功能或未充分利用的功能。
* 实时显示公告和新闻，无需发布应用更新。
* 创建调查和轮播。
* 帮助进行引导和教育内容。
***
## 应用内设置
您必须在应用中安装 OneSignal SDK 才能使用应用内消息。完成后，您可以从 OneSignal 仪表板创建和发送应用内消息，无需编写任何代码。我们的 SDK 还具有用于高级用例的方法，如：
* 在特定时间触发消息
* 点击处理和深度链接
* 暂停消息
* 生命周期管理等等！
将 OneSignal 添加到您的移动应用代码库中。
开发者：访问触发器、点击处理器和生命周期 API。
基于用户行为或应用活动控制消息何时出现。
定义用户与您的消息交互时会发生什么。
***
## 发送应用内消息
您可以从 OneSignal 仪表板和历程中发送应用内消息。
从 OneSignal 仪表板撰写并发送应用内消息。
构建自动化的多步骤和多渠道流程。
### 从仪表板发送
选择 **创建...** 然后选择您的消息渠道。您也可以导航到 **消息** 或 **模板** 查看以前的消息。
* 使用[块编辑器](./design-your-in-app-message)或 [HTML 编辑器](./design-your-in-app-message-with-html)从头开始
* 使用预构建的[模板](./templates)
添加用于跟踪和报告的内部元数据。API 对应字段：`name`
选择哪些用户接收消息。您可以包含和排除[细分](./segmentation)以定位特定群体。如果未设置细分，默认为所有“已订阅用户”。
应用内消息将传递给细分中的所有[移动订阅](./subscriptions)，无论推送选择加入状态如何。但是，如果您的消息包含推送提示[点击操作](#click-actions)，它将不会显示给已订阅（已选择加入）的移动订阅。
### 消息设计
使用我们的可视化拖放编辑器或 HTML 编辑器以获得更多控制。
使用我们的可视化编辑器快速构建消息。
为开发者提供完全控制来自定义消息。
从经过测试的布局和活动开始。
Add OneSignal's click actions to your HTML messages.
添加动态内容以为每个用户个性化消息。
为全球受众本地化您的内容。
### 点击操作
自定义用户点击消息中元素时发生的事情。
自定义用户点击消息中元素时发生的事情。
跟踪与消息的交互。
使用我们的移动 SDK 响应点击事件。
在点击时导航用户。
### 触发器
定义消息在应用会话期间何时出现。
Four trigger types:
用户启动应用时触发。
Delay X seconds after app open.
Delay X time after last in-app message.
Controlled via SDK `addTrigger(s)`.
#### 此消息何时应该被取消？
Messages can dismiss:
* On user interaction (click, swipe)
* 设定时间后（自动取消）
### 计划和频率
* **开始显示**：消息符合条件时
* **Stop Showing**: Set end date/time or "Show forever"
#### 您希望多久显示一次此消息？
* **Only once** (default)
* **Every time** triggers are met
* **Multiple times** with custom repeat logic:
Examples:
* Show **2 times** with **1 hour** gap
* Show **12 times** with **30 days** gap
***
## 应用内消息如何显示
应用内消息不是主动推送的。相反，它们在应用启动时根据受众被拉取。然后根据触发逻辑显示。
消息将显示如果：
1. 用户在 **新会话** 开始 *之前* 符合受众标准。
* A **new session** starts when the user opens your app after it has been in the background or closed for at least 30 seconds.
* 如果用户在消息上线时打开了应用或在同一会话期间进入细分，他们需要将应用失去焦点（关闭或后台）至少 30 秒才有资格看到消息。
2. 触发条件得到满足。
3. 计划的时间和频率有效。
如果细分标准在会话中期发生变化，用户必须重新打开应用才能看到消息。
### 测试
While testing, it is recommended to do the following:
Add our [`setLogLevel` method to `Verbose`](./mobile-sdk-reference#setloglevel) in your app to get more detailed logs.
如上所述在[应用内消息如何显示](#how-in-app-messages-are-shown)中，用户必须在 **新会话开始之前** 符合受众标准。
* See [Find Devices & Set Test Users](./test-users) if you don't know your device's Subscription ID.
* 确保您设备的订阅在包含的细分中，如果使用的话，不在排除的细分中。
* **提示**：您可以将您的设备添加为测试订阅，并创建或更新细分以包含 **测试用户** 筛选器。
这将确保您正在打开应用以创建新会话并符合接收消息的条件。
确保您满足消息显示的[触发器](#triggers)。
* Make sure the "Start showing" and "Stop showing" dates are set correctly.
* 在测试时将[“您希望多久显示一次此消息？”](#schedule-%26-frequency)设置为“每次触发条件得到满足时”。
* 一旦消息处于活动状态，您可以在设备上打开应用。
* 您应该根据您的触发条件看到消息显示。
#### Test & Preview button
使用 **测试和预览** 按钮将向您选择的测试设备发送推送通知。当您点击推送打开应用时，应用内消息将显示。要使用此功能，您必须：
* 确保您的设备是[测试用户](./test-users)。
* 推送通知 **仅用于测试目的**。当消息正式上线时不会发送推送。
* 您可以打开应用并发送“测试消息”。应用内消息将显示。
* 标签替换不适用于测试应用内消息。
* 如果您没有看到消息，请确保您已遵循[测试步骤](#testing)。
需要帮助？
与我们的支持团队聊天或发送邮件至 `support@onesignal.com`
请包含以下信息：
* 您遇到的问题详情以及复现步骤（如有）
* 您的 OneSignal 应用 ID
* 外部 ID 或订阅 ID（如适用）
* 您在 OneSignal 控制台中测试的消息 URL（如适用）
* 任何相关的[日志或错误信息](/docs/cn/capturing-a-debug-log)
我们很乐意为您提供帮助！
***
## 教程和用例
Step-by-step guide to personalize your in-app message with tags.
提示用户更新其应用。
通过及时的评价请求提高您的评分。
在您的应用内收集反馈。
Improve push opt-in rates.
请求用户启用位置跟踪。
设置教程来帮助用户了解您应用的新功能！
***
## 分析
跟踪消息性能和参与度。
应用内消息的展示次数、点击次数、关闭次数和转化指标。
OneSignal 中所有可用的分析选项。
实时将推送事件流式传输到您的数据仓库或 BI 工具。
***
## 常见问题
### 应用内消息需要推送通知权限吗？
不需要。应用内消息会发送至目标细分群体中的所有移动端订阅者，无论其推送订阅状态如何。它们在活跃会话期间显示在应用内。
### 为什么我的应用内消息没有显示？
最常见的原因是用户的会话未刷新。用户必须关闭或将应用切换到后台至少30秒，然后重新打开以开始新会话。还请验证用户是否在目标细分群体中，以及是否满足触发条件。完整清单请参见[测试](#testing)。
### 我可以通过 API 发送应用内消息吗？
您必须在 OneSignal 控制台中创建应用内消息。
您可以将应用内消息包含在 [Journeys](./journeys-overview) 中，并通过从 API 触发的[自定义事件](./custom-events)将用户加入 Journey。
### 应用内消息与推送通知有何不同？
应用内消息在用户主动使用应用时显示在应用内。推送通知显示在设备的通知栏中，即使应用关闭也可以触达用户。应用内消息不需要推送权限，在会话开始时拉取，而不是由服务器推送。
### 我可以在网页上使用应用内消息吗？
不可以。应用内消息仅适用于安装了 OneSignal 移动 SDK 的移动应用。对于网页，请考虑改用[网页推送通知](./web-push-setup)。
应用内消息 (IAM) 是在您的移动应用内显示的可自定义、有针对性的消息。它们使您能够：
* 提示用户操作，如订阅推送通知或更新他们的位置。
* 向目标用户推广新功能或未充分利用的功能。
* 实时显示公告和新闻，无需发布应用更新。
* 创建调查和轮播。
* 帮助进行引导和教育内容。
***
## 应用内设置
您必须在应用中安装 OneSignal SDK 才能使用应用内消息。完成后，您可以从 OneSignal 仪表板创建和发送应用内消息，无需编写任何代码。我们的 SDK 还具有用于高级用例的方法，如：
* 在特定时间触发消息
* 点击处理和深度链接
* 暂停消息
* 生命周期管理等等！
Four trigger types:
### 计划和频率
* **开始显示**：消息符合条件时
* **Stop Showing**: Set end date/time or "Show forever"
#### 您希望多久显示一次此消息？
* **Only once** (default)
* **Every time** triggers are met
* **Multiple times** with custom repeat logic:
Examples:
* Show **2 times** with **1 hour** gap
* Show **12 times** with **30 days** gap
***
## 应用内消息如何显示
应用内消息不是主动推送的。相反，它们在应用启动时根据受众被拉取。然后根据触发逻辑显示。
消息将显示如果：
1. 用户在 **新会话** 开始 *之前* 符合受众标准。
* A **new session** starts when the user opens your app after it has been in the background or closed for at least 30 seconds.
* 如果用户在消息上线时打开了应用或在同一会话期间进入细分，他们需要将应用失去焦点（关闭或后台）至少 30 秒才有资格看到消息。
2. 触发条件得到满足。
3. 计划的时间和频率有效。
如果细分标准在会话中期发生变化，用户必须重新打开应用才能看到消息。
### 测试
While testing, it is recommended to do the following: