MMP(Tracker)

MMP에서 Targetpick 광고 데이터를 활용하기 위한 API 입니다.

도메인 및 API Key는 별도로 제공됩니다.

담당자에게 문의해주세요.

코드 정의

구분	코드	설명
ERROR_CODE	0	성공
	1	시스템에 에러가 발생했습니다.
	2	알 수 없는 오류가 발생했습니다.
	3	조회 권한이 없습니다.
	4	존재하지 않는 API 입니다.
	5	Parameter 정보가 잘못되었습니다.
	6	날짜는 반드시 입력해야 하며, 세 달을 초과 할 수 없습니다.
OS_CODE	2	iOS
	3	Android
	-1	알수없음

광고주 리포트

Request URL

URL	Method
/S-Plus_api/MAT/getAdverList.xml	Get
/S-Plus_api/MAT/getAdverList.json	Get

Request Parameters

Filed Name	타입	필수	코드 예시	설명
sDate	String	Y	20160101	리포트 조회 시작일
eDate	String	Y	20160131	리포트 조회 종료일
USER	String	Y		메조미디어에서 발급한 고유 ID
Auth_Type	String	Y	mat	mat 구분 값

Response Fields

이름	타입	전달 값 예시	설명
Adver_List_Count	Integer	1	반환되는 리스트 행 수
AdverList.Adver_List	Array
adver_no	Integer	1645	광고주 고유 번호
adver_name	String	광고주	광고주 명
brand_no	Integer	2944	광고주 – 브랜드 고유 번호
brand_name	String	브랜드	광고주 – 브랜드 명
imps	Integer	145	노출 수
click	Integer	561	클릭 수

Response Sample

{
  "error_code": "000",
  "Adver_List_Count": 1,
  "Adver_List": [
    {
      "adver_no": 1645,
      "adver_name": "펀플웍스",
      "brand_no": 2912,
      "brand_name": "완소여단",
      "imps": 51,
      "click": 0
    }
  ]
}

캠페인 리포트

Request URL

URL	Method
/S-Plus_api/MAT/getCampaignList.xml	Get
/S-Plus_api/MAT/getCampaignList.json	Get

Request Parameters

Filed Name	타입	필수	코드 예시	설명
sDate	String	Y	20160101	리포트 조회 시작일
eDate	String	Y	20160131	리포트 조회 종료일
USER	String	Y		메조미디어에서 발급한 고유 ID
Auth_Type	String	Y	mat	mat 구분 값
Adver_No	Integer	Y	1645	광고주 고유 번호
Brand_No	Integer	N	2944	광고주 – 브랜드 고유 번호
Group_Day	Integer	N	1	0 : 일자별 Grouping 안함
				1 : 일자별 Grouping 처리
Group_OS	Integer	N	1	0 : OS 별 Grouping 안함
				1 : OS 별 Grouping 처리

Response Fields

이름	타입	전달 값 예시	설명
Campaign_List_Count	Integer	1	반환되는 리스트 행 수
Campaign_List.Campaign_List	Array
cmp_no	Integer	306	캠페인 고유 번호
cmp_id	String	캠페인 테스트	캠페인 명
app_id_android	String	test.android	앱 ID ( 안드로이드 )
app_id_ios	String	test.ios	앱 ID ( iOS )
cmp_start_date	String	2018-10-01	캠페인 시작 일자
cmp_end_date	String	2018-10-15	캠페인 종료 일자
cmp_budget_total	Integer	515110	캠페인 총 예산
currency	String	KRW	통화 코드
imps	Integer	145	노출 수
click	Integer	561	클릭 수
cost	Integer	1742	소진 금액
day	String	2018-10-01	리포트 일자 (Group_Day 가 1 일 경우 반환)
os_code	String	1	OS 코드 (Group_OS 가 1 일 경우 반환)

Response Sample

{
  "error_code": "000",
  "Campaign_List_Count": 1,
  "Campaign_List": [
    {
      "cmp_no": 306,
      "cmp_id": "20170421_ENP Games_반지_NCPI",
      "app_id_android": "aaa",
      "app_id_ios": "bbb",
      "cmp_start_date": "2017-04-20",
      "cmp_end_date": "2017-08-31",
      "cmp_budget_total": 200000000,
      "currency": "KRW",
      "imps": 0,
      "click": 39580372,
      "cost": 0
    }
  ]
}

광고물 리포트

Request URL

URL	Method
/S-Plus_api/MAT/getADList.xml	Get
/S-Plus_api/MAT/getADList.json	Get

Request Parameters

Filed Name	타입	필수	코드 예시	설명
sDate	String	Y	20160101	리포트 조회 시작일
eDate	String	Y	20160131	리포트 조회 종료일
USER	String	Y		메조미디어에서 발급한 고유 ID
Auth_Type	String	Y	mat	mat 구분 값
Adver_No	Integer	Y	1645	광고주 고유 번호
Cmp_No	Integer	Y	306	캠페인 고유 번호
Group_Day	Integer	N	1	리포트 일자(Group_Day 가 1 일 경우 반환)
Group_OS	Integer	N	1	OS 코드(Group_OS 가 1 일 경우 반환)
Group_Pub	Integer	N	1	퍼블리셔 코드(Group_Pub 이 1 일 경우 반환)

Response Fields

이름	타입	전달 값 예시	설명
AD_Count	Integer	1	반환되는 리스트 행 수
AD_List.AD_List	Array
ads_no	Integer	9502	애드 고유 번호
ads_id	String	광고11	애드 명
img_path	String		광고 소재 경로
landing_url	String	http://www.mezzomedia.co.kr	광고물 랜딩 url
currency	String	KRW	통화 코드
imps	Integer	5151	노출 수
click	Integer	144	클릭 수
cost	Integer	3050	소진 금액
day	String	2018-10-01	리포트 일자 (Group_Day 가 1 일 경우 반환)
os_code	Integer	3	OS 코드 (Group_OS 가 1 일 경우 반환)
section_no	Integer	5	퍼블리셔 코드 (Group_Pub 이 1 일 경우 반환)

Response Sample

{
  "error_code": "000",
  "AD_List_Count": 2,
  "AD_List": [
    {
      "ads_no": 9502,
      "ads_id": "20170421_ENP Games_반지_NCPI_AOS",
      "img_path": "",
      "landing_url": "",
      "currency": "KRW",
      "imps": 0,
      "click": 38725073,
      "cost": 0
    },
    {
      "ads_no": 9503,
      "ads_id": "20170421_ENP Games_반지_NCPI_iOS",
      "img_path": "",
      "landing_url": "",
      "currency": "KRW",
      "imps": 0,
      "click": 855299,
      "cost": 0
    }
  ]
}