Adrop REST API를 사용하면 SDK 없이 서버 사이드에서 직접 광고를 요청할 수 있습니다. 웹 서버, 백엔드 서비스, 또는 SDK를 지원하지 않는 플랫폼에서 광고를 연동할 때 유용합니다.
기본 정보
| 항목 | 값 |
|---|
| Base URL | https://api-v2.adrop.io |
| 프로토콜 | HTTPS |
| 인증 방식 | App Key (Authorization 헤더) |
인증 설정
API를 사용하기 위해서는 App Key가 필요합니다.
App Key 발급
- Adrop 콘솔에 로그인
- 관리 탭으로 이동
- 앱 메뉴에서 플랫폼별
adrop_service.json 다운로드
- JSON 파일에서 App Key 확인
인증 헤더
모든 API 요청에 Authorization 헤더를 포함해야 합니다:
Authorization: YOUR_APP_KEY
공통 파라미터
필수 파라미터
| 파라미터 | 타입 | 설명 |
|---|
unit | STRING | 광고 유닛 ID |
권장 파라미터
| 파라미터 | 타입 | 설명 |
|---|
uid | STRING | 사용자 고유 식별자 |
pf | STRING | 플랫폼 (android, ios, web) |
lcl | STRING | 로케일 (예: ko_KR, en_US) |
선택 파라미터
| 파라미터 | 타입 | 설명 |
|---|
theme | STRING | 테마 모드 (light, dark) |
adId | STRING | 광고 식별자 (ADID/IDFA) |
contextId | STRING | 컨텍스트 타겟팅 ID |
uid 파라미터는 사용자별 광고 노출 빈도 제어와 타겟팅 정보 매핑에 사용됩니다. 제공하지 않으면 정확한 타겟팅이 어려울 수 있습니다.
지원 광고 포맷
관련 문서
