Search...
Menu

Create Audience

You need to use the Token to change the status. For more details, please check Token.

For creating audience.

Request address

https://ss-api.mintegral.com/api/open/v1/audience

Request method

POST

Request example

json Copy 
POST /api/open/v1/audience HTTP/1.1
Host: ss-api.mintegral.com
Content-Type: application/json

{
    "ta_name": "test20240110test1",
    "area_type": 1,
    "platform": 2,
    "data_path": [
        {
            "device_type": 2,
            "data_path": "s3://mob-emr-test/audience/tmp_upload/2024/01/10/hwqyrswtztijvawi/1ceada6012b007afb4b0a29984660ad0/test.txt"
        },
        {
            "device_type": 3,
            "data_path": "s3://mob-emr-test/audience/tmp_upload/2024/01/10/hwqyrswtztijvawi/1ceada6012b007afb4b0a29984660ad0/test.txt"
        }
    ]
}

Request Parameter

PS: If default value is "--", indicating that the current field has no default value.

Fields Type Explanations Default Value Value Examples
ta_name string Audience name -- test_audience
area_type int Data Cluster
1:Outside Mainland of China		 -- 1
platform int Audience delivery platform
1:Android
2:iOS
3:mix		 -- 1
data_path array<object> Audience Data List --
data_path[].device_type int Device type
1: IMEI
2: IDFA
3: GAID
4: OAID
6: IMEI_MD5
7: IDFA_MD5
8: GAID_MD5
9: OAID_MD5
10: IDFV
11: IDFV_MD5		 -- 6
data_path[].data_path string File Data Path，create from:
[Upload Audience File]		 -- s3://mob-emr-test/audience/tmp_upload/2024/01/10/hwqyrswtztijvawi/1ceada6012b007afb4b0a29984660ad0/test.txt

Response

Fields Type Explanations
code int 200 code, is success. Others, are fail.
msg string If success, return to “success”. If fail, return to detailed wrong info.
data json If success, return to “success”. If fail, return to detailed wrong info.
data.ta_id int Audience ID.

Response Example

json Copy 
{
 "code": 200,
 "message": "success",
 "data": {
 "ta_id": 1148
 }
}
Previous
Upload Audience File
Next
Update Audience
Last modified: 2025-07-29