# 쿠팡 API - Report



## URL

* https://sspi-ext-report.adpopcorn.com/v1/analytics/data



## Method

* GET



## Request Headers

<table><thead><tr><th width="154">Name</th><th width="79">Type</th><th width="153">Value</th><th width="69" align="center">필수</th><th>설명</th></tr></thead><tbody><tr><td>Authorization</td><td>string</td><td>Bearer ${access_token}</td><td align="center"><mark style="color:red;">Y</mark></td><td>생성된 액세스 토큰을 ${access_token} 자리에 넣어 인증에 사용하세요.</td></tr></tbody></table>

예시 : curl “https://sspi-ext-report.adpopcorn.com/v1/analytics/data?fromDate=20220101\&toDate=20220101” -H “Authorization: Bearer test\_access\_token” -L



## Parameter

<table><thead><tr><th width="156">Parameter</th><th width="83">Type</th><th width="65">필수</th><th>설명</th></tr></thead><tbody><tr><td>fromDate</td><td>string</td><td><mark style="color:red;">Y</mark></td><td>시작일</td></tr><tr><td>toDate</td><td>string</td><td><mark style="color:red;">Y</mark></td><td>종료일</td></tr><tr><td>reportTypeId</td><td>int</td><td>N</td><td>리포트 타입</td></tr></tbody></table>

<table><thead><tr><th width="151">reportTypeId</th><th>설명</th></tr></thead><tbody><tr><td>1</td><td>sub_id 별 리포트 (default)</td></tr><tr><td>2</td><td>sub_id 별 publisher_id를 구분한 리포트. 단, 클릭 데이터가 제공되지 않음</td></tr><tr><td>3</td><td>쿠팡 리포트 API를 통해 수집된 데이터. 전일 데이터는 익일 오후 12시 30분 이후 조회 가능</td></tr><tr><td>4</td><td>sub_id 별 sub_param을 구분한 리포트.</td></tr></tbody></table>



## Content-Type

* application/json



## Response parameter

<table><thead><tr><th width="188">Body parameter</th><th width="142">Type</th><th>설명</th></tr></thead><tbody><tr><td>alert</td><td>string</td><td>서버에서 전송된 알림 메시지. 대부분의 경우 null일 것입니다. 예시: "alert": null</td></tr><tr><td>records</td><td>Array of object</td><td>리포트 데이터</td></tr></tbody></table>

<table><thead><tr><th width="201">records</th><th width="130">Type</th><th>설명</th></tr></thead><tbody><tr><td>report_date</td><td>string</td><td>날짜</td></tr><tr><td>sub_id</td><td>string</td><td>sub id</td></tr><tr><td>publisher_id</td><td>string</td><td>publisher id (reportTypeId: 2 에서만 제공)</td></tr><tr><td>click</td><td>numeric</td><td>클릭 수 (reportTypeId: 1, 3 에서만 제공)</td></tr><tr><td>conversion</td><td>numeric</td><td>전환 수</td></tr><tr><td>conversion_revenue</td><td>numeric</td><td>전환 비용</td></tr><tr><td>cancel</td><td>numeric</td><td>취소 수</td></tr><tr><td>cancel_revenue</td><td>numeric</td><td>취소 비용</td></tr><tr><td>total_revenue</td><td>numeric</td><td>총 revenue</td></tr></tbody></table>



{% tabs %}
{% tab title="200" %}
{% code title="json" %}
```json
{
	"alert": null,
	"records": [
		{
			"report_date": "20220101",
			"sub_id": "test_sub_id",
			"publisher_id": "test_publisher_id",
			"click": 22649,
			"conversion": 470,
			"conversion_revenue": 13065380,
			"cancel": 55,
			"cancel_revenue": -978080
			"total_revenue": 12087300
		}
	]
}
```
{% endcode %}
{% endtab %}
{% endtabs %}



## 서버 응답 코드

아래 표는 Adpopcorn API 플랫폼에서 REST API 응답으로 전송되는 일반적인 HTTP 상태 코드를 나열한 것입니다.

<table><thead><tr><th width="126">Code</th><th width="173">메세지</th><th>설명</th></tr></thead><tbody><tr><td>200</td><td>성공</td><td>요청이 성공적으로 처리되었습니다.</td></tr><tr><td>400</td><td>client-side 에러</td><td>유효성 검사에 실패했습니다.</td></tr><tr><td>401</td><td>인증되지 않음</td><td>인증 또는 권한 부여 실패가 발생했습니다.</td></tr><tr><td>500</td><td>API-side 에러</td><td>Adpopcorn API 플랫폼에 문제가 발생했습니다.</td></tr></tbody></table>







