抖音小程序

抖音小程序对抖音小程序多样的开发方式,我们给出了主流开发方式的集成方法参考。如您使用了其他开发方式,请咨询我们。

如果您使用跨平台框架开发且有多端(特指小程序,快应用、App 和 Web 除外)同时需要集成 SDK 的需求时,只需在框架代码中集成一次即可。例:

使用 uni-app 同时开发微信小程序和阿里(支付宝)小程序,只需集成一次即可。

准备工作​

1、在 GrowingIO 平台中新数据源并获取 accountId和dataSourceId。

2、在您的小程序中获取 appId。

3、在下列选项中选择对应的开发方式,并下载对应的 SDK 文件存放在项目中或使用 npm 的方式集成。

集成SDK​

原生uni-appTaro1、加载 SDK​下载SDK添加至项目目录中,下文中以utils/gio目录作为下载集成的示例目录(目录和 SDK 文件可自定义重命名)。

抖音原生 SDK 下载:https://assets.giocdn.com/sdk/minip/4.4.2/gio-bytedance.js

(如果您点击链接在浏览器中直接打开了文件并不是下载文件,请尝试右键点击链接,选择 链接存储为... 即可正常触发下载)

2、使用init方法进行初始化​参考示例代码在 app.js 小程序主文件中引用SDK并在 App 实例之前调用init方法进行初始化。

注意不要随意修改初始化代码位置,SDK 不支持在小程序的任意生命周期中进行初始化。

示例代码​// app.jsimport gdp from './utils/gio/gio-bytedance.js';gdp('init', 'your GrowingIO accountId', 'your dataSourceId', 'your AppId', { version: 'your miniProgram version', // OP私有部署客户请填写serverUrl,Saas客户请忽略 serverUrl: 'your server url' ...other settings});App({ ... });原有 require 的引用方式依然可以使用。const gdp = require('./utils/gio/gio-bytedance.js').default;1、加载 SDK​方式一:下载本地集成​下载SDK添加至项目目录中,下文中以utils/gio目录作为下载集成的示例目录(目录和 SDK 文件可自定义重命名)。

uniapp 框架 SDK 下载:https://assets.giocdn.com/sdk/minip/4.4.2/gio-uniapp.js

(如果您点击链接在浏览器中直接打开了文件并不是下载文件,请尝试右键点击链接,选择 链接存储为... 即可正常触发下载)

方式二:npm 集成​npm i gio-miniprogram-sdk --save2、使用init方法进行初始化​参考示例代码在 main.js 小程序主文件中引用SDK并调用init方法进行初始化。

注意init方法所处位置(vue2 和 vue3 中分别与 app 实例的相对位置不同)

注意不要随意修改初始化代码位置,SDK 不支持在小程序的任意生命周期中进行初始化。

示例代码​uni-app(vue2)uni-app(vue3)// main.jsimport Vue from 'vue';import App from './App.vue';// 下载集成方式import gdp from './utils/gio/gio-uniapp.js';// npm集成方式import gdp from 'gio-miniprogram-sdk/uniapp';App.mpType = 'app';gdp('init', 'your GrowingIO accountId', 'your dataSourceId', 'your AppId', { version: 'your miniProgram version', // OP私有部署客户请填写serverUrl,Saas客户请忽略 serverUrl: 'your server url' uniVue: Vue, ...other settings});// 注意vue2中app实例在初始化之后const app = new Vue(App);app.$mount();// main.jsimport App from './App.vue';import { createApp } from 'vue';// 下载集成方式import gdp from './utils/gio/gio-uniapp.js';// npm集成方式import gdp from 'gio-miniprogram-sdk/uniapp';export function createApp() { // 注意vue3中app实例在初始化之前 const app = createApp(App); gdp('init', 'your GrowingIO accountId', 'your dataSourceId', 'your AppId', { version: 'your miniProgram version', // OP私有部署客户请填写serverUrl,Saas客户请忽略 serverUrl: 'your server url' uniVue: app, ...other settings }); return { app };}原有 require 的引用方式依然可以使用。const gdp = require('./utils/gio/gio-uniapp.js').default;1、加载 SDK​方式一:下载本地集成​下载SDK添加至项目目录中,下文中以utils/gio目录作为下载集成的示例目录(目录和 SDK 文件可自定义重命名)。

Taro 框架 SDK 下载:https://assets.giocdn.com/sdk/minip/4.4.2/gio-taro.js

(如果您点击链接在浏览器中直接打开了文件并不是下载文件,请尝试右键点击链接,选择 链接存储为... 即可正常触发下载)

方式二:npm 集成​npm i gio-miniprogram-sdk --save2、使用init方法进行初始化​参考示例代码在 app.js 小程序主文件中引用SDK并调用init方法进行初始化。

注意init方法所处位置(vue2 和 vue3 中分别与 app 实例的相对位置不同)。使用 vue 开发时taro和taroVue都要传。

注意不要随意修改初始化代码位置,SDK 不支持在小程序的任意生命周期中进行初始化。

示例代码​Taro2Taro3(react)Taro3(vue2)Taro3(vue3)// app.jsximport Taro, { Component } from '@tarojs/taro';// 下载集成方式import gdp from './utils/gio/gio-taro.js';// npm集成方式import gdp from 'gio-miniprogram-sdk/taro';gdp('init', 'your GrowingIO accountId', 'your dataSourceId', 'your AppId', { version: 'your miniProgram version', // OP私有部署客户请填写serverUrl,Saas客户请忽略 serverUrl: 'your server url' taro: Taro, ...other settings});class App extends Component { ... }Taro.render(, document.getElementById('app'));// app.jsimport React, { Component } from 'react';// 下载集成方式import gdp from './utils/gio/gio-taro.js';// npm集成方式import gdp from 'gio-miniprogram-sdk/taro';const taroRuntime = require('@tarojs/runtime');gdp('init', 'your GrowingIO accountId', 'your dataSourceId', 'your AppId', { version: 'your miniProgram version', // OP私有部署客户请填写serverUrl,Saas客户请忽略 serverUrl: 'your server url' taro: taroRuntime, ...other settings});class App extends Component { ... }export default App;// app.jsimport Vue from 'vue';import Taro from '@tarojs/taro';// 下载集成方式import gdp from './utils/gio/gio-taro.js';// npm集成方式import gdp from 'gio-miniprogram-sdk/taro';gdp('init', 'your GrowingIO accountId', 'your dataSourceId', 'your AppId', { version: 'your miniProgram version', // OP私有部署客户请填写serverUrl,Saas客户请忽略 serverUrl: 'your server url' // 注意taro和taroVue都需要传 taro: Taro, taroVue: Vue, ...other settings});// 注意vue2中App实例在初始化之后const App = { ... };export default App;// app.jsimport { createApp } from 'vue';import Taro from '@tarojs/taro';// 下载集成方式import gdp from './utils/gio/gio-taro.js';// npm集成方式import gdp from 'gio-miniprogram-sdk/taro';const taroRuntime = require('@tarojs/runtime');// 注意vue3中App实例在初始化之前const App = createApp({ ... });gdp('init', 'your GrowingIO accountId', 'your dataSourceId', 'your AppId', { version: 'your miniProgram version', // OP私有部署客户请填写serverUrl,Saas客户请忽略 serverUrl: 'your server url' // 注意taro和taroVue都需要传 taro: taroRuntime, taroVue: App, ...other settings});export default App;原有 require 的引用方式依然可以使用。const gdp = require('./utils/gio/gio-taro.js').default;

更多配置项请在集成配置菜单中查看

SDK功能插件扩展​

集成 SDK 时,SDK 仅内置埋点功能,如您需要扩展其他功能时,需要集成并注册对应插件方可激活对应功能使用。

各个插件的介绍和集成方式请见插件。

加载插件后会在初始化之前打印日志。例:

数据校验​

请在init初始化配置项中,将 debug 设置为 true 打开调试模式,然后在开发者工具中 Console 标签中即可实时查看 SDK 上报的 log 数据。如下图:

添加白名单​

由于抖音小程序对网络请求的限制参考文档,您需要在「抖音小程序开发者平台-开发管理-开发设置-服务器域名」中添加 request 合法域名。抖音小程序开发者平台

注意:请在正式生产环境发布前完成白名单的添加,未添加白名单可能会出现 SDK 无法上报数据的情况。

如何在2025年Google平台安全进行匿名评论(实操指南)
‎ZEPETO:虚拟角色、社交、娱乐