创建和发送应用程序内消息
了解如何使用Experience PlatformMobile SDK和Journey Optimizer为移动应用程序创建应用程序内消息。
Journey Optimizer允许您创建营销活动,以将应用程序内消息发送给目标受众。 Journey Optimizer中的营销活动用于通过各种渠道向特定受众投放一次性内容。 借助营销策划,可同时执行各种操作,可以立即执行,也可以根据指定的计划执行。 使用历程时(请参阅Journey Optimizer推送通知课程),操作将按顺序执行。
在使用Journey Optimizer发送应用程序内消息之前,必须确保进行适当的配置和集成。 要了解Journey Optimizer中的应用程序内消息传送数据流,请参阅文档。
先决条件
- 在安装和配置SDK的情况下成功构建和运行应用程序。
- 为Adobe Experience Platform设置应用程序。
- 访问Journey Optimizer和足够的权限,如此处所述。 此外,您需要具有足够的权限才能使用以下Journey Optimizer功能。
- 管理营销活动。
- 用于测试的物理iOS设备或模拟器。
学习目标
在本课程中,您将执行以下操作
- 在AJO中创建应用程序表面。
- 安装和配置Journey Optimizer标记扩展。
- 更新您的应用程序以注册Journey Optimizer标记扩展。
- 验证Assurance中的设置。
- 在Journey Optimizer中定义您自己的营销活动和应用程序内消息体验。
- 在应用程序中发送您自己的应用程序内消息。
设置
在数据收集中添加应用程序表面
-
从数据收集界面中,在左侧面板中选择 应用程序表面。
-
要创建配置,请选择 创建应用程序表面。
-
输入配置的 名称,例如
Luma App Tutorial
。 -
从 移动设备应用程序配置 中,选择 Apple iOS。
-
在 应用程序ID (iOS捆绑包ID) 字段中输入移动应用程序捆绑包ID。 例如,
com.adobe.luma.tutorial.swiftui
。 -
选择 保存。
更新数据流配置
要确保将从您的移动应用程序发送到Edge Network的数据转发到Journey Optimizer,请更新您的Experience Edge配置。
-
在数据收集UI中,选择 数据流,然后选择您的数据流,例如 Luma Mobile App。
-
为 Experience Platform 选择 并从上下文菜单中选择 编辑。
-
在 数据流 > > Adobe Experience Platform 屏幕中,确保已选择 Adobe Journey Optimizer。 有关详细信息,请参阅Adobe Experience Platform设置。
-
要保存数据流配置,请选择 保存。
安装Journey Optimizer标记扩展
要使您的应用程序能够与Journey Optimizer配合使用,必须更新标记属性。
- 导航到 标记 > 扩展 > 目录。
- 打开您的属性,例如 Luma Mobile App Tutorial。
- 选择 目录。
- 搜索 Adobe Journey Optimizer 扩展。
- 安装扩展。
当 仅 在您的应用程序中使用应用程序内消息时,在 安装扩展 或 配置扩展 中,您无需配置任何内容。 但是,如果您已按照本教程中的推送通知课程进行操作,您将看到对于 开发 环境,已从 事件数据集 列表中选择 AJO推送跟踪体验事件数据集 数据集。
在应用程序中实施Journey Optimizer
如前面的课程中所述,安装移动标记扩展仅提供配置。 接下来,您必须安装并注册消息传送SDK。 如果未清除这些步骤,请查看安装SDK部分。
-
在Xcode项目导航器中导航到 Luma > Luma > AppDelegate。
-
确保
AEPMessaging
是导入列表的一部分。import AEPMessaging
-
请确保
Messaging.self
是正在注册的扩展数组的一部分。code language-swift let extensions = [ AEPIdentity.Identity.self, Lifecycle.self, Signal.self, Edge.self, AEPEdgeIdentity.Identity.self, Consent.self, UserProfile.self, Places.self, Messaging.self, Optimize.self, Assurance.self ]
使用Assurance验证设置
-
查看设置说明部分以将模拟器或设备连接到Assurance。
-
在Assurance UI中,选择 配置。
-
选择 应用程序内消息传送 旁边的 按钮。
-
选择 保存。
-
从左侧导航中选择 应用程序内消息传送。
-
选择 验证 选项卡。 确认您没有收到任何错误。
创建您自己的应用程序内消息
要创建您自己的应用程序内消息,您必须在Journey Optimizer中定义一个促销活动,以根据发生的事件触发应用程序内消息。 这些事件可以是:
- 数据发送到Adobe Experience Platform,
- 通过Mobile Core通用API的核心跟踪事件(如操作)或PII数据的状态或集合,
- 应用程序生命周期事件,例如启动、安装、升级、关闭或崩溃,
- 地理位置事件,例如进入或退出目标点。
在本教程中,您将使用Mobile Core通用API和与扩展无关的API(请参阅Mobile Core通用API)来促进对用户屏幕、操作和PII数据的事件跟踪。 这些API生成的事件将发布到SDK事件中心,可供扩展使用。 SDK事件中心提供了与所有Mobile Platform SDK扩展绑定的核心数据结构,其中维护着已注册的扩展和内部模块的列表、已注册的事件侦听器的列表以及共享状态数据库。
SDK事件中心发布并接收来自已注册的扩展的事件数据,以简化与Adobe和第三方解决方案的集成。 例如,在安装优化扩展时,事件中心将处理所有请求以及与Journey Optimizer — 决策管理选件引擎的交互。
-
在Journey Optimizer UI中,从左边栏中选择 促销活动。
-
选择 创建营销活动。
-
在 创建营销活动 屏幕中:
-
选择 应用程序内消息 并从 应用程序表面 列表中选择应用程序表面,例如 Luma Mobile App。
-
选择 创建
-
-
在Campaign定义屏幕的 属性 中,输入促销活动的 名称,例如
Luma - In-App Messaging Campaign
,并输入 描述,例如In-app messaging campaign for Luma app
。
-
向下滚动至 操作,然后选择 编辑内容。
-
在 应用程序内消息 屏幕中:
-
选择 模式 作为 消息布局。
-
为 媒体URL 输入
https://luma.enablementadobe.com/content/dam/luma/en/logos/Luma_Logo.png
。 -
输入 标头,例如
Welcome to this Luma In-App Message
,并输入 正文,例如Triggered by pushing that button in the app...
。 -
输入 解除 作为 按钮#1文本(主要)。
-
请注意预览的更新方式。
-
选择 查看以激活。
-
-
在 查看以激活(Luma — 应用程序内消息传送促销活动) 屏幕中,选择 计划 拼贴中的 。
-
返回 Luma - In-App Messaging Campaign 屏幕,选择 编辑触发器。
-
在 应用程序内消息触发器 对话框中,您可以配置触发应用程序内消息的跟踪操作的详细信息:
-
要删除 应用程序启动事件,请选择 。
-
重复使用 添加条件 为 显示消息if 生成以下逻辑。
-
单击 完成。
您已定义一个跟踪操作,其中 操作 等于
in-app
,而包含该操作的 上下文数据 是"showMessage" : "true"
的键值对。 -
-
返回 Luma - In-App Messaging Campaign 屏幕,选择 审阅以激活。
-
在 查看以激活(Luma — 应用程序内消息传送促销活动) 屏幕中,选择 激活。
-
您在 营销活动 列表中看到状态为 直播 的 Luma - In-App Messaging Campaign。
触发应用程序内消息
您已具备发送应用程序内消息的所有条件。 剩下的是如何在应用程序中触发此应用程序内消息的。
-
在Xcode项目导航器中,转到 Luma > Luma > Utils > MobileSDK。 查找
func sendTrackAction(action: String, data: [String: Any]?)
函数,并根据参数action
和data
添加以下代码以调用MobileCore.track
函数。code language-swift // Send trackAction event MobileCore.track(action: action, data: data)
-
转到Xcode项目导航器中的 Luma > Luma > Views > General > ConfigView。 查找应用程序内消息按钮的代码并添加以下代码:
code language-swift // Setting parameters and calling function to send in-app message Task { MobileSDK.shared.sendTrackAction(action: "in-app", data: ["showMessage": "true"]) }
使用应用程序进行验证
-
使用 ,在模拟器中或在Xcode的物理设备上重建并运行应用程序。
-
转到 设置 选项卡。
-
点按 应用程序内消息。 您会在应用程序中看到应用程序内消息。
{width="300"}
在Assurance中验证实施
您可以在Assurance UI中验证应用程序内消息。
- 查看设置说明部分以将模拟器或设备连接到Assurance。
- 选择 应用程序内消息传送。
- 选择 事件列表。
- 选择 显示消息 条目。
- Inspect原始事件,特别是
html
,其中包含应用程序内消息的完整布局和内容。
后续步骤
现在,您应该拥有所有相关和适用的所有工具,以便开始添加应用程序内消息。 例如,根据您在应用程序中跟踪的特定交互来促销产品。
下一步: 创建和显示选件