使用决策管理创建和显示优惠

了解如何使用Experience Platform移动SDK在移动应用程序中显示Journey Optimizer决策管理中的选件。

Journey Optimizer决策管理可帮助您在适当的时候通过所有接触点为客户提供最佳优惠和体验。 设计完成后,为您的受众提供个性化优惠。

架构

决策管理通过集中的营销优惠库和决策引擎(该引擎可将规则和约束应用于Adobe Experience Platform创建的丰富实时用户档案)轻松实现个性化。 这样,您就可以在适当的时间向客户发送合适的优惠。 请参阅 关于决策管理 以了解更多信息。

NOTE
本课程是可选的,仅适用于希望使用决策管理功能在移动应用程序中显示优惠的Journey Optimizer用户。

先决条件

  • 在安装和配置SDK的情况下成功构建和运行应用程序。
  • 为Adobe Experience Platform设置应用程序。
  • 访问Journey Optimizer — 具有相应权限以管理优惠和决策的决策管理,如所述 此处.

学习目标

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

  • 为决策管理更新您的边缘配置。
  • 使用Journey Optimizer - Decisioning扩展更新您的标记属性。
  • 更新您的架构以捕获建议事件。
  • 验证Assurance中的设置。
  • 根据Journey Optimizer - Decision Management中的优惠创建优惠决策。
  • 更新您的应用程序以注册Optimizer扩展。
  • 在应用程序中实施来自决策管理的选件。

设置

TIP
如果您已将环境设置为 使用Target设置A/B测试 课程,您可能已经执行了此设置部分中的某些步骤。

更新数据流配置

要确保将从您的移动应用程序发送到Platform边缘网络的数据转发到Journey Optimizer — 决策管理,请更新您的数据流。

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

  2. 选择 更多 对象 Experience Platform 并选择 编辑 编辑 从上下文菜单中。

  3. 数据流 > 文件夹 > Adobe Experience Platform 屏幕,确保 offer decisioning边缘分段、和 Adobe Journey Optimizer 已选中。 如果要学习Target课程,请选择 个性化目标 ​也一样。 请参阅 Adobe Experience Platform设置 以了解更多信息。

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

    AEP数据流配置

安装Journey Optimizer - Decisioning标记扩展

  1. 导航到 标记 并找到您的移动标记资产并打开该资产。

  2. 选择 扩展.

  3. 选择 目录.

  4. 搜索 Adobe Journey Optimizer - Decisioning 扩展。

  5. 安装扩展。 该扩展不需要其他配置。

    Add Decisioning扩展

更新您的架构

  1. 导航到数据收集界面并选择 架构 从左边栏开始。
  2. 选择 浏览 从顶部栏中。
  3. 选择您的架构以将其打开。
  4. 在架构编辑器中,选择 添加 添加 ,位于字段组旁边。
  5. 添加字段组 对话框, Search 搜索 proposition,选择 体验事件 — 建议交互 并选择 添加字段组. 此字段组收集与选件相关的体验事件数据:显示哪些选件,作为哪些收集、决策和其他参数的一部分(请参阅本课程后面部分的)。 但是,这项服务又发生了什么情况? 是否显示、交互、取消等。
    建议
  6. 选择 保存 以保存对架构所做的更改。

验证Assurance中的设置

要在Assurance中验证设置,请执行以下操作:

  1. 转到Assurance UI。
  2. 选择 配置 在左边栏中选择 添加 旁边 验证设置Adobe Journey Optimizer决策.
  3. 选择​ 保存
  4. 选择 验证设置 在左边栏中。 您的应用程序中的数据流设置和SDK设置都经过验证。
    AJO决策验证

创建投放位置

在实际创建选件之前,您必须定义这些选件在移动设备应用程序中的放置方式和位置。 在决策管理中,您可以为此定义版面,并为支持JSON有效负载的移动渠道定义版面:

  1. 在Journey Optimizer UI中,选择 组件 组件决策管理 在左边栏中。

  2. 选择 版面 从顶部栏中。

  3. 如果没有带名称的版面 移动设备JSON移动设备 作为 渠道类型JSON 作为 内容类型 列出,您必须创建一个版面。 否则,请继续 创建优惠.

要创建移动JSON投放位置,请执行以下操作:

  1. 选择 添加 创建投放位置。

    1. 详细信息 部分,输入 Mobile JSON 作为 名称,选择 移动设备渠道类型JSON内容类型.
    2. 选择 保存 以保存投放位置。

    创建投放位置

创建优惠

  1. 在Journey Optimizer UI中,选择 选件 选件决策管理 在左边栏中。

  2. 选件 屏幕,选择 浏览 以查看选件列表。

  3. 选择 创建选件.

  4. 新优惠 对话框,选择 个性化优惠 并单击 下一个.

  5. 详细信息 第步/共步 创建新的个性化优惠

    1. 输入 名称 例如,对于选件 Luma - Juno Jacket,并输入 开始日期和时间结束日期和时间. 在这些日期之外,决策引擎将不会选择选件。

    2. 选择​ 下一步

      优惠 — 详细信息

  6. 添加呈现 第步/共步 创建新的个性化优惠

    1. 选择 移动设备 移动设备渠道 列表,然后选择 移动设备JSON投放 列表。

    2. 选择 自定义 对象 内容.

    3. 选择 添加内容. 在 添加个性化 对话框:

      1. 如果是 模式 选择器可用,请确保将其设置为 JSON.

      2. 输入以下JSON:

        code language-json
        {
            "title": "Juno Jacket",
            "text": "On colder-than-comfortable mornings, you'll love warming up in the Juno All-Ways Performance Jacket, designed to compete with wind and chill. Built-in Cocona™ technology aids evaporation, while a special zip placket and stand-up collar keep your neck protected.",
            "image": "https://luma.enablementadobe.com/content/dam/luma/en/products/women/tops/jackets/wj06-purple_main.jpg"
        }
        
      3. 选择​ 保存

        选件 — 自定义内容

    4. 选择​ 下一步

      优惠呈现

  7. 添加约束 步骤 创建新的个性化优惠

    1. 设置 优先级10.

    2. 切换 包括上限 关闭。

    3. 选择​ 下一步

      优惠 — 约束

  8. 审核 第步/共步 创建新的个性化 选件:

    1. 查看选件,然后选择 完成.
    2. 保存选件 对话框,选择 保存并批准.
  9. 重复步骤3 - 8以创建四个具有不同名称和内容的更多选件。 所有其他配置值(例如开始日期和时间或优先级)与您创建的第一个选件相似。 您可以快速创建重复和编辑选件。

    1. 在Journey Optimizer UI中,选择 选件 选件 从左边栏中,然后从顶部栏中选择选件。

    2. 选择您创建的选件的行。

    3. 在右窗格中,选择 更多 更多操作 并从上下文菜单中选择 复制 复制.

      使用下表定义其他四个选件。

      table 0-row-2 1-row-2 2-row-2 3-row-2 4-row-2 layout-fixed
      选件名称 JSON中的选件内容
      Luma - Affirm水瓶 { "title": "Affirm Water Bottle", "text": "You'll stay hydrated with ease with the Affirm Water Bottle by your side or in hand. Measurements on the outside help you keep track of how much you're drinking, while the screw-top lid prevents spills. A metal carabiner clip allows you to attach it to the outside of a backpack or bag for easy access.", "image": "https://luma.enablementadobe.com/content/dam/luma/en/products/gear/fitness-equipment/ug06-lb-0.jpg" }
      Luma - Desiree健身球 { "title": "Desiree Fitness Tee", "text": "When you're too far to turn back, thank yourself for choosing the Desiree Fitness Tee. Its ultra-lightweight, ultra-breathable fabric wicks sweat away from your body and helps keeps you cool for the distance.", "image": "https://luma.enablementadobe.com/content/dam/luma/en/products/women/tops/tees/ws05-yellow_main.jpg" }
      Luma - Adrienne Trek Jacket { "title": "Adrienne Trek Jacket", "text": "You're ready for a cross-country jog or a coffee on the patio in the Adrienne Trek Jacket. Its style is unique with stand collar and drawstrings, and it fits like a jacket should.", "image": "https://luma.enablementadobe.com/content/dam/luma/en/products/women/tops/jackets/wj08-gray_main.jpg" }
      Luma - Aero每日健身运动鞋 { "title": "Aero Daily Fitness Tee", "text": "Need an everyday action tee that helps keep you dry? The Aero Daily Fitness Tee is made of 100% polyester wicking knit that funnels moisture away from your skin. Don't be fooled by its classic style; this tee hides premium performance technology beneath its unassuming look.", "image": "https://luma.enablementadobe.com/content/dam/luma/en/products/men/tops/tees/ms01-black_main.jpg" }
  10. 作为最后一步,您必须创建后备优惠,如果客户不符合其他优惠的条件,该优惠将发送给客户。

    1. 选择 创建选件.

    2. 新优惠 对话框,选择 个性化优惠 并选择 下一个.

    3. 详细信息 第步/共步 创建新的后备优惠,输入 名称 例如,对于选件 Luma - Fallback Offer,并选择 下一个.

    4. 添加呈现 第步/共步 创建新的后备优惠

      1. 选择 移动设备 移动设备渠道 列表,然后选择 移动设备JSON投放 列表。

      2. 选择 自定义 对象 内容.

      3. 选择 添加内容.

      4. 添加个性化 对话框,输入以下JSON并选择 保存

        code language-json
        {
           "title": "Luma",
           "text": "Your store for sports wear and equipment.",
           "image": "https://luma.enablementadobe.com/content/dam/luma/en/logos/Luma_Logo.png"
        }
        
      5. 选择​ 下一步

  11. 审核 第步/共步 创建新的后备 选件:

    1. 查看选件,然后选择 完成.
    2. 保存选件 对话框,选择 保存并批准.

现在,您应该拥有以下选件列表:
选件列表

创建收藏集

要向移动设备应用程序用户呈现选件,您必须定义选件收藏集,其中包含您创建的一个或多个选件。

  1. 在Journey Optimizer UI中,选择 选件 从左边栏开始。

  2. 选择 收藏集 从顶部栏中。

  3. 选择 添加 创建收藏集.

  4. 新建收藏集 对话框,请输入 名称 例如,对于您的收藏集 Luma - Mobile App Collection,选择 创建静态收藏集,然后单击 下一个.

  5. Luma - Mobile App Collection ​中,选择要包含在收藏集中的选件。 在本教程中,选择您创建的五个选件。 您可以使用搜索字段轻松筛选列表,例如,通过键入 Luma.

  6. 选择​ 保存

    优惠 — 收藏集

创建决策

最后一步是定义决策,即一个或多个决策范围与您的备用优惠的组合。

决策范围是特定投放位置(例如电子邮件中的HTML或移动应用程序中的JSON)和一个或多个评估标准的组合。

评估标准是

  • 优惠收藏集,
  • 资格规则:例如,选件仅适用于特定受众,
  • 排名方法:当有多个选件可供选择时,您使用哪个方法为其排名(例如,按选件优先级、使用公式或AI模型)。

请参阅 创建和管理优惠的关键步骤 如果您想更好地了解投放位置、规则、排名、优惠、呈现、收藏集、决策等如何相互交互和相互关联。 本课程仅侧重于使用决策的输出,而不是侧重于在Journey Optimizer中定义决策的灵活性 — 决策管理。

  1. 在Journey Optimizer UI中,选择 选件 从左边栏开始。

  2. 选择 决策 从顶部栏中。

  3. 选择 添加 创建决策.

  4. 详细信息 第步/共步 创建新的优惠决策

    1. 输入 名称 例如,对于决策 Luma - Mobile App Decision,输入 开始日期和时间结束日期和时间.
    2. 选择​ 下一步
  5. 添加决策范围 第步/共步 创建新的优惠决策

    1. 选择 移动设备JSON投放 列表。

    2. 评估标准 图块,选择 添加 添加.

      1. 添加优惠收藏集 对话框中,选择您的选件收藏集。 例如:Luma - Mobile App Collection

      2. 选择​ 添加

        决策 — 选择收藏集

    3. 确保 已选定用于 资格、和 优惠优先级 已选为 排名方法.

    4. 选择​ 下一步

      决策范围 .

  6. 添加后备优惠 第步/共步 创建新的优惠决策

    1. 选择您的后备优惠,例如 Luma - Fallback offer.
    2. 选择​ 下一步
  7. 摘要 第步/共步 创建新的优惠决策

    1. 选择​ 完成
    2. 保存优惠决策 对话框,选择 保存并激活.
    3. 决策 选项卡,您会看到自己的决策状态 实时.

您的优惠决策(由一组优惠组成)现已准备就绪,可供使用。 要在应用程序中使用决策,您必须在代码中引用决策范围。

  1. 在Journey Optimizer UI中,选择 选件.

  2. 选择 决策 从顶部栏中。

  3. 选择您的决策,例如 Luma - Mobile App Decision.

  4. 决策范围 图块,选择 复制 复制.

  5. 从上下文菜单中,选择 决策范围.
    复制决策范围

  6. 使用任意文本编辑器粘贴决策范围以供将来使用。 决策范围具有以下JSON格式。

    code language-json
    {
        "xdm:activityId":"xcore:offer-activity:xxxxxxxxxxxxxxx",
        "xdm:placementId":"xcore:offer-placement:xxxxxxxxxxxxxxx"
    }
    

在应用程序中实施选件

如前面的课程中所述,安装移动标记扩展仅提供配置。 接下来,您必须安装并注册优化SDK。 如果这些步骤不明确,请查阅 安装SDK 部分。

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

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

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

    code language-swift
    import AEPOptimize
    
  4. 确保 Optimize.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
    ]
    
  5. 导航到 Luma > Luma > Model > Data > 决策 在Xcode项目导航器中。 更新 activityIdplacementId 值以及从Journey Optimizer界面复制的决策范围详细信息。

  6. 导航到 Luma > Luma > Utils > MobileSDK 在Xcode项目导航器中。 查找 func updatePropositionOD(ecid: String, activityId: String, placementId: String, itemCount: Int) async 函数。 添加以下代码:

    code language-swift
    // set up the XDM dictionary, define decision scope and call update proposition API
    Task {
       let ecid = ["ECID" : ["id" : ecid, "primary" : true] as [String : Any]]
       let identityMap = ["identityMap" : ecid]
       let xdmData = ["xdm" : identityMap]
       let decisionScope = DecisionScope(activityId: activityId, placementId: placementId, itemCount: UInt(itemCount))
       Optimize.clearCachedPropositions()
       Optimize.updatePropositions(for: [decisionScope], withXdm: xdmData)
    }
    

    此函数:

    • 设置XDM词典 xdmData,包含ECID以标识必须提供选件的配置文件。

    • 定义 decisionScope,该对象基于您在Journey Optimizer — 决策管理界面中定义的决策,并使用从复制的决策范围进行定义 创建决策. Luma应用程序使用配置文件(decisions.json)以检索范围参数,具体取决于以下JSON格式:

      code language-swift
      "scopes": [
          {
              "name": "name of the scope",
              "activityId": "xcore:offer-activity:xxxxxxxxxxxxxxx",
              "placementId": "xcore:offer-placement:xxxxxxxxxxxxxxx",
              "itemCount": 2
          }
      ]
      

      但是,您可以使用任何类型的实施来确保优化API获得正确的参数(activityIdplacementId 和, itemCount),以构造有效的 DecisionScope 实施对象。
      有关信息,请参见 decisions.json 文件仅供将来使用,与本课程和教程中的当前使用情况无关。

    • 调用两个API: Optimize.clearCachePropositionsOptimize.updatePropositions. 这些函数清除任何缓存的建议并更新此用户档案的建议。

  7. 导航到 Luma > Luma > Views > 个性化 > EdgeOffersView 在Xcode项目导航器中。 查找 func onPropositionsUpdateOD(activityId: String, placementId: String, itemCount: Int) async 函数并检查此函数的代码。 此函数最重要的部分是 Optimize.onPropositionsUpdate API调用,其中

    • 根据决策范围(您在Journey Optimizer — 决策管理中定义)检索当前用户档案的建议,
    • 从建议中检索优惠,
    • 解包选件的内容,以便该内容可以在应用程序中正确显示,并且
    • 触发 displayed() 选件上的操作会将事件发送回Edge Network,从而通知该选件。
  8. 仍在使用 EdgeOffersView,将以下代码添加到 .onFirstAppear 修饰符。 此代码确保用于更新优惠的回调仅注册一次。

    code language-swift
    // Invoke callback for offer updates
    Task {
        await self.onPropositionsUpdateOD(activityId: decision.activityId, placementId: decision.placementId, itemCount: decision.itemCount)
    }
    
  9. 仍在使用 EdgeOffersView,将以下代码添加到 .task 修饰符。 刷新视图后,此代码会更新选件。

    code language-swift
    // Clear and update offers
    await self.updatePropositionsOD(ecid: currentEcid, activityId: decision.activityId, placementId: decision.placementId, itemCount: decision.itemCount)
    

使用应用程序进行验证

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

  2. 转到 Personalisation 选项卡。

  3. 选择 Edge Personalisation

  4. 滚动到顶部,您将看到您在中定义的收藏集中显示的两个随机选件。 DECISION LUMA - MOBILE APP DECISION 磁贴。

    {width="300"}

    这些优惠是随机的,因为您为所有优惠提供了相同的优先级,且决策的排名基于优先级。

在Assurance中验证实施

验证Assurance中的选件实施:

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

  2. 选择 配置 在左边栏中选择 添加 旁边 审阅和模拟Adobe Journey Optimizer决策.

  3. 选择​ 保存

  4. 选择 审阅和模拟 在左边栏中。 数据流设置以及应用程序中的SDK设置均已验证。

  5. 选择 请求 在顶栏里。 您看到您的 选件 请求。
    AJO决策验证

  6. 您可以浏览 模拟事件列表 选项卡以了解更多功能,检查您的Journey Optimizer决策管理设置。

后续步骤

您现在应该拥有所有工具,可以开始向Journey Optimizer — 决策管理实施添加更多功能。 例如:

  • 将不同的参数应用于选件(例如,优先级、上限)
  • 收集应用程序中的配置文件属性(请参阅 个人资料),并使用这些配置文件属性构建受众。 然后,将这些受众用作您决策中的资格规则的一部分。
  • 合并多个决策范围。
SUCCESS
您已启用应用程序,以便使用适用于Experience PlatformMobile SDK的Journey Optimizer - Decisioning扩展来显示Offers。
感谢您投入时间学习Adobe Experience Platform Mobile SDK。 如果您有疑问、希望分享一般反馈或有关于未来内容的建议,请在此共享它们 Experience League社区讨论帖子.

下一步: 执行A/B测试

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