> For the complete documentation index, see [llms.txt](https://kakaobusiness.gitbook.io/main/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://kakaobusiness.gitbook.io/main/ad/ezad/mychannelad/run/report.md).

# 성과 확인

집행한 광고가 실제로 얼마나 노출되고 클릭되었는지, 얼마나 많은 친구가 추가되고 혜택·구매로 이어졌는지 세부 성과를 수치로 확인할 수 있습니다.

## 1. 광고 성과 대시보드

* 집행한 광고를 통해 실제로 얼마나 채널 친구가 증가했는지, 광고를 본 사용자로부터 어떤 반응을 일으켰는지 세부 광고 효과를 수치로 확인할 수 있습니다.
* [광고 관리](/main/ad/ezad/mychannelad/run/manage.md) > '광고 성과 자세히보기' 버튼을 클릭하여 광고 성과 대시보드 화면으로 이동할 수 있습니다.

<figure><img src="https://234308570-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MVZVmVOd-5LtENUPqdq%2Fuploads%2F2rtrZQa44Yu5eJ47q0nI%2F19_%E1%84%89%E1%85%B1%E1%84%8B%E1%85%AE%E1%86%AB%E1%84%80%E1%85%AA%E1%86%BC%E1%84%80%E1%85%A9_1_%E1%84%8B%E1%85%AE%E1%84%85%E1%85%B5%20%E1%84%8E%E1%85%A2%E1%84%82%E1%85%A5%E1%86%AF%20%E1%84%8B%E1%85%A1%E1%86%AF%E1%84%85%E1%85%B5%E1%84%80%E1%85%B5_%E1%84%8B%E1%85%AE%E1%86%AB%E1%84%8B%E1%85%A7%E1%86%BC%E1%84%92%E1%85%A1%E1%84%80%E1%85%B5_%E1%84%89%E1%85%A5%E1%86%BC%E1%84%80%E1%85%AA%20%E1%84%92%E1%85%AA%E1%86%A8%E1%84%8B%E1%85%B5%E1%86%AB_%E1%84%83%E1%85%A2%E1%84%89%E1%85%B5%E1%84%87%E1%85%A9%E1%84%83%E1%85%B3.png?alt=media&amp;token=70bd8754-9c20-46f9-8925-c299b5926bcf" alt=""><figcaption></figcaption></figure>

#### ❶ **상단 메뉴**

* 뒤로가기 버튼(←)을 통해 '[광고 관리](/main/ad/ezad/mychannelad/run/manage.md)' 페이지로 이동할 수 있습니다.

#### ❷ **조회 기간**

* **좌/우 스와이프하여 기간 버튼 선택**: 광고 집행 이후 부터 어제까지의 광고 집행 성과를 확인할 수 있습니다. \
  (오늘 '실시간' 지표는 제공하지 않음)&#x20;
  * 특정 기간 버튼 선택 시 빠르게 해당 기간의 수치를 확인할 수 있습니다.
* **기간 지정:** 조회 시작일, 종료일을 설정하여 조회도 가능합니다. 이 때 최대 1년 설정이 가능합니다.

#### ❸ **성과 요약 카드**

* 선택한 기간에 대해 주요 광고 성과 지표를 한 눈에 확인할 수 있습니다.
* 개별 카드 클릭 시 해당 지표별 상세 내역이 아래로 펼쳐집니다.

<table><thead><tr><th width="222.447265625">지표</th><th>설명</th></tr></thead><tbody><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>

#### ❹ 톡 채널 쿠폰 지표

> 오프라인 매장 전용 쿠폰만 집계됩니다. 매장에서 사용 완료 처리가 된 건만 반영됩니다.

<table><thead><tr><th width="285.259765625">지표</th><th>설명</th></tr></thead><tbody><tr><td>채널 쿠폰 사용수</td><td>발급된 채널 쿠폰이 매장에서 사용 완료된 건수입니다.</td></tr></tbody></table>

> ℹ️ 쿠폰 유효기간 이내 사용 건 기준이며, 최대 30일까지 집계됩니다. 캠페인 종료 후에도 유효기간 내 사용 건은 보고서에 반영될 수 있습니다.&#x20;
>
> ℹ️ 사용자 개인정보 보호를 위해, 채널 쿠폰 사용수가 일정 수치 이하인 경우 정확한 값 대신 '\*'로 표기됩니다. (0건은 그대로 표기)

#### ❺ 톡스토어 구매 지표

> 광고 클릭 후 30일 이내 채널과 연결된 톡스토어에서 발생한 결제 건으로, 취소·환불된 건은 제외됩니다.

<table><thead><tr><th width="292.330078125">지표</th><th>설명</th></tr></thead><tbody><tr><td>구매 전환수</td><td>연결된 톡스토어에서 구매(결제)가 발생한 건수입니다.</td></tr><tr><td>구매 금액</td><td>연결된 톡스토어에서 발생한 구매 결제 금액의 합계입니다.</td></tr></tbody></table>

> ℹ️ 채널에 연결된 톡스토어가 없으면 지표가 집계되지 않습니다. \[톡스토어 구매 성과 연결하기]를 통해 톡스토어를 연결할 수 있습니다.&#x20;
>
> ℹ️ 사용자 개인정보 보호를 위해, 구매 전환수가 일정 수치 이하인 경우 정확한 값 대신 '\*'로 표기됩니다. (0건은 그대로 표기)

## 2. 광고 성과 상세

성과 요약의 각 지표 카드를 누르면 펼쳐지며, 성·연령별 · 일자별 세부 분석을 확인할 수 있습니다.

### 2-1. 친구 추가수

<figure><img src="https://234308570-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MVZVmVOd-5LtENUPqdq%2Fuploads%2FbFIvPkPtFYk3EzH5OHi0%2F20_%E1%84%89%E1%85%B1%E1%84%8B%E1%85%AE%E1%86%AB%E1%84%80%E1%85%AA%E1%86%BC%E1%84%80%E1%85%A9_1_%E1%84%8B%E1%85%AE%E1%84%85%E1%85%B5%20%E1%84%8E%E1%85%A2%E1%84%82%E1%85%A5%E1%86%AF%20%E1%84%8B%E1%85%A1%E1%86%AF%E1%84%85%E1%85%B5%E1%84%80%E1%85%B5_%E1%84%8B%E1%85%AE%E1%86%AB%E1%84%8B%E1%85%A7%E1%86%BC%E1%84%92%E1%85%A1%E1%84%80%E1%85%B5_%E1%84%89%E1%85%A5%E1%86%BC%E1%84%80%E1%85%AA%20%E1%84%92%E1%85%AA%E1%86%A8%E1%84%8B%E1%85%B5%E1%86%AB_2-1.%20%E1%84%8E%E1%85%B5%E1%86%AB%E1%84%80%E1%85%AE%20%E1%84%8E%E1%85%AE%E1%84%80%E1%85%A1%E1%84%89%E1%85%AE.png?alt=media&amp;token=5041449f-b613-4661-baa3-f5ecb72e541e" alt=""><figcaption></figcaption></figure>

<table><thead><tr><th width="191.3681640625">항목</th><th>설명</th></tr></thead><tbody><tr><td>❶ 친구 추가수</td><td>광고를 통해 새로 추가된 채널 친구 수입니다. </td></tr><tr><td>❷ 성·연령별</td><td>전체 친구 추가수 대비 성별 비율 및 성·연령별 친구 추가수를 보여줍니다.<br>성·연령을 추정할 수 없는 경우 '알 수 없음'으로 표기됩니다.</td></tr><tr><td>❸ 일자별</td><td>일자별 친구 추가수를 의미합니다. '전체보기' 선택 시 설정 기간 전체 일자별 수치를 확인할 수 있습니다.</td></tr></tbody></table>

### 2-2. 친구 추가당 비용

<figure><img src="https://234308570-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MVZVmVOd-5LtENUPqdq%2Fuploads%2FRId0Euq2iSLUKi73wNTv%2F21_%E1%84%89%E1%85%B1%E1%84%8B%E1%85%AE%E1%86%AB%E1%84%80%E1%85%AA%E1%86%BC%E1%84%80%E1%85%A9_1_%E1%84%8B%E1%85%AE%E1%84%85%E1%85%B5%20%E1%84%8E%E1%85%A2%E1%84%82%E1%85%A5%E1%86%AF%20%E1%84%8B%E1%85%A1%E1%86%AF%E1%84%85%E1%85%B5%E1%84%80%E1%85%B5_%E1%84%8B%E1%85%AE%E1%86%AB%E1%84%8B%E1%85%A7%E1%86%BC%E1%84%92%E1%85%A1%E1%84%80%E1%85%B5_%E1%84%89%E1%85%A5%E1%86%BC%E1%84%80%E1%85%AA%20%E1%84%92%E1%85%AA%E1%86%A8%E1%84%8B%E1%85%B5%E1%86%AB_2-2.%20%E1%84%8E%E1%85%B5%E1%86%AB%E1%84%80%E1%85%AE%20%E1%84%8E%E1%85%AE%E1%84%80%E1%85%A1%E1%84%83%E1%85%A1%E1%86%BC%20%E1%84%87%E1%85%B5%E1%84%8B%E1%85%AD%E1%86%BC.png?alt=media&amp;token=1eb469e3-8c9f-4c0b-995d-6bdde66ab6d5" alt=""><figcaption></figcaption></figure>

<table><thead><tr><th width="198.501953125">항목</th><th>설명</th></tr></thead><tbody><tr><td>❶ 친구 추가당 비용</td><td><p>친구 1명을 추가하는 데 사용된 평균 비용입니다. (실제 광고비 ÷ 친구 추가수)</p><p>부가세가 포함된 금액입니다.</p></td></tr><tr><td>❷ 일자별</td><td>일자별 친구 추가당 비용을 의미합니다. '전체보기' 선택 시 전체 일자별 수치를 확인할 수 있습니다.</td></tr></tbody></table>

### 2-3. 광고 노출수

<figure><img src="https://234308570-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MVZVmVOd-5LtENUPqdq%2Fuploads%2FYLUDAk8MtymbyJU3pRVK%2F22_%E1%84%89%E1%85%B1%E1%84%8B%E1%85%AE%E1%86%AB%E1%84%80%E1%85%AA%E1%86%BC%E1%84%80%E1%85%A9_1_%E1%84%8B%E1%85%AE%E1%84%85%E1%85%B5%20%E1%84%8E%E1%85%A2%E1%84%82%E1%85%A5%E1%86%AF%20%E1%84%8B%E1%85%A1%E1%86%AF%E1%84%85%E1%85%B5%E1%84%80%E1%85%B5_%E1%84%8B%E1%85%AE%E1%86%AB%E1%84%8B%E1%85%A7%E1%86%BC%E1%84%92%E1%85%A1%E1%84%80%E1%85%B5_%E1%84%89%E1%85%A5%E1%86%BC%E1%84%80%E1%85%AA%20%E1%84%92%E1%85%AA%E1%86%A8%E1%84%8B%E1%85%B5%E1%86%AB_2-3.%20%E1%84%80%E1%85%AA%E1%86%BC%E1%84%80%E1%85%A9%20%E1%84%82%E1%85%A9%E1%84%8E%E1%85%AE%E1%86%AF%E1%84%89%E1%85%AE.png?alt=media&amp;token=21cb343c-7123-4c44-b21a-e9259f917696" alt=""><figcaption></figcaption></figure>

<table><thead><tr><th width="205.7919921875">항목</th><th>설명</th></tr></thead><tbody><tr><td>❶ 광고 노출수</td><td>광고가 얼마나 노출되었는지, 총 광고 노출수를 의미합니다.</td></tr><tr><td>❷ 성·연령별</td><td>전체 광고 노출수 대비 성, 연령 조합별 광고 클릭 비율을 의미합니다.<br>성, 연령을 추정할 수 없는 경우 '알 수 없음'으로 표기됩니다.</td></tr><tr><td>❸ 일자별</td><td>일자별 광고 노출수를 의미합니다. '전체보기' 선택 시 설정 기간 전체 일자별 수치를 확인할 수 있습니다.</td></tr></tbody></table>

### 2-4. 광고 클릭수

<figure><img src="https://234308570-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MVZVmVOd-5LtENUPqdq%2Fuploads%2FRHtBiK3GKbOaInrEOhBj%2F23_%E1%84%89%E1%85%B1%E1%84%8B%E1%85%AE%E1%86%AB%E1%84%80%E1%85%AA%E1%86%BC%E1%84%80%E1%85%A9_1_%E1%84%8B%E1%85%AE%E1%84%85%E1%85%B5%20%E1%84%8E%E1%85%A2%E1%84%82%E1%85%A5%E1%86%AF%20%E1%84%8B%E1%85%A1%E1%86%AF%E1%84%85%E1%85%B5%E1%84%80%E1%85%B5_%E1%84%8B%E1%85%AE%E1%86%AB%E1%84%8B%E1%85%A7%E1%86%BC%E1%84%92%E1%85%A1%E1%84%80%E1%85%B5_%E1%84%89%E1%85%A5%E1%86%BC%E1%84%80%E1%85%AA%20%E1%84%92%E1%85%AA%E1%86%A8%E1%84%8B%E1%85%B5%E1%86%AB_2-4.%20%E1%84%80%E1%85%AA%E1%86%BC%E1%84%80%E1%85%A9%20%E1%84%8F%E1%85%B3%E1%86%AF%E1%84%85%E1%85%B5%E1%86%A8%E1%84%89%E1%85%AE.png?alt=media&amp;token=587ade82-5c9b-429c-b052-58486569ebbe" alt=""><figcaption></figcaption></figure>

<table><thead><tr><th width="212.06640625">항목</th><th>설명</th></tr></thead><tbody><tr><td>❶ 광고 클릭수</td><td>사용자가 광고를 클릭한 회수를 의미합니다.</td></tr><tr><td>❷ 성·연령별</td><td>전체 광고 클릭 대비 성, 연령 조합별 광고 클릭 비율을 의미합니다.<br>성, 연령을 추정할 수 없는 경우 '알 수 없음'으로 표기됩니다.</td></tr><tr><td>❸ 일자별</td><td>일자별 광고 클릭수를 의미합니다. '전체보기' 선택 시 설정 기간 전체 일자별 수치를 확인할 수 있습니다.</td></tr></tbody></table>

### 2-5. 채널 쿠폰 사용수

<figure><img src="https://234308570-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MVZVmVOd-5LtENUPqdq%2Fuploads%2FwMNEQgMTAM84jZnnLfV3%2F24_%E1%84%89%E1%85%B1%E1%84%8B%E1%85%AE%E1%86%AB%E1%84%80%E1%85%AA%E1%86%BC%E1%84%80%E1%85%A9_1_%E1%84%8B%E1%85%AE%E1%84%85%E1%85%B5%20%E1%84%8E%E1%85%A2%E1%84%82%E1%85%A5%E1%86%AF%20%E1%84%8B%E1%85%A1%E1%86%AF%E1%84%85%E1%85%B5%E1%84%80%E1%85%B5_%E1%84%8B%E1%85%AE%E1%86%AB%E1%84%8B%E1%85%A7%E1%86%BC%E1%84%92%E1%85%A1%E1%84%80%E1%85%B5_%E1%84%89%E1%85%A5%E1%86%BC%E1%84%80%E1%85%AA%20%E1%84%92%E1%85%AA%E1%86%A8%E1%84%8B%E1%85%B5%E1%86%AB_2-5.%20%E1%84%8E%E1%85%A2%E1%84%82%E1%85%A5%E1%86%AF%20%E1%84%8F%E1%85%AE%E1%84%91%E1%85%A9%E1%86%AB%20%E1%84%89%E1%85%A1%E1%84%8B%E1%85%AD%E1%86%BC%E1%84%89%E1%85%AE.png?alt=media&amp;token=8b605a7e-1521-4ba9-8f50-eaa43d9ec019" alt=""><figcaption></figcaption></figure>

<table><thead><tr><th width="217.720703125">항목</th><th>설명</th></tr></thead><tbody><tr><td>❶ 채널 쿠폰 사용수</td><td>발급된 채널 쿠폰이 매장에서 사용 완료된 건수입니다. </td></tr><tr><td>❷ 일자별</td><td>일자별 쿠폰 사용수를 의미합니다. '전체보기' 선택 시 설정 기간 전체 일자별 수치를 확인할 수 있습니다.</td></tr></tbody></table>

### 2-6. 구매 전환수

<figure><img src="https://234308570-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MVZVmVOd-5LtENUPqdq%2Fuploads%2FkfB82tiCbeOGDxp2KiFb%2F25_%E1%84%89%E1%85%B1%E1%84%8B%E1%85%AE%E1%86%AB%E1%84%80%E1%85%AA%E1%86%BC%E1%84%80%E1%85%A9_1_%E1%84%8B%E1%85%AE%E1%84%85%E1%85%B5%20%E1%84%8E%E1%85%A2%E1%84%82%E1%85%A5%E1%86%AF%20%E1%84%8B%E1%85%A1%E1%86%AF%E1%84%85%E1%85%B5%E1%84%80%E1%85%B5_%E1%84%8B%E1%85%AE%E1%86%AB%E1%84%8B%E1%85%A7%E1%86%BC%E1%84%92%E1%85%A1%E1%84%80%E1%85%B5_%E1%84%89%E1%85%A5%E1%86%BC%E1%84%80%E1%85%AA%20%E1%84%92%E1%85%AA%E1%86%A8%E1%84%8B%E1%85%B5%E1%86%AB_2-6.%20%E1%84%80%E1%85%AE%E1%84%86%E1%85%A2%20%E1%84%8C%E1%85%A5%E1%86%AB%E1%84%92%E1%85%AA%E1%86%AB%E1%84%89%E1%85%AE.png?alt=media&amp;token=50223066-9240-40a1-8f3d-90d6bbed7f8a" alt=""><figcaption></figcaption></figure>

<table><thead><tr><th width="217.7255859375">항목</th><th>설명</th></tr></thead><tbody><tr><td>❶ 구매 전환수</td><td>연결된 톡스토어에서 발생한 구매(결제) 건수입니다. </td></tr><tr><td>❷ 일자별</td><td>일자별 구매 전환수를 의미합니다. '전체보기' 선택 시 설정 기간 전체 일자별 수치를 확인할 수 있습니다.</td></tr></tbody></table>

### 2-7. 구매 금액

<figure><img src="https://234308570-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MVZVmVOd-5LtENUPqdq%2Fuploads%2F0zC0UTSPbpmYGJ6XlIEi%2F26_%E1%84%89%E1%85%B1%E1%84%8B%E1%85%AE%E1%86%AB%E1%84%80%E1%85%AA%E1%86%BC%E1%84%80%E1%85%A9_1_%E1%84%8B%E1%85%AE%E1%84%85%E1%85%B5%20%E1%84%8E%E1%85%A2%E1%84%82%E1%85%A5%E1%86%AF%20%E1%84%8B%E1%85%A1%E1%86%AF%E1%84%85%E1%85%B5%E1%84%80%E1%85%B5_%E1%84%8B%E1%85%AE%E1%86%AB%E1%84%8B%E1%85%A7%E1%86%BC%E1%84%92%E1%85%A1%E1%84%80%E1%85%B5_%E1%84%89%E1%85%A5%E1%86%BC%E1%84%80%E1%85%AA%20%E1%84%92%E1%85%AA%E1%86%A8%E1%84%8B%E1%85%B5%E1%86%AB_2-7.%20%E1%84%80%E1%85%AE%E1%84%86%E1%85%A2%20%E1%84%80%E1%85%B3%E1%86%B7%E1%84%8B%E1%85%A2%E1%86%A8.png?alt=media&amp;token=fec875df-df3e-4f0a-bf91-339a33e3a3c8" alt=""><figcaption></figcaption></figure>

<table><thead><tr><th width="220.4111328125">항목</th><th>설명</th></tr></thead><tbody><tr><td>❶ 구매 금액</td><td>연결된 톡스토어에서 발생한 구매 결제 금액의 합계입니다.</td></tr><tr><td>❷ 일자별</td><td>일자별 구매 금액을 의미합니다. '전체보기' 선택 시 설정 기간 전체 일자별 수치를 확인할 수 있습니다.</td></tr></tbody></table>

## 3. 광고 성과 알림톡

* 주 1회 매주 월요일 마다 지난주 광고 성과를 요약하여 알림톡으로 알려드립니다.
* 지난주 집행한 광고 이력이 있으면 광고 성과 알림톡이 발송됩니다.
* 광고 성과 보고서와 동일하게 생성된 하나의 광고 당 하나의 알림톡이 발송됩니다.
  * ex) 3개의 광고를 운영하는 경우, 3개의 알림톡이 발송됩니다.

<figure><img src="https://234308570-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MVZVmVOd-5LtENUPqdq%2Fuploads%2F38oWYmAZ8yPx09GqP08A%2F27_%E1%84%89%E1%85%B1%E1%84%8B%E1%85%AE%E1%86%AB%E1%84%80%E1%85%AA%E1%86%BC%E1%84%80%E1%85%A9_1_%E1%84%8B%E1%85%AE%E1%84%85%E1%85%B5%20%E1%84%8E%E1%85%A2%E1%84%82%E1%85%A5%E1%86%AF%20%E1%84%8B%E1%85%A1%E1%86%AF%E1%84%85%E1%85%B5%E1%84%80%E1%85%B5_%E1%84%8B%E1%85%AE%E1%86%AB%E1%84%8B%E1%85%A7%E1%86%BC%E1%84%92%E1%85%A1%E1%84%80%E1%85%B5_%E1%84%89%E1%85%A5%E1%86%BC%E1%84%80%E1%85%AA%20%E1%84%92%E1%85%AA%E1%86%A8%E1%84%8B%E1%85%B5%E1%86%AB_%E1%84%8B%E1%85%A1%E1%86%AF%E1%84%85%E1%85%B5%E1%86%B7%E1%84%90%E1%85%A9%E1%86%A8.png?alt=media&amp;token=f715099f-6959-4d25-9892-e3e07a7d98d8" alt=""><figcaption></figcaption></figure>

<table><thead><tr><th width="222.7109375">항목</th><th>설명</th></tr></thead><tbody><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>


---

# 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 following URL with the `ask` and `goal` query parameters:

```
GET https://kakaobusiness.gitbook.io/main/ad/ezad/mychannelad/run/report.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `build a script that syncs our docs to a CMS` lets GitBook tailor the answer to that use case.

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.