内容交付故障诊断

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

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

在设置 Target ,以确保触发Target请求并设置Cookie。 但是,在调试内容交付时,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,来自定位表达式库或营销活动中任意客户群的匿名定位。
  • Unmatched:在此调用中,请求不符合这些客户群或定位的要求。
  • Matched:请求符合指定客户群或定位的要求。

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

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

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

您网站的正常功能和外观不受 mboxTrace 的影响。访客可以看到您的常规Recommendations设计。

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 Debugger

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

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

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

推荐中未显示最畅销商品

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

检查活动优先级

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

自定义代码无法在 Internet Explorer 8 中生成预期结果。

Target 不再支持 IE 8。

未设置 Target Cookie

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

如果某个元素同时也是Adobe Experience Manager个性化的一部分,则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。

确保 Target 活动可正确处理包含查询字符串参数的URL。

的 活动URL 确定符合活动访客条件并向用户呈现活动体验的页面。 在活动创建过程中,如果出现提示,键入完整的URL并不总能确保内容是在该网站页面上交付的,尤其是包含查询字符串参数的URL。

默认情况下, 可视化体验编辑器 (VEC)打开您的 可视化体验编辑器设置. 您还可以在活动创建期间指定其他页面。

要在VEC打开后显示其他页面,请单击 配置齿轮图标 >选择 页面交付 > ,然后在 活动URL 字段。

配置页面交付设置UI

但是,如果URL包含查询字符串参数,该怎么办? 它是否有效并显示个性化内容? 在此方案中,无论您的目标受众是什么,您都可以在基本URL之外还包含模板规则来定义查询参数。

以下选项可用于包含其他模板规则:

选项1:复制URL并将其保留在模板规则中,并使用“包含”选项。

此选项可确保此URL符合活动条件,但请注意,其中附加了一些可能影响报表数据的拐角案例,这些案例会向包含基本URL的URL添加其他记录。

在此方案中,URL为 https://shopping.mycart.com?type=Summers%20Offers 和其他模板规则“包含”相同的URL(由OR运算符分隔):

在模板规则中复制URL

选项2:限制仅包含查询字符串的URL“包含”条件。

此选项中将应用上一个选项中讨论的拐角大小写,但此处的条件设置仅限于查询字符串。

在此方案中,URL为 https://shopping.mycart.com?type=Summers%20Offers 和其他模板规则“包含”的“仅”查询字符串,并使用OR运算符分隔:

模板规则仅包含查询字符串

选项3:利用URL的特定部分,而不是定位完整的URL。

在此方案中,URL为 https://shopping.mycart.com?type=Summers%20Offers 和其他模板规则指定 查询 with type > 为(区分大小写) > type=Summers%20Offers,由OR运算符分隔:

利用URL特定部分的模板规则

培训视频

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

添加扩展 教程徽章

基本 Adobe Target 调试 课程徽章

Mbox 跟踪 教程徽章

在此页面上