# 소재 보고서 조회

## UI 소개

{% tabs %}
{% tab title="자동화" %}

<figure><img src="https://1362923181-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F5PH5ktGI0BWG6g9fvtcn%2Fuploads%2F2os7bdQzG2aqmC4eRB8C%2FScreenshot%200007-01-06%20at%202.29.45%E2%80%AFPM.png?alt=media&#x26;token=ef54b13c-3100-4f80-89ca-bb72d789e58d" alt="" width="563"><figcaption></figcaption></figure>

{% endtab %}

{% tab title="데이터플로우" %}

<figure><img src="https://1362923181-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F5PH5ktGI0BWG6g9fvtcn%2Fuploads%2FSPKZSrTjPdYGDL52ZMzA%2FScreenshot%200007-01-06%20at%202.25.31%E2%80%AFPM.png?alt=media&#x26;token=dd6f51e4-f8cf-4775-b4c6-32b15c08f847" alt="" width="563"><figcaption></figcaption></figure>
{% endtab %}
{% endtabs %}

<table><thead><tr><th width="173" align="center">항목명</th><th width="288" align="center">항목소개</th><th align="center">비고</th></tr></thead><tbody><tr><td align="center">광고계정</td><td align="center">광고 계정 선택</td><td align="center"></td></tr><tr><td align="center">캠페인</td><td align="center">광고계정과 관련된 캠페인 선택</td><td align="center"></td></tr><tr><td align="center">광고그룹</td><td align="center">캠페인과 관련된 광고그룹 선택</td><td align="center"></td></tr><tr><td align="center">보고서 지표 선택</td><td align="center">조회할 보고서 지표 선택</td><td align="center"><ul><li>기본 지표 (기본값)</li><li>추가 지표</li><li>픽셀 &#x26; SDK 전환 지표</li><li>카카오친구 지표</li></ul><p>상세내역 하단 실행 결과 내용 참조</p></td></tr><tr><td align="center">조회기간 선택</td><td align="center">보고서 조회기간 선택</td><td align="center"><ul><li>어제(기본값)</li><li>오늘</li><li>최근 7일</li><li>최근 14일</li><li>최근 30일</li><li>이번 달</li><li>지난 달</li></ul></td></tr><tr><td align="center">보고서 분석항목</td><td align="center">보고서 상세 분석 항목 선택</td><td align="center"><ul><li>기본정보 (기본값)</li><li>시간대</li><li>디바이스</li><li>매체유형</li><li>매칭유형</li><li>소재타입</li></ul></td></tr><tr><td align="center">기간 단위 선택</td><td align="center">보고서 조회 기간 단위 선택</td><td align="center"><ul><li>일단위 : 31일 내의 데이터를 조회</li><li>주단위 : 62일 내의 데이터를 조회</li><li>월단위 : 12개월 내의 데이터를 조회</li></ul></td></tr></tbody></table>

## 실행 결과

### 공통 반환값

| 데이터 값          | 데이터 내용  |
| -------------- | ------- |
| start          | 조회 시작일  |
| end            | 조회 종료일  |
| adAccountId    | 광고계정 ID |
| campaignId     | 캠페인 ID  |
| adGroupId      | 광고그룹 ID |
| creativeLinkId | 소재연결 ID |

### 분석항목 선택에 따른 데이터 반환값

| 데이터 값         | 데이터 내용               |
| ------------- | -------------------- |
| hour          | 시간 (시간대 선택시)         |
| device        | 기기 형태 (디바이스 선택시)     |
| placement     | 유입된 매체 유형 (매체유형 선택시) |
| targetingType | 광고 매칭유형 (매칭유형 선택시)   |
| assetType     | 소재 유형 (소재유형 선택시)     |

### 기본지표 선택시 데이터 반환값&#x20;

| 데이터 값    | 데이터 내용 |
| -------- | ------ |
| imp      | 노출수    |
| click    | 클릭수    |
| ctr      | 클릭률    |
| spending | 비용     |

### 추가지표 선택시 데이터 반환값&#x20;

| 데이터 값      | 데이터 내용                  |
| ---------- | ----------------------- |
| rimp       | 전체 노출수                  |
| ppc        | 클릭당 비용                  |
| rank       | 평균노출순위(프리미엄링크 유형에서만 제공) |
| costperimp | 노출당비용(톡채널검색 유형에서만 제공)   |

### 픽셀\&SDK 전환 지표 선택시 데이터 반환값

| 데이터 값               | 데이터 내용       |
| ------------------- | ------------ |
| convCmptReg1d       | 가입완료 (1일)    |
| convCmptReg7d       | 가입완료 (7일)    |
| convViewCart1d      | 장바구니 보기 (1일) |
| convViewCart7d      | 장바구니 보기 (7일) |
| convPurchase1d      | 구매 (1일)      |
| convPurchase7d      | 구매 (7일)      |
| convPurchaseP1d     | 구매금액 (1일)    |
| convPurchaseP7d     | 구매금액 (7일)    |
| convParticipation1d | 잠재고객 (1일)    |
| convParticipation7d | 잠재고객 (7일)    |
| convSignup1d        | 가입 및 등록 (1일) |
| convSignup7d        | 가입 및 등록 (7일) |
| convAppInstall1d    | 앱설치 (1일)     |
| convAppInstall7d    | 앱설치 (7일)     |

### 카카오친구 지표 선택시 데이터 반환값

| 데이터 값                | 데이터 내용           |
| -------------------- | ---------------- |
| convKfPfAdd1d        | 친구 추가수 (1일)      |
| convKfPfAdd7d        | 친구 추가수 (7일)      |
| costPerConvKfPfAdd1d | 친구 추가 수당 비용 (1일) |
| costPerConvKfPfAdd7d | 친구 추가 수당 비용 (7일) |
| convKfPfAdd1dRate    | 친구 추가율 (1일)      |
| convKfPfAdd7dRate    | 친구 추가율 (7일)      |