更新记录

1.0.0（2026-06-09）

首次提交

平台兼容性

uni-app(4.81)

Vue2 Vue3 Chrome Safari app-vue app-nvue Android Android插件版本 iOS iOS插件版本 鸿蒙
- - - - - - 5.0 1.0.0 12 1.0.0 ×
微信小程序 支付宝小程序 抖音小程序 百度小程序 快手小程序 京东小程序 鸿蒙元服务 QQ小程序 飞书小程序 小红书小程序 快应用-华为 快应用-联盟
- - - - - - - - - - - -

uni-app x(4.82)

Chrome Safari Android iOS 鸿蒙 微信小程序
- - - - × -

hl-gdt-action-sdk

腾讯广告广点通 APP 转化行为数据上报 SDK 的 UniApp UTS 封装，支持 Android 和 iOS。

基础用法

import * as GdtAction from '@/uni_modules/hl-gdt-action-sdk'

// 如需隐私控制，建议在 initSDK 之前调用。
GdtAction.setPrivateController({
  canUsePhoneState: true,
  devImei: ''
})

// 建议在 App.vue onLaunch 中调用，必须早于其他上报接口。
GdtAction.initSDK({
  userActionSetId: '你的行为数据源 ID',
  appSecretKey: '你的 App Secret Key',
  autoStart: true,
  channelType: '',
  channelId: ''
})

// 初始化后尽快调用 start。
GdtAction.start()
// 建议在 App.vue onShow 中上报启动行为。
GdtAction.reportAppStart()

API

方法 说明
initSDK(options) 初始化 SDK，传入 userActionSetId、appSecretKey，可选 autoStart、channelType、channelId
setPrivateController(options) 设置隐私控制，控制是否允许 SDK 使用 phone state / IMEI
start() 调用官方 GDTAction.start()
reportAppStart() 上报 ActionType.START_APP
reportOpenURL(openUrl) 上报 URL 唤起启动行为，iOS 对齐 AppDelegate openURL 场景
logAction(actionType) 上报标准或自定义行为
logActionWithParams(actionType, params) 上报带参数行为
getClickID() 获取 clickID
getChannelID() 获取 channelID
getCaid() 获取 iOS CAID 信息；Android 返回空对象
setAutoStartEnable(enabled) 设置自动启动上报开关
getAutoStartEnable() 读取自动启动上报开关
setAnidEnable(enabled) 设置 anid 采集开关
setUserUniqueId(userUniqueId) 设置用户唯一 ID
requestTrackingAuthorization() iOS 14+ ATT 授权请求示例；Android 返回 no-op 成功
onRegister(method, success) 注册转化上报
onLogin(method, success) 登录转化上报
onBindAccount(method, success) 绑定账号转化上报
onQuestFinish(options) 任务完成转化上报
onCreateRole(role) 创建角色转化上报
onUpdateLevel(level) 更新等级转化上报
onShare(shareChannel, success) 分享转化上报
onRateApp(rateValue) 评分转化上报
onViewContent(options) 查看内容转化上报
onAddToCart(options) 加入购物车转化上报
onCheckout(options) 发起结账转化上报
onPurchase(options) 购买转化上报
onAddPaymentChannel(paymentChannel, success) 添加支付渠道转化上报

标准行为值

可直接传官方标准行为字符串，例如：

  • START_APP
  • PAGE_VIEW
  • REGISTER
  • VIEW_CONTENT
  • CONSULT
  • ADD_TO_CART
  • PURCHASE
  • SEARCH
  • ADD_TO_WISHLIST
  • INITIATE_CHECKOUT
  • COMPLETE_ORDER
  • DOWNLOAD_APP
  • RATE
  • RESERVATION
  • SHARE
  • APPLY
  • CLAIM_OFFER
  • NAVIGATE
  • PRODUCT_RECOMMEND

Demo

  • 初始化、隐私控制、start
  • START_APP 上报
  • 标准行为、自定义行为、带参数行为
  • clickID / channelID 读取
  • iOS CAID / ATT / openURL 启动上报
  • 自动启动、ANID、用户唯一 ID 设置
  • Android ActionUtils / iOS convenience 场景方法

注意

GDTAction.init(...) 按官方说明只需调用一次，且第一次调用后再次调用不会重新初始化。请不要在未取得用户隐私授权前调用初始化或上报方法。

隐私、权限声明

1. 本插件需要申请的系统权限列表：

Android: INTERNET、ACCESS_NETWORK_STATE、READ_PHONE_STATE；iOS: IDFA/CAID 归因相关权限说明

2. 本插件采集的数据、发送的服务器地址、以及数据用途说明：

按腾讯广告 SDK 规则上报转化行为、设备标识和渠道点击信息

3. 本插件是否包含广告，如包含需详细说明广告表达方式、展示频率：

腾讯广告广点通转化行为数据上报 SDK

评论列表 撰写评论 向官方投诉

暂无用户评论。