API를 활용한 네이티브 광고

1. Request Ad

GET /request

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

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

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

REST API를 참고해주세요.

Parameters:

이름	타입	필수 여부	설명
unit	STRING	필수	광고 유닛 ID
uid	STRING	권장 사항	개별 유저 식별자
pf	STRING	권장 사항	Platform
lcl	STRING	권장 사항	Locale
trackMode	INT	선택	소재에 등록된 이미지의 URL을 내려받고, 노출과 클릭 추적을 직접 처리하려고 할 때 사용하는 모드입니다. 값을 1로 설정하는 경우 응답에 asset, pixelTracker, imprTracker, clickTracker 필드가 추가됩니다.
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
ad	STRING	선택	광고 소재 (trackMode가 1이 아닐 경우)
w	INT	필수	Width
h	INT	필수	Height
advertiser	STRING	선택	광고주 명
icon	URL	선택	광고주 Icon
cover	URL	선택	광고주 Cover
advertiserURL	URL	선택	광고주 URL
headline	STRING	선택	헤드 라인 텍스트
body	STRING	선택	본문 텍스트
callToAction	STRING	선택	CTA 텍스트
destinationURL	URL	선택	도착 URL
accountTag	JSON	선택	퍼블리셔가 추가한 Account tag 데이터
creativeTag	JSON	선택	퍼블리셔가 추가한 Creative tag 데이터
extra	JSON	선택	추가 텍스트 항목 key: 콘솔에서 생성한 추가 텍스트의 id value: 광고주가 입력한 값
asset	URL	선택	(trackMode가 1인 경우) 소재 이미지 URL
pixelTracker	STRING	선택	(trackMode가 1인 경우) 소재 이미지 URL을 사용해서 화면을 구성하는 경우, 노출 집계를 위해서 1 x 1 픽셀의 투명 이미지를 제공합니다. 해당 이미지를 소재와 함께 화면에 배치하면 광고 노출시 자동으로 집계가 가능합니다. pixelTracker 와 imprTracker 중 한 가지 방법만을 사용해서 노출을 집계해야 합니다.
imprTracker	URL	선택	(trackMode가 1인 경우) 노출을 직접 추적하기 위한 URL입니다. 사용자에게 광고가 노출되었을때 해당 URL을 호출해주어야 정상적으로 노출이 집계됩니다. pixelTracker 와 imprTracker 중 한 가지 방법만을 사용해서 노출을 집계해야 합니다.
clickTracker	URL	선택	(trackMode가 1인 경우) 클릭을 직접 추적하기 위한 URL입니다. 사용자가 광고를 클릭했을 때 해당 URL을 호출해주어야 정상적으로 클릭이 집계됩니다.
profile	JSON	선택	광고유닛에 광고주 프로필을 받도록 설정했을때, 광고주가 소재 등록시 등록한 정보입니다. displayLogo: 광고주가 업로드한 정사각형 로고 displayName: 광고주가 입력한 이름 link: 광고주가 입력한 링크

---

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={unit_id}&uid={user_id}&{platform}&lcl={locale}' \
--header 'Authorization: {app_key}'

{
    "code": 0,
    "msg": "OK",
    "result": {
        "format": "nativeAd",
        "unit": "unit_id",    
        "ad": "...",
        "advertiser": "..."
    }
}