공통(배너/네이티브 포함)

Targetpick 배너 광고 적용을 위한 API 가이드 입니다.

파라미터 필수 구분

MUST: 거래 상 반드시 추가되어야 하는 필수 값으로 제외 시 응답하지 않을 수 있습니다.
SHOULD: 필수(MUST)는 아니지만 추천하는 값으로 응답률 상승에 도움줄 수 있습니다.
MAY: 선택 값입니다.

Request

HTTP POST 방식으로 아래 정의된 객체를 작성해 TARGETPICK 인터페이스를 호출합니다.

도메인 정보

구분

URL

테스트

https://ssp-stg.mman.kr

상용

https://ssp.mman.kr

{domain}/ssp.mezzo/?pub={publisher}&media={media}&section={section}&used_type=api

쿼리 파라미터

필드

유형

필수

설명

pub

integer

MUST

사업자번호 (광고솔루션에서 발급)

media

integer

MUST

미디어번호 (광고솔루션에서 발급)

section

integer

MUST

섹션번호 (광고솔루션에서 발급)

used_type

string

MUST

api

Body

필드

유형

필수

설명

string

MAY

광고요청시 Client에서 고유코드를 생성하여 관리

(universally unique identifier, UUID)

device

object

MUST

단말기 정보

geo

object

MUST

지역 정보

app

object

MUST (App일 경우)

앱 정보

site

object

MUST (Web일 경우)

사이트 정보

object

MUST

광고 정보

user

object

SHOULD

사용자 정보

ext

object

MAY

확장 영역

Device

필드

유형

필수

설명

adid

string

SHOULD

Android: Google AdvertiseID iOS: IDFA

sid

string

MAY

공유한 sid

puid

string

MAY

공유한 puid

os_type

integer

MUST

1: PC

2: iOS

3: Android

os_name

string

MUST

디바이스 OS명 ex) Android, iPad, iPhone..

manufacturer

string

SHOULD

디바이스 제조사

model

string

SHOULD

디바이스 모델명

os_ver

string

MUST

디바이스 OS버전 ex) 7.0, 8.0

network_type

integer

SHOULD

code 코드정의를 참고하세요.

carrier

string

SHOULD

디바이스 통신사명

integer

MUST

디바이스 가로사이즈

integer

MUST

디바이스 세로사이즈

densty

string

MAY

해상도

orientation

integer

MAY

code 코드정의를 참고하세요.

language

string

SHOULD

디바이스 언어코드 ex) ko, en…

mcc

integer

SHOULD

USIM 국가코드

mnc

integer

SHOULD

USIM 통신사코드

skadn

string

MUST (ios)

skadn값

string

MUST

요청한 사용자의 user-agent

string

MUST

요청한 사용자의 ip

UA(User Agent)의 경우, AD Exchange 거래를 위한 조건으로 반드시 필수 제공해주셔야 합니다.
IP의 경우, Private IP(가상IP)가 아닌 Public IP 기준으로 전달주셔야 합니다. 공유기, 회사 내부망에 할당된 IP가 그대로 전달 될 경우 광고 거래가 제한적일 수 있습니다.
IP를 Device 내 적용 불가할 경우에는 Header X-Forwarded-For에 전달해주시면 됩니다.

Geo

필드

유형

필수

설명

country

string

MUST

국가 코드 (KOR)

App

필드

유형

필수

설명

string

MUST

앱패키지명

ver

string

MUST

앱버전

name

string

MUST

앱명

store_url

string

MUST

스토어url

Site

필드

유형

필수

설명

domain

string

MUST

page domain

page_url

string

MUST

지면 url

필드

유형

필수

설명

section

integer

MUST

섹션번호 (광고솔루션에서 발급)

integer

MUST

광고영역 넓이

integer

MUST

광고영역 높이

assets

string

MUST (Native 연동 시)

Native assets 상품 사용 시 필수

IAB 가이드 참고
- native version: 1.2인 경우
- native version: 1.2 이하인 경우

minduration

string

MUST (Video 연동 시)

동영상 최소 시간 (초 단위로 입력)

maxduration

string

MUST (Video 연동 시)

동영상 최대 시간 (초 단위로 입력)

User

필드

유형

필수

설명

age_level

integer

MUST

나이 레벨 0: 어린이(만 13세 미만) 1: 성인 청소년(만 13세 이상) -1: 알 수 없음

Request 예제

http://ssp.mman.kr/ssp.mezzo/?pub={pub}&media={media}&section={section}&used_type=api

{
    "device": {
        "adid": "52e49a4b-e10f-497d-96ac-af561abd0339",
        "sid": "4a34bafc-6aa2-4c51-8d32-099376261a41",
        "puid": "c1a380fc-42f5-4751-9393-52ec57533bf0",
        "os_type": 3,
        "os_name": "Android",
        "os_ver": "12",
        "manufacturer": "samsung",
        "model": "SM-G977N",
        "carrier": "-",
        "w": 1080,
        "h": 2050,
        "densty": "420",
        "orientation": 1,
        "language": "ko",
        "ua":"Mozilla%2F5.0%20%28Linux%3B%20Android%2013%3B%20SM-S908N%20Build%2FTP1A.220624.014%3B%20wv%29%20AppleWebKit%2F537.36%20%28KHTML%2C%20like%20Gecko%29%20Version%2F4.0%20Chrome%2F116.0.0.0%20Mobile%20Safari%2F537.36",
        "ip":"11.111.111.11"
    },
    "geo": {
        "country": "KOR"
    },
    "app": {
        "id": "com.mezzomedia.adman.app",
        "ver": "1.0",
        "name": "%EC%9D%B4%EA%B2%83%EC%9D%B4+%ED%85%8C%EC%8A%A4%ED%8A%B8",
        "store_url": "https%3A%2F%2Fplay.google.com%2Fstore%2Fapps%2Fdetails%3Fid%3Dcom.mz.mezzomediaapp"
    },
    "ad": { 
        "section": 12345,
        "w": 1080,
        "h": 131
    },
    "user": {
        "age_level": 1
    },
    "ext": {}
}

Response

TARGETPICK 는 아래 정의된 JSON 객체를 응답합니다.

Response

필드

유형

필수

설명

string

MAY

광고고유아이디

cur

string

MAY

통화 “KRW”

seatbid

object array

MUST

seatbid object 참고

ext

object

MAY

확장영역(미사용)

Seatbid object

필드

유형

필수

설명

bid

object array

MUST

bid object 참고

seat

string

MAY

mezzomedia

ext

object

MAY

확장영역(미사용)

Bid object

필드

유형

필수

설명

string

MAY

광고 고유 아이디

impid

string

MAY

광고 고유 아이디

cid

string

MAY

캠페인 넘버

crid

string

MAY

소재 아이디

adm

string

MUST

배너
- product_attr: 1, 2, 6, 12
- html을 웹뷰에 처리
비디오(VAST)
- product_attr: 4
- 비디오가이드 참고
네이티브
- product_attr: 10, product_no: 67
- adm 내부 string을 json 변형 후 ext>privacy>icon은 아이콘으로 처리, ext>privacy>click은 아이콘 클릭 처리 필요
- IAB 가이드 참고
  - native version: 1.2인 경우
  - native version: 1.2 이하인 경우

price

float

MAY

단가

integer

MAY

소재 넓이

integer

MAY

소재 높이

ext

object

MUST

확장영역

Bid object > Ext

필드

유형

필수

설명

ad_type

integer

MAY

과금 형태

bg_color

string

MAY

백그라운드 색상

close_location

integer

MAY

close btn위치

end_datetime

integer

MAY

소재 허용 시간

eventtrackers

object

MAY

eventtrackers object 참고

logo_location

integer

MAY

logo 위치

product_attr

integer

MAY

상품 중 분류

product_no

integer

MAY

상품 소 분류

response_time

integer

MAY

응답 후 랜더링 타임아웃 시간

viewability

object

SHOULD

viewability object 참고

Eventtrackers object

필드

유형

필수

설명

event

integer

MAY

1 노출: 노출 시 포함된 url 호출 필요

5 클릭(랜딩 페이지): 별도 작업 불필요

6 클릭: 클릭 시 포함된 url 호출 필요

method

integer

MAY

1: img tag 2: js

url

string

MAY

트래킹

event 필드가 없거나 한 개 또는 복수 개 (1+5, 1+6)로 응답할 수 있습니다.

event가 없음: adm으로 모든 노출/클릭 처리가 가능한 경우에는 해당 값이 없습니다.
"event": 1: 외부 DSP 중 nurl, burl만 사용하여 imptracking 발생하지 않을 경우 전달합니다. 광고 노출 시 eventtrackers > url을 처리해야 하며, 미발생 시 노출 집계되지 않습니다.
"event": 5: html 내부에 clicktracking 포함되어 있어 별도의 처리없이도 클릭 집계됩니다.
"event": 6: 외부 DSP 중 html 내 clicktracking 포함하지 않을 경우 전달됩니다. 클릭 발생 시 eventtrackers > url을 처리해야 하며, 발생하지 않을 경우 클릭 집계되지 않습니다.

Viewability object

필드

유형

필수

설명

impression

string

SHOULD

트래킹

time

integer

SHOULD

노출 시간

Viewability 내 impression은 노출 트래킹과 별개이며 time에 맞추어 처리하면 됩니다.

Response 예제 (JSON)


{
    "id": "1dfe1833-fdfe-4639-a04e-7ff29f9a4b8d$1233855558",
    "seatbid": [
        {
            "bid": [
                {
                    "id": "",
                    "impid": "",
                    "price": 0,
                    "adm": "...",
                    "cid": "21281",
                    "crid": "5379_12350",
                    "w": 1920,
                    "h": 1080,
                    "ext": {
                        "ad_type": 4,
                        "bg_color": "#ffffff",
                        "close_location": 0,
                        "end_datetime": 1753973999,
                        "eventtrackers": [],
                        "logo_location": 0,
                        "mobileweb_type": 0,
                        "product_attr": 4,
                        "product_no": 4,
                        "response_time": 0,
                        "rotatetime": 0,
                        "viewability": {
                            "impression": "",
                            "time": 2000
                        }
                    }
                }
            ],
            "seat": "mezzomedia",
            "ext": { 
            //미사용(응답문에 포함은 되나, API 사용 시 무시)
                "verification": [
                    {
                        "javascriptresource": {
                            "apiframework": "omid",
                            "url": "https://s3-us-west-2.amazonaws.com/omsdk-files/compliance-js/omid-validation-verification-script-v1.js"
                        },
                        "vendor": "iabtechlab.com-omid",
                        "verificationparameters": "iabtechlab-mezzomedia"
                    }
                ]
            }
        }
    ],
    "cur": "KRW",
    "ext": {
    //미사용(응답문에 포함은 되나, API 사용 시 무시)
        "verification": [
            {
                "javascriptresource": {
                    "apiframework": "omid",
                    "url": "https://s3-us-west-2.amazonaws.com/omsdk-files/compliance-js/omid-validation-verification-script-v1.js"
                },
                "vendor": "iabtechlab.com-omid",
                "verificationparameters": "iabtechlab-mezzomedia"
            }
        ]
    }
}

코드 정의

광고코드

필드

코드

설명

product_attr

1 2 4 6 10 12

띠배너 전면/종료배너 동영상 정사각형 및 직사각형 Native Splash

product_no

100 99 98 97 96 95 94 93 92 91 90 89 88 87 86 85 84 83 82 81 80 79 78 77 76 75 74 73 71 71 71 70 70 70 69 69 68 68 67 66 65 64 63 62 61 60 59 58 57 56 55 54 53 52 51 50 49 48 47 46 45 44 43 42 41 40 39 38 37 36 35 34 33 32 31 30 20 19 16 15 14 13 12 11 10 9 8 7 4 3 2 1

스플래시 디데이_카운트다운_직사각형_300x250 디데이_카운트다운_배너_320x50 디데이_카운트다운_배너_320x100 디데이_카운트다운_전면배너_640x960 저단가판매용(CPC)_250x250 저단가판매용(CPC)_200x200 세로 범퍼 동영상 카운트다운_배너_320x50 카운트다운_배너_320x100 카운트다운_전면배너_640x960 Native_외부판매용(CPM)_640x960_이미지 Native_외부판매용(CPM)_300x250_이미지 Native_외부판매용(CPM)_320x50_이미지 저단가판매용(CPC)_300x250 저단가판매용(CPC)_640x960 저단가판매용(CPC)_320x100 저단가판매용(CPC)_320x50 Native_직사각형_동영상 Native_직사각형_이미지 Native_직사각형_텍스트 외부판매용(CPM)_300x250 외부판매용(CPM)_640x960 외부판매용(CPM)_320x100 외부판매용(CPM)_320x50 동영상(PlanB) 프리롤_배너 TVING 동영상 Native_띠배너_동영상 Native_띠배너_동영상 Native_띠배너_동영상 Native_띠배너_이미지 Native_띠배너_이미지 Native_띠배너_이미지 Native_전면배너_동영상 Native_전면배너_동영상 Native_전면배너_이미지 Native_전면배너_이미지 Native_3자거래 전면배너_300x250 app promo video(동영상) interstitial video(동영상,설명) Image C(이미지,타이틀,CTA) Image B(이미지,타이틀) Image A(이미지) App Promo Icon(아이콘,타이틀) 사각형 동영상 정사각형_240x240 정사각형_150x150 파노라마_980x120 빌보드_970x250 큰리더보드_970x90 상단배너_930x180 리더보드배너_728x90 리더보드배너_468x60 세로_300x1050 반페이지광고_300x600 와이드스카이스크래퍼_160x600 스카이스크래퍼_120x600 넷보드_580x400 큰직사각형_336x280 인라인직사각형_300x250 트리플와이드스크린_250x360 세로직사각형_240x400 사각형_250x250 작은정사각형_200x200 전면배너_768x1024 전면배너_1024x768 전면배너_480x320 전면배너_320x480 띠배너_728x90 띠배너_468x60 띠배너_300x50 세로 동영상 범퍼 동영상 전면동영상 배너_300x250 종료배너_640x960 전면배너_640x640 전면배너_1040x585 전면배너_640x960 띠배너_640x148 띠배너_640x100 띠배너_640x240 CJ EnM 동영상 띠배너_320x100 띠배너_340x95 띠배너_340x51 동영상 종료배너_750x1200 전면배너_750x1200 띠배너_320x50

network_type

network_index 코드정의를 참고하세요.

네트워크 타입

orientation

1 2

세로 가로

mcc / mnc

USIM 국가/통신사 코드

os_type

2 3

iOS Android

gender

2 3

남성 여성

ad_type

1 2 3 4 5 6

보장형 경매형 비과금 하우스 리워드 기간제

Network_type code

Code

Android

iOS

Unknown

Internet

WIFI

Cellular Network - 2G

4, 7, 11

Cellular Network - 3G

3, 5, 6, 8, 9, 10, 12, 14, 15

Cellular Network - 4G

Cellular Network - 5G

Cellular Network - Unknown Generation

Previous매체 연동 API Next비디오(VAST 참고)

Last updated 13 days ago