使用Platform Web SDK调试Target
验证Target活动并调试Web SDK,以排查实施、内容交付或受众资格问题。 迁移指南的此页面说明了使用at.js调试与使用Platform Web SDK调试之间的区别。
下表总结了各种功能和对测试和调试方法的支持。
mboxDebug
URL参数alloy_debug
参数用于类似的调试信息mboxTrace
URL参数alloy_debug
URL参数Adobe Experience Platform Debugger浏览器扩展
适用于Chrome和Firefox的Adobe Experience Platform Debugger扩展可检查您的网页,并帮助您验证Adobe Experience Cloud实施。
您可以在任何网页上运行Platform Debugger,并且该扩展可以访问公共数据。 若要使用扩展访问非公共数据(如Target跟踪信息),必须通过 登录 链接向Experience Cloud进行身份验证。
获取并安装Adobe Experience Platform Debugger
Adobe Experience Platform Debugger可以安装在Google Chrome或Mozilla Firefox浏览器中。 请按照下面的相应链接在您的首选浏览器上安装扩展:
安装Chrome扩展或Firefox加载项后,会在扩展栏中添加一个图标( )。 选择此图标以打开扩展。
有关Adobe Experience Platform Debugger扩展以及如何调试所有AdobeWeb应用程序的详细信息,请参阅专用指南。
使用QA URL预览Target活动
at.js和Platform Web SDK都允许您使用Target QA URL预览Target活动,并且这两种实施方法都支持相同的QA功能。
通过指示at.js或Platform Web SDK将特定Cookie写入名为at_qa_mode
的浏览器,Target QA URL可正常工作。 此Cookie用于强制对特定活动和体验进行鉴别。
sendEvent
调用中传递的xdm.web.webPageDetails.URL
值启用目标QA模式。 对此值所做的任何修改(例如将所有字符变为小写),都可能会妨碍Target QA模式正常工作。有关Target活动QA的详细信息,请参阅专用指南。
调试Target实施
下表概述了at.js与Platform Web SDK调试策略之间的差异:
使用URL参数加载页面:
mboxDisable=true
使用URL参数
mboxDebug=true
加载页面加载包含URL参数的页面:
alloy_debug=true
或在开发人员控制台中执行
alloy("setDebug", { "enabled": true });
window.___target_trace
对象下提供了包含参与决策过程的详细信息的跟踪对象。加载包含URL参数的页面:
mboxTrace=window&authorization={TOKEN}
禁用Target功能
Platform Web SDK当前没有选择性地禁止Target响应的功能。 但是,可以使用浏览器的开发人员工具、各种浏览器扩展或第三方应用程序阻止Platform Web SDK请求。 例如,要使用Google Chrome阻止Platform Web SDK,请执行以下操作:
- 右键单击页面上的任意位置,然后选择 Inspect
- 选择 网络 选项卡
- 按字符串
//ee//
筛选,以仅查看Platform Web SDK调用 - 重新加载页面
- 右键单击其中一个过滤的网络请求,然后选择 阻止请求域
- 重新加载页面,并注意网络请求已被阻止
- 完成调试后,右键单击被阻止的网络请求并选择 取消阻止,或关闭“开发人员工具”面板
查看调试日志记录
使用mboxDebug=true
URL参数调试at.js日志记录可显示有关每个Target请求、响应以及尝试将内容呈现到页面的详细信息。 Platform Web SDK具有类似的使用alloy_debug=true
URL参数的调试日志记录。
mboxDebug=true
)alloy_debug=true
)AT:
[alloy]
查看Target跟踪
Target跟踪可提供有关活动资格和访客的Target配置文件的详细信息。 由于Target跟踪包含不公开的信息,因此查看这些跟踪需要授权令牌或在Adobe Experience Platform Debugger浏览器扩展窗口中进行身份验证。
mboxTrace
URL参数要使用Adobe Experience Platform Debugger查看Platform Web SDK Target跟踪,请执行以下操作:
- 导航到网站上已使用Platform Web SDK实施Target的页面
- 选择浏览器导航栏中的图标( )以打开Adobe Experience Platform Debugger扩展
- 选择 登录 链接
- 使用Adobe Experience Cloud登录名进行身份验证
- 选择左侧的 日志 选项卡
- 选择顶部的 Edge 选项卡
- (可选)为您的调试会话提供一个名称,然后单击 连接 按钮
- 重新加载页面,日志中应填充有关边缘网络交互的详细信息
- 关注描述中以“目标跟踪”开头的日志条目,并选择 查看 以查看Target跟踪详细信息
选择 视图 后,将显示一个叠加图,允许您查看与请求相关的以下信息:
- 匹配的活动
- 不匹配的活动
- 请求详细信息
- 配置文件快照
有关Target跟踪的详细信息,请参阅有关调试Target内容投放的专用指南。
使用保障进行故障排除
可以在Adobe Experience Platform Debugger浏览器扩展和Assurance应用程序(以前称为Project Griffon)中查看Target跟踪信息。 要在Assurance中查看Target跟踪,请执行以下操作:
- 如上所述,打开Adobe Experience Platform Debugger浏览器扩展并连接远程调试会话
- 选择带有您的会话名称的链接,该链接位于调试日志上方
- 平台保证会加载并在数据流中为您的实施配置的所有Adobe应用程序显示详细的日志记录
- 按
adobe.target
筛选日志 - 选择类型为
com.adobe.target.trace
的日志条目 - 展开有效负载的详细信息并查看
context > targetTrace
下的信息
检查网络请求和响应
Platform Web SDK sendEvent
调用的请求有效负载和响应与at.js不同。 使用浏览器的开发人员工具检查网络调用时,以下概要应该帮助您了解请求和响应的结构。
内容请求有效负荷
- 配置文件、实体和其他非mbox参数在
data.__adobe.target
下的事件数组中传递 - 决策范围位于
query.personalization.decisionScopes
下的事件数组中 - 映射到下游mbox参数的XDM数据位于
xdm
下的事件数组中
内容响应正文
- Platform Web SDK返回
handle
对象下所有Adobe应用程序的操作 personalization:decisions
操作表示来自Target或offer decisioning的响应- 目标建议以数组形式呈现,每个建议都具有以
AT:
为前缀的唯一建议ID - 决策范围和活动详细信息位于建议数组中
- 选件详细信息位于
data
下的items
数组中 - 响应令牌位于
meta
下的items
数组中
建议事件有效负载
- Target特定的SDK事件为展示的
decisioning.propositionDisplay
或交互的decisioning.propositionInteract
,例如点击 - 建议事件的详细信息位于
xdm._experience.decisioning
下的事件数组中 - 显示或交互事件的建议ID应当与从Target返回的内容的建议ID匹配
恭喜,您已到达本教程的结尾! 祝您顺利将Adobe Target实施迁移到Web SDK!