Request (POST)

3 분 소요

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 MUST 사업자번호 (광고솔루션에서 발급)
media integer MUST 미디어번호 (광고솔루션에서 발급)
section integer MUST 섹션번호 (광고솔루션에서 발급)
used_type string MUST api

Body

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

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

Banner

{
    "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": {}
}

Native

{
    "ad": {
        "h": 627,
        "w": 1200,
        "assets":"{\"ver\":\"1,2\",\"battr\":[],\"request\":{\"assets\":[{\"id\":1,\"required\":1,\"title\":{\"len\":18}},{\"id\":100,\"required\":1,\"img\":{\"type\":3,\"w\":1200,\"h\":627,\"mimes\":[\"image/png\",\"image/jpg\"]}},{\"id\":2,\"required\":1,\"data\":{\"type\":2,\"len\":60}},{\"id\":3,\"required\":0,\"data\":{\"type\":10,\"len\":30}}],\"ver\":\"1.2\"}}"
    },
    "app": {
        "id": "com.mezzomedia.adman.app",
        "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",
        "ver": "1.0"
    },
    "device": {
        "adid": "7ecb4ad5-68f0-483a-a54e-e013ab5cede3",
        "carrier": "KT",
        "densty": 0,
        "h": 2400,
        "ip": "220.119.16.142",
        "language": "ko",
        "manufacturer": "",
        "mcc": "450",
        "mnc": "08",
        "model": "SM-G991N",
        "network_type": 3,
        "orientation": 2,
        "os_name": "Android",
        "os_type": 3,
        "os_ver": "14",
        "puid": "7ecb4ad5-68f0-483a-a54e-e013ab5cede3",
        "sid": "7ecb4ad5-68f0-483a-a54e-e013ab5cede3",
        "ua": "Dalvik/2.1.0 (Linux; U; Android 14; SM-G991N Build/UP1A.231005.007)",
        "w": 1080
    },
    "ext": {},
    "geo": {
        "country": "KR",
        "geo": "KOR"
    },
    "used_type": "api",
    "user": {
        "age_level": 1
    }
}

업데이트: