오디언스 타게팅 API (Audience Targeting API)

버전3.0 / 2015년 3월

이 API를 이용하여 광고주들은 이용자 그룹을 만들어 캠페인의 대상으로 삼을 수 있습니다. 오디언스(이용자 그룹)는 애플의 IDFA나 안드로이드의 Advertising ID를 이용하여 생성할 수 있습니다.

이용 가능한 Audience targeting API

List: 현재 오디언스 리스트  

Create: 신규 오디언스 생성

Update: 새로운 이용자 그룹으로 리스트를 업데이트. 기존의 오디언스가 새 리스트로 대체됨.

Append: 기존의 오디언스에 신규 이용자를 추가

Delete: 오디언스 삭제

인증(Authentication)

이 API는 요청 시 쿼리 매개변수로 받을 API key가 있어야만 합니다. Audience API 인증을 위해 사용되는Management Key는 광고주 account page의 ‘keys’ 탭에서 찾을 수 있습니다. Management Key가 보이지 않으면 AppLovin 지원센터(adsupport@applovin.com)으로 메일을 보내 key를 생성하기 바랍니다.

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

오류(Error)

Http 상태 코드는 오류를 표시하기 위해 사용됩니다.

생성(Create)

커스텀 오디언스(Custom Audience)를 제출하려면 먼저 빈 오디언스를 생성하십시오. 새로운 오디언스를 생성하기 위해서는 아래의 주소로 HTTP 요청을 해야 합니다.

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

The create API accepts the following fields passed as URL encoded query parameters

응답은 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"}

리스트(List)

어떤 이용자에 대한 현재의 모든 오디언스 목록을 얻으려면 List API에 HTTP 요청을 보내십시오.

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)

오디언스에 이용자 리스트를 업로드 하기 위해서는 Update API를 이용하십시오. 오디언스에 이미 이용자 리스트가 있다면, 이 리스트는 Update API 요청 시 신규 이용자 리스트로 대체됩니다.

새로운 이용자 리스트로 오디언스를 업데이트 하려면 아래의 주소로 HTTP POST를 전송하십시오.

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

쿼리 매개변수

Post Body: Update API는 POST 요청을 통해 새 줄로 구분된 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)

기존의 오디언스에 이용자를 추가하려면 Append API를 사용하십시오. 오디언스가 이미 이용자 리스트를 가지고 있다면 해당 리스트에 이용자가 추가됩니다.

기존 오디언스에 신규 이용자 리스트를 추가하려면 아래로 HTTP POST를 전송하십시오.

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

쿼리 매개변수

Post Body: Update API는 POST 요청을 통해 새 줄로 구분된 ID 리스트를 받아옵니다.

응답은 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 }

삭제(Delete)

오디언스를 삭제하기 위해서는 아래로 HTTP 요청을 보내십시오.

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

요청 예시

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

팁

• AppLovin Audiences.postman_collection.json6 킬로바이트