Create Audience

PS: You need to use Token. For more details, please check Token

For creating audience.

Note：Publish Api is called internally in the create audience api, so the new audience cannot be published in 12 hours.

Request address

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

Request method

POST

Request example

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, 2:Mainland of China	--	1
platform	int	Audience delivery platform 1:Android,2:iOS,3:mix	--	1
data_path	array<json>	Audience Data List	--
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	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.
ta_id	int	Audience ID.

Response Example

{
 "code": 200,
 "message": "success",
 "data": {
 "ta_id": 1148
 }
}