> For the complete documentation index, see [llms.txt](https://developers-apps-in-toss.toss.im/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://developers-apps-in-toss.toss.im/guide/analytics/conversion-metrics.md).

# 핵심 지표

### 핵심 지표란

핵심 지표는 미니앱의 **활성 사용자**와 **핵심 목표 행동**을 정의하는 기준이에요.

핵심 지표를 바탕으로 우리 앱을 좋아할 만한 사용자를 찾아 노출하고 추천해요. 핵심 지표를 잘 설정한 앱일수록 더 적합한 사용자에게 노출될 기회가 커져요.

핵심 지표는 **활성 지표**와 **전환 지표** 두 가지로 구성돼요.

| 구분        | 설명                         | 개수    |
| --------- | -------------------------- | ----- |
| **활성 지표** | 내 앱을 자주 쓰는 사용자를 정의해요       | 1개    |
| **전환 지표** | 서비스 목적에 가까운 핵심 목표 행동을 정의해요 | 최대 3개 |

***

### **왜 설정해야 하나요?**

* **노출·추천 최적화**: 활성 사용자와 비슷한 사용자를 찾아, 우리 앱을 좋아할 만한 사용자에게 노출하고 추천해요.
* **성과 분석**: 일회성 방문이 아닌 실제 재방문이 많은 사용자가 얼마나 늘고 있는지 확인할 수 있어요.
* **운영·개선**: 파트너사 내부적으로도 "핵심 지표가 무엇인지" 합의하는 기준이 돼요.

***

### **콘솔에서 설정하는 방법**

앱인토스 콘솔 → 워크스페이스 선택 → 미니앱 선택 → 좌측 메뉴 '핵심 지표'를 선택해 주세요.

<figure><img src="/files/5UNiJpPMn1vSNKZNikjx" alt=""><figcaption></figcaption></figure>

***

### 활성 지표

활성 지표는 내 앱을 자주 쓰는 사용자를 정의하는 기준이에요. 앱당 1개만 설정할 수 있어요.

**활성 지표는 이렇게 활용돼요**

* **노출·추천**: 토스가 활성 사용자와 비슷한 사용자를 찾아, 우리 앱을 좋아할 만한 사용자에게 노출하고 추천해요.
* **성과 분석**: 일회성 방문이 아닌 실제 재방문이 많은 사용자가 얼마나 늘고 있는지 확인할 수 있어요.

#### **1. 템플릿 선택하기**

3가지 템플릿 중에서 선택할 수 있어요. 선택한 뒤 원하는 값을 입력하면 바로 등록할 수 있어요.

<figure><img src="/files/2HmbYv13SCmiERFo54hC" alt=""><figcaption></figcaption></figure>

| 템플릿             | 설명                           | 입력값    |
| --------------- | ---------------------------- | ------ |
| n일 이후 재방문한 유저   | 처음 방문한 후 n일이 지나 다시 돌아온 사용자예요 | 2\~30일 |
| n분 이상 체류한 유저    | 한 번 방문할 때 n분 이상 머문 사용자예요     | 2\~5분  |
| 하루 n회 이상 방문한 유저 | 하루에 n회 이상 앱을 연 사용자예요         | 2\~30회 |

{% hint style="info" %}
**참고하세요**

게임 앱은 기본값이 "n분 이상 체류한 유저(2분)"로, 비게임 앱은 "n일 이후 재방문한 유저(7일)"로 설정돼요.
{% endhint %}

#### **2. 직접 조합하기**

원하는 템플릿이 없다면, 커스텀 이벤트를 활성 지표로 설정할 수 있어요.

* **지표 이름**: 팀에서 구분할 수 있도록, 어떤 지표인지 드러나게 적어 주세요.
* **설명**: 지표를 한눈에 이해할 수 있도록 짧게 적어 주세요.
* 이벤트를 OR 조건으로 조합하고, 파라미터도 함께 정의할 수 있어요.

***

### 전환 지표

전환 지표는 미니앱에서 가장 중요하게 보고 싶은 사용자 행동(핵심 목표 행동)을 정의하는 기준이에요.

단순 앱 실행·화면 조회만이 아니라, 서비스 목적에 가까운 순간(예: 회원가입 완료, 첫 결제 완료, 핵심 콘텐츠 소비 등)을 전환으로 두는 것이 좋아요.

전환 지표는 최대 **3개**까지 등록할 수 있어요.

#### **1. 템플릿 선택하기**

자주 쓰는 지표를 토스팀이 템플릿으로 만들어 두었어요. 선택만 하면 바로 등록할 수 있어요.

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

| 템플릿                 | 설명                                         |
| ------------------- | ------------------------------------------ |
| 수익 발생한 유저           | 인앱 광고, 인앱 결제, 토스페이 중 하나 이상으로 매출이 발생한 사용자예요 |
| 토스페이 결제한 유저         | 토스페이로 결제를 완료한 사용자예요                        |
| 인앱 상품 구매한 유저        | 인앱 상품을 결제한 사용자예요                           |
| 인앱 광고 시청한 유저        | 인앱 광고를 1회 이상 시청한 사용자예요                     |
| 한 명당 평균 매출 (ARPU)   | 매출을 사용자 수로 나눈 평균 금액이에요                     |
| 한 건당 평균 결제 금액 (AOV) | 결제 한 건당 평균 금액이에요                           |
| 토스로그인 완료한 유저        | 토스 계정으로 로그인을 완료한 사용자예요                     |
| 유저 식별키 발급받은 유저      | 별도 서버 없이 유저 식별키를 발급받은 사용자예요                |
| 게임 플레이 완료한 유저       | 게임을 1회 이상 완료한 사용자예요                        |
| 알림 받기 동의한 유저        | 미니앱에서 보내는 알림을 받기로 동의한 사용자예요                |
| 특정 경로로 들어온 유저       | 특정 경로로 미니앱에 들어온 사용자예요                      |

{% hint style="info" %}
**참고하세요**

원하는 템플릿이 없다면, 목록 하단의 '원하는 지표가 없어요' 를 선택해 필요한 지표를 토스팀에 요청할 수 있어요.
{% endhint %}

#### **2. 직접 조합하기**

이벤트를 OR 조건으로 조합하고, 파라미터도 함께 정의할 수 있어요.

* **지표 이름**: 팀에서 구분할 수 있도록, 어떤 전환인지 드러나게 적어 주세요.
* **설명**: 지표를 한눈에 이해할 수 있도록 짧게 적어 주세요.

***

### 대표 전환과 보조 전환

전환 지표 중 **대표 전환은 1개**만 둘 수 있어요.

* **대표 전환**: 이 미니앱에서 가장 우선순위로 두는 전환이에요. 노출·추천 등 최적화와 분석에서 기본으로 보는 지표가 돼요.
* **그 외 전환**: 대표 전환까지 이어지는 과정을 함께 보기 위한 지표예요.
  * 예를 들어 대표 전환이 결제 완료라면, 장바구니 담기·결제 시도를 보조로 두어 어느 단계에서 이탈하는지를 함께 볼 수 있어요.

처음 만든 전환 지표는 자동으로 대표 전환으로 지정되고, 변경을 원할 경우 다른 전환 지표를 선택해서 대표 전환으로 체크할 수 있어요.

***

### 지표 확인하기

등록한 핵심 지표는 목록 화면에서 차트로 확인할 수 있어요.

* 상단 **날짜 범위**와 **시간 단위**(일별/주별/월별)를 선택해 데이터를 조회할 수 있어요.
* 활성 지표는 활성 유저 수, 전환 지표는 전환 유저 수를 보여줘요.

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

***

### 유의사항

* 일부 전환 지표 템플릿이 활성 지표로 옮겨졌어요. 기존에 전환 지표를 설정한 경우, 전환 지표 템플릿을 다시 선택한 뒤 저장해 주세요.
* 변경한 지표는 **다음 날부터** 적용돼요.
* 핵심 지표는 노출·추천 및 성과 분석의 기준으로 활용되므로 신중하게 설정해 주세요.


---

# 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://developers-apps-in-toss.toss.im/guide/analytics/conversion-metrics.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.