API 배너 광고

1

Request Ad

GET /request

응답부터 수신된 데이터 중, adof result필드를 이용하여 배너 광고를 표시할 수 있습니다.

배너는 HTML 형식으로 반환되므로 웹 프로젝트에서 직접 렌더링할 수 있습니다.

다른 플랫폼에서는 WebView를 활용할 수 있습니다.

2

Parameters

이름	타입	필수 여부	설명
unit	STRING	필수	광고 유닛 ID
uid	STRING	권장 사항	개별 유저 식별자
pf	STRING	권장 사항	android | ios | web
lcl	STRING	권장 사항	국가/언어 정보
contextId	STRING	문맥 타겟 광고 요청 시 필수	콘솔 타겟팅 메뉴 > 문맥 타겟팅 에서 설정한 아이디로 광고 요청을 보낼때 사용됩니다.
adId	STRING	내 기기에서 보기 광고 요청시 필수	광고 식별자

3

Response

이름	타입	필수 여부	Description
code	INT	필수	Adrop Error Code
msg	STRING	필수	Adrop Error Code Message
result	STRING	필수	Ad data

4

Ad data

이름	타입	필수 여부	설명
id	STRING	필수
cpId	STRING	필수
type	STRING	필수	"display" | "video"
carouselActivated	BOOLEAN	선택	배너 캐러셀 활성화 여부
format	STRING	필수	광고 형식
unit	STRING	필수	광고 유닛 ID
w	INT	필수	Width
h	INT	필수	Height
ad	STRING	필수	광고 소재
target	STRING	선택	애드컨트롤 콘솔에서 소재에 설정한 도착 위치 선택 필드입니다. external : 기본 브라우저 선택 internal : 내부 브라우저 선택

5

Example

아래 코드 스니펫에서 생성한 유닛 ID로 코드를 변경해주세요.

혹은 Adrop의 test_유닛ID를 대신해서 테스트 할 수 있습니다.

HTTP

GET /request?unit={unit_id}&uid={user_id}&pf={platform}&lcl={locale} HTTP/1.1
Host: api-v2.adrop.io
Authorization: {app_key}

cURL

문맥타겟팅 예시

{
    "code": 0,
    "msg": "OK",
    "result": {
        "format": "banner",
        "unit": "unit_id",    
        "w": 375,
        "h": 80,
        "ad": "...",
    }
}

6

캐러셀 배너 광고 연결

하나의 광고 유닛에 여러 캠페인이 진행되는 경우에 자동으로 캐러셀 배너가 동작되도록 설정할 수 있어요. 캐러셀 배너 설정하기를 참고하여, 콘솔에서 캐러셀 배너를 설정해주세요!

콘솔에서 캐러셀 배너를 설정해 주셔도, 아래 스크립트를 적용해 주지 않으시면 캐러셀 배너가 정상적으로 동작되지 않습니다.

head에 아래 스크립트를 추가해 주세요!

<script type=text/javascript src='https://storage.adrop.io/js/adrop-carousel-1.0.1.min.js'></script>