Documentation

Support

Audience API Overview

Use the Tapjoy Offerwall Audience API to manage lists of devices that already have your app installed and prevent those users from receiving duplicate offers.
Read time 2 minutesLast updated 3 hours ago

The Tapjoy Audience API is a REST API for creating and retrieving information about audiences that can be used for app suppression on a list of devices.

App Suppression

App Suppression means the provided devices should be marked as having the associated App ID already installed. This information comes from outside our normal network/SDK data about a device. For example, an advertiser uploads a list of devices that they know already have the app installed. Tapjoy will 'suppress' the app offers, so that we do not show offers for this app to the users.

Making Requests

To make a API request you must first request an access token via our OAuth API. Details on how to do this are here.

Required Parameters and Expected Values

Required parameter

Expected value

Notes

account_id
The Advertiser account ID to authenticate the advertiser in the system.
name
Name of the Audience.
description
Description of the Audience.
devices
A CSV file of device IDs with no headers.IDFA and GAID may be any case and may include hyphens; they are normalized on the backend.
offer_id
The Tapjoy
offer_id
(or AdSet ID).
app_id
The Tapjoy
app_id
for the app the Advertiser wants to suppress.
list_type
List type indicating the request is for app suppression.
Allowed values:
['app_suppression']
. The expected value must be one of the available options.
Endpoint
https://api.tapjoy.com/v4/audiences

Example Requests

POST /v4/audiences 
Host: api.tapjoy.com 
Authorization: Bearer <token_string> 
Accept: application/json
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'
curl --header "Authorization: Bearer YOUR-TOKEN" --request POST --form devices=@/path/to/device_list.csv "https://api.tapjoy.com/v4/audiences?account_id=497670f6-a152-4bdd-a717-dbe7f7635dc7&app_id=6881899b-9c55-4d83-9afc-552f880289d4&description=LIST-DESCRIPTION&list_type=app_suppression&name=LIST-NAME&offer_id="

FAQ

As often as they want, (for example, 1hr).

There is a soft upper limit of 1 million devics. Contact engineering if you want to process more.

App Suppression - every device in the csv will be marked as having the specified app installed. Sending two lists has the effect of merging them.

App Suppression - No, when a device is marked as having the app installed there is no way to tell Tapjoy the user has uninstalled the app. If a partner wants to be able to remove devices, they should use a denylist.