버전 1.0 / 2015년 3월
Suppression API를 통해 광고주들은 특정 앱을 이용하고 있는 이용자들이 해당 앱의 광고에 타게팅 되는 것을 막아줍니다. 서프레션(Suppression)은 애플의 IDFA나 안드로이드의 advertising ID를 이용하여 이루어집니다.
인증(Authentication)
Suppression API는 요청 시 쿼리 매개변수로 받을 API key가 있어야 합니다.Management Key는 광고주 계정(Account) 페이지의 ‘keys’ 탭에서 찾을 수 있습니다.Management Key가 보이지 않으면 AppLovin 지원센터(adsupport@applovin.com)으로 메일을 보내 key를 생성하기 바랍니다.
https://api.applovin.com/suppressionApps?api_key=<API_KEY>
오류(Errors)
Http 상태 코드는 오류를 표시하기 위해 사용됩니다.
HTTP응답 코드 |
설명 |
200 |
성공 |
400 |
요청이 형식에 맞지 않거나, 데이터가 누락되었거나, 유효하지 않은 데이터가 있음. |
403 |
인증 실패. API key가 유효한지 확인 바람. |
500 |
서비스 불가 |
업로드 요청(Upload Request)
제어할 이용자들의 리스트를 업로드 하기 위해서는 아래로 HTTP POST 요청을 보내십시오.
https://api.applovin.com/
suppressionApps
?api_key=<API_KEY>&package_name=<PACKAGE_NAME>
쿼리 매개변수
이름 |
유형 |
설명 |
필수여부 |
package_name |
String |
앱의 번들 ID나 패키지 이름 |
필수
|
Post Body: Update API는 POST 요청을 통해 새 줄로 구분된 ID 리스트를 받아옵니다.
유형 |
설명 |
필수여부 |
List of Strings |
새 줄로 구분된 애플의 IDFA나 안드로이드의 advertising ID. ID는 UUID 형식이어야 함. |
필수
|
응답은 JSON 형식으로 합니다
이름 |
유형 |
설명 |
num_valid_ids |
Integer |
이 요청에서 성공적으로 처리된 ID의 수 |
num_invalid_ids |
Integer |
이 요청에서 유효하지 않은 Advertising ID의 수 |
요청 예시
curl -X POST --data-binary @userIds.txt "https://api.applovin.com/
suppressionApps
?api_key=<API_KEY>&package_name=com.machinezone.gow"
여기에서 userIds.txt 파일의 내용은 아래와 같습니다.
c77bbe4e-6a28-11e4-bcda-14109fdf9591
f601faf5-4a83-44d6-98ef-b67c24919d39
응답 예시
{ "num_valid_ids" : 2, "num_invalid_ids" : 0 }