> 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/banner.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="571">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              |
| click     | click count           |
| revenue   | 매체수익금 ( 부가세별도 )       |
| …         | 추가적인 값이 있으면 공유부탁드립니다. |

### 예제

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

```json
{
    "data": [
        {
            "pubid": "0338E1B551069026A4EA5B805413E2FD",
            "date": "20181121",
            "request": 1588,
            "imps": 1588,
            "click": 1,
            "revenue": 70
        },
        {
            "pubid": "0338E1B551069026A4EA5B805413E555",
            "date": "20181121",
            "request": 33,
            "imps": 33,
            "click": 1,
            "revenue": 70
        },
        {
            "pubid": "0338E1B551069026A4EA5B805413E666",
            "date": "20181121",
            "request": 44,
            "imps": 55,
            "click": 1,
            "revenue": 70
        },
        ...
    ]
}
```

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