# 대행사

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

캠페인 집행 담당자에게 문의해주세요.
{% endhint %}

## **리스트 타입**

| 리스트명     | ListType |
| -------- | -------- |
| 캠페인 리스트  | C        |
| 광고그룹 리스트 | AG       |
| 광고물 리스트  | AD       |

## **에러코드**

<table><thead><tr><th width="261">코드</th><th>설명</th></tr></thead><tbody><tr><td>000</td><td>성공</td></tr><tr><td>001</td><td>시스템에 에러가 발생했습니다.</td></tr><tr><td>002</td><td>알 수 없는 오류가 발생했습니다.</td></tr><tr><td>003</td><td>조회 권한이 없습니다.</td></tr><tr><td>004</td><td>존재하지 않는 API 입니다.</td></tr><tr><td>005</td><td>Parameter 정보가 잘못되었습니다.</td></tr><tr><td>006</td><td>날짜는 반드시 입력해야 하며, 세 달을 초과 할 수 없습니다.</td></tr></tbody></table>

## **전체 캠페인 목록**

### **Request URL**

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

### **Request Parameters**

| 이름         | 타입      | 기본값 | 코드 예시    | 설명        |
| ---------- | ------- | --- | -------- | --------- |
| USER       | String  | Y   | XXXXXX   | ID 암호화    |
| Auth\_Type | String  | Y   | agy      | 권한        |
| sDate      | Integer | Y   | 20160101 | 캠페인 시작 일자 |
| eDate      | Integer | Y   | 20160131 | 캠페인 종료 일자 |

### **Response Fields**

<table><thead><tr><th width="259">이름</th><th width="116">타입</th><th width="164">코드 예시</th><th>설명</th></tr></thead><tbody><tr><td>AllCam_Count</td><td>Integer</td><td>100</td><td>반환되는 리스트 행 수</td></tr><tr><td>AllCampaigns.AllCampaign</td><td> </td><td> </td><td> </td></tr><tr><td>AllCam_No</td><td>Integer</td><td>12345</td><td>캠페인ID</td></tr><tr><td>AllCam_Status</td><td>String</td><td>1</td><td>0: 준비<br>1: 진행<br>2: 중지<br>3: 완료<br>4: 삭제</td></tr><tr><td>AllCam_Name</td><td>String</td><td>메조_테스트캠페인</td><td>캠페인명</td></tr><tr><td>AllCam_sDate</td><td>String</td><td>2016-01-01 00:00</td><td>캠페인 시작일</td></tr><tr><td>AllCam_eDate</td><td>String</td><td>2016-01-01 00:00</td><td>캠페인 종료일</td></tr><tr><td>AllCam_Imp</td><td>Integer</td><td>1000</td><td>노출</td></tr><tr><td>AllCam_ImpP</td><td>Integer</td><td>1000</td><td>노출+</td></tr><tr><td>AllCam_Click</td><td>Integer</td><td>1000</td><td>클릭</td></tr><tr><td>AllCam_CTR</td><td>Integer</td><td>1000</td><td>노출 대비 클릭</td></tr><tr><td>AllCam_CTRP</td><td>Integer</td><td>1000</td><td>노출+ 대비 클릭</td></tr><tr><td>AllCam_CV</td><td>Integer</td><td>1000</td><td>전환 수</td></tr><tr><td>AllCam_CVR</td><td>Integer</td><td>1000</td><td>클릭 대비 전환율(%)</td></tr></tbody></table>

### **Response Sample**

{% code lineNumbers="true" %}

```xml
<?xml version="1.0" encoding="utf-8" ?>
<message>
     <error>
           <code>000</code>
           <message>성공</message>
     </error>
        <result>
                <AllCamCount>10</AllCamCount> 
                <AllCampaigns>
                        <AllCampain>
                                <AllCam_No>1234</AllCam_No>
                                <AllCam_Status>1</AllCam_Status>
                                <AllCam_Name>메조_테스트캠페인</AllCam_Name>
                                <AllCam_sDate> 2016-01-01 00:00</AllCam_sDate>
                                <AllCam_eDate> 2016-01-01 00:00 </AllCam_eDate>
                                <AllCam_Imp> 1000 </AllCam_Imp>
                                <AllCam_ImpP> 1000 </AllCam_ImpP>
                                <AllCam_Click> 1000 </AllCam_Click>
                                <AllCam_CTR> 1000 </AllCam_CTR>
                                <AllCam_CTRP> 1000 </AllCam_CTRP>
                                <AllCam_CV> 1000 </AllCam_CV>
                                <AllCam_CVR> 1000 </AllCam_CVR>
                        </AllCampain>
                        <AllCampain>
                            ……
                        </AllCampain>
                </AllCampaigns>
        </result>
</message>
```

{% endcode %}

## **캠페인 목록**

### **Request URL**

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

### **Request Parameters**

| 이름         | 타입      | 기본값 | 코드 예시    | 설명        |
| ---------- | ------- | --- | -------- | --------- |
| USER       | String  | Y   | XXXXXX   | ID 암호화    |
| Auth\_Type | String  | Y   | agy      | 권한        |
| Cam\_No    | Integer | Y   | 12345    | 캠페인ID     |
| sDate      | Integer | Y   | 20160101 | 캠페인 시작 일자 |
| eDate      | Integer | Y   | 20160131 | 캠페인 종료 일자 |

### **Response Fields**

<table><thead><tr><th width="215">이름</th><th width="113">타입</th><th>코드 예시</th><th>설명</th></tr></thead><tbody><tr><td>Cam_Count</td><td>Integer</td><td>100</td><td>반환되는 리스트 행 수</td></tr><tr><td>Cam_Name</td><td>String</td><td>메조_테스트캠페인</td><td>캠페인명</td></tr><tr><td>CamInfo_Goal</td><td>Integer</td><td>100</td><td>캠페인 목표량</td></tr><tr><td>CamInfo_sDate</td><td>Integer</td><td>2016-01-01 0:00</td><td>캠페인 시작일</td></tr><tr><td>CamInfo_eDate</td><td>String</td><td>2016-01-01 0:00</td><td>캠페인 종료일</td></tr><tr><td>CamInfo_Status</td><td>String</td><td>1</td><td>0: 준비<br>1: 진행<br>2: 중지<br>3: 완료<br>4: 삭제</td></tr><tr><td>CamInfo_tBudjet</td><td>Integer</td><td>10000000</td><td>캠페인 총 예산</td></tr><tr><td>CamInfo_Brand</td><td>String</td><td>메조몰</td><td>캠페인 브랜드</td></tr><tr><td>CamInfo_Category</td><td>String</td><td>유통/유통기타</td><td>캠페인 카테고리</td></tr><tr><td>CamInfo_Agency</td><td>String</td><td>제일기획</td><td>캠페인 대행사</td></tr><tr><td>CamInfo_Agency2</td><td>String</td><td>이노션</td><td>캠페인 대대행사</td></tr><tr><td>CamInfo_Rep</td><td>String</td><td>메조미디어</td><td>캠페인 렙사</td></tr><tr><td>Campaigns.Campaign</td><td> </td><td> </td><td> </td></tr><tr><td>Cam_Daily</td><td>String</td><td>2016-01-01</td><td>일자</td></tr><tr><td>Cam_Imp</td><td>Integer</td><td>1000</td><td>노출</td></tr><tr><td>Cam_Click</td><td>Integer</td><td>1000</td><td>클릭</td></tr><tr><td>Cam_CTR</td><td>Integer</td><td>1000</td><td>노출 대비 클릭</td></tr><tr><td>Cam_CPC</td><td>Integer</td><td>1000</td><td>CPC 단가</td></tr><tr><td>Cam_CPM</td><td>Integer</td><td>1000</td><td>CPM 단가</td></tr><tr><td>Cam_CPV</td><td>Integer</td><td>1000</td><td>CPV 단가</td></tr></tbody></table>

### **Response Sample**

{% code lineNumbers="true" %}

```xml
<?xml version="1.0" encoding="utf-8" ?>
<message>
     <error>
           <code>000</code>
           <message>성공</message>
     </error>
        <result>
                <Cam_Count>10</Cam_Count> 
                <Cam_Name>메조미디어 캠페인</Cam_Name> 
                <CamInfo_sDate>2016-06-01</CamInfo_sDate> 
                <CamInfo_eDate>2016-06-31</CamInfo_eDate> 
                <CamInfo_Status>1</CamInfo_Status> 
                <CamInfo_tBudjet>10000</CamInfo_tBudjet> 
                <CamInfo_Brand>메조브랜드</CamInfo_Brand> 
                <CamInfo_Category>가정용품/주방용품</CamInfo_Category> 
                <CamInfo_Agency>제일기획</CamInfo_Agency> 
                <CamInfo_Agency2>이노션</CamInfo_Agency2> 
                <CamInfo_Rep>메조미디어</CamInfo_Rep> 
                <AllCampaigns>
                        <AllCampain>
                                <AllCam_No>1234</AllCam_No>
                                <AllCam_Status>1</AllCam_Status>
                                <AllCam_Name>메조_테스트캠페인</AllCam_Name>
                                <AllCam_sDate> 2016-01-01 00:00</AllCam_sDate>
                                <AllCam_eDate> 2016-01-01 00:00 </AllCam_eDate>
                                <AllCam_Imp> 1000 </AllCam_Imp>
                                <AllCam_ImpP> 1000 </AllCam_ImpP>
                                <AllCam_Click> 1000 </AllCam_Click>
                                <AllCam_CTR> 1000 </AllCam_CTR>
                                <AllCam_CTRP> 1000 </AllCam_CTRP>
                                <AllCam_CV> 1000 </AllCam_CV>
                                <AllCam_CVR> 1000 </AllCam_CVR>
                        </AllCampain>
                        <AllCampain>
                            ……
                        </AllCampain>
                </AllCampaigns>
        </result>
</message>
```

{% endcode %}

## **광고 그룹 목록**

### **Request URL**

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

### **Request Parameters**

#### **Main Request**

캠페인 목록 API를 통해 반환된 Cam\_No를 이용하여 해당 캠페인 하위에 포함되어 있는 광고그룹 목록을 요청합니다.

| 이름         | 타입      | 기본값 | 코드 예시    | 설명        |
| ---------- | ------- | --- | -------- | --------- |
| USER       | String  | Y   | XXXXXX   | ID 암호화    |
| Auth\_Type | String  | Y   | agy      | 권한        |
| Cam\_No    | Integer | Y   | 12345    | 캠페인ID     |
| sDate      | Integer | Y   | 20160101 | 기간 조회 시작일 |
| eDate      | String  | Y   | 20160130 | 기간 조회 종료일 |
| AGP        | Integer | N   | 00001    | 광고그룹 목록 수 |

#### **Sub Request**

Main Request를 통해 반환된 AG\_No와 AG\_Product\_Type을 이용하여 해당 광고그룹의 상세 리포트를 요청합니다.

<table><thead><tr><th width="187">이름</th><th width="115">타입</th><th width="102">기본값</th><th width="127">코드 예시</th><th>설명</th></tr></thead><tbody><tr><td>USER</td><td>String</td><td>Y</td><td>XXXXXX</td><td>ID 암호화</td></tr><tr><td>Auth_Type</td><td>String</td><td>Y</td><td>agy</td><td>권한</td></tr><tr><td>sDate</td><td>Integer</td><td>Y</td><td>20160101</td><td>기간 조회 시작일</td></tr><tr><td>eDate</td><td>String</td><td>Y</td><td>20160130</td><td>기간 조회 종료일</td></tr><tr><td>Cam_No</td><td>Integer</td><td>Y</td><td>12345</td><td>캠페인ID</td></tr><tr><td>AG_No</td><td>Integer</td><td>Y</td><td>00001</td><td>광고그룹ID</td></tr><tr><td>AG_Product_Type</td><td>String</td><td>Y</td><td>banner</td><td>banner, movie, native</td></tr></tbody></table>

### **Response Fields**

#### **Main Response**

<table><thead><tr><th width="198">이름</th><th width="105">타입</th><th>코드 예시</th><th>설명</th></tr></thead><tbody><tr><td>AG_Count</td><td>Integer</td><td>100</td><td>반환되는 리스트 행 수</td></tr><tr><td>ADGroups.ADGroup</td><td> </td><td> </td><td> </td></tr><tr><td>AG_No</td><td>Integer</td><td>00001</td><td>광고그룹ID</td></tr><tr><td>AG_Name</td><td>String</td><td>메조_테스트_띠배너</td><td>광고그룹명</td></tr><tr><td>AG_Status</td><td>String</td><td>1</td><td>0: 준비<br>1: 진행<br>2: 중지<br>3: 완료<br>4: 삭제</td></tr><tr><td>AG_Product_Type</td><td>String</td><td>Banner</td><td>banner, movie, native</td></tr><tr><td>AG_Product</td><td>String</td><td>배너_320X50</td><td>광고상품명</td></tr><tr><td>AG_Imp</td><td>String</td><td>1000</td><td>노출</td></tr><tr><td>AG_ImpP</td><td>String</td><td>1000</td><td>노출+</td></tr><tr><td>AG_Click</td><td>String</td><td>1000</td><td>클릭</td></tr><tr><td>AG_CTR</td><td>String</td><td>1000</td><td>노출 대비 클릭</td></tr><tr><td>AG_CTRP</td><td>String</td><td>1000</td><td>노출+ 대비 클릭</td></tr><tr><td>AG_CV</td><td>String</td><td>1000</td><td>전환 수</td></tr><tr><td>AG_CVR</td><td>String</td><td>1000</td><td>클릭 대비 전환율(%)</td></tr></tbody></table>

#### **Sub Response**

AG\_Product\_Type 이 banner 일 경우

<table><thead><tr><th width="315">이름</th><th width="94">타입</th><th width="165">코드 예시</th><th>설명</th></tr></thead><tbody><tr><td>AG_Sub_B_Count</td><td>Integer</td><td>100</td><td>반환되는 리스트 행 수</td></tr><tr><td>ADGroups_Sub_B.ADGroup_Sub_B</td><td> </td><td> </td><td> </td></tr><tr><td>Cam_No</td><td>Integer</td><td>12345</td><td>캠페인ID</td></tr><tr><td>AG_No</td><td>Integer</td><td>12345</td><td>광고그룹ID</td></tr><tr><td>AG_Sub_Date</td><td>String</td><td>2016-01-01 00:00</td><td>일자</td></tr><tr><td>AG_Sub_Imp</td><td>String</td><td>1000</td><td>노출</td></tr><tr><td>AG_Sub_Click</td><td>String</td><td>1000</td><td>클릭</td></tr><tr><td>AG_Sub_CTR</td><td>String</td><td>1000</td><td>노출 대비 클릭</td></tr><tr><td>AG_Sub_CV</td><td>String</td><td>1000</td><td>전환 수</td></tr><tr><td>AG_Sub_CVR</td><td>String</td><td>1000</td><td>클릭 대비 전환율(%)</td></tr></tbody></table>

AG\_Product\_Type 이 movie 일 경우

| 이름                               | 타입      | 코드 예시            | 설명               |
| -------------------------------- | ------- | ---------------- | ---------------- |
| AG\_Sub\_M\_Count                | Integer | 100              | 반환되는 리스트 행 수     |
| ADGroups\_Sub\_M.ADGroup\_Sub\_M |         |                  |                  |
| Cam\_No                          | Integer | 12345            | 캠페인ID            |
| AG\_No                           | Integer | 12345            | 광고그룹ID           |
| AG\_Sub\_Date                    | String  | 2016-01-01 00:00 | 일자               |
| AG\_Sub\_Imp                     | Integer | 1000             | 노출               |
| AG\_Sub\_ImpP                    | Integer | 1000             | 노출+              |
| AG\_Sub\_View                    | Integer | 1000             | 시청               |
| AG\_Sub\_Click                   | Integer | 1000             | 클릭               |
| AG\_Sub\_CTR                     | Integer | 1000             | 노출 대비 클릭         |
| AG\_Sub\_CTRP                    | Integer | 1000             | 노출+(15초) 대비 클릭   |
| AG\_Sub\_VTR                     | Integer | 1000             | 노출당 시청 비율        |
| AG\_Sub\_VTRP                    | Integer | 1000             | 노출+(15초)당 시청 비율  |
| AG\_Sub\_CVTR                    | Integer | 1000             | 노출당 재생+클릭        |
| AG\_Sub\_CVTRP                   | Integer | 1000             | 노출+(15초)당 재생+클릭  |
| AG\_Sub\_Start                   | Integer | 1000             | 동영상 시작시 노출 수     |
| AG\_Sub\_1Q                      | Integer | 1000             | 동영상 25% 재생시 노출 수 |
| AG\_Sub\_2Q                      | Integer | 1000             | 동영상 50% 재생시 노출 수 |
| AG\_Sub\_3Q                      | Integer | 1000             | 동영상 75% 재생시 노출 수 |
| AG\_Sub\_Complete                | Integer | 1000             | 동영상 재생 종료시 노출 수  |
| AG\_Sub\_CV                      | String  | 1000             | 전환 수             |
| AG\_Sub\_CVR                     | String  | 1000             | 클릭 대비 전환율(%)     |

### **Response Sample**

#### **Main Response Sample**

{% code lineNumbers="true" %}

```xml
<?xml version="1.0" encoding="utf-8"?>
<message>
    <error>
        <code>000</code>
        <message>성공</message>
    </error>
    <result>
        <AG_Count>10</AG_Count>
        <ADGroups>
            <ADGroup>
                <AG_No>1234</AG_No>
                <AG_Name>메조_테스트_띠배너</AG_Name>
                <AG_Status>1</AG_Status>
                <AG_Product_Type>banner</AG_Product_Type>
                <AG_Product>배너_320X50</AG_Product>
                <AG_Imp>1000</AG_Imp>
                <AG_ImpP>1000</AG_ImpP>
                <AG_Click>1000</AG_Click>
                <AG_CTR>1000</AG_CTR>
                <AG_CTRP>1000</AG_CTRP>
                <AG_CV>1000</AG_CV>
                <AG_CVR>1000</AG_CVR>
            </ADGroup>
            <ADGroup>
                ……
            </ADGroup>
        </ADGroups>
    </result>
</message>
```

{% endcode %}

#### **Sub Response Sample**

AG\_Product\_Type 이 banner 일 경우

{% code lineNumbers="true" %}

```xml
<?xml version="1.0" encoding="utf-8"?>
<message>
    <error>
        <code>000</code>
        <message>성공</message>
    </error>
    <result>
        <AG_Sub_B_Count>10</AG_Sub_B_Count>
        <ADGroups_Sub_B>
            <ADGroup_Sub_B>
                <Cam_No>1234 </Cam_No>
                <AG_No>12345</AG_No>
                <AG_Sub_Date>2016-01-01 00:00</AG_Sub_Date>
                <AG_Sub_Imp>1000</AG_Sub_Imp>
                <AG_Sub_Click>1000</AG_Sub_Click>
                <AG_Sub_CTR>1000</AG_Sub_CTR>
                <AG_Sub_CV>1000</AG_Sub_CV>
                <AG_Sub_CVR>1000</AG_Sub_CVR>
            </ADGroup_Sub_B>
            <ADGroup_Sub_B>
                ……
            </ADGroup_Sub_B>
        </ADGroups_Sub_B>
    </result>
</message>
```

{% endcode %}

AG\_Product\_Type 이 movie 일 경우

{% code lineNumbers="true" %}

```xml
<?xml version="1.0" encoding="utf-8"?>
<message>
    <error>
        <code>000</code>
        <message>성공</message>
    </error>
    <result>
        <AG_Sub_M_Count>10</AG_Sub_M_Count>
        <ADGroups_Sub_M>
            <ADGroup_Sub_M>
                <Cam_No>1234</Cam_No>
                <AG_No>12345</AG_No>
                <AG_Sub_Date>2016-01-01 00:00</AG_Sub_Date>
                <AG_Sub_Imp>1000</AG_Sub_Imp>
                <AG_Sub_ImpP>1000</AG_Sub_ImpP>
                <AG_Sub_View>1000</AG_Sub_View>
                <AG_Sub_Click>1000</AG_Sub_Click>
                <AG_Sub_CTR>1000</AG_Sub_CTR>
                <AG_Sub_CTRP>1000</AG_Sub_CTRP>
                <AG_Sub_VTR>1000</AG_Sub_VTR>
                <AG_Sub_VTRP>1000</AG_Sub_VTRP>
                <AG_Sub_CVR>1000</AG_Sub_CVR>
                <AG_Sub_CVTR>1000</AG_Sub_CVTR>
                <AG_Sub_CVTRP>1000</AG_Sub_CVTRP>
                <AG_Sub_Start>1000</AG_Sub_Start>
                <AG_Sub_1Q>1000</AG_Sub_1Q>
                <AG_Sub_2Q>1000</AG_Sub_2Q>
                <AG_Sub_3Q>1000</AG_Sub_3Q>
                <AG_Sub_Complete>1000</AG_Sub_Complete>
            </ADGroup_Sub_M>
            <ADGroup_Sub_M>
                ……
            </ADGroup_Sub_M>
        </ADGroups_Sub_M>
    </result>
</message>
```

{% endcode %}

## **광고물 목록**

### **Request URL**

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

### **Request Parameters**

#### **Main Request**

캠페인 목록 API를 통해 반환된 Cam\_No를 이용하여 해당 캠페인 하위에 포함되어 있는 광고그룹 목록을 요청합니다.

| 이름         | 타입      | 기본값 | 코드 예시    | 설명        |
| ---------- | ------- | --- | -------- | --------- |
| USER       | String  | Y   | XXXXXX   | ID 암호화    |
| Auth\_Type | String  | Y   | agy      | 권한        |
| Cam\_No    | Integer | Y   | 12345    | 캠페인ID     |
| sDate      | Integer | Y   | 20160101 | 기간 조회 시작일 |
| eDate      | String  | Y   | 20160130 | 기간 조회 종료일 |
| ADP        | Integer | N   | 00001    | 광고그룹 목록 수 |

#### **Sub Request**

Main Request를 통해 반환된 AD\_No와 AD\_Product\_Type을 이용하여 해당 광고그룹의 상세 리포트를 요청합니다.

<table><thead><tr><th width="187">이름</th><th width="115">타입</th><th width="81">기본값</th><th width="127">코드 예시</th><th>설명</th></tr></thead><tbody><tr><td>USER</td><td>String</td><td>Y</td><td>XXXXXX</td><td>ID 암호화</td></tr><tr><td>Auth_Type</td><td>String</td><td>Y</td><td>XXXXXXX</td><td>권한</td></tr><tr><td>sDate</td><td>Integer</td><td>Y</td><td>20160101</td><td>기간 조회 시작일</td></tr><tr><td>eDate</td><td>String</td><td>Y</td><td>20160130</td><td>기간 조회 종료일</td></tr><tr><td>Cam_No</td><td>Integer</td><td>Y</td><td>12345</td><td>캠페인ID</td></tr><tr><td>AD_No</td><td>Integer</td><td>Y</td><td>00001</td><td>광고그룹ID</td></tr><tr><td>AD_Product_Type</td><td>String</td><td>Y</td><td>banner</td><td>banner, movie, native</td></tr></tbody></table>

### **Response Fields**

#### **Main Response**

<table><thead><tr><th width="190">이름</th><th width="90">타입</th><th width="252">코드 예시</th><th>설명</th></tr></thead><tbody><tr><td>AD_Count</td><td>Integer</td><td>100</td><td>반환되는 리스트 행 수</td></tr><tr><td>ADs.AD</td><td> </td><td> </td><td> </td></tr><tr><td>AD_No</td><td>Integer</td><td>1</td><td>광고물  ID</td></tr><tr><td>AD_Name</td><td>String</td><td>메조_테스트_띠배너</td><td>광고물명</td></tr><tr><td>AD_Status</td><td>String</td><td>1</td><td>0: 준비<br>1: 진행<br>2: 중지<br>3: 완료<br>4: 삭제</td></tr><tr><td>AD_Product_Type</td><td>String</td><td>Banner</td><td>banner, movie, native</td></tr><tr><td>AD_Product</td><td>String</td><td>배너_320X50</td><td>광고상품명</td></tr><tr><td>AD_imgURL</td><td>String</td><td>http://www.a.com/image.jpg</td><td>이미지 배너 소재 경로</td></tr><tr><td>AD_movieURL</td><td>String</td><td>http://www.a.com/movie.mp4</td><td>동영상 소재 경로</td></tr><tr><td>AD_Imp</td><td>String</td><td>1000</td><td>노출</td></tr><tr><td>AD_ImpP</td><td>String</td><td>1000</td><td>노출+</td></tr><tr><td>AD_Click</td><td>String</td><td>1000</td><td>클릭</td></tr><tr><td>AD_CTR</td><td>String</td><td>1000</td><td>노출 대비 클릭</td></tr><tr><td>AD_CTRP</td><td>String</td><td>1000</td><td>노출+ 대비 클릭</td></tr><tr><td>AD_CV</td><td>String</td><td>1000</td><td>전환 수</td></tr><tr><td>AD_CVR</td><td>String</td><td>1000</td><td>클릭 대비 전환율(%)</td></tr></tbody></table>

#### **Sub Response**

AD\_Product\_Type 이 banner 일 경우

| 이름                     | 타입      | 코드 예시            | 설명           |
| ---------------------- | ------- | ---------------- | ------------ |
| AD\_Sub\_B\_Count      | Integer | 100              | 반환되는 리스트 행 수 |
| ADs\_Sub\_B.AD\_Sub\_B |         |                  |              |
| Cam\_No                | Integer | 12345            | 캠페인ID        |
| AD\_No                 | Integer | 12345            | 광고물 ID       |
| AD\_Sub\_Date          | String  | 2016-01-01 00:00 | 일자           |
| AD\_Sub\_Imp           | String  | 1000             | 노출           |
| AD\_Sub\_Click         | String  | 1000             | 클릭           |
| AD\_Sub\_CTR           | String  | 1000             | 노출 대비 클릭     |
| AD\_Sub\_CV            | String  | 1000             | 전환 수         |
| AD\_Sub\_CVR           | String  | 1000             | 클릭 대비 전환율(%) |

AD\_Product\_Type 이 movie 일 경우

| 이름                     | 타입      | 코드 예시            | 설명               |
| ---------------------- | ------- | ---------------- | ---------------- |
| AD\_Sub\_M\_Count      | Integer | 100              | 반환되는 리스트 행 수     |
| ADs\_Sub\_M.AD\_Sub\_M |         |                  |                  |
| Cam\_No                | Integer | 12345            | 캠페인ID            |
| AD\_No                 | Integer | 12345            | 광고물 ID           |
| AD\_Sub\_Date          | String  | 2016-01-01 00:00 | 일자               |
| AD\_Sub\_Imp           | Integer | 1000             | 노출               |
| AD\_Sub\_ImpP          | Integer | 1000             | 노출+              |
| AD\_Sub\_View          | Integer | 1000             | 시청               |
| AD\_Sub\_Click         | Integer | 1000             | 클릭               |
| AD\_Sub\_CTR           | Integer | 1000             | 노출 대비 클릭         |
| AD\_Sub\_CTRP          | Integer | 1000             | 노출+(15초) 대비 클릭   |
| AD\_Sub\_VTR           | Integer | 1000             | 노출당 시청 비율        |
| AD\_Sub\_VTRP          | Integer | 1000             | 노출+(15초)당 시청 비율  |
| AD\_Sub\_CVTR          | Integer | 1000             | 노출당 재생+클릭        |
| AD\_Sub\_CVTRP         | Integer | 1000             | 노출+(15초)당 재생+클릭  |
| AD\_Sub\_Start         | Integer | 1000             | 동영상 시작시 노출 수     |
| AD\_Sub\_1Q            | Integer | 1000             | 동영상 25% 재생시 노출 수 |
| AD\_Sub\_2Q            | Integer | 1000             | 동영상 50% 재생시 노출 수 |
| AD\_Sub\_3Q            | Integer | 1000             | 동영상 75% 재생시 노출 수 |
| AD\_Sub\_Complete      | Integer | 1000             | 동영상 재생 종료시 노출 수  |
| AD\_Sub\_CV            | String  | 1000             | 전환 수             |
| AD\_Sub\_CVR           | String  | 1000             | 클릭 대비 전환율(%)     |

### **Response Sample**

#### **Main Response Sample**

{% code lineNumbers="true" %}

```xml
<?xml version="1.0" encoding="utf-8"?>
<message>
    <error>
        <code>000</code>
        <message>성공</message>
    </error>
    <result>
        <AD_Count>10</AD_Count>
        <ADs>
            <AD>
                <AD_No>1234</AD_No>
                <AD_Name>메조_테스트_띠배너</AD_Name>
                <AD_Status>1</AD_Status>
                <AD_Product_Type>banner</AD_Product_Type>
                <AD_Product>배너_320X50</AD_Product>
                <AD_imgURL>http://www.a.com/image.jpg</AD_imgURL>
                <AD_MovieURL>http://www.a.com/movie.mp4</AD_MovieURL>
                <AD_Imp>1000</AD_Imp>
                <AD_ImpP>1000</AD_ImpP>
                <AD_Click>1000</AD_Click>
                <AD_CTR>1000</AD_CTR>
                <AD_CTRP>1000</AD_CTRP>
                <AD_CV>1000</AD_CV>
                <AD_CVR>1000</AD_CVR>
            </AD>
            <AD>
                ……
            </AD>
        </ADs>
    </result>
</message>
```

{% endcode %}

#### **Sub Response Sample**

AG\_Product\_Type 이 banner 일 경우

{% code lineNumbers="true" %}

```xml
<?xml version="1.0" encoding="utf-8"?>
<message>
    <error>
        <code>000</code>
        <message>성공</message>
    </error>
    <result>
        <AD_Sub_B_Count>10</AD_Sub_B_Count>
        <ADs_Sub_B>
            <AD_Sub_B>
                <Cam_No>1234 </Cam_No>
                <AD_No>12345</AD_No>
                <AD_Sub_Date>2016-01-01 00:00</AD_Sub_Date>
                <AD_Sub_Imp>1000</AD_Sub_Imp>
                <AD_Sub_Click>1000</AD_Sub_Click>
                <AD_Sub_CTR>1000</AD_Sub_CTR>
                <AD_Sub_CV>1000</AD_Sub_CV>
                <AD_Sub_CVR>1000</AD_Sub_CVR>
            </AD_Sub_B>
            <AD_Sub_B>
                ……
            </AD_Sub_B>
        </ADs_Sub_B>
    </result>
</message>
```

{% endcode %}

AG\_Product\_Type이 movie 일 경우

{% code lineNumbers="true" %}

```xml
<?xml version="1.0" encoding="utf-8"?>
<message>
    <error>
        <code>000</code>
        <message>성공</message>
    </error>
    <result>
        <AD_Sub_M_Count>10</AD_Sub_M_Count>
        <ADs_Sub_M>
            <AD_Sub_M>
                <Cam_No>1234</Cam_No>
                <AD_No>12345</AD_No>
                <AD_Sub_Date>2016-01-01 00:00</AD_Sub_Date>
                <AD_Sub_Imp>1000</AD_Sub_Imp>
                <AD_Sub_ImpP>1000</AD_Sub_ImpP>
                <AD_Sub_View>1000</AD_Sub_View>
                <AD_Sub_Click>1000</AD_Sub_Click>
                <AD_Sub_CTR>1000</AD_Sub_CTR>
                <AD_Sub_CTRP>1000</AD_Sub_CTRP>
                <AD_Sub_VTR>1000</AD_Sub_VTR>
                <AD_Sub_VTRP>1000</AD_Sub_VTRP>
                <AD_Sub_CVR>1000</AD_Sub_CVR>
                <AD_Sub_CVTR>1000</AD_Sub_CVTR>
                <AD_Sub_CVTRP>1000</AD_Sub_CVTRP>
                <AD_Sub_Start>1000</AD_Sub_Start>
                <AD_Sub_1Q>1000</AD_Sub_1Q>
                <AD_Sub_2Q>1000</AD_Sub_2Q>
                <AD_Sub_3Q>1000</AD_Sub_3Q>
                <AD_Sub_Complete>1000</AD_Sub_Complete>
            </AD_Sub_M>
            <AD_Sub_M>
                ……
            </AD_Sub_M>
        </ADs_Sub_M>
    </result>
</message>
```

{% endcode %}