> 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/rep.md).

# 미디어렙사

{% 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   | rep      | 권한        |
| 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   | rep      | 권한        |
| 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   | rep      | 권한        |
| 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>rep</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   | rep      | 권한        |
| 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 %}


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## 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, and the optional `goal` query parameter:

```
GET https://docs.targetpick.io/targetpick_eng/report-api/rep.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

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.