Web SDK 集成指南

通过 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。该包会自动更新，您无需更改目标文件。

要通过 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 (var e = 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 (var e = 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。要将包加入您的项目，请使用您常用的包管理器：

2. 初始化 SDK

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

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

appToken (string)：您的 Adjust 应用识别码。
environment (string)：SDK 运行的环境。传送 sandbox，可在 sandbox 模式下运行 SDK，方便进行测试；传送 production，可在生产模式下运行 SDK，方便发布。

Adjust.initSdk({
   appToken: "YOUR_APP_TOKEN",
   environment: "sandbox",
});