공통(배너 포함)

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

Request

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

도메인 정보

구분	URL
테스트	https://ssp-dev.mman.kr
상용	https://ssp.mman.kr

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

쿼리 파라미터

필드	유형	필수	설명
pub	integer	Y	사업자번호 (광고솔루션에서 발급)
media	integer	Y	미디어번호 (광고솔루션에서 발급)
section	integer	Y	섹션번호 (광고솔루션에서 발급)
used_type	string	Y	api

Body

필드	유형	필수	설명
device	object	Y	단말기 정보
geo	object	Y	지역 정보
app	object	Y	앱 정보
ad	object	Y	광고 정보
user	object	Y	사용자 정보
ext	object	Y	확장 영역

Device

필드	유형	필수	설명
adid	string	Y	Android : Google AdvertiseID iOS : IDFA
sid	string	권장	공유한 sid
puid	string	권장	공유한 puid
os_type	integer	Y	2 : iOS, 3 : Android
os_name	string	Y	디바이스 OS명 ex) Android, iPad, iPhone..
manufacturer	string	권장	디바이스 제조사
model	string	권장	디바이스 모델명
os_ver	string	Y	디바이스 OS버전 ex) 7.0, 8.0
network_type	integer	권장	code 코드정의를 참고하세요.
carrier	string	권장	디바이스 통신사명
w	integer	권장	디바이스 가로사이즈
h	integer	권장	디바이스 세로사이즈
densty	string	권장	해상도
orientation	integer	권장	code 코드정의를 참고하세요.
language	string	권장	디바이스 언어코드 ex) ko, en…
mcc	integer	권장	USIM 국가코드
mnc	integer	권장	USIM 통신사코드
skadn	string	ios필수	skadn값
ua	string	Y	요청한 사용자의 user-agent
ip	string	Y	요청한 사용자의 ip

• UA(User Agent)의 경우, AD Exchange 거래를 위한 조건으로 반드시 필수 제공해주셔야 합니다.

• IP의 경우, Private IP(가상IP)가 아닌 Public IP 기준으로 전달주셔야 합니다. 공유기, 회사 내부망에 할당된 IP가 그대로 전달 될 경우 광고 거래가 제한적일 수 있습니다.

Geo

필드	유형	필수	설명
country	string	Y	국가 코드 (KOR)

App

필드	유형	필수	설명
id	string	Y	앱패키지명
ver	string	Y	앱버전
name	string	Y	앱명
store_url	string	Y	스토어url

Site

필드	유형	필수	설명
domain	string	Y	page domain
page_url	string	Y	지면 url

AD

필드	유형	필수	설명
section	integer	Y	섹션번호 (광고솔루션에서 발급)
w	integer	Y	광고영역 넓이
h	integer	Y	광고영역 높이

User

필드	유형	필수	설명
age_level	integer	Y	나이 레벨 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": "KR"
    },
    "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": {
        "w": "1080",
        "h": "131"
    },
    "user": {
        "age_level": 1
    },
    "ext": {}
}

Response

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

Response

필드	유형	필수	설명
id	string	Y	광고고유아이디
cur	string	Y	통화 “KRW”
seatbid	object array	Y	seatbid object 참고
ext	object	N	확장영역(미사용)

Seatbid object

필드	유형	필수	설명
bid	object array	Y	bid object 참고
seat	string	Y	mezzomedia
ext	object	N	확장영역(미사용)

Bid object

필드	유형	필수	설명
id	string	Y	광고 고유 아이디
impid	string	Y	광고 고유 아이디
cid	string	Y	캠페인 넘버
crid	string	Y	소재 아이디
adm	string	Y	1. html(배너)는 웹뷰에 처리 2. Vast(비디오)
price	float	Y	단가
w	integer	Y	소재 넓이
h	integer	Y	소재 높이
ext	object	Y	확장영역

Bid object > Ext

필드	유형	필수	설명
ad_type	integer	Y	과금형태
bg_color	string	N	백그라운드 색상
close_location	integer	N	close btn위치
end_datetime	integer	N	소재 허용 시간
eventtrackers	object	Y	eventtrackers object 참고
logo_location	integer	Y	logo 위치
product_attr	integer	Y	상품 중분류
product_no	integer	Y	상품 소분류
response_time	integer	Y	응답 후 랜더링 타임아웃 시간
viewability	object	N	viewability object 참고

Eventtrackers object

eventtrackers object는 1개 또는 2개 또는 없는 경우도 있습니다. (없는 경우 별도 작업 불필요)

필드	유형	필수	설명
event	integer	Y	1 노출: 노출 시 포함된 url 호출 필요 5 클릭(랜딩페이지): 별도 작업 불필요 6 클릭: 클릭 시 포함된 url 호출 필요
method	integer	Y	1 img tag 2 js
url	string	Y	트래킹

Viewability object

필드	유형	필수	설명
impression	string	Y	트래킹
time	integer	Y	노출 시간

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_직사각형_동영상-00 Native_직사각형_이미지-00 Native_직사각형_텍스트-00 외부판매용(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 국가/통신사 코드	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	0	0
Internet	1	1
WIFI	2	2
Cellular Network - 2G	4, 7, 11	4
Cellular Network - 3G	3, 5, 6, 8, 9, 10, 12, 14, 15	5
Cellular Network - 4G	13	6
Cellular Network - 5G	20	7
Cellular Network - Unknown Generation	0	3