개요
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 헤더를 포함해야 합니다:
공통 파라미터
필수 파라미터
| 파라미터 | 타입 | 설명 |
|---|---|---|
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 파라미터는 사용자별 광고 노출 빈도 제어와 타겟팅 정보 매핑에 사용됩니다. 제공하지 않으면 정확한 타겟팅이 어려울 수 있습니다.지원 광고 포맷
배너 광고
HTML 형식으로 반환되어 웹에서 직접 렌더링 가능
네이티브 광고
구조화된 데이터로 반환되어 커스텀 UI 구현 가능
관련 문서
타겟팅 설정
사용자 속성 및 컨텍스트 타겟팅 설정
이벤트 전송
사용자 행동 이벤트 전송 및 전환 추적
에러 코드
API 에러 코드 및 해결 방법