智能横幅 SDK 集成指南

通过智能横幅 SDK，您可以将Adjust 智能横幅添加至自己的网站或网页应用。该指南展示了如何将 SDK 集成到项目中。

1. 安装 SDK

要将 SDK 添加到您的现有 Javascript 项目中，请使用包管理器进行安装。

安装依赖项后，将其导入到项目中。

import AdjustSmartBanner from "@adjustcom/smart-banner-sdk";

使用 CDN

如果您不想将 SDK 作为运行时依赖项进行安装，则可以通过 CDN (内容分发网络) 加载 SDK。在加载 SDK 时，您可以通过全局AdjustSmartBanner命名空间访问 SDK。

通过 CDN 加载 SDK 时，您应该使用缩小版本以获得更好的性能。

特定版本。例如： https://cdn.adjust.com/adjust-smart-banner-0.0.7.min.js
最新版本。例如： https://cdn.adjust.com/adjust-smart-banner-latest.min.js

SDK 文件会被缓存在 CDN 上，以便以最快的速度加载。缓存每 30 分钟刷新一次。要立即接收更新，请定向特定版本的 SDK。

要通过 CDN 加载智能横幅 SDK，请将下列代码片段粘贴进页面的<head>标签中：

<script type="application/javascript">
   !(function (e, n, t, a, o, s, r, i, c) {
      var d = o + "_q";
      (e[o] = e[o] || {}), (e[d] = e[d] || []);
      for (var u = 0; u < s.length; u++) r(e[o], e[d], s[u]);
      (i = n.createElement(t)),
         (c = n.getElementsByTagName(t)[0]),
         (i.async = !0),
         (i.src = "https://cdn.adjust.com/adjust-smart-banner-latest.min.js"),
         (i.onload = function () {
            e[o] = e[o].default;
            for (var n = 0; n < e[d].length; n++)
               e[o][e[d][n][0]]
                  ? e[o][e[d][n][0]].apply(e[o], e[d][n][1])
                  : console.error(
                       "No such function found in " + o + ": " + e[d][n][0],
                    );
            e[d] = [];
         }),
         c.parentNode.insertBefore(i, c);
   })(
      window,
      document,
      "script",
      0,
      "AdjustSmartBanner",
      [
         "init",
         "show",
         "hide",
         "setLanguage",
         "setIosDeepLinkPath",
         "setAndroidDeepLinkPath",
         "setContext",
         "setAndroidAppSchema",
         "setDeepLinkPath",
      ],
      function (e, n, t) {
         e[t] = function () {
            n.push([t, arguments]);
         };
      },
   );
</script>

2. 初始化 SDK

要初始化智能横幅 SDK，请调用AdjustSmartBanner.init方法。

AdjustSmartBanner.init({
   appToken: "APP_TOKEN",
});

调用该方法时，SDK 会检测设备平台。如果设备为移动平台，SDK 就会加载可用的智能横幅。可用横幅会在初始化后立即显示。

如果您的项目针对单一平台应用，请在appToken对象中将每个平台识别码作为键进行发送。

AdjustSmartBanner.init({
   appToken: {
      ios: "IOS_APP_TOKEN",
      android: "ANDROID_APP_TOKEN",
   },
});

3. 横幅本地化

您可以对智能横幅进行本地化，以获得更好的用户体验。智能横幅 SDK 会读取浏览器中的语言，如果横幅存在的本地化版本则显示本地化横幅。如果您想改变该行为，则可以指示 SDK 使用不同的语言。设置首选语言的方法有两种：

将其作为language参数发送至AdjustSmartBanner.init方法。
将两个字母的语言代码作为 字符串 参数调用setLanguage方法。

AdjustSmartBanner.setLanguage("fr");

完成了！SDK 现已集成到您的项目中。请查看本节其他指南，了解 SDK 功能相关信息，掌握不同功能的配置方法。