创建和发送应用程序内消息

了解如何使用Experience PlatformMobile SDK和Journey Optimizer为移动应用程序创建应用程序内消息。

Journey Optimizer允许您创建营销活动,以将应用程序内消息发送给目标受众。 Journey Optimizer中的营销活动用于通过各种渠道向特定受众投放一次性内容。 借助营销策划,可同时执行各种操作,可以立即执行,也可以根据指定的计划执行。 使用历程时(请参阅Journey Optimizer推送通知课程),操作将按顺序执行。

架构

在使用Journey Optimizer发送应用程序内消息之前,必须确保进行适当的配置和集成。 要了解Journey Optimizer中的应用程序内消息传送数据流,请参阅文档

NOTE
本课程是可选的,仅适用于希望发送应用程序内消息的Journey Optimizer用户。

先决条件

  • 在安装和配置SDK的情况下成功构建和运行应用程序。
  • 为Adobe Experience Platform设置应用程序。
  • 访问Journey Optimizer和足够的权限,如此处所述。 此外,您需要具有足够的权限才能使用以下Journey Optimizer功能。
    • 管理营销活动。
  • 用于测试的物理iOS设备或模拟器。

学习目标

在本课程中,您将执行以下操作

  • 在AJO中创建应用程序表面。
  • 安装和配置Journey Optimizer标记扩展。
  • 更新您的应用程序以注册Journey Optimizer标记扩展。
  • 验证Assurance中的设置。
  • 在Journey Optimizer中定义您自己的营销活动和应用程序内消息体验。
  • 在应用程序中发送您自己的应用程序内消息。

设置

TIP
如果您已将环境设置为Journey Optimizer推送消息课程的一部分,则您可能已执行了此设置部分中的某些步骤。

在数据收集中添加应用程序表面

  1. 数据收集界面中,在左侧面板中选择​ 应用程序表面

  2. 要创建配置,请选择​ 创建应用程序表面
    应用表面主页

  3. 输入配置的​ 名称,例如Luma App Tutorial

  4. 从​ 移动设备应用程序配置 ​中,选择​ Apple iOS

  5. 在​ 应用程序ID (iOS捆绑包ID) ​字段中输入移动应用程序捆绑包ID。 例如,com.adobe.luma.tutorial.swiftui

  6. 选择​ 保存

    应用程序表面配置

更新数据流配置

要确保将从您的移动应用程序发送到Edge Network的数据转发到Journey Optimizer,请更新您的Experience Edge配置。

  1. 在数据收集UI中,选择​ 数据流,然后选择您的数据流,例如​ Luma Mobile App

  2. 为​ Experience Platform ​选择 更多 并从上下文菜单中选择 编辑 编辑

  3. 在​ 数据流 > 文件夹 > Adobe Experience Platform ​屏幕中,确保已选择​ Adobe Journey Optimizer。 有关详细信息,请参阅Adobe Experience Platform设置

  4. 要保存数据流配置,请选择​ 保存

    AEP数据流配置

安装Journey Optimizer标记扩展

要使您的应用程序能够与Journey Optimizer配合使用,必须更新标记属性。

  1. 导航到​ 标记 > 扩展 > 目录
  2. 打开您的属性,例如​ Luma Mobile App Tutorial
  3. 选择​ 目录
  4. 搜索​ Adobe Journey Optimizer ​扩展。
  5. 安装扩展。

当​ ​在您的应用程序中使用应用程序内消息时,在​ 安装扩展 ​或​ 配置扩展 ​中,您无需配置任何内容。 但是,如果您已按照本教程中的推送通知课程进行操作,您将看到对于​ 开发 ​环境,已从​ 事件数据集 ​列表中选择​ AJO推送跟踪体验事件数据集 ​数据集。

在应用程序中实施Journey Optimizer

如前面的课程中所述,安装移动标记扩展仅提供配置。 接下来,您必须安装并注册消息传送SDK。 如果未清除这些步骤,请查看安装SDK部分。

NOTE
如果您已完成安装SDK部分,则表明该SDK已安装,您可以跳过此步骤。
  1. 在Xcode中,确保将AEP消息添加到包依赖关系中的包列表中。 请参阅Swift包管理器

  2. 在Xcode项目导航器中导航到​ Luma > Luma > AppDelegate

  3. 确保AEPMessaging是导入列表的一部分。

    import AEPMessaging

  4. 请确保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验证设置

  1. 查看设置说明部分以将模拟器或设备连接到Assurance。

  2. 在Assurance UI中,选择​ 配置
    配置click

  3. 选择​ 应用程序内消息传送 ​旁边的 加号 按钮。

  4. 选择​ 保存
    保存

  5. 从左侧导航中选择​ 应用程序内消息传送

  6. 选择​ 验证 ​选项卡。 确认您没有收到任何错误。

    应用程序内验证

创建您自己的应用程序内消息

要创建您自己的应用程序内消息,您必须在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 — 决策管理选件引擎的交互。

  1. 在Journey Optimizer UI中,从左边栏中选择​ 促销活动

  2. 选择​ 创建营销活动

  3. 在​ 创建营销活动 ​屏幕中:

    1. 选择​ 应用程序内消息 ​并从​ 应用程序表面 ​列表中选择应用程序表面,例如​ Luma Mobile App

    2. 选择​ 创建

      营销活动属性

  4. 在Campaign定义屏幕的​ 属性 ​中,输入促销活动的​ 名称,例如Luma - In-App Messaging Campaign,并输入​ 描述,例如In-app messaging campaign for Luma app
    促销活动名称

  5. 向下滚动至​ 操作,然后选择​ 编辑内容

  6. 在​ 应用程序内消息 ​屏幕中:

    1. 选择​ 模式 ​作为​ 消息布局

    2. 为​ 媒体URL ​输入https://luma.enablementadobe.com/content/dam/luma/en/logos/Luma_Logo.png

    3. 输入​ 标头,例如Welcome to this Luma In-App Message,并输入​ 正文,例如Triggered by pushing that button in the app...

    4. 输入​ 解除 ​作为​ 按钮#1文本(主要)

    5. 请注意预览的更新方式。

    6. 选择​ 查看以激活

      应用程序内编辑器

  7. 在​ 查看以激活(Luma — 应用程序内消息传送促销活动) ​屏幕中,选择​ 计划 ​拼贴中的 编辑
    查看计划选择计划

  8. 返回​ Luma - In-App Messaging Campaign ​屏幕,选择 编辑 编辑触发器

  9. 在​ 应用程序内消息触发器 ​对话框中,您可以配置触发应用程序内消息的跟踪操作的详细信息:

    1. 要删除​ 应用程序启动事件,请选择 关闭

    2. 重复使用 添加 添加条件 ​为​ 显示消息if ​生成以下逻辑。

    3. 单击​ 完成

      触发器逻辑

    您已定义一个跟踪操作,其中​ 操作 ​等于in-app,而包含该操作的​ 上下文数据 ​是"showMessage" : "true"的键值对。

  10. 返回​ Luma - In-App Messaging Campaign ​屏幕,选择​ 审阅以激活

  11. 在​ 查看以激活(Luma — 应用程序内消息传送促销活动) ​屏幕中,选择​ 激活

  12. 您在​ 营销活动 ​列表中看到状态为​ 直播 ​的​ Luma - In-App Messaging Campaign
    营销活动列表

触发应用程序内消息

您已具备发送应用程序内消息的所有条件。 剩下的是如何在应用程序中触发此应用程序内消息的。

  1. 在Xcode项目导航器中,转到​ Luma > Luma > Utils > MobileSDK。 查找func sendTrackAction(action: String, data: [String: Any]?)函数,并根据参数actiondata添加以下代码以调用MobileCore.track函数。

    code language-swift
    // Send trackAction event
    MobileCore.track(action: action, data: data)
    
  2. 转到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"])
    }
    

使用应用程序进行验证

  1. 使用 Play ,在模拟器中或在Xcode的物理设备上重建并运行应用程序。

  2. 转到​ 设置 ​选项卡。

  3. 点按​ 应用程序内消息。 您会在应用程序中看到应用程序内消息。

    {width="300"}

在Assurance中验证实施

您可以在Assurance UI中验证应用程序内消息。

  1. 查看设置说明部分以将模拟器或设备连接到Assurance。
  2. 选择​ 应用程序内消息传送
  3. 选择​ 事件列表
  4. 选择​ 显示消息 ​条目。
  5. Inspect原始事件,特别是html,其中包含应用程序内消息的完整布局和内容。
    保证应用程序内消息

后续步骤

现在,您应该拥有所有相关和适用的所有工具,以便开始添加应用程序内消息。 例如,根据您在应用程序中跟踪的特定交互来促销产品。

SUCCESS
您已为应用程序内消息传送启用应用程序,并为Experience PlatformMobile SDK使用Journey Optimizer和Journey Optimizer扩展添加了应用程序内消息传送促销活动。
感谢您投入时间学习Adobe Experience Platform Mobile SDK。 如果您有疑问、希望共享一般反馈或有关于未来内容的建议,请在此Experience League社区讨论帖子上共享它们。

下一步: 创建和显示选件

recommendation-more-help
9fed61f5-c338-47ad-8005-0b89a5f4af8b