人群洞察分析

开发环境

GET

/v1.3/custom_audience_insights/get

使用说明

目前仅支持 LBS_CROSS_CITY、LBS_CUSTOM_LOCATION、LBS_POI、KEYWORDD、AD、APP_ACTION_DATA_COMBINE、APP_ACTION_DATA、UNION_ACTION_DATA、WEBSITE_ACTION_DATA、WEBSITE_ACTION_DATA_COMBINE、PACKAGE、CUSTOM_AUDIENCE_COMBINE、CUSTOM_AUDIENCE_SAVED、TAG、LABEL、LOOKALIKE 类型的人群;人群数必须大于 1000 ；人群必须是 SUCCESS 状态。

请求示例

Shell

JavaScript

Java

Swift

curl --location --request GET '/v1.3/custom_audience_insights/get' \
--header 'access_token;' \
--header 'timestamp;' \
--header 'nonce;' \
--data-urlencode 'account_id=<ACCOUNT_ID>' \
--data-urlencode 'audience_id=<AUDIENCE_ID>' \
--data-urlencode 'dimension_type=["AGE"]'

响应示例

{
    "code": 0,
    "message": "",
    "message_cn": "",
    "data": {
        "list": [
            {
                "dimension_type": "AGE",
                "match_rate": 0.9899999999999999911182158029987476766109466552734375,
                "distribution": [
                    {
                        "dimension_value": "1~17",
                        "percentage": 5,
                        "tgi": 0.299999999999999988897769753748434595763683319091796875
                    },
                    {
                        "dimension_value": "18~23",
                        "percentage": 15,
                        "tgi": 0.95999999999999996447286321199499070644378662109375
                    },
                    {
                        "dimension_value": "24~30",
                        "percentage": 27,
                        "tgi": 0.7199999999999999733546474089962430298328399658203125
                    },
                    {
                        "dimension_value": "31~40",
                        "percentage": 26,
                        "tgi": 1.5300000000000000266453525910037569701671600341796875
                    },
                    {
                        "dimension_value": "41~50",
                        "percentage": 17,
                        "tgi": 1.87000000000000010658141036401502788066864013671875
                    },
                    {
                        "dimension_value": "51~65",
                        "percentage": 9,
                        "tgi": 2.160000000000000142108547152020037174224853515625
                    },
                    {
                        "dimension_value": "66~127",
                        "percentage": 0,
                        "tgi": 2.850000000000000088817841970012523233890533447265625
                    }
                ]
            }
        ]
    }
}

请求参数

Header 参数

access_token

string

必需

以Query Parameter方式在请求路径中传递。授权令牌，完成 OAuth 2.0 授权后获得，参考授权认证章节。

默认值:

<ACCESS_TOKEN>

timestamp

string

必需

以Query Parameter方式在请求路径中传递。当前的时间戳，单位为秒，允许客户端请求最大时间误差为300秒。
MarketingAPI 所使用的时间戳，若无特殊说明，均为秒级时间戳
MarketingAPI 所使用的时区为GMT+8，例如当时间戳为1494840119时，表示 2018-05-15 17:21:59

默认值:

nonce

string

必需

以Query Parameter方式在请求路径中传递。随机字串标识，不超过32个字符，由调用方自行生成，需保证全局唯一性。

默认值:

<NONCE>

Body 参数application/x-www-form-urlencoded

account_id

integer

必需

推广帐号 id，有操作权限的帐号 id，包括代理商和广告主帐号 id

示例值:

<ACCOUNT_ID>

audience_id

integer

必需

人群 id，通过 [custom_audiences] 模块创建客户人群获得,仅支持 LBS、KEYWORD、AD、USER_ACTION 类型的人群透视

示例值:

<AUDIENCE_ID>

dimension_type

integer

必需

透视维度数组，目前仅支持单维度，[枚举详情]
数组长度为 1
枚举列表：{ AGE, GENDER, EDUCATION, RESIDENT_AREA_CODE, USER_BUSINESS_INTEREST, RELATIONSHIP_STATUS, LOCARD_INTEREST, LOCARD_BEHAVIOR_CATEGORY }

示例值:

["AGE"]

返回响应

🟢200成功

application/json

Body

code

integer

必需

message

string

必需

message_cn

string

必需

data

object

必需

list

array [object {3}]

返回数组列表

必需

修改于 2023-11-07 08:24:58

获取文件接口

获取订单