> 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/for-dsp/report-api/video.md).

# 비디오 광고 리포트

{% hint style="info" %}
SSP :arrow\_right: DSP
{% endhint %}

CJ 메조미디어 SSP는 DSP에게 Report api를 아래와 같이 호출합니다.\
SSP에게 전달하는 response는 json array형태이며, 대소문자 구분합니다. DSP API를 호출할 때 별도 주의할 점이나 추가사항이 있으시면 연동 협의를 진행할 때 공유해주시기 바랍니다.

## **1. API 호출 URL**

| request Url          | Description                |
| -------------------- | -------------------------- |
| http\://{DSP domain} | 자사에서 호출 가능한 DSP 매체 api url |

### **API Request 파라미터 구성**

| Parameter | Scope    | Description                      | Sample     |
| --------- | -------- | -------------------------------- | ---------- |
| key       | optional | dsp에서 ssp 별로 정의가 필요하시면 사용하시면됩니다. | 44800908   |
| sdate     | required | 일자별 검색할 시작일(yyyy-mm-dd)          | 2019-01-01 |
| edate     | required | 일자별 검색할 종료일(yyyy-mm-dd)          | 2019-01-01 |

### **Report API Sample**

<table><thead><tr><th width="576">Sample url</th><th>Description</th></tr></thead><tbody><tr><td>{DSP URL}?key={keyvalue}&#x26;sdate=2018-09-30&#x26;edate=2018-10-03</td><td>key값이 있을 경우</td></tr><tr><td>{DSP URL}?sdate=2018-09-30&#x26;edate=2018-10-03</td><td>key값이 없을 경우</td></tr></tbody></table>

## **2. API Response 구성**

| Parameter | Description           |
| --------- | --------------------- |
| date      | 해당일(2018-10-02)       |
| pubid     | 대상 site ID 또는 app ID  |
| request   | 요청 count              |
| imps      | 노출 count              |
| view      | 시청 count              |
| q1        | start count           |
| q2        | firstQuartile count   |
| q3        | midpoint count        |
| q4        | thirdQuartile count   |
| q5        | complete count        |
| click     | click count           |
| revenue   | 매체수익금 ( 부가세별도 )       |
| …         | 추가적인 값이 있으면 공유부탁드립니다. |

### 예제

{% tabs %}
{% tab title="Response" %}
{% code lineNumbers="true" %}

```json
{
    "data" :[ 
        {
            "date":"20181017",
            "pubid":"da123dfd45645",
            "request":333,
            "imps":333,
            "view":333,
            "q1":333,
            "q2":333,
            "q3":333,
            "q4":333,
            "q5":333,
            "click":333,
            "revenue":333
        },
        ...
    ]
}
```

{% endcode %}
{% endtab %}
{% endtabs %}