创建原生应用内消息

原生应用内消息使用现成的布局，由 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+。Video 目前仅支持 iOS。

创建原生应用内消息模板

1. 前往 Content → In-apps。
2. 点击 Create in-app。
3. 输入模板名称。
4. 选择 Create native rich media。
5. 在 DISPLAY TYPE 中，选择一个显示类型：modal、fullscreen、stories、sheet、carousel、banner 或 video。
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 留空，横幅将停留在屏幕上无法关闭。点击总是会打开链接而不是关闭它。

视频 (Video)

一个用于 HLS 流媒体链接（.m3u8）或直接 .mp4 文件的全屏播放器，顶部可选择添加标题、消息和按钮。

注意

视频目前仅在 iOS 上可用。在 Android 上，使用此显示类型的模板不会渲染。有关详细信息，请参阅平台支持。

1. 在 Content 下，将 Video URL（必填）设置为一个指向 .m3u8 或 .mp4 文件的绝对 HTTPS 链接。可选地，添加一个在播放开始前显示的 Poster 图片，以及一个在视频无法播放时显示的 Fallback image。
2. 添加标题和消息，每个都有自己的文本颜色。
3. 在 Config 下，打开 Loop 以在视频结束后重新开始播放。
4. 打开 Muted 以在静音状态下开始播放。
5. 如果您想要一个 ✕ 控件，以便用户无需等待视频结束即可关闭应用内消息，请打开 Close button。
6. 在 Actions 下，添加一个或多个按钮。请参阅配置按钮。

配置文本字段

文本字段不支持多行文本。如果您按 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 检查会捕获语法错误，如未关闭的标签。它仍可能通过不完整的表达式，这些表达式只有在发送消息时才会失败。如果您使用的不仅仅是简单的标签，请给自己发送一个测试。

配置按钮

模态、全屏、每个故事幻灯片、底部动作条和视频使用相同的按钮字段：

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

点击 Add 添加另一个按钮，或点击按钮上的 × 将其移除。

警告

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

添加图片

每个图片字段（图片、封面图片以及每个卡片或幻灯片的图片）的工作方式都相同。将托管的图片 URL 直接粘贴到字段中，或点击其旁边的 Choose from Media storage 打开媒体库并选择您已上传的图片。从媒体库中选择图片会替换字段中当前的任何 URL。

添加本地化

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

注意

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

1. 点击顶部栏中语言选择器旁边的 +。
2. 选择要添加的语言并点击 Apply。

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

注意

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

保存模板

点击右上角的 Save 以保存您的更改。

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

在营销活动中使用它

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

您可以用它来：

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

注意

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