> For the complete documentation index, see [llms.txt](https://docs.dfinery.ai/user-guide/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.dfinery.ai/user-guide/playbook/report.md).

# 리포트 시나리오

## 리포트란?

디파이너리에서 캠페인 성과와 고객 데이터를 확인할 수 있는 리포트 기능입니다.

디파이너리 콘솔 내 리포트는 다양한 형태로 제공되며,  크게 세 가지 형태로 제공니다.

| 기능          | 내용                                                                                                |
| ----------- | ------------------------------------------------------------------------------------------------- |
| 캠페인 상세 리포트  | <p>캠페인을 생성 및 퍼블리시 이후 캠페인 상세 화면에서 자동으로 제공됩니다. <br>해당 캠페인의 성공·실패·구매 전환 이벤트 수치를 일자별로 확인할 수 있습니다.</p> |
| 액션 > 통합 리포트 | 여러 캠페인의 성과를 통합해서 보거나, 조회 기간(최대 1개월 단위)별로 캠페인별·채널별 성공·전환 이벤트 수치를 비교할 수 있습니다.                       |
| 분석 > 리포트    | 캠페인과 무관하게, 특정 이벤트 발생 횟수나 구매금액을 조회 기간에 따라 직접 조합해 분석하는 범용 분석 기능입니다.                                 |

{% hint style="warning" %}
'분석 > 리포트' 타입은 **캠페인을 조건에 설정할 수 없습니다.**\
해당 리포트 시나리오 5개는 캠페인을 직접 지정하는 대신, 오디언스 혹은 캠페인에 설정된 고객 행동과 유저 속성 값을 분석해 캠페인 집행 전 인사이트를 얻거나 캠페인 진행 후 구매로 이어진 상품·쿠폰 현황을 파악하는 용도로 제공합니다. \
캠페인 자체의 성공·전환 수치는 캠페인 상세 리포트 또는 통합 리포트에서 확인하실 수 있습니다.
{% endhint %}

***

## 리포트 생성 기본 방법

### **콘솔 진입 경로**

```
분석 > 리포트 > 리포트 생성
```

1. 조회 기간
   * 단위 선택 (시간별/일별/주별/월별)
   * 기간 설정 (당일/1일/7일/30일/직접 선택)
2. 메트릭 설정
   * 이벤트 선택 > 집계 방식(횟수) 또는 구매금액 합계 지정 (최대 5개)
3. 필터 설정 (선택)
   * 이벤트 속성 또는 유저 프로필 조건 추가
4. 그룹바이 설정 (선택, 최대 3개)
   * 유저 프로필 / 이벤트명 / 이벤트 속성 중 선택
5. 생성 또는 CSV 다운로드

***

## 👉 리포트 시나리오 목록

<table><thead><tr><th width="90.78515625">번호</th><th>리포트명</th></tr></thead><tbody><tr><td>1</td><td>신규 가입 고객 연령·성별 분포 분석</td></tr><tr><td>2</td><td>플랫폼(OS)별 활성 유저 분포</td></tr><tr><td>3</td><td>상품 조회 대비 구매 전환 분석</td></tr><tr><td>4</td><td>생일 쿠폰 사용 현황 분석</td></tr><tr><td>5</td><td>90일 미접속 고객의 과거 구매 카테고리 분석</td></tr></tbody></table>

### \[리포트 1] *<mark style="background-color:yellow;">신규 가입 고객 연령·성별 분포 분석</mark>*

최근 한 달간 가입한 고객이 어떤 연령대·성별로 구성되어 있는지 파악합니다. \
캠페인 1의 A/B 테스트를 한 단계 더 발전시켜, 연령대별로 서로 다른 톤의 메시지를 발송하는 데 참고할 수 있습니다. \
예를 들어 20대에게는 트렌디한 톤으로, 40대 이상에게는 신뢰감 있는 톤으로 문구를 다르게 구성하는 식입니다.

<table><thead><tr><th width="147.1484375">항목</th><th width="468.2109375">설정 내용</th></tr></thead><tbody><tr><td>조회 기간</td><td>월별 (최근 1개월)</td></tr><tr><td>메트릭</td><td><code>회원가입</code> > 횟수</td></tr><tr><td>그룹바이</td><td>유저 프로필 > <code>연령대</code>, <code>성별</code></td></tr></tbody></table>

**리포트 설정 예시**

1. 조회 기간 설정

<figure><img src="/files/dlGjtO2fybRSXmkkeIPN" alt=""><figcaption></figcaption></figure>

2. 상세 조건 설정

<figure><img src="/files/vPAgwE45M0YgAW8Y5fyI" alt=""><figcaption></figcaption></figure>

***

### \[리포트 2] *<mark style="background-color:yellow;">플랫폼(OS)별 활성 유저 분포</mark>*

전체 활성 유저가 App, Web 중 어느 플랫폼에 더 많이 분포되어 있는지 확인합니다. \
캠페인 2(수신동의 전환 유도 인앱 메시지)를 발송하기 전, 어느 플랫폼에 인앱 메시지 노출을 우선할지 판단하는 사전 참고 자료로 활용합니다.

<table><thead><tr><th width="175.4375">항목</th><th width="443.8359375">설정 내용</th></tr></thead><tbody><tr><td>조회 기간</td><td>월별 (3개월)</td></tr><tr><td>메트릭</td><td><code>세션 실행</code> > 유저 수</td></tr><tr><td>그룹바이</td><td>이벤트/이벤트 속성 > <code>DFN 라이브러리 플랫폼</code></td></tr></tbody></table>

#### **리포트 설정 예시**

1. 조회 기간 설정

<figure><img src="/files/NUCRWwqFO4uZTOkopLyC" alt=""><figcaption></figcaption></figure>

2. 상세 조건 설정

<figure><img src="/files/PVID3WUtucnG2l1etFs8" alt=""><figcaption></figcaption></figure>

> 리포트에서는 수신동의 속성을 직접 조회할 수 없습니다. 채널별 수신동의 수치는 홈 대시보드에서 확인해주세요.

***

### \[리포트 3] *<mark style="background-color:yellow;">상품별 조회 대비 구매 현황</mark>*

상품별로 조회수와 구매수를 함께 확인해, 관심도는 높지만 구매 전환이 낮은 상품을 파악합니다. \
이런 상품은 캠페인 3(상품 조회 후 미구매 리타겟팅)의 타겟 후보 상품이나 별도 프로모션 대상으로 활용할 수 있습니다.

<table><thead><tr><th width="178.66796875">항목</th><th width="350.02734375">설정 내용</th></tr></thead><tbody><tr><td>조회 기간</td><td>주별 (최근 1주)</td></tr><tr><td>메트릭</td><td><code>상품 상세 보기</code> 횟수, <code>구매</code> 횟수</td></tr><tr><td>그룹바이</td><td>이벤트/이벤트 속성 > <code>상품명</code></td></tr></tbody></table>

#### **리포트 설정 예시**

1. 조회 기간 설정

<figure><img src="/files/kYdIMPGpeZdGVvbw4C4t" alt=""><figcaption></figcaption></figure>

2. 상세 조건 설정

<figure><img src="/files/rgkhxpYnrf3c3bUVOCs8" alt=""><figcaption></figcaption></figure>

***

### 리포트 4. *<mark style="background-color:yellow;">생일 쿠폰 사용 현황 분석</mark>*

오디언스 4, 캠페인 4에서 발송한 생일 쿠폰이 실제 구매로 이어지는지 일별로 확인합니다. \
생일 쿠폰을 사용해 주로 구매하는 상품도 함께 확인할 수 있어, 다음 생일 캠페인의 쿠폰 적용 상품이나 추천 상품 구성에 참고할 수 있습니다.

| 항목    | 설정 내용                       |
| ----- | --------------------------- |
| 조회 기간 | 일별 (30일)                    |
| 메트릭   | `구매` 횟수, `구매` 주문 총액 합       |
| 필터    | 이벤트 속성 > 쿠폰명 > 값 선택 > 생일 쿠폰 |
| 그룹바이  | 이벤트/이벤트 속성 > `상품명`          |

> 그룹바이에 이벤트 속성인 사용 쿠폰을 설정하면, 전체 쿠폰 사용 내역 중 생일 쿠폰 사용분만 따로 확인할 수 있습니다.

{% hint style="info" %}
구매이벤트의 쿠폰명 속성은 기본 제공 항목이 아닌 커스텀 이벤트 속성입니다. 이 리포트를 사용하려면 사전에 사용 쿠폰에 대한 이벤트 속성이 구매 이벤트에 포함되어있어야 합니다.
{% endhint %}

#### **리포트 설정 예시**

1. 조회 기간 설정

<figure><img src="/files/6VLIwP720juB91BxzYkx" alt=""><figcaption></figcaption></figure>

![image.png](attachment:af46b44c-0f38-4264-ad11-fbf2b0e1dbe5:image.png)

2. 상세 조건 설정

<figure><img src="/files/js2zKh9XZ6yd6zv2dTfO" alt=""><figcaption></figcaption></figure>

***

### \[리포트 5] *<mark style="background-color:yellow;">90일 미접속 고객의 과거 구매 카테고리 분석</mark>*

현재 90일 이상 미접속 상태인 고객이 비활성화되기 전 주로 구매했던 상품 카테고리를 확인합니다.\
최종 활동일 이전의 과거 구매 이력을 분석해 고객이 이전에 관심 있어 했던 카테고리의 상품이나 쿠폰을 추천하는 데 활용할 수 있습니다.

#### **리포트 설정 예시**

<table><thead><tr><th width="154.734375">항목</th><th width="517.2421875">설정 내용</th></tr></thead><tbody><tr><td>조회 기간</td><td>월별 (상대 > 최근 6개월, 기준 3개월 전)</td></tr><tr><td>메트릭</td><td><code>구매</code> 횟수, <code>구매</code> 주문 총액 합</td></tr><tr><td>필터</td><td>행동 속성 > <code>최종 활동 일시</code> > 직접 선택 (상대 > 최근 0일 > 기준 90일 전)</td></tr><tr><td>그룹바이</td><td>이벤트/이벤트 속성 > <code>상품 카테고리1</code>, <code>상품 카테고리2</code>, <code>상품 카테고리3</code></td></tr></tbody></table>

1. 조회 기간 설정

<figure><img src="/files/EOTPWa570rEHUAcLcMOk" alt=""><figcaption></figcaption></figure>

2. 상세 조건 설정

<figure><img src="/files/4RJsrVFnn7K8Zu8suuAn" alt=""><figcaption></figcaption></figure>

***

### 캠페인 성과는 어디서 확인하나요?

분석 > 리포트에서는 캠페인별 성과를 직접 조회할 수 없습니다.&#x20;

캠페인 성과는 아래 두 곳에서 확인하세요.

<table><thead><tr><th width="182.8359375">확인 위치</th><th>내용</th></tr></thead><tbody><tr><td>캠페인 상세 화면</td><td>각 캠페인 상세 화면에서 성공·실패·전환 이벤트 수치를 일자별로 확인</td></tr><tr><td>액션 > 통합 리포트</td><td>여러 캠페인을 통합해서 보거나, 조회 기간(최대 1개월)별 캠페인별·채널별 성공·전환 이벤트 수치를 비교</td></tr></tbody></table>

#### 이전 단계

[→ 🚀 캠페인 시나리오로 이동](/user-guide/playbook/campaign.md)


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## 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, and the optional `goal` query parameter:

```
GET https://docs.dfinery.ai/user-guide/playbook/report.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

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.