[Alpha]{class="badge informative"}

与Web SDK的区别

Server SDK和Web SDK共享相同的核心,因此它们以相同的格式将数据发送到相同的数据流,并使用相同的Cookie。 因为一个运行在服务器上,而另一个运行在浏览器中,所以它们在几个方面有所不同。 使用此页面可计划迁移,或在浏览器和服务器实施之间共享代码。

比较 comparison

面积
Web SDK
服务器SDK
运行位置
访客的浏览器
您的服务器,位于Node.js或其他服务器端JavaScript运行时中。 请参阅运行时支持。
安装
标记扩展、JavaScript库或@adobe/alloy npm包
@adobe/alloy-node npm包。 请参阅安装。
如何称呼它
alloy("sendEvent", { ... })
alloy.sendEvent({ ... }). 请参阅方法概述。
实例
每个页面加载一次,为一位访客提供服务
每个进程一个,加上每个访客请求的forRequest句柄
身份验证
无
必需。 事件转到经过身份验证的Edge Network服务器API。 请参阅身份验证。
身份标识
自动读取和写入浏览器Cookie
读取并写入您提供的Cookie服务。 每个事件都需要一个主标识。
同意
defaultConsent接受"in"、"out"和"pending"
defaultConsent仅接受"in"和"out"
个性化
请求、呈现和跟踪建议的显示
请求建议并返回它们。 不渲染它们或跟踪它们的显示。
上下文数据
浏览器中的页面、设备、环境、位置和客户端提示详细信息
实施详细信息、访客转发的请求标头以及Referer标头中的页面URL。 请参阅上下文和转发的标头。
sendEvent个结果
propositions、inferences和destinations
propositions
调试
debugEnabled、setDebug、alloy_debug查询字符串参数和Adobe Experience Platform Debugger
debugEnabled和setDebug,消息已写入控制台
监控挂钩
monitors选项和__alloyMonitors全局变量
createInstance的monitors选项

方法 methods

服务器SDK添加forRequest方法,Web SDK中不存在该方法。

它支持以下Web SDK命令作为方法: appendIdentityToUrl、applyResponse、configure、getIdentity、getLibraryInfo、sendEvent、setConsent和setDebug。

以下Web SDK命令不可用,因为它们依赖于浏览器或Server SDK不包含的组件:

  • applyPropositions
  • createMediaSession
  • getMediaAnalyticsTracker
  • sendMediaEvent
  • sendPushSubscription
  • subscribeRulesetItems

配置选项 configuration

sendEvent选项 sendevent

常见问题 faq

我可以在同一网站上使用Server SDK和Web SDK吗? same-site

是的。 一种常见模式是在服务器上请求个性化并在浏览器中呈现它。 请参阅混合个性化。 如果其​ 访问类型 ​为​混合身份验证,则两个库都可以将数据发送到相同的数据流。 两者使用相同的Cookie名称来标识和表示同意。

为何每个事件都需要一个主要身份? primary-identity

服务器SDK将事件发送到经过身份验证的Edge Network服务器API。 由于请求来自您的服务器,因此Edge Network无法使用访客的浏览器Cookie来识别这些访客。 相反,它要求在事件中包含主标识。 请参阅xdm。

我可以在无服务器功能中使用Server SDK吗? serverless

是,如果函数的运行时满足要求。 在函数处理程序之外的模块顶级创建和配置实例。 这样,热调用将重用配置的实例及其缓存的访问令牌。 在每次调用的处理程序中调用forRequest。

我可以使用Adobe Experience Platform Debugger吗? debugger

没有。 Adobe Experience Platform Debugger是一种用于检查页面的浏览器扩展。 要调试服务器SDK,请将debugEnabled设置为true或调用setDebug,然后查看服务器的控制台输出。

recommendation-more-help
experience-platform-help-collection