跳到主要内容

数据源用户行为报表获取


请求地址​

https://api.e.qq.com/v3.0/user_action_set_reports/get


请求方法​

GET


所属权限​

数据上报（User Actions）


请求参数​

参数名描述
access_token密钥信息，可在 DataNexus 的 数据源 - 【查看密钥】获取
timestamp当前的时间戳，单位为秒，允许客户端请求最大时间误差为 300 秒。MarketingAPI 所使用的时间戳，若无特殊说明，均为秒级时间戳签名算法。MarketingAPI 所使用的时区为 GMT+8，例如当时间戳为 1494840119 时，表示 2017-05-15 17:21:59
nonce随机字串标识，不超过 32 个字符，由调用方自行生成，需保证全局唯一性
fieldsget 接口增加 fields 字段，用于指定返回参数的字段列表，为选填字段。fields 取值范围为 get 接口返回的 list 中的字段。如不填写，则返回 date

请求体类型​

application/json


请求体参数​

阅读说明：Y - 必填；C - 条件选填（conditional），请关注“描述”信息；空 - 非必填

名称类型描述
account_idinteger
推广帐号 id或 DataNexus 账号 id
user_action_set_idinteger
用户行为源 id，通过 user_action_sets 接口 创建用户行为源时分配的唯一 id。请注意，当填写的用户行为数据源类型为 {WECHAT, WECHAT_MINI_PROGRAM, WECHAT_MINI_GAME} 时，必填 user_id 字段中的 wechat_openid (或 wechat_unionid) 及 wechat_app_id。
date_rangeobject
时间范围，日期格式
start_datestring
开始时间点对应的时间戳，如：2022-01-27，小于或等于 end_date，字段长度为 10 字节
end_datestring
结束时间点对应的时间戳，如：2023-01-27，小于或等于今天，且大于或等于 start_date，字段长度为 10 字节
time_granularityenum
时间粒度，针对流量的粒度，可选值：DAILY（按天汇总）, HOURLY（按小时汇总），默认小时
aggregationenum
聚合维度，是否将结果按照指定类型细分，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=1111111111' \
-d 'date_range={"start_date":"YYYY-MM-DD","end_date":"YYYY-MM-DD"}' \
-d 'time_granularity=HOURLY' \
-d 'aggregation=DOMAIN'

应答体结构​

名称类型描述
listarray
返回数组列表
datestring
采样日期，格式：yyyy-MM-dd
hourinteger
小时，当 time_granularity=HOURLY 时有值，返回格式 HH
domainstring
行为发生的域名，当 aggregation=DOMAIN 时有值
action_typeenum
标准行为类型，当 aggregation=ACTION_TYPE 时有值，见 枚举值
custom_actionstring
自定义行为类型，当 aggregation=ACTION_TYPE 时有值
raw_action_countinteger
原始上报行为数
identified_action_countinteger
可识别的行为数
identified_user_countinteger
可识别的独立用户数，当没有指定 aggregation 时，有值

应答示例​

{
    "code": 0,
    "message": "",
    "message_cn": "",
    "data": {
        "list": [
            {
                "date": "2017-04-25",
                "hour": "11",
                "domain": "https://example.com",
                "raw_action_count": 4000,
                "identified_action_count": 2100,
                "identified_user_count": 1400
            }
        ]
    }
}



该内容是否有帮助？