接口文档SDK业务专题开发者工具

网站行为数据接入

本节将为您介绍如何接入您的网站行为数据,网站行为数据接入分为JS和Marketing API两种方式。

通过Marketing API接入网站行为数据可以分为三步:


1、新建网站用户行为数据源

在为您进行网站数据接入之前,您需要新建网站用户行为数据源。您可以在DMP系统(http://de.qq.com)的“数据接入”模块里创建网站用户行为数据源或者调用接口 创建用户行为数据源 进行创建。对网站行为数据,用户行为数据源的类型需要选择WEB。同一个WEB页面只需创建一次行为数据源,如果其他自有广告账号需要使用数据源用于提取行为人群或配置转化跟踪,可以开通商务管家,认领自有的广告账号,在DMP授权给自己的其他广告账号使用已对接上报的数据源。

如果您已经创建了用户行为数据源,您可以使用接口获取用户行为数据源,获取行为数据源的信息及数据接入的情况

2、上报行为数据

创建好用户行为数据源后,您可以通过用户行为数据上报 接口上报网站行为数据。

参数说明

    • 页面url(url):行为发生的页面url。
    • 用户标识(user_id)
      • gdt_openid: GDT Cookie Mapping分配的openid,不做处理
      • hash_imei: 对IMEI设备号转成小写,再进行md5编码
      • hash_idfa: IDFA 设备号保持大写,进行 md5 编码
      • hash_phone:电话号码直接 MD5 编码,如 md5(13500000000)
    • 行为类型 – 标准行为和自定义行为 (action_type, custom_action)
      • 标准行为: 标准行为是各数据应用方通用的常见行为,默认用于转化报表。标准行为填写在action_type字段中。标准行为列表详见 标准行为
      • 自定义行为: 您也可以自定义任意自己需要的行为。设置action_type = CUSTOM, 并在custom_action中填写您自定义的行为名称。例子:上报一个‘complete_tutorial’的自定义行为,设置action_type=CUSTOM, custom_action=‘complete_tutorial’
    • 行为时间(action_time):实际行为发生的时间,如果不填写,系统将自动填充为收到数据的时间。标准UNIX时间戳,精确到秒。
    • 行为参数(action_param):您可以为行为带上更多的信息。例如您上报了一个VIEW_CONTENT(浏览)行为,您还希望能附上浏览的类目、价格等信息,您可以将这些信息附加在行为参数(action_param字段)中。行为参数可以用来作为条件用于提取人群。尤其如果您希望对接动态创意,您需要在action_param中附上动态创意需要的字段。具体动态创意的行为数据接入请参见动态创意行为数据接入

请求示例:

curl 'https://api.e.qq.com/v1.1/user_actions/add?access_token=<ACCESS_TOKEN>&timestamp=<TIMESTAMP>&nonce=<NONCE>' \
-d 'account_id=123456' \
-d 'user_action_set_id=<USER_ACTION_SET_ID>'\
-d 'actions=[
    {
        "url": "<URL>",
        "action_time": 1487923255,
        "user_id": {
            "gdt_openid": "<GDT_OPENID>"
        },
        "action_type": "VIEW_CONTENT",
        "action_param": {
            "param": "value",
            "product_id": [
                13453,
                6583
            ]
        }
    }
]'

3、查看数据接入监测报表

上报数据后,您可以登录DMP系统(de.qq.com),在移动应用数据接入模块下查看您移动应用数据的接入情况。在DMP系统上,您可以看到您接入的pv,映射上的pv, 映射上的uv等信息。

除了上述方法外,您也可以通过接口获取用户行为数据源报表来查看到数据上报的情况。以下将为您展示获取用户行为数据源报表接口的调用示例。

curl -G 'https://api.e.qq.com/v1.0/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": "2017-04-24",
    "end_date": "2017-05-01"
}' \
-d 'time_granularity=HOURLY' \
-d 'aggregation=DOMAIN' 

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