Request (GET)
Geonjin Mun
REQUEST
Publisher, SSP TARGETPICK
TARGETPICK API로써, 물량 소진 시 noad가 발생 됩니다.
HTTP GET 방식으로 아래 정의된 객체를 작성해 TARGETPICK 인터페이스를 호출합니다.
도메인 정보
| 구분 | URL | 설명 |
|---|---|---|
| 테스트 | https://ssp-stg.mman.kr | 테스트 진행 시 사용( 매체 사용될 ip 등록 후 사용 가능 ) |
| 상용 | https://ssp.mman.kr | 라이브 배포 시 사용 |
/ssp.mezzo/get/?pub={publisher}&media={media}§ion={section}&adid={adid}&sid={sid}&app_name={appname}&app_id={packagename}&app_ver={appVersion}&site_domain={page domain}&page_url={지면url}&ad_w={광고영역넓이}&ad_h={광고영역높이}&os_type={단말기os}&age_level={사용자나이레벨}&i_request_id={요청고유아이디}&d_screen={단말기타입}&manufacturer={단말기제조사}&model={단말기모델명}&carrier={통신사}&os_name={os명}&os_ver={os버전}&d_w={단말기사이즈넓이}&d_h={단말기사이즈높이}&densty={해상도}&orientation={가로세로인덱스}&language={언어}&app_store_url={앱스토어url}&ip={사용자요청ip}&ua={사용자요청UserAgent}&mcc={USIM 국가코드}&mnc={USIM 통신사코드}&skadn={skadn값}&network_type={네트워크타입}&country={국가코드}&i_response_format=json&d_used_type=api
쿼리 파라미터
| 필드 | 유형 | 필수 | 설명 |
|---|---|---|---|
| pub | integer | MUST | 사업자번호 (광고솔루션에서 발급) |
| media | integer | MUST | 미디어번호 (광고솔루션에서 발급) |
| section | integer | MUST | 섹션번호 (광고솔루션에서 발급) |
| used_type | string | MUST | api |
| request_id | string | MAY | 광고요청시 Client에서 고유코드를 생성하여 관리 (universally unique identifier, UUID) |
| 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버전 |
| network_type | integer | SHOULD | code 코드정의를 참고하세요. |
| carrier | string | SHOULD | 디바이스 통신사명 |
| screen | integer | SHOULD | 미전달시 스마트폰/PC는 User Agent를 이용하여 구분 code 코드정의를 참고하세요. |
| d_w | integer | MUST | 디바이스 가로사이즈 |
| d_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( url encoding ) |
| ip | string | MUST | 요청한 사용자의 ip |
app일 경우
| 필드 | 유형 | 필수 | 설명 |
|---|---|---|---|
| app_id | string | MUST | 앱패키지명 |
| app_ver | string | MUST | 앱버전 |
| app_name | string | MUST | 앱명 |
| app_store_url | string | MUST | 스토어url( url encoding ) |
site일 경우
| 필드 | 유형 | 필수 | 설명 |
|---|---|---|---|
| site_domain | string | MUST | page domain |
| page_url | string | MUST | 지면 url |
request 예제
/ssp.mezzo/get/?&pub=100&media=200§ion=300&adid=8aaa70b8-cbd5-4f3f-88a4-e8427becc274&sid=32baa0e8-27cc-45ea-a194-704cd85c29f8&app_name=Meverage&app_id=com.mezzomedia.adman.app&app_ver=1.0&ad_w=1768&ad_h=150&os_type=3&age_level=1&i_request_id=c1053500-466b-4f64-a241-b9c9c405d818&d_screen=1&manufacturer=samsung&model=SM-F916N&carrier=SKTELECOM&os_name=Android&os_ver=13&d_w=1768&d_h=1976&densty=480&orientation=1&language=ko&app_store_url=https%3A%2F%2Fplay.google.com%2Fstore%2Fapps%2Fdetails%3Fid%3Dcom.mz.mezzomediaapp&ip=111.111.11.111&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&mcc=450&mnc=5&skadn=&network_type=2&country=KOR&i_response_format=json&d_used_type=api