将网站的Audience Manager实施从客户端DIL迁移到服务器端转发 migrating-your-site-s-aam-implementation-from-client-side-dil-to-server-side-forwarding
如果您同时拥有Adobe Audience Manager (AAM)和Adobe Analytics，并且当前使用DIL(Data Integration Library)代码将点击从页面发送到AAM，同时还会将点击从页面发送到Adobe Analytics，则本教程适用于您。 由于您拥有这两个解决方案，并且它们都是Adobe Experience Cloud的一部分，因此您有机会遵循启用服务器端转发的最佳实践，这种最佳实践使Analytics数据收集服务器能够实时将网站分析数据转发到Audience Manager，而不是让客户端代码从页面向AAM发送额外的点击。 本教程将指导您完成从旧版客户端DIL实现切换到新版服务器端转发方法的步骤。
客户端(DIL)与服务器端 client-side-dil-vs-server-side
在比较和对比将Adobe Analytics数据导入AAM的这两种方法时，可能首先需要在以下图像中显示差异：
客户端DIL实现 client-side-dil-implementation
如果使用此方法将Adobe Analytics数据导入AAM，则您将有两个来自网页的点击：一个转到Analytics，另一个转到AAM（在网页上复制Analytics数据后）。 Segments从AAM返回到页面，可在其中用于个性化等。 这被视为旧版实施，不再推荐。
除了没有遵循最佳实践这一事实之外，使用此方法的缺点包括：
- 来自页面的两个点击，而不是仅一个点击
- 需要服务器端转发才能将AAM受众实时共享到Analytics，因此客户端实施不允许使用此功能（以及将来可能的其他功能）
建议您改用AAM实施的服务器端转发方法。
服务器端转发实施 server-side-forwarding-implementation
如上图所示，点击来自访问Adobe Analytics的网页。 Analytics随后将该数据实时转发到AAM，并将访客评估为AAM特征和segments，就像点击直接来自页面一样。
Segments在同一实时点击中返回到Analytics，后者将响应转发到网页以进行个性化等等。
迁移到服务器端转发没有时间限制。 Adobe强烈建议同时拥有Audience Manager和Analytics的任何用户使用此实现方法。
您有两个主要任务 you-have-two-main-tasks
这个网页上有很多信息，当然也很重要。 但是，它 归根结底是您需要执行的两个主要操作：
- 将您的代码从客户端DIL代码更改为服务器端转发代码
- 翻转Analytics Admin Console中的开关以开始实际的数据转发（每report suite）
如果您跳过其中任一任务，则服务器端转发将无法正常工作。 本文档中添加了步骤和其他数据，可帮助您正确执行这两个步骤以进行设置。
实施选项 implementation-options
当您从客户端转发转移到服务器端转发时，您面临的任务之一是将代码更改为新的服务器端转发代码。 可使用以下任一选项完成此操作：
- Adobe Experience Platform标记 — Adobe为Web资产推荐的实施选项。 您会看到这是一项轻松的任务，因为Platform标记已为您完成了所有艰难的工作。
- 在页面上 — 如果您尚未使用Adobe启动，则还可以将新的SSF代码直接放置到
appMeasurement.js文件内的doPlugins函数中 - 其他标记管理器 — 这些代码的处理方式与上一步（在页面上）选项相同，因为无论其他标记管理器在何处存储AppMeasurement代码，您仍会将SSF代码放在
doPlugins中
我们将在 更新代码 部分中查看以下各个部分。
实施步骤 implementation-steps
以下步骤描述了实施。
步骤0：先决条件：Experience CloudID服务(ECID) step-prerequisite-experience-cloud-id-service-ecid
迁移到服务器端转发的主要先决条件是实施Experience CloudID服务。 如果您使用的是Experience Platform Launch，则最轻松完成这项操作，在这种情况下，您只需安装ECID扩展并将其余部分用于实施。
如果您使用的是非AdobeTMS，或根本没有TMS，则请实施ECID以在 任何其他Adobe解决方案之前运行。 有关详细信息，请参阅ECID文档。 唯一的其他先决条件与代码版本有关，因此，由于您只需按以下步骤应用代码的最新版本，因此您不会有任何问题。
步骤1：从DIL中记录当前使用的选项 step-record-currently-used-options-from-dil-code
在您准备好从客户端DIL代码迁移到服务器端转发时，第一步是识别您使用DIL代码执行的所有操作，包括自定义设置以及发送到AAM的数据。 需要注意和考虑的事项包括：
- 使用
siteCatalyst.initDIL模块的普通Analytics变量 — 您无需担心此变量，因为其作业只是发送普通Analytics变量，只需启用服务器端转发即可完成此操作。 - 合作伙伴子域 — 在
DIL.create函数中，记录partner参数。 这称为您的“合作伙伴子域”，有时也称为“合作伙伴ID”，在放置新的服务器端转发代码时需要此ID。 - Visitor Service Namespace — 也称为您的“Org ID”或“IMS Org ID”，当您设置新的服务器端转发代码时，也会需要此代码。 记下它。
- containerNSID、uuidCookie和其他高级选项 — 请记下您正在使用的任何其他高级选项，以便您也可以在服务器端转发代码中设置它们。
- 其他页面变量 — 如果从页面将其他变量发送到AAM（除了siteCatalyst.init处理的正常Analytics变量之外），您将需要记下这些变量，以便它们可以通过服务器端转发发送（破坏程序警报：通过contextData变量）。
第2步：更新代码 step-updating-the-code
在实施选项（上述）中，提供了多个关于如何以及在何处实施服务器端转发的选项。 为了使本节有效，我们需要将其分成这些部分（其中两个结合使用）。 转到最能描述您需求的方法。
Adobe Experience Platform标记 launch-by-adobe
观看以下视频，了解如何在Experience Platform Launch中将实施选项从客户端DIL代码移动到服务器端转发。
“在页面上”或非Adobe标签管理器 on-the-page-or-non-adobe-tag-manager
观看以下视频，了解如何以AppMeasurement代码将实施选项从客户端DIL代码移动到服务器端转发，该代码驻留在文件或非Adobe标签管理系统中。
步骤3：启用转发（每Report Suite） step-enabling-the-forwarding-per-report-suite
在本教程中，到目前为止，我们已经将全部时间都花在了将代码从客户端DIL代码切换到服务器端转发上。 那没关系，因为这是最困难的部分。 虽然您会看到此部分非常简单，但与更新代码一样重要。 在本视频中，您将了解如何翻转启用将数据从Analytics实际转发到Audience Manager的开关。
注意： 如视频中所述，请记住，在Experience Cloud后端完全实施转发最多需要4个小时。
计时 timing
请注意，从客户端DIL转移到服务器端转发有两个主要任务：
- 更新代码
- 在Analytics Admin Console中翻转开关
但问题是，你首先要做什么？ 这重要吗？ 好吧，对不起，那有两个问题。 但答案是……视情况而定，是的，可能 很重要。 这话怎么说呢？ 我们来解释一下。 但是，首先还有一个问题，如果您是一个拥有众多网站的大型组织，那么可能会出现这个问题：我是否必须同时完成所有操作？ 那个比较简单。 不行。 你可以一分为二。
再深入一点 a-little-deeper-dive
时间与顺序重要的原因在于转发 实际上 的工作方式，这可以用以下几个技术事实来概括：
- 如果您实施了Experience CloudID服务(ECID)，并且Analytics Admin Console中的开关（“开关”）已打开，那么即使您尚未更新代码，数据也会从Analytics转发到AAM。
- 如果您未实施ECID，数据将不会转发，即使您已打开开关且服务器端转发代码也是如此。
- 服务器端转发代码（无论在Platform标记中还是在页面上）将真正处理响应，并且是完成迁移所必需的。
- 请记住，服务器端转发开关由report suite启用，但代码由Platform标记中的属性处理，或者如果您不使用Platform标记，则由AppMeasurement文件处理。
最佳实践 best-practices
根据这些技术详细信息，以下是有关何时做什么以及做什么时间的建议：
如果您尚未实施ECID if-you-do-not-have-ecid-yet-implemented
-
为要启用服务器端转发的每个report suite在Analytics中翻转开关。
- 由于您没有ECID，转发尚未开始。
-
根据站点，将代码从客户端DIL更新到服务器端转发（这可能位于Platform标记中）或页面上，如上面的另一部分所述。
- 转发现在流程（因为您已添加ECID），并且您还应该收到针对Analytics信标的正确JSON响应（有关更多详细信息，请参阅下面的“验证和疑难解答”部分）。
如果您实施了ECID if-you-do-have-ecid-implemented
-
准备并规划，以便准备好根据report suite将启用服务器端转发的将代码从DIL更新到服务器端转发：
-
在Analytics中翻转交换机以启用服务器端转发。
- 由于您已启用ECID，转发操作将启动。
-
请尽快将您的代码从客户端DIL更新为单端转发（这可以在Platform标签中或页面上，如上面的另一节所述）。
- 您应会收到针对Analytics信标的正确JSON响应（有关更多详细信息，请参阅下面的验证和故障排除部分）。
-
具有多个网站和report suites时的迁移时间 migration-timing-when-you-have-many-sites-and-report-suites
在前几节中简要地谈到了这一主题，主要战略可概括如下：
一次迁移一个站点/report suite（或一组站点/report suites）。
但是，根据以下几种可能的情况，这可能会变得有点棘手：
- 您有一个包含多个不同的report suites的网站
- 您有一个包含多个站点的report suite（如全局report suite）
- 您可以使用一个Platform标记属性来涵盖多个网站
- 您拥有适用于不同站点的不同开发团队
因为这些东西，它可能会变得有点复杂。 我能提出的最好的建议是：
- 请花些时间根据上文介绍的内容，制定迁移到服务器端转发的策略
- 由于Platform标记中的单个属性（或单个AppMeasurement文件）通常映射到1个或2个不同的report suites，因此您可能会制定一个计划，以逐个处理这些不同的组，从而将您的企业更新到服务器端转发
- 如果您在使用Adobe Consulting，请与他们讨论您的迁移计划，以便他们能够提供所需的帮助
验证和故障排除 validation-and-troubleshooting
验证服务器端转发是否已启动并正在运行的主要方法是，查看应用程序针对任意Adobe Analytics点击的响应。
如果您没有对数据执行从Analytics到Audience Manager的服务器端转发，则实际不会有任何针对Analytics信标的响应（除2x2像素以外）。 但是，如果您正在执行服务器端转发，则可以在Analytics请求和响应中验证一些项目，以确认Analytics与Audience Manager正确通信、转发点击并获得响应。
stuff对象。 如果不这样做，您可能会看到一条显示"status":"SUCCESS"的消息。 尽管这听起来很不可思议，但实际上却证明SSF没有正常运行。
有关服务器端转发的详细信息，请参阅文档。