设置保证

Last update: Tue Jul 16 2024 00:00:00 GMT+0000 (Coordinated Universal Time)

主题：

创建对象：

初学者
中级
开发人员

了解如何在移动应用程序中设置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还需要添加以下内容才能启动应用程序的保障会话。

在Xcode的项目导航器中导航到 Luma > Luma > SceneDelegate。

将以下代码添加到 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) }`

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

可在此处找到更多信息。

定义捆绑包标识符

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

在Xcode中打开项目。
在项目导航器中选择 Luma。
选择 Luma 目标。
选择 签名和功能 选项卡。

定义 捆绑包标识符。

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

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

设置基本URL

转到Xcode中的项目。
在项目导航器中选择 Luma。
选择 Luma 目标。
选择信息选项卡。
要添加基本URL，请向下滚动到 URL类型 并选择 + 按钮。

将 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中：

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

note tip
TIP
或者，您可能希望“清理”内部版本，尤其是看到意外结果时。为此，请从Xcode 产品菜单中选择清理生成文件夹……。

在 允许“Luma应用程序”使用您的位置 对话框中，选择 使用应用程序时允许。

{width="300"}
在 “Luma应用”希望向您发送通知 对话框中，选择允许。

{width="300"}
选择 继续…… 以允许应用跟踪您的活动。

{width="300"}
在 允许“Luma应用”在其他公司的应用和网站 中跟踪您的活动，选择允许。

{width="300"}

在您的浏览器中：

转到数据收集UI。
从左边栏中选择保证。
选择 创建会话。
选择启动。
提供 会话名称，如Luma Mobile App Session和 基本URL，它是您在Xcode中输入的URL方案，后面是://，例如： lumatutorialswiftui://
选择 下一步。
在 创建新会话 模式对话框中：

如果您使用的是物理设备：
- 选择 扫描二维码。要打开应用程序，请使用物理设备上的摄像头扫描二维码并点击链接。
如果您使用模拟器：
1. 选择 复制链接。
2. 使用复制深层链接，然后使用该深层链接在模拟器中通过Safari打开应用程序。
应用程序加载时，系统会显示一个模式对话框，要求您输入步骤7中显示的PIN。

{width="300"}

输入PIN并选择连接。
如果连接成功，您会看到：
- “保证”图标浮动在应用程序顶部。
  
  {width="300"}
- 在Assurance UI中执行的Experience Cloud更新显示：
  1. 来自应用程序的体验事件。
  2. 选定事件的详细信息。
  3. 设备和时间轴。

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

验证扩展

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

选择配置。
为 扩展版本 选择。
选择保存。
选择 扩展版本 可查看应用程序版本中最新可用扩展和所用扩展的概述。
要更新扩展版本（例如，Messaging 和 Optimize），请从 包依赖项（例如，AEPMessaging）中选择包（扩展），然后从上下文菜单中选择 更新包。 Xcode将更新包依赖项。