Direct ADs API
등록된 직광고를 사용자에게 송출합니다.
테스트 지면정보
광고 요청 시, 아래 placementID를 이용해 연동 및 테스트 해 주세요.
상용 키는 요청 시, 별도로 전달 예정입니다.
iOS
c66ccd8e-c402-4823-ae01-85c1b5b8b387
335x120
Android
c06a1383-325f-4f60-b5cc-4f98551220d3
335x120
직광고 요청 API
직광고는 직광고 어드민을 통해 등록된 광고를 조회할 수 있습니다. 노출 기간 등 광고 세팅에 따라 노출 가능한 광고만 조회됩니다.
요청 값
광고 요청에는 '광고ID(AD-ID / IDFA)'가 필요하며, 광고ID가 포함되지 않은 경우, 일부 직광고를 조회할 수 없습니다.
userKey
String
필수
사용자 키
placementID
String
필수
광고 위치 ID
deviceADID
String
필수 아님
기기 광고 ID
응답 값
placementID와 advertiseID는 임프레션 및 참여에 사용됩니다. imageUrl 로 사용자에게 보여지는 이미지를 구성하고, 사용자가 클릭 시, landingUrl로 이동시킵니다.
받을 보상이 없는 경우 reward 값이 0으로 반환됩니다.
useInAppBrowser이 true인 경우, 인앱브라우저로 랜딩시켜주세요.
placementID
String
광고 지면 ID
advertiseID
String
광고 ID
title
String
제목
productID
String
제품 ID
imageUrl
String
이미지 URL
reward
String
보상
landingUrl
String
랜딩 페이지 URL
useInAppBrowser
Boolean
앱 내 브라우저 사용 여부
구현
직광고 임프레션 API
사용자에게 광고가 노출되는 시점에 임프레션을 호출합니다. 응답 값은 따로 없으며 호출만 해주시면 됩니다.
임프레션이 정상적으로 이루어지지 않으면 사용자의 적립 또는 매출정산이 정상적으로 이루어지지 않을 수 있으므로, 반드시 호출해주셔야 합니다.
요청 값
deviceADID는 사용자의 중복 참여를 막기위한 기준 값이 됩니다.
placementID
String
필수
광고 지면 ID
advertiseID
String
필수
광고 ID
userKey
String
필수
사용자 키
deviceADID
String
필수 아님
기기 광고 ID
구현
직광고 클릭 API
사용자가 광고를 클릭했을 때, landingUrl 로 이동시키는 동시에 클릭을 호출해야 합니다.
클릭이 정상적으로 호출되면, 리워드가 가능한 직광고는 리워드가 적립됩니다.
클릭 API를 호출하셔야 사용자에게 리워드가 지급되므로, 반드시 호출해주세요.
요청 값
임프레션과 마찬가지로 deviceADID는 사용자의 중복 참여를 막기위한 기준 값이 됩니다.
deviceADID
String
필수 아님
기기 광고 ID
deviceID
String
필수 아님
기기 ID
placementID
String
필수
광고 지면 ID
advertiseID
String
필수
광고 ID
userKey
String
필수
사용자 키
구현
Last updated