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

地理位置人群

如果您对广告投放目标人群的出行规律十分了解,我们为您提供以下三种地理位置圈选人群的方式。

注意:对特定地点人群和跨城市人群有需求的客户可线下联系您的运营接口人申请开通。自定义坐标打点人群需要单独申请权限,仅开放给部分特定用户使用。

1、特定地点人群:可以圈选出在指定时间段内,出现在特定地点的人群,并且可以规定人群的出现频次,例如“2019.7.1至2019.7.15去过上海飞机场3次及以上的人”。

2、跨城市人群:可以圈选出在一段时间内,发生两地之间位置变化的人群,方便找出多地的差旅人群和旅游人群。比如“2019.8.1至2019.8.5,从上海到北京的人”。

特定地点和跨城市人群的限制:①地理位置-特定地点功能,单次任务最多可输入10个POI点;②地理位置-特定地点功能,单次任务最多可输入50个regionID;③地理位置-跨城市人群功能,单次任务最多可输入10条route;④地理位置人群,date_range仅支持选择最近一年的日期;⑤此功能需要联系运营,进行白名单申请,通过后方有使用权限;⑥特定地点POI对照表和regionID对照表由运营线下给出。

3、自定义坐标打点人群:支持用户精细化创建特定地点人群,用户可以选择目标地点0.1km-5km半径范围一段时间内,到访特定频次的人生成人群用于定向。例如“2019.10.1至2019.10.7,到访西单大悦城为圆心2公里半径内3次的人”。目前打点只支持中国大陆范围内地点。

自定义坐标打点人群的限制:①地点输入只支持经纬度,不支持指定区域;②生成地理位置的条件不超过20个,多个地理条件之间取并集;③经纬度坐标数据的时间范围为最近一年,可选的最大时间宽度为60天;④到访频次为到访所有地点的频次,例如A点和B点为某品牌线下门店的位置,若到访A点一次,到访B点二次,则到访频次为三次;⑤单次圈选半径上限为5km,下限为0.1km,最小单位为0.1km;⑥人群数量上限为2000W,超出创建失败。

接下来,将为您介绍三种地理位置人群的接口调用方式。

1、特定地点人群

请求示例:

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": 20459,
        "name": "LBS-POI人群",
        "type": "LBS",
        "audience_spec": {
            "lbs_spec": {
                "lbs_type": "POI",
                "poi_rule": {
                    "poi_category_id": [
                        271020
                    ],
                    "region_id": [
                        310000
                    ],
                    "date_range":  {
                    "start_date" : "2017-08-01",
                    "end_date" : "2017-08-05"
                    },
                    "day_of_week": [
                        "MONDAY",
                        "TUESDAY",
                        "WEDNESDAY",
                        "THURSDAY",
                        "SUNDAY"
                    ],
                    "frequency": 2
                }
            }
        }
    }'

返回示例:

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

2、跨城市人群

请求示例:

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, 
        "type": "LBS", 
        "name": "cross-city人群", 
        "audience_spec": {
            "lbs_spec": {
                "lbs_type": "CROSS_CITY", 
                "cross_city_rule": {
                    "route": ["31000~31001"], 
                    "date_range":  {
                        "start_date":"2017-08-01",
                        "end_date":"2017-08-06"
                    },
                    "frequency": 2
                }
            }
        }
    }'

返回示例:

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

3、自定义坐标打点人群

请求示例:

curl 'https://api.e.qq.com/v1.1/custom_audiences/add?access_token=&timestamp=&nonce=' \
        -H 'Content-Type: application/json' \
        -d '{
        "account_id": 25610,
        "type": "LBS",
        "name": "custom location 人群",
        "audience_spec": {
            "lbs_spec": {
                "lbs_type": "CUSTOM_LOCATION",
                "custom_location_rule": {
                    "poi_type": "ALL",
                    "date_range": {
                        "start_date": "2019-10-01",
                        "end_date": "2019-10-07"
                    },
                    "frequency_spec": {
                        "frequency_min_value": 2,
                        "frequency_max_value": 20
                    },
                    "area_list": [
                        {
                            "area_type": "CIRCLE",
                            "circle_area": {
                                "longitude": 113.316,
                                "latitude": 23.106,
                                "radius": 150
                            }
                        }
                    ]
                }
            }
        }
    }'

返回示例:

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

收到接口返回的地理位置人群id后,您就可以将它用于广告定向了。关于如何使用人群定向,详见【广告-定向】页面介绍。

关于地理位置人群读写接口的更详细说明,可以参考 接口清单-Audience