Banner AD. Delivery API ver 3.0.0

6 분 소요

Geonjin Mun

REQUEST

Publisher, SSP TARGETPICK

TARGETPICK API로써, 물량 소진 시 noad가 발생 됩니다.

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

도메인 정보

구분 URL 설명
테스트 https://ssp-stg.mman.kr 테스트 진행 시 사용( 매체 사용될 ip 등록 후 사용 가능 )
상용 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

필드 유형 필수 설명
id string 권장 광고요청시 Client에서 고유코드를 생성하여 관리
(universally unique identifier, UUID)
device object Y 단말기 정보
geo object Y 지역 정보
app object Y 앱 정보
ad object Y 광고 정보
user object Y 사용자 정보
ext object Y 확장 영역
필드 유형 필수 설명
adid string Y Android : Google AdvertiseID
iOS : IDFA
sid string 권장 공유한 sid
puid string 권장 공유한 puid
os_type integer Y 0 : WEB, 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 권장 디바이스 통신사명
screen integer 권장 미전달시 스마트폰/PC는 User Agent를 이용하여 구분
code 코드정의를 참고하세요.
w integer Y 디바이스 가로사이즈
h integer Y 디바이스 세로사이즈
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
필드 유형 필수 설명
country string Y 국가 코드 (KOR)
필드 유형 필수 설명
id string Y 앱패키지명
ver string Y 앱버전
name string Y 앱명
store_url string Y 스토어url
필드 유형 필수 설명
domain string Y page domain
page_url string Y 지면 url
필드 유형 필수 설명
section integer Y 섹션번호 (광고솔루션에서 발급)
w integer Y 광고영역 넓이
h integer Y 광고영역 높이
필드 유형 필수 설명
age_level integer Y 나이 레벨
0: 어린이(만13세 미만)
1: 성인 청소년(만13세 이상)
-1: 알수 없음

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": "-",
        "screen":1,
        "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 Publisher

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

response

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

seatbid object

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

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 확장영역
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
필드 유형 필수 설명
event integer Y 1 노출
5 클릭(랜딩페이지)
6 클릭
method integer Y 1 img tag
2 js
url string Y 트래킹
viewability object
필드 유형 필수 설명
impression string Y 트래킹
time integer Y 노출 시간 

{
    "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": { 
                //미사용
                "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": {
        //미사용
        "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 0
2
3		 WEB
iOS
Android
gender 2
3		 남성
여성
ad_type 1
2
3
4
5
6		 보장형
경매형
비과금
하우스
리워드
기간제
screen 1
3
4
5		 스마트폰, 태블릿
데스크탑
TV
DOOH

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

업데이트: