# 광고그룹 보고서 조회

## UI 소개

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

<figure><img src="https://1362923181-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F5PH5ktGI0BWG6g9fvtcn%2Fuploads%2FwcyCcrl8iOjizNjJlf5t%2FScreenshot%200007-01-06%20at%202.28.27%E2%80%AFPM.png?alt=media&#x26;token=fff69965-2012-4531-a499-12608c3932ad" 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%2FRk1e1P9oPbZFDlEhxuwx%2FScreenshot%200007-01-06%20at%2012.26.05%E2%80%AFPM.png?alt=media&#x26;token=d57d30ed-775d-4c17-9f6e-816921583582" 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"><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  |

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

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

### 기본지표 선택시 데이터 반환값&#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일)      |