设置保证

了解如何在移动应用程序中设置Adobe Experience Platform保障。

Assurance(正式称为Project Griffon)旨在帮助您检查、证明、模拟和验证在移动应用程序中收集数据或提供体验的方式。

Assurance 可帮助您检查 Adobe Experience Platform Mobile SDK 生成的原始 SDK 事件。SDK 收集的所有事件都可供检查。SDK 事件加载在列表视图中,按时间排序。每个事件都有一个详细视图,可提供更多详细信息。还提供了用于浏览SDK配置、数据元素、共享状态和SDK扩展版本的其他视图。 在产品文档中了解有关Assurance的更多信息。

先决条件

  • 成功设置已安装并配置SDK的应用程序。

学习目标

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

  • 确认您的组织具有访问权限(如果您没有访问权限,请进行请求)。
  • 设置您的基本URL。
  • 添加所需的iOS特定代码。
  • 连接到会话。

确认访问

确认您的组织有权访问Assurance。 您作为用户,应该被添加到Adobe Experience Platform的配置文件。 有关详细信息,请参阅保证指南中的用户访问权限

实施

除了常规的SDK安装之外,您已在前面的课程中完成,iOS还需要添加以下内容才能启动应用程序的保障会话。

  1. 在Xcode的项目导航器中导航到​ Luma > Luma > SceneDelegate

  2. 将以下代码添加到 func scene(_ scene: UIScene, openURLContexts URLContexts: Set<UIOpenURLContext>

    code language-swift
    // Called when the app in background is opened with a deep link.
    if let deepLinkURL = URLContexts.first?.url {
        // Start the Assurance session
        Assurance.startSession(url: deepLinkURL)
    }
    

    当应用程序处于后台并使用深层链接打开时,此代码会启动保证会话。

可在此处找到更多信息。

定义捆绑包标识符

您需要为应用程序提供唯一的捆绑包标识符。

  1. 在Xcode中打开项目。

  2. 在项目导航器中选择​ Luma

  3. 选择​ Luma ​目标。

  4. 选择​ 签名和功能 ​选项卡。

  5. 定义​ 捆绑包标识符

    note important
    IMPORTANT
    请确保使用​_唯一_​捆绑标识符并替换com.adobe.luma.tutorial.swiftui捆绑标识符,因为每个捆绑标识符必须是唯一的。 通常,您使用反向DNS格式来打包的ID字符串,如com.organization.brand.uniqueidentifier。 例如,本教程的完成版本使用com.adobe.luma.tutorial.swiftui

    Xcode签名功能 {modal="regular"}

设置基本URL

  1. 转到Xcode中的项目。

  2. 在项目导航器中选择​ Luma

  3. 选择​ Luma ​目标。

  4. 选择​ 信息 ​选项卡。

  5. 要添加基本URL,请向下滚动到​ URL类型 ​并选择​ + ​按钮。

  6. 将​ Identifier ​设置为您选择的捆绑包标识符,并设置您选择的​ URL方案

    保证URL

    note important
    IMPORTANT
    请确保使用​_唯一_​捆绑标识符并替换com.adobe.luma.tutorial.swiftui捆绑标识符,因为每个捆绑标识符必须是唯一的。 通常,您使用反向DNS格式来打包的ID字符串,如com.organization.brand.uniqueidentifier。 您可以使用在定义捆绑标识符中使用的相同捆绑标识符。
    同样,使用唯一的URL方案,并将已经提供的lumatutorialswiftui替换为您的唯一URL方案。

要详细了解iOS中的URL方案,请查阅Apple的文档

Assurance的工作方式是通过浏览器或二维码打开URL。 该URL以基本URL开头,该URL可打开应用程序并包含其他参数。 这些唯一参数用于连接会话。

连接到会话

在Xcode中:

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

    note tip
    TIP
    或者,您可能希望“清理”内部版本,尤其是看到意外结果时。 为此,请从Xcode 产品 ​菜单中选择​ 清理生成文件夹……
  2. 在​ 允许“Luma应用程序”使用您的位置 ​对话框中,选择​ 使用应用程序时允许

    {width="300"}

  3. 在​ “Luma应用”希望向您发送通知 ​对话框中,选择​ 允许

    {width="300"}

  4. 选择​ 继续…… ​以允许应用跟踪您的活动。

    {width="300"}

  5. 在​ 允许“Luma应用”在其他公司的应用和网站 ​中跟踪您的活动,选择​ 允许

    {width="300"}

在您的浏览器中:

  1. 转到数据收集UI。

  2. 从左边栏中选择​ 保证

  3. 选择​ 创建会话

  4. 选择​ 启动

  5. 提供​ 会话名称,如Luma Mobile App Session和​ 基本URL,它是您在Xcode中输入的URL方案,后面是://,例如: lumatutorialswiftui://

  6. 选择​ 下一步
    保证创建会话

  7. 在​ 创建新会话 ​模式对话框中:

    如果您使用的是物理设备:

    • 选择​ 扫描二维码。 要打开应用程序,请使用物理设备上的摄像头扫描二维码并点击链接。

      保证qa代码

    如果您使用模拟器:

    1. 选择​ 复制链接

    2. 使用 Copy 复制深层链接,然后使用该深层链接在模拟器中通过Safari打开应用程序。

      保证副本链接

  8. 应用程序加载时,系统会显示一个模式对话框,要求您输入步骤7中显示的PIN。

    {width="300"}

    输入PIN并选择​ 连接

  9. 如果连接成功,您会看到:

    • “保证”图标浮动在应用程序顶部。

      {width="300"}

    • 在Assurance UI中执行的Experience Cloud更新显示:

      1. 来自应用程序的体验事件。

      2. 选定事件的详细信息。

      3. 设备和时间轴。

        保证事件

如果您遇到任何挑战,请查阅技术常规文档

验证扩展

要验证您的应用程序是否使用了最新的扩展,请执行以下操作:

  1. 选择​ 配置

  2. 123 扩展版本 ​选择 添加

  3. 选择​ 保存

    配置扩展版本

  4. 选择 123 扩展版本 ​可查看应用程序版本中最新可用扩展和所用扩展的概述。

    扩展版本

  5. 要更新扩展版本(例如,Messaging ​和​ Optimize),请从​ 包依赖项(例如,AEPMessaging)中选择包(扩展),然后从上下文菜单中选择​ 更新包。 Xcode将更新包依赖项。

NOTE
在Xcode中更新扩展(包)后,请关闭并删除当前会话,然后从连接到会话验证扩展中重复所有步骤,以确保Assurance在新的Assurance会话中正确报告正确的扩展。
SUCCESS
您现在已将应用程序设置为在教程的其余部分使用Assurance 。
感谢您投入时间学习Adobe Experience Platform Mobile SDK。 如果您有任何疑问、希望分享一般反馈或有关于未来内容的建议,请在此Experience League社区讨论帖子上分享这些内容

下一步: 实施同意

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