内容交付故障诊断
如果您的页面没有显示预期内容,可以采取以下步骤来对内容交付进行调试。
- 仔细检查您的活动或营销活动代码。键入错误或其他错误可能会导致无法显示预期内容。
- 使用 mboxTrace 或 mboxDebug 为 Target 请求排除故障。
- 使用 Adobe Experience Cloud Debugger(一个易于使用的工具,它与 mboxDebug 提供几乎相同的信息)为 Target 请求排除故障。
当您在您的页面上设置 Target 以确保触发 Target 请求并且设置 Cookie 时,mboxDebug 特别有用。但是,在调试内容交付时,mboxDebug 并不会提供有用的详细信息。如果活动未显示在页面上或页面上显示了不需要的内容,请使用 mboxTrace 对页面进行细致的检查和调试。
检索要用于调试工具的授权令牌 section_BED130298E794D1FA229DB7C3358BA54
由于 mboxTrace 和 mboxDebug 可将营销活动数据和配置文件数据披露给外部各方,因此需要授权令牌。可在 Target UI 中检索授权令牌。令牌的有效时间为 6 个小时。
您必须具有以下用户权限之一才能生成身份验证令牌:
要检索授权令牌,请执行以下操作:
-
单击 Administration > Implementation。
-
在“调试器工具”部分中,单击 Generate New Authentication Token。
-
将生成的令牌作为一个参数添加到 URL 中,以启用任一高级调试工具。
mboxTrace section_256FCF7C14BB435BA2C68049EF0BA99E
通过 mboxTrace,可接收附加到 Target 响应的跟踪信息。跟踪信息反映 Target 调用的结果(例如,转化或展示)以及任何其他可能有助于确定为何发生此特定结果的数据,如在营销活动中从中作出选择的一组可用分支。使用此信息可调试内容发送服务。
可用的参数如下:
?mboxTrace=console
对于 at.js,不会像在 mbox.js 中一样弹出新的浏览器窗口或输出到控制台(现已弃用),而是需要检查网络请求,并在“预览”(Chrome) 或“响应”(Firefox) 下查看。
?mboxTrace=json
?mboxTrace=window
?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 的影响。访客可以看到您的常规推荐设计。
mboxDebug mboxdebug
要使用 mboxDebug,请将 mboxDebug 参数附加到您 URL 的末尾。下表包含关于与 Target 响应相关的 URL 参数的信息。
mboxDebug=1
将此参数添加到任何定义了 Target 请求的 URL 将打开一个弹出窗口,其中显示有用的调试详细信息。Cookie 信息、PCid 和会话 ID 值都会写出,并且用户可看到所有 URL。单击 Target 请求 URL 以显示对该 Target 要求的响应。有关更多信息,请参阅 mbox_debug.pdf。
mboxDisable=1
mboxOverride.browserIp=<Insert IP address>
使用此 URL 参数测试地理定位。输入 IP 地址作为此属性的值,Test&Target 的地理定位功能会评估该 IP 地址,查找营销活动中设置的与其匹配的任何地理定位或客户群。
#
之后的任何内容均为片段标识符,并导致调试参数无法正常运行。Adobe Experience Cloud Debugger section_A2798ED3A431409690A4BE08A1BFCF17
借助 Adobe Experience Cloud 调试器,您可以快速、轻松地了解 Target 实施。您可以快速查看库配置、检查请求以确保正确传递自定义参数、打开控制台日志记录以及禁用所有 Target 请求。在 Experience Cloud 中通过身份验证,即可使用强大的 MboxTrace 工具检查活动和受众资格以及访客个人资料。
有关更多信息,请参阅下面的培训视频:
有关更多详细信息,请参阅使用Adobe Experience Cloud调试器调试at.js。
推荐中未显示最畅销商品 section_3920C857270A406C80BE6CBAC8221ECD
SiteCatalyst: purchase
调用无法用于“购买”算法流量数据。请改用 orderConfirmPage
调用。
检查活动优先级 section_3D0DD07240F0465BAF655D0804100AED
用 Target Standard/Premium 创建的基于表单的活动可能与在 Target Classic UI 中创建的优先级相同并使用相同 Target 请求的活动发生冲突。
自定义代码无法在 Internet Explorer 8 中生成预期结果。 section_FAC3651F19144D12A37A3E4F14C06945
Target 不再支持 IE 8。
未设置 Target Cookie section_77AFEB541C0B495EB67E29A4475DF960
如果您的网站具有一个子域(例如 us.domain.com),但您需要在 domain.com(而不是 us.domain.com)上设置 Target Cookie,则必须覆盖 cookieDomain
设置。有关详细信息,请参阅targetGlobalSettings()。
如果某个元素也是 Adobe Experience Manager 个性化的一部分,则 Target 内容会闪烁或无法显示。 section_9E1DABEB75AB431FB9F09887E6DD07D3
如果某个 DOM 元素是 Adobe Experience Manager (AEM) 个性化定位和 Target 活动的一部分,则 Target 内容可能会闪烁或无法显示。
要修复这种状况,您可以在运行 Target 的页面上禁用 AEM 个性化。
由于 URL 无效,无法交付重定向选件和远程选件。 section_7D09043B687F43B39DAEDF17D00375AC
如果重定向选件或远程选件使用无效的 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。 query-strings
Activity URL确定授予访客参加活动资格并向用户呈现活动体验的页面。 在活动创建期间出现提示时,键入完整的 URL 并不总是能确保在该网站页面上提供内容,尤其是当 URL 包含查询字符串参数时。
默认情况下,Visual Experience Composer (VEC)会打开可视化体验编辑器设置中指定的页面。 您也可以在活动创建期间指定不同页面。
要在VEC打开后显示其他页面,请单击 Configure gear icon >选择 Page Delivery >然后在Activity URL字段中指定所需URL。
但是,如果 URL 包含查询字符串参数呢?它是否会生效并显示个性化内容?在此场景中,无论目标受众是谁,您都可以在基础 URL 之外包括模板规则,以定义您的查询参数。
以下选项可用于包括额外的模板规则:
选项1:复制URL,并使用“包含”选项将其保留在模板规则中。
此选项确保该 URL 符合活动的条件,但请注意,其上可能会附加极端情况,会影响您的报告数据,包含基础 URL 的 URL 会有额外的记录。
在此场景中,URL 是 https://shopping.mycart.com?type=Summers%20Offers
而额外的模板规则“包含”相同的 URL,以 OR 分隔符分隔:
选项2:限制URL仅“包含”查询字符串的条件。
之前选项中讨论的极端情况适用于此选项,但这里的条件性设置仅限为查询字符串。
在此场景中,URL 是 https://shopping.mycart.com?type=Summers%20Offers
而额外的模板规则仅“包含”查询字符串,以 OR 分隔符分隔:
选项 3:不定向到完整 URL,而是利用 URL 的特定部分。
在此方案中,URL是https://shopping.mycart.com?type=Summers%20Offers
,额外的模板规则使用type > is (case sensitive) > type=Summers%20Offers指定Query,以OR分隔符分隔:
Target配置文件属性值中的转义双引号无法按预期工作。 escape
当您在Target配置文件属性中发送包含双引号的值时,必须对其进行双重转义,如下所示。
adobe.target.trackEvent({
"mbox": "data-collection",
"params": {
"profile.tagLine": "Escape \\\"Double Quotes\\\" like this."
}
});
培训视频
以下视频包含有关本文中所讨论概念的详细信息。