创建原生应用内消息

原生应用内消息使用现成的布局，由 Pushwoosh SDK 直接在设备上渲染，而不是像自定义应用内消息那样加载 HTML 页面。这使得它们加载更快，动画更流畅，而且您不需要设计或开发技能即可构建一个。

当您想快速发布促销、提醒或功能公告，且不需要完全自定义的布局时，可以选择原生应用内消息。如果您需要完全控制设计，请改为构建基于 HTML 的应用内消息。

先决条件

需要开发者协助

您可以在控制面板中构建原生应用内消息模板，无需任何代码更改。但只有当用户的应用运行的 Pushwoosh SDK 版本足够新，能够渲染该消息时，用户才能看到它。在发布前，请与您的开发团队确认。

在创建原生应用内消息模板之前，请确保：

• 您的应用中已集成 Pushwoosh SDK，以便应用内消息可以显示。了解更多
• 您的应用运行 iOS SDK 7.2.0+ 或 Android SDK 6.10.0+ 以支持 modal、fullscreen 和 stories。Sheet、carousel 和 banner 需要 iOS SDK 7.2.1+ 或 Android SDK 6.10.1+。

创建原生应用内消息模板

1. 前往 内容 (Content) → 应用内消息 (In-apps)。
2. 点击 创建应用内消息 (Create in-app)。
3. 输入模板名称。
4. 选择 创建原生富媒体 (Create native rich media)。
5. 在 显示类型 (DISPLAY TYPE) 中，选择一种显示类型：modal、fullscreen、stories、sheet、carousel 或 banner。
6. 点击 创建应用内消息 (Create in-app)。

编辑器将打开，右侧是实时移动预览，左侧是模板字段，分为 内容 (Content)、配置 (Config) 和 操作 (Actions) 三组。您在每组中看到的内容取决于您选择的显示类型。

配置显示类型

警告

编辑器顶部的 显示类型 (Display type) 下拉菜单允许您随时切换类型，但切换会将其下方的所有“内容 (Content)”、“配置 (Config)”和“操作 (Actions)”字段重置为新类型的默认值。请在确定类型后再填写内容。

Modal (模态框)

一个居中的卡片，可选择在变暗的背景上显示。

1. 在 内容 (Content) 下，添加标题和消息，各自有独立的文本颜色，以及一个可选的图片。
2. 在 配置 (Config) 下，设置卡片背景颜色。这将填充文本和图片后面的卡片区域。
3. 如果您希望有一个 ✕ 控件，以便用户无需点击按钮即可关闭应用内消息，请打开 关闭按钮 (Close button)。
4. 打开 背景变暗 (Dim background) 以使卡片后面的屏幕变暗，从而将焦点保持在您的消息上。
5. 在 操作 (Actions) 下，添加一个或多个按钮。请参阅配置按钮。

Fullscreen (全屏)

一张铺满屏幕的封面图片，上面有文本和按钮。在左侧面板中填写以下字段：

1. 在 内容 (Content) 下，添加一张封面图片，以及标题和消息，各自有独立的文本颜色。
2. 在 配置 (Config) 下，设置封面颜色。它会在封面图片加载时显示，或者如果您将图片留空，它会单独显示。
3. 如果您希望有一个 ✕ 控件，以便用户无需点击按钮即可关闭应用内消息，请打开 关闭按钮 (Close button)。
4. 在 操作 (Actions) 下，添加一个或多个按钮。请参阅配置按钮。

Stories (故事)

一系列全屏幻灯片，顶部有进度条，类似于社交媒体故事。每张幻灯片都是 内容 (Content) 下的一个独立的 Stories 条目。

1. 填写第一张幻灯片的 图片 (Image)、标题 (Title) 和 消息 (Message)（各自有独立的文本颜色）。
2. 设置 秒数 (Seconds)，即幻灯片在自动切换前在屏幕上停留的时间。默认值为 5。输入 1 到 30 之间的值。超出此范围的值将导致 保存 (Save) 因验证错误而被阻止。
3. （可选）点击幻灯片内的 添加 (Add)，为其设置专属的 CTA 按钮。请参阅配置按钮。

4. 点击最后一张幻灯片下方的 添加 (Add) 以添加另一张幻灯片，然后为其重复步骤 1-3。
5. 在 配置 (Config) 下，如果您希望故事在最后一张幻灯片结束后从第一张重新开始，请打开 循环 (Loop)。
6. 如果您希望有一个 ✕ 控件，以便用户可以在所有幻灯片播放完毕前退出，请打开 关闭按钮 (Close button)。

最终故事对用户的展示效果示例

Sheet (底部滑出式)

一个从屏幕下边缘向上滑出的底部面板。顶部的把手允许用户向下拖动以关闭。

在左侧面板中填写以下字段：

1. 在 内容 (Content) 下，添加标题和消息，各自有独立的文本颜色，以及一个可选的图片。
2. 在 配置 (Config) 下，设置底部面板的背景颜色。这将填充文本和图片后面的面板区域。
3. 如果您希望有一个 ✕ 控件，以便用户无需点击按钮即可关闭底部面板，请打开 关闭按钮 (Close button)。
4. 在 操作 (Actions) 下，添加一个或多个按钮。请参阅配置按钮。

Carousel (轮播)

一个全屏消息，包含多张用户可以滑动的卡片。底部的圆点显示当前活动的卡片。在 内容 (Content) 下，每张卡片都是一个独立的 Cards 条目。

1. 填写第一张卡片的 图片 (Image)、标题 (Title) 和 消息 (Message)（各自有独立的文本颜色）。
2. 为卡片设置 操作 (Action)。选择 close 以在用户点击卡片时关闭应用内消息，或选择 url 以打开链接（选项与配置按钮相同）。
3. 点击最后一张卡片下方的 添加 (Add) 以添加另一张卡片，然后为其重复步骤 1-2。
4. 如果您希望有一个 ✕ 控件，以便用户无需点击卡片即可离开轮播，请打开 关闭按钮 (Close button)。

警告

如果您关闭 关闭按钮 (Close button) 并将每张卡片的 操作 (Action) 设置为 url，用户将没有屏幕上的控件来关闭轮播。点击总是会打开链接而不是关闭它。

Banner (横幅)

一个固定在屏幕顶部或底部边缘的紧凑条，用于显示不应阻挡整个 UI 的消息。

1. 在 内容 (Content) 下，添加标题和消息，各自有独立的文本颜色，以及一个可选的小图片。
2. 在 配置 (Config) 下，将 位置 (Position) 设置为 top 或 bottom，以将横幅固定在您想要的屏幕边缘。
3. 设置 自动关闭（秒）(Auto-dismiss, sec)，以便在指定秒数后自动关闭横幅。留空则横幅会一直显示，直到用户关闭它。
4. 设置横幅的背景颜色。
5. 如果您希望横幅上有一个 ✕ 控件，请打开 关闭按钮 (Close button)。
6. 在 操作 (Actions) 下，将 操作 (Action) 设置为 close 或 url。横幅没有单独的按钮。点击横幅的任何位置都会执行此操作。有关 close 和 url 的行为，请参阅配置按钮。

警告

如果您关闭 关闭按钮 (Close button)，将 操作 (Action) 设置为 url，并留空 自动关闭 (Auto-dismiss)，横幅将停留在屏幕上无法关闭。点击总是会打开链接而不是关闭它。

配置文本字段

文本字段不支持多行文本。如果您按 Enter 键，编辑器可能会显示换行符，但 Pushwoosh 会保存为空格。在设备上，文本将显示为一行。

要添加表情符号，请点击字段工具栏旁边的 表情符号 (Emoji)。支持表情符号的文本字段与支持纯文本的字段相同。请检查实时预览，查看它们在布局中的显示效果。

添加动态内容

每个文本字段都支持使用标签和 User ID 进行个性化。

1. 点击字段工具栏旁边的 个性化 (Personalization)。
2. 在 标签 (Tag) 下，选择一个标签或 User ID。
3. 选择一个格式修饰符（例如，CapitalizeFirst 或 regular）。
4. （可选）输入一个 默认标签值 (Default Tag Value)。
5. 点击 插入 (Insert)。

插入的标签在字段中显示为一个芯片。在点击 插入 (Insert) 之前，您可以更改标签、修饰符和默认值。个性化使用与动态内容相同的标签、修饰符和默认值。

提示

对于条件逻辑（例如，仅当某个标签等于特定值时才显示此文本），请直接在字段中输入 Liquid 语法。

当您点击 保存 (Save) 时，Pushwoosh 会检查每个文本字段中的动态内容和 Liquid。如果某个字段无法解析（例如，一个未关闭的 {% if %} 标签），保存 (Save) 将被阻止，并会弹出一个 动态内容包含错误 (Dynamic content contains errors) 的提示，指出有问题的字段和语言。在那里修复它，然后再次点击 保存 (Save)。

注意

保存时的 Liquid 检查会捕获语法错误，如未关闭的标签。但它仍可能通过不完整的表达式，这些表达式只有在消息发送时才会失败。如果您使用的不仅仅是简单的标签，请给自己发送一个测试。

配置按钮

Modal、fullscreen、每个 stories 幻灯片和 sheet 使用相同的按钮字段：

• 按钮文本 (Button text) 及其颜色。
• 背景 (Background)、边框颜色 (Border color) 和 边框半径 (Border radius)。
• 操作 (Action)： 选择用户点击按钮时发生的事情：
  • close： 关闭应用内消息。
  • url： 打开您在出现的字段中输入的链接。使用网址（例如，https://example.com）或指向您应用的深层链接（例如，myapp://product/123）。

点击 添加 (Add) 以添加另一个按钮，或点击按钮上的 × 以移除它。

警告

如果您关闭 关闭按钮 (Close button) 并且不添加任何按钮，用户将没有屏幕上的控件来关闭应用内消息。

添加本地化

默认情况下，原生应用内消息只有一种语言。要添加更多语言：

注意

此处的语言选择器仅计算渲染应用内内容的平台上的设备。通过用户级标签设置的语言值与设备平台无关，因此不会在此处显示。

1. 点击顶部栏中语言选择器旁边的 +。
2. 选择要添加的语言，然后点击 应用 (Apply)。

3. 使用顶部栏中的语言选择器在不同语言之间切换，并为每种语言填写文本字段。

注意

当您添加一种语言时，Pushwoosh 会将默认语言的内容复制到其中：文本、图片和按钮标签。切换到该语言并独立编辑这些字段中的任何一个。

保存模板

点击右上角的 保存 (Save) 以持久化您的更改。

然后，该模板将与您的其他应用内消息模板一起出现在 内容 (Content) → 应用内消息 (In-apps) 中。

在营销活动中使用

原生应用内消息模板会与您的其他应用内消息模板一起出现在模板选择器中。

您可以用它来：

• 发送即时应用内消息
• 向 Customer Journey 添加应用内消息步骤
• 当用户点击推送时打开应用内消息

注意

投放设置，如开始和结束日期以及频率上限，与任何其他应用内消息的工作方式相同，不属于此编辑器的一部分。