添加 Adobe Audience Manager

本课程将指导您完成使用服务器端转发将 Adobe Audience Manager 实施到 Experience Platform Mobile SDK 中的步骤。

Adobe Audience Manager (AAM) 提供了行业领先的在线受众数据管理服务,为数字广告商和出版商提供了控制和利用其数据资产所需的工具,进而助力取得销售成功。

注意

Adobe Experience Platform Launch将作为一套数据收集技术集成到Adobe Experience Platform中。 界面中已推出一些术语更改,在使用此内容时,您应该注意这些更改:

学习目标

在本课程结束后,您将能够:

  1. 阐述在移动设备应用程序中实施 Audience Manager 的两种主要方法
  2. 使用 Analytics 信标的服务器端转发功能添加 Audience Manager
  3. 验证 Audience Manager 实施

先决条件

要完成本课程,您将需要:

  1. 完成配置标记部分下的课程,即创建标记属性添加扩展创建库安装Mobile SDK

  2. 拥有 Adobe Analytics 的管理员访问权限,以便能够为将在本教程中使用的报表包启用服务器端转发。或者,也可以按照下面的说明,请求贵组织的现有管理员为您执行此操作。

如果您尚未实施 Audience Manager,请按照以下说明获取 Audience Manager 子域

实施选项

在应用程序中实施 Audience Manager 的方法有两种:

  • 服务器端转发 (SSF) — 对于具有 Adobe Analytics 的客户来说,这是最简单、也是推荐的实施方法。Adobe Analytics 会将数据转发到 Adobe 后端的 AAM,这样您就无需从应用程序直接向 Audience Manager 发出请求。此外,这种方法还支持重要的集成功能,并符合 Audience Manager 代码实施和部署的最佳实践。

  • 客户端 DIL — 这种方法适用于没有 Adobe Analytics 的客户。应用程序中的 Audience Manager 方法会将数据直接发送到 Audience Manager。在这种情况下,当您设置移动标记属性时,应在标记中使用Audience Manager扩展。

如果您之前在本教程的添加扩展部分中设置了 Analytics 扩展,那么您已选中用于启动数据从 Analytics 到 Audience Manager 的服务器端转发的框。这会动态地将处理 Audience Manager 区段响应所需的代码重新插入到您的应用程序。我们不会在本教程中添加 Audience Manager 扩展,因为这仅适用于您没有 Adobe Analytics 时的用例。

启用服务器端转发

实施 SSF 有两个主要步骤:

  1. 在 Analytics Admin Console 中打开用于“按报表包”**​将数据从 Analytics 转发到 Audience Manager 的“选项开关”。
  2. 将SDK代码放置到适当位置, 您已通过标记​完成该操作,方法是只需选中Analytics扩展中用于将数据转发到AAM的框。

在 Analytics Admin Console 中启用服务器端转发

需要在 Adobe Analytics Admin Console 中进行配置,才能开始将数据从 Adobe Analytics 转发到 Adobe Audience Manager。请注意,系统最长可能需要四个小时才能开始转发数据,因此,在对转发问题进行故障诊断时请牢记这一点。

在 Analytics Admin Console 中启用 SSF

  1. 通过 Experience Cloud UI 登录 Analytics。如果您没有 Analytics 的管理员访问权限,则需要联系 Experience Cloud 或 Analytics 管理员,以便向您分配访问权限或为您完成这些步骤。

    登录 Adobe Analytics UI

  2. 在 Analytics 的顶部导航中,选择​管理员 > 报表包,然后从列表中选择(或多选)要转发到 Audience Manager 的报表包。

    单击 Admin Console

  3. 在“报表包”屏幕中已选定报表包的情况下,选择​编辑设置 > 常规 > 服务器端转发

    选择 SSF 菜单

    警告

    如上所述,您需要拥有管理员权限,才能查看此菜单项。

  4. 在“服务器端转发”页面上,阅读相应信息并为报表包选中​启用服务器端转发​框。

  5. 单击​保存

    完成 SSF 设置

注意

由于需要按报表包启用 SSF,因此,当您在实际应用程序的报表包中部署 SSF 时,请不要忘记为每个实际的报表包重复此步骤。

此外,如果 SSF 选项为灰色,您需要将报表包映射到 Experience Cloud 组织,才能启用此选项。此文档对此进行了说明。

在您实施了 Adobe Experience Platform Identity Service 之后,此选项开关就会开始将数据实际转发到 AAM。其余的SSF实施都发生在代码中,当您选中Analytics扩展中用于转发到AAM的框后,该代码会在标记中进行处理。

现在已为您的应用程序实施服务器端转发代码!

验证服务器端转发

验证服务器端转发是否已启动并正在运行的主要方法是,查看应用程序针对任意 Adobe Analytics 点击的响应。

如果您没有对数据执行从 Analytics 到 Audience Manager 的服务器端转发 (SSF),则实际不会有任何针对 Analytics 信标的响应(除 2x2 像素以外)。但是,启用 SSF 后,则可以在 Analytics 请求和响应中验证一些项目,以确认 SSF 运行正常。

由于 Xcode 控制台不显示对信标的响应,因此您应该使用其他可以显示响应的调试器/数据包探查器,例如 Charles 代理(将在下面的屏幕快照中展示)。

  1. 打开调试器并筛选 b/ss,这将限制您仅可看到 Adobe Analytics 请求

  2. 构建并运行之前练习中的示例应用程序

  3. 对于您的任何 Analytics 请求,查看对应的响应。它应该包含一个 dcs_region 参数、一个 uuid 参数,以及一个“stuff”对象。此对象是 AAM 区段 ID 将发送回浏览器的位置(对于用户所属的任何区段,这些 ID 会在 AAM 中分配给 Cookie 目标)。如果具有“stuff”对象,则表示 SSF 运行正常!

    AA 响应 - stuff 对象

警告

请注意误报的“成功”- 如果存在响应,并且一切似乎都运行正常,请​确保​具有“stuff”对象。如果没有该对象,您可能会在响应中看到一条显示 "status":"SUCCESS" 的消息。尽管这听起来很不可思议,但实际上却证明 SSF 没有​正常运行。如果您看到此消息,则表示您已完成标记中要转发到AAM的步骤,但尚未完成AnalyticsAdmin Console中的转发步骤。 在这种情况下,您需要验证是否已在 Analytics Admin Console 中启用 SSF。如果您已启用,但尚未满 4 个小时,请耐心等待。

AA 响应 - 误报的成功

下一课程“发布您的资产”>

在此页面上