오디언스 API

1. 개요

탭조이 오디언스 API는 리타게팅 및 거부 목록에 사용할 수 있는 오디언스 정보를 생성 및 조회하기 위한 REST API입니다. 또한 특정 디바이스 리스트에 대한 광고노출 제한에 사용할 수 있습니다.

A. 앱 서프레션 (App Suppression)

앱 서프레션 데이타는 디바이스에 이미 설치된 앱ID의 정보를 제공합니다. 이 정보는 탭조이 네트워크 외부에서 가져오게 됩니다. 예를 들어 광고주가 이미 앱이 설치된 것으로 기록된 기기 목록을 업로드하면 탭조이는 광고 노출을 '억제(Suppression)'하여 사용자에게 이 앱에 대한 광고를 표시하지 않습니다.

B. 거부리스트 (Denylist)

거부리스트는 광고 노출을 거부하는 디바이스 목록을 제공합니다. 이는 기기에 앱이 설치되어 있는지 여부와 관계없기 때문에 앱 서프레션과는 다릅니다. 특정 광고에 대해 거부 목록에 포함된 기기일지라도, 동일한 광고주 앱에 대한 다른 광고는 표시될 수 있습니다.

C. 리타케팅

퍼블리셔가 리타겟팅 목적으로 특정 기기 ID 목록에 광고를 타겟팅할 수 있습니다.

2. 요청하기

API를 요청하려면 먼저 OAuth API를 통해 액세스 토큰을 요청해야 합니다. 자세한 방법은 이 문서를 참조해주세요.

A. Required Parameters and Expected Values

account_id - 탭조이 시스템에서 해당 광고주를 인증하기 위한 광고주 계정 ID입니다.

name - 오디언스의 이름입니다.

description - 오디언스에 대한 설명.

devices - 장치 ID의 CSV 파일. 이 CSV에는 헤더가 포함되어서는 안 됩니다. IDFA 및 GAID는 대소문자에 관계없이 사용할 수 있으며 하이픈을 포함하거나 포함하지 않습니다. 백엔드에서 정규화됩니다.

offer_id - 클라이언트가 리타겟팅 또는 거부리스트를 위해 연결하려는 탭조이 offer_id(또는 AdSet ID)입니다.

app_id - 광고주가 차단하려는 탭조이 app_id.

list_type - 목록 유형은 클라이언트 API 요청이 대상을 재타겟팅하기 위한 것인지, 대상 목록을 거부하거나 앱제한(App Suppression)을 위한 것 인지를 오디언스 API에 알려줍니다.

list_type에 사용할 수 있는 값: ['retarget', 'denylist', 'app_suppression'].

목록 유형 매개변수의 값은 나열된 3가지 옵션 중 하나여야 합니다.

참고: 나열된 매개변수(총 7개)는 API 요청에 필요하지만 API에서 성공적인 응답을 반환하기 위해 모든 값을 전달할 필요는 없습니다.

추가 참고 사항: 각 요청은 동일한 API 엔드포인트에 대해 이루어집니다.

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: 'denylist' 

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=

앱 서프레션

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

클라이언트가 대상 변경, 거부 목록 또는 금지 목록을 위해 얼마나 자주 데이타를 업로드할 수 있습니까?

원하는 만큼 자주(예: 1시간)

업로드할 수 있는 최대 장치 목록은 얼마입니까??

디바이스 100만건에 대한 소프트 상한이 있습니다. 더 처리하려면 담당 AM에게 문의하십시오.

두 개의 파일(예: list_one.csv, list_two.csv)을 업로드하면 대체되거나 병합됩니까?

앱 서프레션 - csv의 모든 장치는 지정된 앱이 설치된 것으로 표시됩니다. 두 개의 목록을 보내면 병합됩니다. 거부 리스트 - 대체 됩니다. 리타겟팅 - 대체 됩니다.

목록을 삭제할 수 있습니까?

앱 서프레션 - 아니요, 기기에 앱이 설치된 것으로 표시되면 사용자가 앱을 제거했다고 탭조이에게 알릴 방법이 없습니다. 파트너가 장치를 제거하려면 거부 목록을 사용해야 합니다. 거부 리스트 - 빈 목록을 업로드하십시오. 리타겟팅 - 빈 목록을 업로드하십시오.

어떤 MMP가 대상 API와 자동으로 통합됩니까?

Appsflyer.