adjust-icon

智能横幅 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 功能相关信息,掌握不同功能的配置方法。