内容交付故障诊断

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

  • 仔细检查您的活动或营销活动代码。键入错误或其他错误可能会导致无法显示预期内容。
  • 使用mboxTrace或mboxDebug对Target请求进行疑难解答。
  • 使用Adobe Experience Cloud调试器(一个简单易用的工具,它提供与mboxDebug大部分相同的信息)对Target请求进行疑难解答。

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

检索要与调试工具一起使用的授权令牌

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

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

  • 至少Editor权限(或Approver)

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

  • 工作区/产品用户档案级别上的管理员角色

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

  • Adobe Target产品级别上的管理权限(Sysadmin权限)

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

  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添加为页面上的查询参数并添加推荐将替换页面上的Recommendations设计,并添加一个mboxTrace详细信息窗口,该窗口显示有关您的推荐的详细信息,包括:

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

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

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

mboxDebug

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

注意

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

URL 参数 用途
mboxDebug=1 调试器
将此参数添加到定义了目标请求的任何URL会打开一个弹出窗口,其中包含宝贵的调试详细信息。 Cookie 信息、PCid 和会话 ID 值都会写出,并且用户可看到所有 URL。单击目标请求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调试器调试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内容。 全局Target请求的<script>标签内的JavaScript内容在DOMContentLoaded事件触发后执行。 内容投放的顺序确保全局Target请求的JavaScript内容能够正确传送和呈现。

目标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

目标请求未在我的站点上触发。

如果您使用的doctype无效,at.js不会触发目标请求。 at.js 需要 HTML 5 doctype。

培训视频

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

添加扩展 教程徽章

基本目标调试教程标记

Mbox跟踪教程标记

在此页面上