API를 활용한 배너광고

1. Request Ad

GET /request

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

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

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

REST API를 참고해주세요.

Parameters:

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

Response:

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

Ad data

이름	타입	필수 여부	설명
format	STRING	필수	광고 형식
unit	STRING	필수	광고 유닛 ID
w	INT	필수	Width
h	INT	필수	Height
ad	STRING	필수	광고 소재

---

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

curl --location 'https://api-v2.adrop.io/request?{unit_id}&uid={user_id}&pf={platform}&lcl={locale}' \
--header 'Authorization: {app_key}'

문맥타겟팅 예시

const res = await axios.get(`https://api-v2.adrop.io/request?unit={{REPLACE_YOUR_ADROP_AD_UNIT}}&contextId={{CONTEXT_ID}}`,
         {
            headers: {
                Authorization: {{app_key}}
            }
        })

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

캐러셀 배너 광고 연결

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

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

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

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