天幕字节版文档
返回天幕联系我们天幕微信版文档天幕QQ版文档
  • 3分钟了解天幕字节跳动版
  • 买量助手
    • 主要功能与操作说明
      • 数据菜单
      • 渠道管理与机制
      • 渠道商与开放数据
      • 自动计算成本
    • 渠道类型说明
    • 数据指标说明
    • 技术接入指南
  • 游戏数据
    • 主要功能说明
    • 技术接入指南
  • 游戏配置
    • A/Btest
    • 自定义事件
    • 版本控制
    • 分享素材配置
    • 在线参数
    • 技术接入指南
  • 游戏收支
    • 字节收入管理操作说明
    • 买量成本管理操作说明
    • 内购退款管理操作说明
  • 通用功能
    • 成员权限
    • 自定义视图
    • 游戏管理
    • 有效新增用户
    • 获取accessToken
  • 技术接入指南
    • 必须或基础功能
      • SDK接入(重要)
      • SDK初始化(重要)
      • 登录/获取用户信息(重要)
        • .login
        • .updateUserInfo
    • 游戏数据类功能
      • 内购分析
      • 字节banner分析(.createBannerAd)
      • 字节激励视频分析(.createRewardedVideoAd)
      • 性能分析 (.sendLoadingLog)
    • 游戏配置类功能
      • 分享素材配置
        • .onShareAppMessage
        • .shareAppMessage
        • .getShareTemplates
      • 版本控制 (.getJudgeConfig)
      • 在线参数 (.getAppJSONConfig)
      • 自定义事件(.sendEvent)
      • A/B test(.abtest)
  • 常见问题
    • 热门问题
    • SDK兼容问题
  • 服务与隐私条款
    • 服务条款
    • 隐私政策
  • 联系我们
由 GitBook 提供支持
在本页
  • 一、概述
  • 二、调用方法
  • 三、返回值说明
  • 返回值示例

这有帮助吗?

  1. 技术接入指南
  2. 必须或基础功能
  3. 登录/获取用户信息(重要)

.updateUserInfo

上一页.login下一页游戏数据类功能

最后更新于4年前

这有帮助吗?

一、概述

用于从字节跳动获取用户的昵称头像信息。

  • 获取到的用户信息,SDK会自动上传到天幕服务器,通过获取。

  • 关于用户信息的更新策略,开发者可。

  • 接入此接口时,注意。

二、调用方法

tt.tmSDK.updateUserInfo().then(res=>{ console.log(res) });

三、返回值说明

返回值示例

{
    "pid": "",
    "app_id": "tta73fd8e544880e89",
    "open_id": "qPKIsWizTRH91gwh",
    "union_id": "7L942AwAqIiBababh",
    "nick_name": "",
    "avatar_url": "",
    "gender": 0,
    "city": "广州",
    "province": "广东省",
    "country": "中国",
    "language": "zh_CN",
    "gold": 0,
    "diamond": 0,
    "share_new": 0,
    "share_times": 0,
    "online_days": 0,
    "online_duration": 0,
    "last_login_time": 1551690740,
    "login_times": 1,
    "from_scene": "011001",
    "from_code": "ball-resurrection-1",
    "is_new": false,
    "ofp": "",
    "jwt": "",
    "login_province": "广东省",
    "login_city": "广州市",
    "login_district": "海珠区"
}

字段

字段类型

字段说明

pid

string

用户在天幕的统一索引,但可能变化,已废弃

app_id

string

应用的appid

open_id

string

用户在该应用下的anonymous_openid,天幕使用anonymous_openid作为数据统计依据与用户标识

union_id

string

用户的openid,默认为空字符串,在用户登录以后方可获取。若同一个设备(即同一个anonymous_openid)上登录过多个账号,则展示最近一个登录账号的用户openid

nick_name

string

avatar_url

string

gender

number

男:1 / 女:0

language

string

用户设置的语言。若同一个设备(即同一个anonymous_openid)上登录过多个账号,则展示最近一个登录且授权账号的用户语言。

city

string

用户设置的城市。若同一个设备(即同一个anonymous_openid)上登录过多个账号,则展示最近一个登录且授权账号的用户城市。

province

string

用户设置的省份。若同一个设备(即同一个anonymous_openid)上登录过多个账号,则展示最近一个登录且授权账号的用户省份。

country

string

用户设置的国家。若同一个设备(即同一个anonymous_openid)上登录过多个账号,则展示最近一个登录且授权账号的用户国家。

gold、diamond

string

游戏内金币、钻石,已废弃

share_new

number

用户在当前游戏的分享引入新用户的数量

share_times

number

用户在当前游戏的分享次数

online_days

number

用户在当前游戏在线的天数

online_duration

number

累计在线时长(单位:秒)

last_login_time

number

最近一次访问的时间戳

login_times

number

用户在当前游戏的累计登录访问次数

from_scene

string

来源场景值

from_code

string

is_new

bool

是否新注册的用户

login_province

string

login_city

string

根据用户ip判断用户所在的城市

login_district

string

根据用户ip判断用户所在的区县

​

用户的昵称,为空时需要调用 获取。若同一个设备(即同一个anonymous_openid)上登录过多个账号,则展示最近一个登录且授权账号的用户的昵称

用户的头像,为空时需要调用 获取。若同一个设备(即同一个anonymous_openid)上登录过多个账号,则展示最近一个登录且授权账号的用户的头像

来源

根据用户ip判断用户所在的省份(注意:返回的省份名称与的名称一致,如西藏,返回的是西藏自治区。若要实现地区屏蔽功能,建议根据返回值前两位进行地区匹配)

.login
点击此处
兼容性问题
updateUserinfo
updateUserinfo
渠道ID​
行政划分