入门与指南专题介绍帐号管理营销资产广告管理数据洞察人群管理数据接入接口清单
授权认证 帐号管理 营销资产 广告管理 数据洞察 辅助工具 用户行为数据 用户人群数据 用户标签数据 用户属性数据
附录

用户行为数据源 (User Action Set)

V1.1

loading


本节将为您介绍用户行为数据源 (User Action Set) 相关接口。


创建用户行为数据源

user_action_sets/add

POST

*为必填项
名称 类型 描述
account_id*
integer 推广帐号 id,有操作权限的帐号 id,包括代理商和广告主帐号 id
type*
enum 用户行为源类型,[枚举详情]
枚举列表:{ WEB, ANDROID, IOS, OFFLINE }
mobile_app_id
integer 应用 id,IOS:App Store id ; ANDROID:应用宝 id,type=ANDROID 或 IOS 时必填
name
string 用户行为源名称,当 type=WEB 时必填,当 type=ANDROID 或 IOS 时,若未填写该字段,则默认通过 mobile_app_id 获取名称
字段长度最小 1 字节,长度最大 32 字节
description
string 用户行为源描述
字段长度最小 1 字节,长度最大 128 字节

curl 'https://api.e.qq.com/v1.1/user_action_sets/add?access_token=<ACCESS_TOKEN>&timestamp=<TIMESTAMP>&nonce=<NONCE>' \
-H 'Content-Type: application/json' \
-d '{
    "account_id": "<ACCOUNT_ID>",
    "type": "WEB",
    "name": "webuser_action_set",
    "description": ""
}'
					
名称 类型 描述
user_action_set_id
integer 用户行为源 id,通过 [user_action_sets 接口] 创建用户行为源时分配的唯一 id
{
    "code": 0,
    "message": "",
    "message_ch": "",
    "data": {
        "user_action_set_id": "<USER_ACTION_SET_ID>"
    }
}


获取用户行为数据源

user_action_sets/get

GET

*为必填项
名称 类型 描述
account_id*
integer 推广帐号 id,有操作权限的帐号 id,包括代理商和广告主帐号 id
user_action_set_id
integer 用户行为源 id,通过 [user_action_sets 接口] 创建用户行为源时分配的唯一 id

curl -G 'https://api.e.qq.com/v1.1/user_action_sets/get?access_token=<ACCESS_TOKEN>&timestamp=<TIMESTAMP>&nonce=<NONCE>' \
-d 'account_id=<ACCOUNT_ID>' \
-d 'user_action_set_id=<USER_ACTION_SET_ID>' 
					
名称 类型 描述
list
struct[] 返回数组列表
user_action_set_id
integer 用户行为源 id,通过 [user_action_sets 接口] 创建用户行为源时分配的唯一 id
type
enum 用户行为源类型,[枚举详情]
mobile_app_id
integer 应用 id,IOS:App Store id ; ANDROID:应用宝 id,type=ANDROID 或 IOS 时必填
name
string 用户行为源名称,当 type=WEB 时必填,当 type=ANDROID 或 IOS 时,若未填写该字段,则默认通过 mobile_app_id 获取名称
description
string 用户行为源描述
activate_status
boolean 数据接入状态,true 表示已接入,false 表示未接入
created_time
string 创建时间,格式为 yyyy-MM-dd HH:mm:ss,如 2016-11-01 10:42:56
{
    "code": 0,
    "message": "",
    "message_ch": "",
    "data": {
        "list": [
            {
                "type": "WEB",
                "name": "webuser_action_set",
                "description": "",
                "user_action_set_id": "<USER_ACTION_SET_ID>",
                "activate_status": true,
                "created_time": "2017-02-20 16:04:27"
            }
        ]
    }
}


获取用户行为数据源报表

user_action_set_reports/get

GET

*为必填项
名称 类型 描述
account_id*
integer 推广帐号 id,有操作权限的帐号 id,包括代理商和广告主帐号 id
user_action_set_id*
integer 用户行为源 id,通过 [user_action_sets 接口] 创建用户行为源时分配的唯一 id
date_range*
struct 时间范围,日期格式,{"start_date":"2017-03-01","end_date":"2017-04-02"}
start_date*
string 开始时间点对应的时间戳,小于或等于 end_date
字段长度为 10 字节
end_date*
string 结束时间点对应的时间戳,小于或等于今天,且大于或等于 start_date
字段长度为 10 字节
time_granularity*
enum 时间粒度,针对流量的粒度,可选值:DAILY(按天汇总), HOURLY(按小时汇总),默认小时,[枚举详情]
枚举列表:{ DAILY, HOURLY }
aggregation
enum 聚合维度,是否将结果按照指定类型细分,可选值'DOMAIN', 'ACTION_TYPE',[枚举详情]
枚举列表:{ DOMAIN, ACTION_TYPE }

curl -G 'https://api.e.qq.com/v1.1/user_action_set_reports/get?access_token=<ACCESS_TOKEN>&timestamp=<TIMESTAMP>&nonce=<NONCE>' \
-d 'account_id=<ACCOUNT_ID>' \
-d 'user_action_set_id=<USER_ACTION_SET_ID>' \
-d 'date_range={"start_date":"YYYY-MM-DD","end_date":"YYYY-MM-DD"}' \
-d 'time_granularity=HOURLY' \
-d 'aggregation=DOMAIN' 
					
名称 类型 描述
list
struct[] 返回数组列表
date
string 采样日期,格式:yyyy-MM-dd
hour
integer 小时,当 time_granularity=HOURLY 时有值,返回格式 HH
domain
string 行为发生的域名,当 aggregation=DOMAIN 时有值
action_type
enum 标准行为类型,当 aggregation=ACTION_TYPE 时有值,[枚举详情]
custom_action
string 自定义行为类型,当 aggregation=ACTION_TYPE 时有值
raw_action_count
integer 原始上报行为数
identified_action_count
integer 可识别的行为数
identified_user_count
integer 可识别的独立用户数,当没有指定 aggregation 时,有值
{
    "code": 0,
    "message": "",
    "message_ch": "",
    "data": {
        "list": [
            {
                "date": "2017-04-25",
                "hour": "11",
                "domain": "https://example.com",
                "raw_action_count": 4000,
                "identified_action_count": 2100,
                "identified_user_count": 1400
            }
        ]
    }
}