> For the complete documentation index, see [llms.txt](https://docs.targetpick.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.targetpick.io/targetpick_eng/report-api/mmp.md).

# MMP(Tracker)

{% hint style="info" %}
도메인 및 API Key는 별도로 제공됩니다.

담당자에게 문의해주세요.
{% endhint %}

## **코드 정의**

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

## **광고주 리포트**

### **Request URL**

| URL                                | Method |
| ---------------------------------- | ------ |
| /S-Plus\_api/MAT/getAdverList.xml  | Get    |
| /S-Plus\_api/MAT/getAdverList.json | Get    |

### **Request Parameters**

<table><thead><tr><th width="174">Filed Name</th><th width="103">타입</th><th width="76">필수</th><th width="122">코드 예시</th><th>설명</th></tr></thead><tbody><tr><td>sDate</td><td>String</td><td>Y</td><td>20160101</td><td>리포트 조회 시작일</td></tr><tr><td>eDate</td><td>String</td><td>Y</td><td>20160131</td><td>리포트 조회 종료일</td></tr><tr><td>USER</td><td>String</td><td>Y</td><td> </td><td>메조미디어에서 발급한 고유 ID</td></tr><tr><td>Auth_Type</td><td>String</td><td>Y</td><td>mat</td><td>mat 구분 값</td></tr></tbody></table>

### **Response Fields**

<table><thead><tr><th width="216">이름</th><th width="147">타입</th><th width="130">전달 값 예시</th><th>설명</th></tr></thead><tbody><tr><td>Adver_List_Count</td><td>Integer</td><td>1</td><td>반환되는 리스트 행 수</td></tr><tr><td>AdverList.Adver_List</td><td>Array</td><td> </td><td> </td></tr><tr><td>adver_no</td><td>Integer</td><td>1645</td><td>광고주 고유 번호</td></tr><tr><td>adver_name</td><td>String</td><td>광고주</td><td>광고주 명</td></tr><tr><td>brand_no</td><td>Integer</td><td>2944</td><td>광고주 – 브랜드 고유 번호</td></tr><tr><td>brand_name</td><td>String</td><td>브랜드</td><td>광고주 – 브랜드 명</td></tr><tr><td>imps</td><td>Integer</td><td>145</td><td>노출 수</td></tr><tr><td>click</td><td>Integer</td><td>561</td><td>클릭 수</td></tr></tbody></table>

#### **Response Sample**

{% code lineNumbers="true" %}

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

{% endcode %}

## **캠페인 리포트**

### **Request URL**

| URL                                   | Method |
| ------------------------------------- | ------ |
| /S-Plus\_api/MAT/getCampaignList.xml  | Get    |
| /S-Plus\_api/MAT/getCampaignList.json | Get    |

### **Request Parameters**

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

### **Response Fields**

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

#### **Response Sample**

{% code lineNumbers="true" %}

```xml
{
  "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
    }
  ]
}
```

{% endcode %}

## **광고물 리포트**

### **Request URL**

| URL                             | Method |
| ------------------------------- | ------ |
| /S-Plus\_api/MAT/getADList.xml  | Get    |
| /S-Plus\_api/MAT/getADList.json | Get    |

### **Request Parameters**

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

#### **Response Fields**

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

#### **Response Sample**

{% code lineNumbers="true" %}

```xml
{
  "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
    }
  ]
}
```

{% endcode %}