> 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).

# 핵심 지표

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

### 핵심 지표를 설정하는 이유

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

***

### 콘솔에서 설정하기

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

<figure><img src="https://3177177630-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F8pQgXiR5QAzduV54W8Om%2Fuploads%2FKXFI8x7jAWAQuQVW4oN7%2F%E1%84%8B%E1%85%AF%E1%86%AB%E1%84%87%E1%85%A9%E1%86%AB%20copy%207.png?alt=media&amp;token=65fa4983-0436-4c0a-94a1-aeeb91e904d6" alt=""><figcaption></figcaption></figure>

#### 활성 지표

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

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

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

**1) 템플릿 선택하기**

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

**2) 직접 조합하기**

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

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

#### 전환 지표

전환 지표는 미니앱에서 가장 중요하게 보고 싶은 사용자 행동(핵심 목표 행동)을 정의하는 기준이에요. 단순히 앱을 실행하거나 화면을 조회하는 것만이 아니라, 서비스 목적에 가까운 순간(예: 회원가입 완료, 첫 결제 완료, 핵심 콘텐츠 소비 등)을 전환으로 두는 게 좋아요. 전환 지표는 최대 3개까지 등록할 수 있어요.

**1) 템플릿 선택하기**

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

**2) 직접 조합하기**

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

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

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

**대표 전환과 보조 전환**

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

* 대표 전환: 이 미니앱에서 가장 우선순위로 두는 전환이에요. 노출·추천 등 최적화와 분석에서 기본으로 보는 지표가 돼요.
* 그 외 전환: 대표 전환까지 이어지는 과정을 함께 보기 위한 지표예요.

예를 들어 대표 전환이 결제 완료라면, 장바구니 담기·결제 시도를 보조로 두어 어느 단계에서 이탈하는지를 함께 볼 수 있어요.

처음 만든 전환 지표는 자동으로 대표 전환으로 지정돼요. 바꾸고 싶다면 다른 전환 지표를 선택해 대표 전환으로 체크할 수 있어요.

{% hint style="warning" %}
**꼭 확인해 주세요**

* 변경한 지표는 다음 날부터 적용돼요.
* 핵심 지표는 노출·추천과 성과 분석의 기준으로 쓰이니 신중하게 설정해 주세요.
  {% endhint %}

***

### 지표 확인하기

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

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

<figure><img src="https://3177177630-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F8pQgXiR5QAzduV54W8Om%2Fuploads%2FRjvb9tG5AYbaDzoFzsWE%2Fimage.png?alt=media&amp;token=536621a4-af7a-479f-9c28-85af0324ba1b" 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.