DFA 集成

配置 DFA 集成的过程涉及以下任务:

配置 DFA 集成

逐步完成 DFA Data connectors 集成。

配置页面提供有关集成的概述以及可获取更多信息的有用链接。Adobe 和 DoubleClick 费用均与此集成相关。请联系这两个组织相应的销售代表,并确保您了解费用结构。

  1. 登录 Adobe Analytics.

  2. 单击​Admin > 所有管理员 > 数据连接器

  3. 找到 DoubleClick DFA,然后单击​新增

    步骤结果

    在集成向导的每个页面上,提供所需的信息,然后单击​下一步。下表解释了通过该向导完成集成所需要的信息。

向导页码 字段 描述
1 集成名称 Genesis 在报表包的活动集成列表中显示的集成名称。
1 集成电子邮件地址 接收与此集成相关的所有通知的电子邮件地址。
2 用户名 随此集成一起使用的 DFA API 用户名。要允许用户进行 API 登录,请检查 DFA 界面中的 API 属性。在启用 API 登录后,将显示一个密码字段为用户提供密码。将此密码连同用户名一起输入到向导中进行验证。
2 密码 DFA API 密码。
2 广告商 ID

DFA 广告商 ID 或父 Floodlight 配置 ID。Data connectors 使用此 ID 标识要跟踪的 DFA 广告商(1.5 版本的集成)。此广告商 ID 未用于 2.0 版本的集成,而是将查找并使用父 Floodlight 配置 ID。请参阅屏幕上的说明

3 DFA 广告变量 用于接收 DFA 促销活动属性、展示次数和点击量数据的 Analytics eVar。通常,此为跟踪代码 eVar (s.campaign),但您可以选择任何可用的 eVar。Data connectors 还将以下 DFA 相关分类添加到选定 eVar:

促销活动:向包含常见消息的多个网站提供的广告集合。

网站名称:提供广告服务的网站。

广告名称:在您的 DFA 帐户中定义的广告名称。

网站版面名称:提供广告服务的网站和页面。

交付工具:DoubleClick for Advertisers。

渠道:横幅广告。

成本结构:CPM、CPC 或固定成本,具体取决于广告的成本结构。

创作名称:与广告/版面/创作 ID 关联的创作名称。

DFA > SearchCenter 重复数据删除:指定在发生 DFA 点进和显示到达时,DFA 应将值置入 Searchcenter 变量中。。

4 展示次数 用于接收 DFA 展示次数量度数据的自定义事件。展示次数指示提供广告服务的次数。
4 点击 选择接收 DFA 点击量量度数据的自定义事件。点击量指示访客点击广告的次数,它由 DFA 的重定向测量。点击量量度与 Analytics 点进次数量度关联。

注意:DFA 点击量和 Analytics 点进次数可能因为数据收集方式的不同而不能完全匹配。

5 显示到达变量

用于接收 DFA 显示到达数据的 Analytics eVar。显示到达变量可帮助您了解显示到达次数如何影响网站上的转化率。

Data connectors 将添加到 DFA 广告变量的相同 DFA 相关分类添加到此 eVar(参见上文)。

5 自上次查看以来的时间(显示到达时间段变量) 用于接收自上次查看以来的 DFA 时间数据的 Analytics eVar。自上次查看以来的时间指示自上次广告显示到达起过去的时间量。
5 显示到达次数 用于接收 DFA 显示到达次数量度数据的自定义事件。结合使用显示到达次数事件和显示到达变量,以了解哪些促销活动虽没有影响直接点进,但可能在后续的某个时候起到将流量引导至网站的作用。

Data Connectors 将选定的自定义事件重新命名为“显示到达次数”。

6 DFA 查询失败 (可选)用于接收任何报告的 DFA 查询失败消息代码的 Analytics eVar。可能的 DFA 消息代码包括:
  • nc:无 DoubleClick Cookie。
  • oo:用户已退出。
  • nh:无促销活动历史记录。
  • qe:查询错误(超时、服务器故障等)。
6 超时事件

该 Analytics 计数器事件在每次 s.maxDelay 计时器过期,且未收到来自 DFA 服务器的任何响应时递增。使用此事件配置 s.maxDelay 变量(请参阅“调整 s.maxDelay”)。

针对 DFA 集成的网站更新

在 Genesis 为 DFA 集成配置了 Analytics 报表包之后,您必须执行以下操作以配置您的网站和 DFA 环境来支持集成:

DFA 的 Data connectors 集成要求您在页面的域中设置 Cookie。

部分域已达到了某些 Web 浏览器所允许的最大 Cookie 容量,不过这种情况并不多见。要避免影响访客在您网站上的浏览体验,请咨询您的网络运营部门、开发团队或工程小组,以确认将其他 Cookie 添加到用于 DFA 集成的页面域将不会影响用户体验。您还将需要为此 Cookie 选择一个名称。

更新您的 DFA 查询字符串参数

如果您在 DFA 集成之前已通过 Adobe Analytics 跟踪广告促销活动,则有可能所有促销活动(电子邮件、搜索或横幅)均使用相同的查询字符串参数来标识登陆页面上的反向链接促销活动 ID。

要弄清何时为您的 DFA 广告促销活动请求来自 DFA 数据的显示到达和点进数据,Data connectors 需要在访客点击某 DFA 促销活动横幅广告时进行标识。要做到这一点,您必须在 DFA 广告促销活动的登陆页面 URL 中添加一个差异化的查询字符串参数,这样 Data Connectors 就能够区分 DFA 广告促销活动页面和您的网站上可能存在的其他广告促销活动页面。JavaScript 插件中的 dfa_overrideParam 用于 DFA。

注意

尽管促销活动变量可用于其他促销活动,但请不要将它用于 DFA 促销活动。如果您将促销活动变量设置为 DFA 促销活动登陆页面,则 Adobe 无法将展示次数和点击量关联到 DFA 促销活动点进次数。每次访问后,Adobe 收集服务器都会检查 DFA 服务器中的上一次点进或显示到达。鉴于此,应仅在常见登陆页面上包含 DFA 插件代码,以避免不必要的重定向,这些重定向会减缓页面加载时间,这对于 Internet 连接速度较慢的用户尤其不便。

更新网站的数据收集代码

DFA 的 Genesis 集成可利用 DFA Floodlight 配置 ID (dfa_SPOTID),以提高 DFA 和 Adobe 数据收集系统之间的报表一致性。

注意

术语 Spotlight 已在最近发布的 Google DFA 中更改为 Floodlight。JavaScript 参数 dfa_SPOTID 基于 Spotlight 术语而命名,但它可同时用于两个版本。

要在您的网站上启用 DFA 集成,您必须通过添加以下内容来更新 JavaScript 数据收集代码:

  • DFA 的集成模块
  • 添加到收集代码的内容

DFA 的集成模块

DFA 集成可利用 Adobe Marketing Cloud 集成模块,以向您的核心 JavaScript 数据收集代码 (s_code.js) 添加功能。当您从代码管理器下载 AppMeasurement for Javascript 代码时,集成模块将作为 .zip 文件的一部分提供。仅当您在查找该模块方面需要其他帮助时,才请与 Adobe 顾问联系。

在您网站的 s_code.js 文件的 Modules 部分中插入集成模块代码。

添加到收集代码的内容

基于您在集成向导中激活 DFA 集成时所做的选择,Data connectors 会为您的 JavaScript 数据收集代码生成自定义的添加内容,并通过电子邮件发送给您。将此代码插入 s_code.js 文件的主部分(不在 doPlugins 函数或任何其他函数中)。

以下显示的示例代码仅适用于插图;请使用您在完成 Data connectors 集成向导之后通过电子邮件收到的代码。

收集代码由以下组件组成:

  • DFA 集成设置
  • 需要集成的插件

DFA 集成设置

/************************** DFA VARIABLES **************************/ 
var dfaConfig = { 
   CSID:              "1234567", 
   SPOTID:            "29876543", 
   tEvar:             "eVar17", 
   errorEvar:         "eVar59", 
   timeoutEvent:      "event76", 
   requestURL:         "http://fls.doubleclick.net/ 
json?spot=[SPOTID]&src=[CSID]&var=[VAR]&host=integrate.112.2o7.net%2 
Fdfa_echo%3Fvar%3D[VAR]%26AQE%3D1%26A2S%3D1&ord=[RAND]", 
 
   maxDelay:          "1500", 
   visitCookie:       "s_dfa", 
   clickThroughParam: "CID", 
   searchCenterParam: "s_kwcid", 
   newRsidsProp:      undefined 
}; 
/************************ END DFA Variables ************************/ 

DFA 集成设置块可设置 DFA 集成所需要的变量。这其中每个变量的值来自以下来源:

CSID:客户端 ID。在您完成集成向导之后即由 DFA 生成。Data connectors 在此变量中预填充您的 DFA CS ID,并且在您完成集成向导后通过设置电子邮件向您发送此值。如果您的帐户中启用了高级广告服务,则不需要此变量。

SPOTID:Floodlight 配置(以前称为 Spotlight ID)。根据您在集成向导中指定的 DFA 帐户信息,Data connectors 在此变量中预填充您的 DFA Floodlight 配置 ID。

tEvar:转移变量。Data connectors 在此变量中预填充您在集成向导中为显示到达变量指定的 Analytics 变量名称。在没有与 Adobe 工程或工程服务部门密切协调的情况下,请不要更改此值。

errorEvar:错误变量。Data connectors 在此变量中预填充您在集成向导中为 DFA 查询失败变量指定的 Analytics 变量名称。

timeoutEvent:超时事件。Data connectors 在此变量中预填充您在集成向导中为超时事件变量指定的 Analytics 变量名称。

requestURL:用于查询广告信息的远程 DFA 主机。请不要更改此值,除非 Adobe 指示您这么做。

maxDelay:指定 JavaScript 数据收集代码等待来自 DFA Floodlight 服务器响应的时间量(以毫秒为单位)。Adobe 建议对此值进行试验,以找出基于您网站流量的最佳值。例如,提高此值通常会收集更多的 DFA 数据,但也会增加损失基本访客数据的风险(如果访客在延迟期间离开网站的话)。降低此值可减少损失点击数据的风险,但也会减少随 Adobe 点击数据一起发送的 DFA 数据量。

visitCookie:用于将 DFA 调用限制为每次访问调用一次的 Cookie 的名称。

clickThroughParam:一个查询字符串,通常包含在所有广告内,可通知集成模块刚刚发生了一次点击。如果查询字符串中存在此参数,则无论最近 30 分钟内是否已查询该访客,都可导致向 DFA Floodlight 服务器发出请求。

newRsidsProp:(可选)映射到未使用的流量属性变量。DFA 集成可在访问 Cookie 中收集并存储此值,以标识收集特定访客数据的报表包。此属性仅在通过 Adobe 工程服务进行自定义实施时需要用到。

需要集成的插件

所添加的收集代码加入了可改善 DFA 集成运行的额外插件:

  • 将 DFA 查询限制为每次访问查询一次
  • 使 Cookie 名称具有灵活性。尽管大部分组织都使用 s_dfa,但您可以对 DFA 集成使用任何有效的 Cookie 名称。
  • 消除了不必要的重定向。由于显示到达数据是实时收集的,Adobe 收集服务器和 DFA 有可能交换每次页面查看的数据。在信息并非必要的情况下,插件可阻止这些数据交换。
注意

由插件用于消除不必要的 DFA 查询的其中一个机制是基于域的访问 Cookie。当访客在一次受 DFA 影响的显示到达或点进后跨了多个域时,跨越多个域的集成报表包会夸大点进和显示到达数据。

确认 DFA 集成成功

在进行了所有需要的网站更新之后,您可以使用网络流量查看器(如 Charles*、Chrome 开发人员工具或 Firebug*)来确认 DFA 正在与 Adobe 收集服务器通信。

在部署启用了 DFA 的 s_code.js 文件后,请使用网络流量查看器来查看 DFA 和 Adobe 数据收集服务器之间的请求,进而查找以下内容:

  • 对 DFA 的 fls.doubleclick.net/json 服务的请求。此服务可做出不同的响应,具体取决于您使用的 DFA 版本。通过 DFA 集成版本 1.5 可以:

    • 到 ad.doubleclick.net 的 HTTP 302 重定向。这将在响应中发送一个 Location: 标记,其中包含有关广告访客的信息。
    • 此位置标记可导致到 integrate.112.2o7.net/dfa_echo 的重定向。此服务将有关广告访客的信息转换为 JSON(启用 JavaScript 对象表示法)编码的字符串。将通过一个 200 OK HTTP 响应返回此数据。
  • 通过 DFA 集成版本 2.0(启用高级广告服务)可以:

    • fls.doubleclick.net 将通过一个 200 OK 做出直接响应。

在任何一种情况下,一次成功的请求将导致对 Adobe 数据收集服务器的请求,并且该请求中包含参数 vX,其中 X 是您的显示到达 eVar 数。此参数值采取以下格式:DFA-XXXX-XXXX- XXXX-XXXX-XXXX-XXXX-XXXX-XXXX-XXXX。此字符串包含有关当前访客上次点击和上次展示的数据。

调整 s.maxDelay

为成功实现 DFA 实施,需要为您的特定网站优化 s.maxDelay。

通常,提高或降低 s.maxDelay 的决定涉及在获取更多 DFA 访客数据与影响 Adobe 访客数据收集之间的权衡。提高 s.maxDelay 可获取更多的 DFA 访客数据,但(设置过高)可能影响 Adobe 访客数据的收集。降低 s.maxDelay 值可确保 Adobe 访客数据的收集,但可能损失 DFA 访客数据。

s.maxDelay​不仅在网络通信中封装时间来联系 DFA,它还表示要触发的浏览器延迟并评估这些通信所基于的 JavaScript。这是因为集成模块在将 HTML 元素插入 DOM 后会启动 s.maxDelay 计时器,DOM 将从 DFA Floodlight 服务器中提取数据。浏览器基于这一新 HTML 元素实际发起 HTTP 请求所花费的时间量,根据同时加载的其他图像或 JavaScript 文件、访客计算机的速度和特定的浏览器实施而有所不同。此外,在从 DFA Floodlight 服务器中检索 JSON 数据时,JavaScript 必须由浏览器评估。它仍然由浏览器完全控制,并在同时运行的 JavaScript 代码量较大或存在大量异步 JavaScript 请求的情况下可将其延迟。

如此一来,s.maxDelay​需要根据登陆页面的复杂性以及 DFA 的网络延迟量进行设置。在某些网站上,一种可用来降低复杂性的方法是在页面加载过程中提早触发 Adobe 收集代码,这样可在请求 Floodlight 服务器时减少浏览器中运行的内容。

超时变量在调整 s.maxDelay 时是绝对必要的,因为它会在每次达到 s.maxDelay 超时的时候递增。在决定提高或降低 s.maxDelay 时,我们建议遵循以下流程:

  1. 在将 s.maxDelay 设置为特定值的情况下收集多天数据。
  2. 在相应时间范围内运行 Daily Unique Visitors Report。
  3. 运行 Timeout Event Report 以检查经历的超时次数。请记住,超时只针对每个访客收集一次。

现在有了数据在手,便可计算

Timeout Percentage = [Step 3] / [Step 2] * 100

请注意,超时百分比实际上考虑了所有的网站访客。这其中的某些访客完全不会关联到 DFA,因此该超时具有误导性。要改进此计算,另一项分析可能只考虑设置了 clickThroughParam 的页面独特访客(例如 ?CID=1)。这将显示更高的准确性。

如果超时百分比非常低,请考虑降低 s.maxDelay。如果它非常高,请提高 s.maxDelay。降低 s.maxDelay 时,您将需要重新运行 Timeout Report 以确保超时次数没有显著增加。提高 s.maxDelay 时,您将需要运行 Page Views Report 以确保页面查看次数不会因数据丢失而下降。每当 s.maxDelay 发生更改时,请花几天时间来观察数据,以便确保该数据能代表一种趋势,而不只是简单的逐日浮动现象。

s.maxDelay 的最佳设置是在页面查看次数没有下降的同时使超时百分比达到最小。

当您转到版本 2.0 的集成时,超时次数预计会因为消除了 302 重定向而减少。使用测试版客户端的初步调查结果显示超时次数持续减少,因此将收集更多的 DFA 数据。

在此页面上