内容交付故障诊断

如果您的页面没有显示预期内容,可以采取以下步骤来对内容交付进行调试。

  • 仔细检查您的活动或营销活动代码。键入错误或其他错误可能会导致无法显示预期内容。
  • 使用 mboxTrace 或 mboxDebug 为 Target 请求排除故障。
  • 使用 Adobe Experience Cloud Debugger(一个易于使用的工具,它与 mboxDebug 提供几乎相同的信息)为 Target 请求排除故障。

当您在您的页面上设置 Target 以确保 Target 请求正在触发并且正在设置 Cookie 时,mboxDebug 特别有用。但是,在调试内容交付时,mboxDebug 并不会提供有用的详细信息。如果活动未显示在页面上或页面上显示了不需要的内容,请使用 mboxTrace 对页面进行细致的检查和调试。

检索要用于调试工具的授权令牌

由于 mboxTrace 和 mboxDebug 可将营销活动数据和配置文件数据披露给外部各方,因此需要授权令牌。可在 Target UI 中检索授权令牌。令牌的有效时间为 6 个小时。

您必须具有以下用户权限之一才能生成身份验证令牌:

  • 至少“编辑者”权限(或“审批者”)

    有关 Target Standard 客户的详细信息,请在“用户”**​中参阅指定角色和权限。有关 Target Premium 客户的详细信息,请参阅配置企业权限

  • 工作区/产品配置文件级别的管理员角色

    工作区仅对 Target Premium 客户可用。有关详细信息,请参阅配置企业权限

  • Adobe Target 产品级别的管理员权限(系统管理员权限)

要检索授权令牌,请执行以下操作:

  1. 单击​“管理”>“实现”

  2. 从“调试器工具”部分中,单击​“生成新的身份验证令牌”

    生成新的身份验证令牌

  3. 将生成的令牌作为一个参数添加到 URL 中,以启用任一高级调试工具。

    授权令牌

mboxTrace

通过 mboxTrace,可接收附加到 Target 响应的跟踪信息。跟踪信息反映 Target 调用的结果(例如,转化或展示)以及任何其他可能有助于确定为何发生此特定结果的数据,如在营销活动中从中作出选择的一组可用分支。使用此信息可调试内容发送服务。

可用的参数如下:

mboxTrace 选项 结果
?mboxTrace=console 作为对象打印到控制台日志中。
对于 at.js,不会像在 mbox.js 中一样弹出新的浏览器窗口或输出到控制台,您而是将需要检查网络请求,并在“预览”(Chrome) 或“响应”(Firefox) 下查看。
?mboxTrace=json 作为 JSON 文字字符串打印到控制台日志中
?mboxTrace=window 作为 JSON 字符串打印到弹出窗口中
?mboxTrace=disable 关闭跟踪会话模式

示例 mboxTrace 调用

https://www.mysite.com/page.html?mboxTrace=window&authorization=f543abf-0111-4061-9619-d41d665c59a6

输出会显示与您的内容相关的非常详细的信息。mboxTrace 会显示与您的营销活动或活动以及配置文件相关的详细信息。它还提供执行前配置文件的快照,以及执行后所做更改的快照。同时,也显示为各个位置评估了哪些营销活动或活动。

某些信息包含匹配和不匹配的客户群和定位 ID:

  • SegmentId:客户群的 ID,来自可重复使用的客户群库或为特定营销活动创建的匿名客户群库。
  • TargetId:定位的 ID,来自定位表达式库或营销活动中任意客户群的匿名定位。
  • 不匹配:在此调用中,请求不符合这些客户群或定位的要求。
  • 匹配:请求符合指定客户群或定位的要求。

在推荐页面上使用 mboxTrace:在具有推荐的页面上添加 mboxTrace 作为查询参数会将页面上的推荐设计替换为 mboxTrace 详细信息窗口,后者显示关于您的推荐的深入信息,包括:

  • 返回的推荐与请求的推荐
  • 使用的键值,以及该键值是否在生成推荐
  • 标准生成的推荐与备用推荐
  • 标准配置
  • 应用的排除和包含
  • 收集规则

您不需要在查询参数中包含 =console=json=window。完成 mboxTrace 详细信息后,添加 =disable,然后按 Enter 返回到正常显示模式。

您网站的正常功能和外观不受 mboxTrace 的影响。访客将看到您的常规“推荐”设计。

mboxDebug

要使用 mboxDebug,请将 mboxDebug 参数附加到您 URL 的末尾。下表包含关于与 Target 响应相关的 URL 参数的信息。

注意

某些 mboxDebug 参数无论是否进行身份验证均可用。

URL 参数 用途
mboxDebug=1 调试器
将此参数添加到任何定义了 Target 请求的 URL 将打开一个弹出窗口,其中显示有用的调试详细信息。Cookie 信息、PCid 和会话 ID 值都会写出,并且用户可看到所有 URL。单击 Target 请求 URL 以显示对该 Target 要求的响应。有关更多信息,请参阅 mbox_debug.pdf
mboxDebug=x-cookie 修改 Cookie
mboxDisable=1 停用页面上的 mbox
mboxDebug=x-profile 查看配置文件集。
mboxDebug=x-time 显示每个 Target 请求的响应时间
mboxOverride.browserIp=<Insert IP address> 测试地理定位
使用此 URL 参数测试地理定位。输入 IP 地址作为此属性的值,Test&Target 的地理定位功能会评估该 IP 地址,查找营销活动中设置的与其匹配的任何地理定位或客户群。
注意

确保 URL 片段位于查询字符串参数之后。第一个 # 之后的任何内容均为片段标识符,并导致调试参数无法正常运行。

Adobe Experience Cloud 调试器

借助 Adobe Experience Cloud 调试器,您可以快速、轻松地了解 Target 实施。您可以快速查看库配置、检查请求以确保正确传递自定义参数、打开控制台日志记录以及禁用所有 Target 请求。在 Experience Cloud 中通过身份验证,即可使用强大的 MboxTrace 工具检查活动和受众资格以及访客个人资料。

有关更多信息,请参阅下面的培训视频:

有关更多详细信息,请参阅使用 Adobe Experience Cloud Debugger 调试 at.js

如果 target.js 在交付过程中加载失败

如果 target.js 在交付过程中加载失败,mbox.js 会向访客发送一个名为“em-disabled”的 Cookie。此 Cookie 可防止使用 Visual Experience Composer 创建的选件呈现在网站上。具有此 Cookie 的访客既不会看到测试内容,也不会被计入活动报表。所有其他选件内容(例如 Target Classic 中营销活动的选件内容)将继续加载。此 Cookie 的生命周期为自加载失败之时起 30 分钟。

推荐中未显示最畅销商品

SiteCatalyst: purchase 调用无法用于“购买”算法流量数据。请改用 orderConfirmPage 调用。

检查活动优先级

用 Target Standard/Premium 创建的基于表单的活动可能与在 Target Classic UI 中创建的优先级相同并使用相同 Target 请求的活动发生冲突。

自定义代码在 Internet Explorer 8 中没有产生预期的结果。

Target 不再支持 IE 8。

在使用 mbox.js 时,无法加载全局 Target 请求投放的 JavaScript 内容。

请升级到 mbox.js 版本 58 或更高版本。

mbox.js 58 版和更高版本在出现 HTML BODY 标签之后立即对全局 Target 请求执行非 JavaScript 内容。在触发 DOMContentLoaded 事件之后,执行全局 Target 请求的 <script> 标签内的 JavaScript 内容。这种内容投放顺序确保正确地投放并呈现全局 Target 请求的 JavaScript 内容。

未设置 Target Cookie

如果您的网站具有一个子域(例如 us.domain.com),但您需要在 domain.com(而不是 us.domain.com)上设置 Target Cookie,则必须覆盖 cookieDomain 设置。有关更多信息,请参阅 targetGlobalSettings()

如果某个元素同时也是 AEM 个性化的一部分,则 Target 内容会闪烁或无法显示。

如果某个 DOM 元素是 Adobe Experience Manager (AEM) 个性化定位和 Target 活动的一部分,则 Target 内容可能会闪烁或无法显示。

要修复此问题,您可以在运行 Target 的页面上禁用 AEM 个性化。

由于 URL 无效,无法交付重定向选件和远程选件。

如果重定向选件或远程选件使用无效的 URL,则可能无法交付该选件。

对于重定向选件,Target 响应可包含 /* invalid redirect offer URL */

对于远程选件,Target 响应可包含 /* invalid remote offer URL */

可在浏览器中或使用 mboxTrace 检查 Target 响应。有关有效 URL 的更多信息,请参阅 https://tools.ietf.org/html/std66

我的网站上不触发 Target 请求。

如果所使用的 doctype 无效,则 at.js 不触发 Target 请求。at.js 需要 HTML 5 doctype。

培训视频

以下视频包含有关本文中所讨论概念的详细信息。

添加扩展 教程徽章

基本Adobe Target调试教程徽章

Mbox 跟踪 教程徽章

On this page