adjust-icon

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",
});