如何集成

Web JS SDK 3.0 具备以下特性:

  • 埋点能力,开发同学调用API主动采集自定义事件

  • 无埋点能力,自动采集用户行为事件,可通过开关控制

  • 小程序打通,方便于小程序打通访问用户

  • 原生打通,方便于原生App打通访问用户

  • Web可视化圈选支持

  • Hybrid可视化圈选支持

Web JS SDK 3.0 将SDK 2.0 中的H5内嵌页,Hybrid SDK,Web JS SDK集成与一体

Web JS SDK代码已托管在Github,暂时是 Private 状态,后续会开放

Web JS SDK 集成

请将以下的页面代码放置到需要分析的页面中的<head> 和 </head>标签之间,即可完成最新 Web JS SDK 页面代码的添加。

请注意使用具体的项目ID替换代码中的 your projectId、your DataSourceId 确保JS资源地址正确。

JS文件地址:https://assets.giocdn.com/sdk/cdp/gio.js

Web页面使用集成

<script type='text/javascript'>
(function(window, document, script, src, namespace) {
window[namespace] = window[namespace] || function() {
(window[namespace].q = window[namespace].q || []).push(arguments)
};
script = document.createElement('script');
let tag = document.getElementsByTagName('script')[0];
script.async = true;
script.src = src;
tag.parentNode.insertBefore(script, tag);
})(window, document, 'script', 'JS 资源地址', 'gdp');
gdp('init', 'your projectId', 'your dataSourceId', {
host: 'your apiServerHost',
version: '1.0.0'
});
gdp('send');
</script>

APP 内嵌H5页面使用集成

APP 内嵌 H5 页面集成方式和 Web 页面使用集成一致就行,Web JS SDK 会自动判断桥的情况进行数据的转发,详细可见Hybrid打通插件

小程序内嵌页使用集成

小程序内嵌页集成方式和 Web 页面使用集成添加的跟踪代码一致,可能需要和小程序数据进行用户的打通,这时就需要在SDK初始化时填写您小程序的 projectId,AppId 来作为打通的判断,详细可见小程序内嵌页打通插件

<script type='text/javascript'>
(function(window, document, script, src, namespace) {
window[namespace] = window[namespace] || function() {
(window[namespace].q = window[namespace].q || []).push(arguments)
};
script = document.createElement('script');
let tag = document.getElementsByTagName('script')[0];
script.async = true;
script.src = src;
tag.parentNode.insertBefore(script, tag);
})(window, document, 'script', 'JS 资源地址', 'gdp');
gdp('init', 'your projectId', 'your dataSourceId', 'your AppId', {
host: 'your apiServerHost',
version: '1.0.0'
});
gdp('send');
</script>

常见的初始化失败情况

  1. 初始化需要设置host,不设置会失败。

  2. 初始化必须填写projectId、datasourceId,否则会失败。

  3. 不支持file协议(3.2.0版本起支持)、localhost、127.0.0.1