You need to enable JavaScript to run this app.
最新活动
产品
解决方案
定价
生态与合作
支持与服务
开发者
了解我们
导航

抖音生态数据

最近更新时间2023.05.24 16:50:01

首次发布时间2023.02.02 14:09:34

1. 概述

支持抖音生态数据接入,包括抖音账号下的用户数据、视频数据,为业务关联数据增加更多可分析维度。

注意:该功能从 V2.50.0 开始支持,目前是公测阶段,有需要使用请联系火山引擎工作人员开通。

2. 功能说明

2.1 数据连接步骤

(1)点击进入到某个具体项目下,点击数据准备,在下拉列表找到数据连接,点击新建数据连接。

(2)点击左侧「抖音生态」,选择「抖音短视频-用户数据」或者「抖音短视频-视频数据」

(3)此处选择 抖音短视频-用户数据,在弹出页面上点击授权

(4)使用 抖音APP 扫描二维码进行绑定与授权;

(5)在移动端操作授权,点击 同意 即可;

(6)完成授权后,产品的数据连接页面将展示已确认授权成功的提醒;

2.2 抖音生态下的ID类型

ID名称说明示例

Open ID

  • openid 是抖音用户在不同类型的产品的身份 ID。

  • 是抖音号、抖店、小程序等用户在当前应用的唯一标识。

1ad4e099-4a0c-47d1-a410-bffb4f******

Union ID

  • unionid 是抖音用户在同一个开放平台下的产品的身份ID。

  • 对外提供的 ID,暂未完成用户打通,即开发者拥有多个抖音号、抖店、抖音小程序时,同一个用户非同一个 UnionID

0da22181-d833-447f-995f-1beefe******

2.3 支持接入的用户数据

2.3.1 用户基础数据

字段数据类型展示名描述/枚举值示例
union_idstringunion_id用户在当前开发者账号下的唯一标识(未绑定开发者账号没有该字段)1ad4e099-4a0c-47d1-a410-bffb4f******
open_idstringopen_id0da22181-d833-447f-995f-1beefe******
avatarstring头像https://example.com/x.jpeg
avatar_largerstring大头像
countrystring国家中国
genderint64性别0:未知1:男性2:女性
nicknamestring昵称张伟
provincestring省份上海
citystring城市上海
districtstring

eaccount_role

string

账号类型

EAccountM:普通企业号
EAccountS:认证企业号
EAccountK:品牌企业号

2.3.2 用户统计数据

字段数据类型展示名示例
datestring日期yyyy-MM-dd
new_playint64每天新增视频播放200
total_issueint64每日内容总数200
new_issueint64每日发布内容数200
total_fansint64每日总粉丝数200
new_fansint64每天新粉丝数200
new_likeint64新增点赞200
new_commentint64新增评论200
new_shareint64新增分享200
profile_uvint64当日个人主页访问人数200

2.4 支持接入的视频数据

2.4.1 视频列表数据

字段数据类型展示名示例
item_idstring视频 id
statistics_digg_counti32点赞数200
statistics_download_counti32下载数10
statistics_play_counti32播放数,只有作者本人可见。公开视频设为私密后,播放数也会返回0。300
statistics_share_counti32分享数10
statistics_forward_counti32转发数10
statistics_comment_counti32评论数100
media_typeint媒体类型。2:图集;4:视频2
titlestring视频标题测试视频 #测试话题 @抖音小助手
coverstring视频封面https://p3-dy.byteimg.com/img/tos-cn-p-0015/cfa0d6421bdc4580876cb16974539ff6~c5_300x400.jpeg
is_topbool是否置顶FALSE
create_timei64视频创建时间戳1571075129
is_reviewedbool表示是否审核结束。审核通过或者失败都会返回 true,审核中返回 false。TRUE
video_statusi32表示视频状态。1:已发布; 2:不适宜公开; 4:审核中1
share_urlstring视频播放页面。视频播放页可能会失效,请在观看视频前调用/video/data/获取最新的播放页。

2.4.2 视频统计数据

字段数据类型展示名示例
datestring日期yyyy-MM-dd
item_idstring视频 id
total_sharei64最近 30 天分享数200
avg_play_durationdouble最近 30 天平均播放时长200
total_playi64最近 30 天播放次数200
total_likei64最近 30 天点赞数200
total_commenti64最近 30 天评论数200
likei64每日点赞数200
commenti64每日评论数200
playi64每日播放数200
sharei64每日分享数200