Version 3.0 / March 2015

广告主可以通过Audience API创建用户层级的定位投放活动。

使用Apple IDFA或Android广告ID来创建Audience。

可用的定向受众API为

List – 列出当前audience列表

Create – 创建新audience列表

Update – 通过新user组更新audience列表。对于指定audience，此API将替代现有user列表。

Append  – 增加新user至现有audience

Delete  – 删除指定audience

验证：

所有定向受众API皆须API密钥，以作为该请求的查询参数. 如需用于验证Audience API的Management Key密钥,可于广告主账户页面“Keys”标签获取. 如无法获得 Management Key密钥， 则发送邮件至adsupport@applovin.com，我们会为您生成密钥。

https://api.applovin.com/audiences/list?api_key=<API_KEY>

错误：

Http 状态编码，用于显示Error

创建：

提交自定义audience第一步就是建立一个空白的audience列表. 若想建立一个新的audience列表，提交申请至

https://api.applovin.com/audiences/create?api_key=<API_KEY>

Create API接受包含如下查询参数的URL

响应为JSON格式:

请求范例:

curl "https://api.applovin.com/audiences/create?name=My%20Audience%20Name&package_name=my.app.bundleId&platform=ios&api_key=<API_KEY>"

响应范例:

{"audience_id" : "fce0b41a0849706bd0fbbe181e61f419"}

列表：

如需查看所有当前audience列表，则发出HTTP请求致list API

https://api.applovin.com/audiences/list?api_key=<API_KEY>

响应为JSON格式：

请求范例:

curl "https://api.applovin.com/audiences/list?api_key=<API_KEY>"

响应范例:

{
	"code": 200,
	"audiences": [
		{
			"audience_id": "dab2d1297d35592597b0eee016e92baa",
			"name": "Custom Audience Test",
			"package_name": "Some package name",
			"platform": "ios",
			"description": "Test Custom Audience",
			"user_count": "10"
		}
	],
	"count": 1
}

更新:

使用update API上传user列至指定audience列表. 若audience已存在user列，则该user列将被update API请求中的user列所替代. 

如需用新user列更新audience，则发出HTTP POST请求至

https://api.applovin.com/audiences/update?api_key=<API_KEY>&audience_id=<AUDIENCE_ID>&ttl_seconds=<TTL_SECONDS>

查询参数:

Post 主体: 在一次POST请求中，update API可接收用行隔开的用户ID列表

响应为JSON格式:

请求范例:

curl -X POST --data-binary @userIds.txt "https://api.applovin.com/audiences/update?audience_id=<AUDIENCE_ID>&ttl_seconds=2592000&api_key=<API_KEY>"

其中userIds.txt文件所含内容为

c77bbe4e-6a28-11e4-bcda-14109fdf9591
f601faf5-4a83-44d6-98ef-b67c24919d39 

响应范例

{ "audience_id" :“dab2d1297d35592597b0eee016e92baa”, "num_valid_ids" : 2, "num_invalid_ids" : 0 }  

添加：

使用append API以增加user至现有audience. 若audience已存在user列，则添加新增user至该列中. 

如需通过新的user列插入user至audience，则发出HTTP POST请求至

https://api.applovin.com/audiences/append?api_key=<API_KEY>&audience_id=<AUDIENCE_ID>&ttl_seconds=<TTL_SECONDS>

查询参数:

Post Body: 在一次POST请求中，Append API可接收用行隔开的UserID列表

响应为JSON格式：

请求范例:

curl -X POST --data-binary @userIds.txt "https://api.applovin.com/audiences/append?audience_id=<AUDIENCE_ID>&ttl_seconds=2592000&api_key=<API_KEY>"

其中userIds.txt所含内容为

c77bbe4e-6a28-11e4-bcda-14109fdf9591
f601faf5-4a83-44d6-98ef-b67c24919d39

响应范例:

{ "audience_id" : “dab2d1297d35592597b0eee016e92baa”, "num_valid_ids" : 2, "num_invalid_users" : 0 }

删除：

如需删除某audience，则发出HTTP请求至

https://api.applovin.com/audiences/delete?api_key=<API_KEY>&audience_id=<AUDIENCE__ID>

delete API中无响应body. 若HTTP响应成功，则返回编码200. 

请求范例:

curl "https://api.applovin.com/audiences/delete?audience_id=<AUDIENCE_ID>&api_key=<API_KEY>"

提示：

• AppLovin Audiences.postman_collection.json6 KB