腾讯广告

用户行为人群

对于移动应用行为人群，您可以通过行为方式中的基础模式提取用户行为人群，您可以圈定最近某个时间窗内在某移动应用发生过某行为并且参数符合一定条件的人群，即选择您要圈定的用户行为源、行为和参数，支持多个参数取交，例如圈定最近30天内在某移动应用发生了购买行为，并且商品价格>200 ，商品类型是女装的人群；您也可以通过行为方式中的聚合模式提取用户行为人群，您可以指定行为发生的频次（例如：购买达5次）或按照参数的累计值、最大值、最小值细化提取条件（如：累计付费超过500元）。

对于网站行为人群，您可以通过按照URL或者行为的方式提取用户行为人群。选择URL方式时，可以提取访问了网站的人群或者是提取访问了特定网页的人群；选择行为方式时，接口的调用方式与移动应用行为人群提取相同。

接下来，将分别介绍两种人群提取方式：

• 行为方式提取人群
• URL方式提取人群

行为方式提取人群

行为方式提取人群对应的请求示例如下：

curl 'https://api.e.qq.com/v1.1/custom_audiences/add?access_token=<ACCESS_TOKEN>&timestamp=<TIMESTAMP>&nonce=<NONCE>' \
    -H "Content-Type: application/json" \
    -d '{
        "account_id": 25610, 
        "name": "jilin-action0519-ios", 
        "type": "USER_ACTION", 
        "audience_spec": {
            "user_action_spec": {
                "user_action_set_id": 1106173386, 
                "match_rule_type": "ACTION", 
                "action_match_rule": {
                    "action_type": "INITIATE_CHECKOUT", 
                    "param_matcher_group": [
                        {
                            "param_matcher": [
                                {
                                    "param_name": "produce_name", 
                                    "param_value": "shoe", 
                                    "operator": "EQ"
                                }, 
                                {
                                    "param_name": "brand", 
                                    "param_value": "KISSCAT", 
                                    "operator": "EQ"
                                }
                            ]
                        }
                    ]
                }, 
                "time_window": 150
            }
        }
    }'

应答示例：

{
    "code": 0,
    "message": "ok",
    "data": {
        "audience_id": 2837392
    }
}

URL方式提取人群

URL方式提取人群对应的请求示例如下：

curl 'https://api.e.qq.com/v1.1/custom_audiences/add?access_token=<ACCESS_TOKEN>&timestamp=<TIMESTAMP>&nonce=<NONCE>' \
    -H "Content-Type: application/json" \
    -d '{
        "account_id": 25610,
        "name": "jilin-web-someurl0519",
        "type" : "USER_ACTION",
        "audience_spec" : {
            "user_action_spec": {
                "user_action_set_id" : 1105929547,
                "match_rule_type" : "URL",
                "url_match_rule" : {
                    "url_matcher_group":[
                        {
                            "url_matcher":[
                                {"param_value":"taobao","operator":"CONTAIN"},
                                {"param_value":"360","operator":"NOT_CONTAIN"}
                            ]
                        }
                    ]
                },
                "time_window": 180
            }       
        }
    }'

应答示例：

{
    "code": 0,
    "message": "ok",
    "data": {
        "audience_id": 2837392
    }
}

收到接口返回的用户行为人群id后，您就可以将它用于广告定向中了，关于如何使用人群定向，详见【广告-定向】页面介绍。

有关用户行为人群读写接口的更详细说明，可以参考 接口清单-Audience。