抖音开放平台Logo
开发者文档
控制台
  • API 概览
  • 开放能力
  • 登录
  • 社交转发裂变
  • 用户信息及授权
  • 小游戏收藏
  • 群聊
  • 关注
  • 游戏互推组件
  • 添加到桌面
  • 游戏排行榜
  • 数据分析
  • tt.reportAnalytics
  • tt.reportScene
  • 视频拍摄器
  • 订阅消息
  • 关系链
  • 客服能力
  • 侧边栏能力
  • 推荐流直出游戏能力
  • 基础
  • 渲染
  • 设备
  • 文件
  • 位置
  • 媒体
  • 网络
  • 游戏转发分享
  • 实时语音
  • 数据缓存
  • 系统
  • 广告
  • 界面
  • 支付
  • Worker
  • tt.reportAnalytics
    收藏
    我的收藏

    基础库 1.8.0 开始支持本方法,这是一个同步方法。

    自定义分析数据上报接口,调用后,会将数据上报到抖音开放平台,开发者可以进入抖音开放平台「数据」-「自定义分析」-「事件分析/漏斗分析」模块查看上报数据。

    前提条件

    使用前,需要前往抖音开放平台「数据 - 自定义分析 - 事件管理」中新建事件,配置好事件名与字段。

    业务背景
    使用限制
    注意事项

    使用埋点验证 能力对已有埋点进行上报时,需要使用上传到开发者平台的测试版本、审核版本、线上版本。目前 IDE 预览版本不支持埋点验证。

    相关教程

    语法

    tt.reportAnalytics(event, data)

    参数说明

    event

    类型默认值必填说明最低支持版本
    string
    事件名,注意不能超过 110 字符
    1.8.0

    data

    类型默认值必填说明最低支持版本
    object
    上报的数据
    1.8.0

    data 参数说明

    data 中传入自定义属性,属性名为配置的字段名,属性值为上报的数据

    属性

    类型

    必填

    说明

    最低支持版本

    key

    string

    配置中的字段名

    1.8.0

    value

    number | string | boolean

    上报的数据

    1.8.0

    返回值

    错误码

    errorCodeerrMsgerrorType说明最低支持版本
    999999param $paramName is exceed maximum length limit $maximumLengthD
    1.8.0
    999993internal errorF
    小游戏框架内部错误,有需要请创建工单咨询
    1.8.0
    999999eventName exceeded the maximum length: 110.D
    参数错误
    1.8.0
    999999invalid paramD
    参数错误
    1.8.0
    103902data exceeded the maximum number of fields: 256.D
    参数错误
    1.8.0
    103903${key} exceeded the maximum number of bytes: 128.D
    参数错误
    1.8.0
    999999invalid type paramD
    1.8.0
    103904the value of data[${key}] exceeded the maximum number of bytes: 1024.D
    1.8.0
    103905the key first char can not be _.D
    1.8.0
    103901the key can not be mp_name or mp_id.D
    1.8.0

    扫码体验

    请使用字节宿主APP扫码

    代码示例

    开发者工具中预览

    tt.reportAnalytics("clickBanner", { time: 1547533711355, uid: 123456, });