Report API for MAT

6 분 소요

Youngjin Lee

기본정보

도메인 및 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 구분 값
Respose 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 클릭 수
Respose 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 처리
Respose 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 일 경우 반환 )
Respose 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 일 경우 반환 )
Respose 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 일 경우 반환 )
Respose 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
    }
  ]
}

업데이트: