# 네이티브 광고 리포트 {% hint style="info" %} SSP :arrow\_right: DSP {% endhint %} 본 문서는 TARGETPICK DSP(Demand Side Platform)와 연동한 SSP(Supply Side Platform) 파트너에게 리포트를 제공하기 위한 API 가이드 입니다. \ TARGETPICK 으로 DSP 리포트를 제공받기 위해서는 CJ 메조미디어 담당자에게 Token을 발급 받아야 사용이 가능합니다. \ API 사용을 위한 Token 발행은 지정 담당자에게 문의해주시기 바랍니다. ## **리포트 데이터 요청**

기본 정보	설명
서비스 API명	SSP 제공 리포트 데이터
API 호출 결과 타입	XML or JSON
인증 방법	Token
호출 방법	HTTPS
API 설명	SSP에 광고를 집행한 결과 리포트를 전달합니다.

### **URL**

구분	URL	Method
테스트	http://211.62.152.212:9000/api/report	Get
상용	https://dsp-report.meba.kr:9000/api/report	Get

### **Parameters**

Field	타입	필수	코드 예시	설명
sDate	String	Y	20160101	리포트 조회 시작일
eDate	String	Y	20160131	리포트 조회 종료일
PartnerID	String	Y	userpartnerid	메조미디어에서 발급한 파트너 고유 ID
Token	String	Y	F379C8K9P0	API 사용을 위한 파트너 고유 Token 값
ADType	Integer	Y	10	0 - ALL : 전체 10 - native : 네이티브
ReportType	Integer	Y	1	1 - 일자별 리포트 2 - 미디어별(PubID) 리포트 3 - 광고 타입별 리포트
format	String	Y	json	json , xml

### **Sample** | Sample URL | | ------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | | ## **리포트 데이터 응답** 기본 정보 - 리포트 API로 Request 시 아래의 양식으로 리포트 데이터가 반환됩니다.

이름	타입	전달 값 예시	설명
ListCount	Integer	100	반환되는 리스트 행 수
ReportType	Integer	1	1 - 일자별 리포트 2 - 미디어별(PubID) 리포트 3 - 광고 타입별 리포트
Date	String	20160101	리포팅 일자
Imp	Integer	1000	노출 횟수
Click	Integer	100	클릭 횟수
CTR	Double	10.00	노출 대비 클릭율
PubID	String	publisher123	미디어를 식별할 수 있는 ID로 AppID 또는 SiteID (난수 또는 암호화된 ID 가능)
Revenue	Double	100000	메조미디어에서 지급해야 할 인벤토리 구매 비용

### **Sample** #### **일자별 리포트 (ReportType=1)** {% code lineNumbers="true" %} ```xml 000



```

{% endcode %}

#### **미디어별 리포트 (ReportType=2)**

{% code lineNumbers="true" %}

```xml


	
		000
		SUCCESS
	
	
		10 
		2 
		20160101 
		20160131 
		banner 
		
			
				20160101
				publisher123
				1000
				100
				10.00
				5000
			
			
				20160101
				publisher456
				1000
				100
				10.00
				3000
			
			
				……
			
		
	
 xml version="1.0" encoding="utf-8" ?>

	
		000
		SUCCESS
	
	
		10 
		1 
		20160101 
		20160131 
		ALL 
		
			
				20160101
				1000
				100
				10.00
				5000
			
			
				……
			
		
	

```

{% endcode %}

#### **광고 타입별 리포트 (ReportType=3)**

{% code lineNumbers="true" %}

```xml


	
		000
		SUCCESS
	
	
		10 
		3 
		20160101 
		20160131 
		ALL 
		
			
				20160101
				banner
				1000
				100
				 10.00
				5000
			
			
				20160101
				interstitial 
				1000
				100
				 10.00
				3000
			
			
				……
			
		
	

```

{% endcode %}

#### **Error Code**

Code Descirption
000 성공
001 시스템에 에러가 발생했습니다.
002 알 수 없는 오류가 발생했습니다.
003 조회 권한이 없습니다.
004 존재하지 않는 API 입니다.
005 Parameter 정보가 잘못되었습니다.
006 날짜는 반드시 입력해야 하며, 세 달을 초과 할 수 없습니다.

#### **Error Response Sample**

{% code lineNumbers="true" %}

```xml


	
		000 
		SUCCESS 
	

```

{% endcode %}


---

# Agent Instructions: 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:

```
GET https://docs.targetpick.io/for-ssp/report-api/native.md?ask=
```

The question should be specific, self-contained, and written in natural language.
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.

Code	Descirption
000	성공
001	시스템에 에러가 발생했습니다.
002	알 수 없는 오류가 발생했습니다.
003	조회 권한이 없습니다.
004	존재하지 않는 API 입니다.
005	Parameter 정보가 잘못되었습니다.
006	날짜는 반드시 입력해야 하며, 세 달을 초과 할 수 없습니다.