# 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 %}


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.targetpick.io/report-api/mmp.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.