> For the complete documentation index, see [llms.txt](https://docs.hackle.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.hackle.io/catalog/catalog.md).

# 카탈로그 소개

카탈로그는 상품, 컨텐츠, 매장처럼 **사용자가 아닌 비즈니스 데이터를 담아두는 표**입니다. 사용자 단위로 쌓이는 이벤트·속성과 달리, 카탈로그에는 "우리 서비스가 다루는 것들"의 정보를 저장합니다.

카탈로그에 데이터를 올려두면 핵클의 CRM 캠페인에서 카탈로그의 데이터를 불러와, 사용자마다 다른 내용을 보여주는 **개인화 메시지**를 만들 수 있습니다. 메시지는 카탈로그의 이름과 아이템 ID로 데이터를 찾아오기 때문에, 한 번 만든 카탈로그를 여러 메시지에서 함께 사용할 수 있습니다.

<figure><img src="https://2738466581-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLHRZjjknm5KdNgPtDsbl%2Fuploads%2FC6s1v2NDGA2sWNbsOyBW%2F%E1%84%8F%E1%85%A1%E1%84%90%E1%85%A1%E1%86%AF%E1%84%85%E1%85%A9%E1%84%80%E1%85%B3.png?alt=media&amp;token=3b9e573c-1cda-4a11-90cf-581359459dd2" alt=""><figcaption></figcaption></figure>

#### 이렇게 활용할 수 있어요

<table><thead><tr><th width="153.44140625">업종</th><th>활용 예시</th></tr></thead><tbody><tr><td>커머스</td><td>장바구니에 담긴 상품의 이름·가격·이미지를 넣은 리마인드 메시지, 재입고·가격 인하 알림</td></tr><tr><td>컨텐츠·미디어</td><td>유저가 보던 컨텐츠의 다음 회차 알림, 관심 장르 기반 신작 추천</td></tr><tr><td>O2O·매장</td><td>자주 가는 매장의 프로모션 안내, 지점별 이벤트 메시지</td></tr></tbody></table>

#### 주요 개념

<table><thead><tr><th width="117.64453125">개념</th><th>설명</th></tr></thead><tbody><tr><td><strong>카탈로그</strong></td><td>같은 종류의 데이터를 담는 하나의 표입니다. 예: <code>products</code>, <code>contents</code></td></tr><tr><td><strong>필드</strong></td><td>표의 열입니다. 아이템이 가지는 속성을 정의합니다. 예: <code>name</code>, <code>price</code>, <code>image_url</code></td></tr><tr><td><strong>아이템</strong></td><td>표의 행입니다. 상품 하나, 컨텐츠 하나가 아이템 하나입니다.</td></tr><tr><td><strong>아이템 ID</strong></td><td>아이템을 찾는 키입니다. 카탈로그 안에서 유일해야 하며, 메시지가 이 값으로 아이템을 찾아옵니다.</td></tr></tbody></table>

#### 환경별 데이터 관리

카탈로그와 필드 구조는 운영·개발 환경에서 **공용**이고, 아이템은 **환경별로 따로** 관리합니다. 개발 환경에서 테스트용 아이템으로 메시지를 검증한 뒤, 운영 환경에 실제 데이터를 올리는 방식으로 사용할 수 있습니다. 그래서 카탈로그 생성 시에는 환경을 선택하지 않고, 아이템을 업로드할 때 환경을 선택합니다.

<table data-column-title-hidden data-view="cards"><thead><tr><th></th><th>가이드</th><th data-hidden data-card-target data-type="content-ref">바로가기</th></tr></thead><tbody><tr><td><strong>카탈로그 생성하기</strong></td><td>카탈로그를 만들고, 아이템에 사용할 필드를 설정합니다.</td><td><a href="/catalog/create.md">카탈로그 생성하기</a></td></tr><tr><td><strong>카탈로그 관리하기</strong></td><td>카탈로그의 아이템과 필드를 조회하고 관리합니다.</td><td><a href="/catalog/manage.md">카탈로그 관리하기</a></td></tr><tr><td><strong>카탈로그 사용하기</strong></td><td>카탈로그 데이터를 메시지에 불러와 개인화합니다.</td><td><a href="/catalog/use.md">카탈로그 사용하기</a></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 by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.hackle.io/catalog/catalog.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 `automate deployments from our CI pipeline` 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.