开始使用

通过 Adjust Web SDK，您可以在网页应用中记录归因、事件以及更多信息。该指南展示了如何将 Adjust SDK 集成至应用。

1. 添加 SDK 至您的项目

要开始使用，您需要将 SDK 添加至应用。Adjust SDK 可在 CommonJS 和 AMD (Asynchronous Module Definition) 环境中运行。当通过 CDN (Content Delivery Network) 加载时可通过全局Adjust命名空间访问。

使用 CDN

通过 CDN 加载 SDK 时，您应该使用缩小的生产版本。您可以通过添加一个版本至 CDN 目标来指定版本：https://cdn.adjust.com/adjust-5.6.0.min.js您可以通过定向adjust-latest包来获取最新版本：https://cdn.adjust.com/adjust-latest.min.js该包会自动更新，您无需更改目标文件。

提示:
SDK 文件会被缓存，确保服务速度。缓存每 30 分钟更新。如果您想强制更新当前版本，请在标头中定向特定版本。

要通过 CDN 加载 SDK，请将以下代码片段加入网页应用<head>标签中间：

<script type="application/javascript">
!function(t,e,a,r,n,s,d,l,o,i,u){t.Adjust=t.Adjust||{},t.Adjust_q=t.Adjust_q||[];for(var c=0;c<l.length;c++)o(t.Adjust,t.Adjust_q,l[c]);i=e.createElement(a),u=e.getElementsByTagName(a)[0],i.async=!0,i.src="https://cdn.adjust.com/adjust-latest.min.js",i.onload=function(){for(vare=0;e<t.Adjust_q.length;e++)t.Adjust[t.Adjust_q[e][0]].apply(t.Adjust,t.Adjust_q[e][1]);t.Adjust_q=[]},u.parentNode.insertBefore(i,u)}(window,document,"script",0,0,0,0,["initSdk","getAttribution","getWebUUID","setReferrer","trackEvent","addGlobalCallbackParameters","addGlobalPartnerParameters","removeGlobalCallbackParameter","removeGlobalPartnerParameter","clearGlobalCallbackParameters","clearGlobalPartnerParameters","switchToOfflineMode","switchBackToOnlineMode","stop","restart","gdprForgetMe","disableThirdPartySharing","initSmartBanner","showSmartBanner","hideSmartBanner"],(function(t,e,a){t[a]=function(){e.push([a,arguments])}}));
</script>

Adjust SDK 会在每个页面上加载并初始化。

子资源完整性

如果您想使用子资源完整性检查来抵御跨站脚本 (XSS) 攻击，可以使用以下调用在运行包之前对其进行验证：

<script type="application/javascript">
!function(t,e,a,r,n,s,o,d,l,i,u){t.Adjust=t.Adjust||{},t.Adjust_q=t.Adjust_q||[];for(var c=0;c<d.length;c++)l(t.Adjust,t.Adjust_q,d[c]);i=e.createElement(a),u=e.getElementsByTagName(a)[0],i.async=!0,i.src="https://cdn.adjust.com/adjust-latest.min.js",i.crossOrigin="anonymous",i.integrity=s,i.onload=function(){for(vare=0;e<t.Adjust_q.length;e++)t.Adjust[t.Adjust_q[e][0]].apply(t.Adjust,t.Adjust_q[e][1]);t.Adjust_q=[]},u.parentNode.insertBefore(i,u)}(window,document,"script",0,0,"sha384-BqbTn9xyk5DPznti1ZP8ksxKiOFhKufLBFWm5eNMCnZABFSG1eqQfcu5dsiZJHu5",0,["initSdk","getAttribution","getWebUUID","setReferrer","trackEvent","addGlobalCallbackParameters","addGlobalPartnerParameters","removeGlobalCallbackParameter","removeGlobalPartnerParameter","clearGlobalCallbackParameters","clearGlobalPartnerParameters","switchToOfflineMode","switchBackToOnlineMode","stop","restart","gdprForgetMe","disableThirdPartySharing","initSmartBanner","showSmartBanner","hideSmartBanner"],(function(t,e,a){t[a]=function(){e.push([a,arguments])}}));
</script>

使用 npm

Adjust SDK 还可用于 npm。要将包加入您的项目，请使用您常用的包管理器：

NPM
yarn
pnpm
$ npm install @adjustcom/adjust-web-sdk --save

2. 初始化 SDK

安装 SDK 后，需要进行初始化。为此，请调用initSdk方法。该方法带有多个参数，可自定义 SDK 在应用内如何工作。

您必须将以下参数添加至initSdk调用来初始化 SDK：

  • appToken：Adjust 应用识别码 (app token)。
  • environment：应用运行的环境。要在本地测试应用，请设置为sandbox。
Javascript
Adjust.initSdk({
  appToken: 'YOUR_APP_TOKEN',
  environment: 'sandbox'
});

要进一步自定义 Adjust SDK 设置，请参考配置功能部分的指南。