受众API介绍

1. 简介

Tapjoy Audience API 是一个 REST API,用于创建和检索有关可用于重定向和屏蔽列表的受众的信息。 此外,它还可用于为应用程序屏蔽相关设备。

A. App Suppression

App Suppression意味着提供的设备应该被标记为已经安装了关联的App ID。 此信息来自我们广告平台/SDK数据之外。 例如,广告主上传他们知道已经安装了该应用程序的设备列表。 Tapjoy将“禁止”应用相关的广告,也就意味着我们不会在这些设备上展示此应用的相关广告。

B. 屏蔽列表

屏蔽列表意味着所提供的设备不应显示相关的广告。 这与 App Suppression 不同,因为它不会告诉我们设备是否安装了该应用程序。 在某一条广告的屏蔽列表上的设备也许会看到同一广告主应用的另一条广告。

C. 重定向

允许广告主将广告定位到特定的设备ID列表。

2. 请求

要发出 API 请求,您必须首先通过我们的 OAuth API 请求访问令牌。详细信息请参考这里.

A. 请求参数和期望值

account_id - 在我们的后台的广告主帐户ID。

name - 受众名称

description - 受众简介

devices - 设备ID的CSV文件。 此CSV不应包含标题。 IDFA和GAID可以是任何大小写,包括或不包括连字符。 它们在后端标准化。

offer_id - 用于重定向或屏蔽的相关Tapjoy offer_id(或AdSet ID)。

app_id - 广告主想屏蔽的app的Tapjoy app_id。

list_type - 列表类型告诉受众API请求是用于重定向、屏蔽受众还是应用禁止。

期望值包括: ['retarget', 'blacklist', 'app_suppression'].

列表类型参数的期望值必须是列出的 3 个选项之一。

注意:列出的参数(总共 7 个)是 API 请求所必需的,但是,并非每个参数都需要有相关值才能从 API 返回成功响应。

附加说明:每个请求都是从同一个 API Endpoint发出的。

Endpoint

https://api.tapjoy.com/v4/audiences

B. 请求示例

POST /v4/audiences 
Host: api.tapjoy.com 
Authorization: Bearer <token_string> 
Accept: application/json; */* 

重定向

account_id: '51a1d60a-0af4-449d-ac12-72f43846c146' 
name: 'foo' 
description: 'This is our foo audience for retargeting' 
devices: device_list.csv 
offer_id: 'bdc9b48c-3e7b-4347-9c56-161fd227e9c8' 
app_id: ' ' (blank for retargeting lists)
list_type: 'retarget' 

屏蔽列表

account_id: '5a4e87ac-119f-4181-91c7-fce4f8542cee' 
name: 'bar'
description: 'This is our foo audience for deny-list' 
devices: device_list_2.csv 
offer_id: 'a5e24cb9-de37-4755-bca8-66ad36c63f23'
app_id: ' ' (blank for deny lists)
list_type: 'blacklist' 
curl --header "Content-Type: text/csv" --header "Authorization: Bearer your-token-here" --request POST --data-binary "/path/to/test.csv" https://api.tapjoy.com/v4/audiences?account_id=974b39c7-7e69-4584-af5e-a159ad29a0e7&app_id=e774b012-c560-40b0-8be1-dcda55d694e4&description=foo&devices=test.csv&list_type=app_suppression&name=bar&offer_id=

App Suppression

account_id: '497670f6-a152-4bdd-a717-dbe7f7635dc7' 
name: ' ' 
description: ' ' 
devices: device_list_3.csv 
offer_id: ' ' (blank for suppression lists)
app_id: '6881899b-9c55-4d83-9afc-552f880289d4' 
list_type: 'app_suppression'

3. FAQ

客户多久可以上传一次受众以进行重定向、屏蔽列表或APP禁止?

根据他们的需要,(例如,1 小时)。

我可以上传的最大设备列表是多少?

有100万个设备的软上限。如果您想处理更多,请联系Tapjoy。

如果我上传两个文件(例如,list_one.csv、list_two.csv),它们是被替换还是合并?

应用禁止 - csv 中的每个设备都将被标记为安装了指定的应用程序。发送两个列表具有合并它们的效果。 屏蔽列表 - 被替换。 重定向 - 被替换。

我可以删除列表吗?

应用禁止 - 不,一旦设备被标记为安装了该应用程序,就无法告诉 Tapjoy 用户已卸载该应用程序。如果合作伙伴希望能够移除设备,他们应该使用屏蔽列表。 屏蔽列表 - 上传空列表。 重定向 - 上传空列表。

哪些 MMP 会自动与受众 API 集成?

Appsflyer。