跳到主要内容
版本:2.6

Web/H5 自适应弹窗 SDK

集成 SDK

集成数据采集 SDK

JS 弹窗 SDK 依赖于数据数据采集 SDK,如已集成请跳过

参考 Web JS SDK

如果你的站点只在移动端使用,可以使用 H5 弹窗 SDK ,如果您的站点只在 PC 端使用,可以使用 Web 弹窗 SDK

集成弹窗 JS SDK

JS 文件下载地址:

弹窗 JS SDK:https://assets.giocdn.com/sdk/cdp/marketing/gtouch.latest.js

SDK 集成方式

按照以下要求,在数据采集 SDK 集成代码下方添加弹窗 SDK 集成代码

<script type='text/javascript'>

// 弹窗 SDK 必须与数据采集 SDK 配合才能正常工作

// 请参考帮助文档「开发者文档 \> SDK 集成 > JS SDK」完成数据数据采集 SDK 集成

// 弹窗 SDK

gdp('plugin', {

id: 'gio\_plugin\_gtouch',

src: document.location.protocol + "//assets.giocdn.com/sdk/cdp/marketing/gtouch.latest.js",

dataHost: '您的弹窗请求地址'

})

//custom page code begin here

//custom page code end here

gdp('send');

</script>

示例代码

以下代码中的配置信息都是示例用的,请不要直接复制使用。

 <script type='text/javascript'>

// 数据采集 SDK

!function (e, t, n, g, i) { e\[i\] = e\[i\] || function () { (e\[i\].q = e\[i\].q || \[\]).push(arguments) }, n = t.createElement("script"), tag = t.getElementsByTagName("script")\[0\], n.async = 1, n.src = g, tag.parentNode.insertBefore(n, tag) }(window, document, "script", "https://assets.giocdn.com/cdp/gio.js", "gdp");

gdp('init', 'a500f222e29e3b0c', '9eda0bb1d74f86e4', {

host: 'gdp-test-api.growingio.com',

scheme: 'http'

});

// 弹窗 SDK

gdp('plugin', {

id: 'gio\_plugin\_gtouch',

src: document.location.protocol + "//assets.giocdn.com/sdk/cdp/marketing/gtouch.latest.js",

dataHost: 'gdp-test.growingio.com'

});



gdp('send');

</script>

测试弹窗

集成 SDK 后请务必创建分别创建一个 「 网页」弹窗和「 H5 应用」 弹窗进行测试,以保证 SDK 正确集成,弹窗创建方法请参考 创建弹窗

自适配 SDK 工作原理

自动适应弹窗主要的工作原理如下,其会自动探测浏览器环境,判断是 PC 端还是移动端,根据当前环境加载移动端 H5 或 PC 端 Web SDK。代码示例如下

//gtouch.latest.js源码分析

//m是sdk加载地址,g表示"是否H5环境",m最终会替换成对应环境的弹窗SDK JS

m = g ? m.replace("gtouch", "h5") : m.replace("gtouch", "access");

所以如果您选择了在自己的服务器或 CDN 托管弹窗 SDK 代码,请务必保证以下三个文件在同一个目录下。