> 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/cafe-24/integration.md).

# 카페24 연동

카페24로 쇼핑몰을 이용하시는 경우 한 번의 클릭만으로 핵클을 설치하고 활용하실 수 있습니다.

{% hint style="success" %}
개발자가 없어도 누구나 손쉽게 카페24에 핵클 연동을 할 수 있습니다!
{% endhint %}

{% stepper %}
{% step %}
**핵클 설치하기**

1. 카페24 스토어 페이지에서 **\[설치하기]** 를 클릭하세요.

![](https://2738466581-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLHRZjjknm5KdNgPtDsbl%2Fuploads%2Fgit-blob-ff1739b7240c2c168e2ee9adf3b0750690dfa5dd%2F0bc6382b4acf5b08d58267f7c189f3f3085c3f72_069b3dcda6bffa21.png?alt=media)

2. 스토어 앱 설치에 필요한 접근 권한에 동의하세요.

![](https://2738466581-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLHRZjjknm5KdNgPtDsbl%2Fuploads%2Fgit-blob-6ea6b7dfa2233190b7f2433b5eab1ad4503dd35d%2F5df116a0d2f7be8b5b8496bbfb24c287b8dd9d76_a0c860444467862e.png?alt=media)

3. 권한 동의 후 **\[연동 시작하기]** 를 클릭하세요.

![](https://2738466581-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLHRZjjknm5KdNgPtDsbl%2Fuploads%2Fgit-blob-f2643bba2192f05d167bfc3a1fe9cb2151d346b6%2F587f4ce27e418a1e9d3ce93553993434716c401f_e113f56013d1ab54.png?alt=media)

핵클 앱 설치를 진행하려면 계정이 필요합니다. Google 계정으로 가입하거나 로그인하세요.

{% hint style="danger" %}
핵클 사용 중에는 카페24에서 앱을 삭제하지 마세요.

앱을 삭제하면 데이터 연동이 해제됩니다.
{% endhint %}
{% endstep %}

{% step %}
**워크스페이스 설정하기**

카페24 웹사이트와 연동할 워크스페이스를 설정하세요.

워크스페이스 이름은 나중에도 바꿀 수 있습니다.

![](https://2738466581-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLHRZjjknm5KdNgPtDsbl%2Fuploads%2Fgit-blob-df2c6f5c0e8c57429f9461f7feb32e570080ca4d%2F2da1ee66b9d403ae2362d8af693af4d3b41d960f_3069584f4a0f4cf9.png?alt=media)
{% endstep %}

{% step %}
**SDK 설치하기**

핵클 사용을 위해 SDK 설치가 필요합니다.\
설치 후에는 페이지뷰, 클릭, 노출 등 방문자 행동 데이터를 수집할 수 있습니다.

{% hint style="info" %}
카페24 연동은 쇼핑몰 단위로 진행됩니다.\
라이브 스킨과 테스트 스킨 구분 없이 전체 쇼핑몰에 적용됩니다.
{% endhint %}

![](https://2738466581-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLHRZjjknm5KdNgPtDsbl%2Fuploads%2Fgit-blob-becf212a7e55ee8d511c676a45884659ef07553e%2Fc4421a25a8f4c313191c2af9f2dcf812ed1abd4f_d5470ff88af440d8.png?alt=media)

* SDK 설치 후 수집되는 데이터는 [카페24 이벤트 설명](/cafe-24/events.md)에서 확인하세요.
* 설치 과정에서 문제가 발생하면 <support@hackle.io>로 문의해주세요.
  {% endstep %}

{% step %}
**개인정보 처리 위탁 설정하기**

개인정보 보호법에 따라 제3자인 핵클에게 개인정보 처리 위탁 내용을 추가해야 합니다.

1. 카페24 관리자 페이지에서 `[쇼핑몰 설정] > [기본 설정] > [이용 약관 설정]` 을 클릭하세요.

![](https://2738466581-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLHRZjjknm5KdNgPtDsbl%2Fuploads%2Fgit-blob-fae83dee34573c27367db322197fa8e2420fa1b6%2Facbb240c05cccee8d23a9ffb136ea62988598c56_3bf38d554025bef0.png?alt=media)

2. `[개인정보처리방침]` 탭의 `개인정보처리의 위탁에 관한 사항` 항목에 아래 내용을 추가하고 저장하세요.

> 제공받는 자 - 핵클 주식회사\
> 목적 - 사용자 행동 기반의 맞춤형 CRM 캠페인 발송 및 데이터 분석 업무\
> 항목 - \[일반] 이름, 아이디, 휴대폰번호, 이메일 주소, 사용자 로그 등\
> 보유기간 - 계약종료시까지

![](https://2738466581-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLHRZjjknm5KdNgPtDsbl%2Fuploads%2Fgit-blob-5356286d4f6ada50ffde3bd218e758f05d5fac85%2F5a685218065eebcabe4e07adf5cad15faf61e394_6efbe7835be7ccce.png?alt=media)

{% hint style="warning" %}
개인정보 처리 위탁 설정을 완료해주세요.

핵클은 해당 약관 미포함으로 발생한 문제에 책임지지 않습니다.
{% endhint %}

3. 약관이 잘 추가되었는지 확인하세요.

체크박스를 선택한 뒤 **\[추가 완료]** 를 클릭하세요.

![](https://2738466581-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLHRZjjknm5KdNgPtDsbl%2Fuploads%2Fgit-blob-ba47d366d8010416c284c43bcacb9f79e6cce35c%2F4fb018351eb84a5a4c8d22807c02bb7f7c915fa8_c7956b8a7a2b13c1.png?alt=media)
{% endstep %}

{% step %}
**기존 회원 연동하기**

핵클을 연동하기 전 가입된 유저를 불러와야합니다. (연동 이후 유저들은 자동으로 불러와집니다.)

핵클 대시보드에서 `[설정] > [외부 연동]` 로 이동 후 아래 이미지에 보이는 버튼을 클릭합니다.

<figure><img src="https://2738466581-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLHRZjjknm5KdNgPtDsbl%2Fuploads%2FUEuJCV0FP0oe4DH1k4su%2Fimage.png?alt=media&amp;token=0caa4e20-6863-4e47-9bf7-819967635996" alt="" width="375"><figcaption></figcaption></figure>

가져온 유저는 다음과 같은 속성 목록을 갖고 있을 수 있습니다.

| 속성 key                  | 속성 타입 | 설명                                          |
| ----------------------- | ----- | ------------------------------------------- |
| `$userId`               | 식별자   | memeber\_id에 해당하는 값                         |
| `$phoneNumber`          | CRM   | E.164 형태의 휴대전화                              |
| `name`                  | 커스텀   | 이름                                          |
| `nick_name`             | 커스텀   | 별명                                          |
| `email`                 | 커스텀   | 이메일                                         |
| `phone`                 | 커스텀   | E.164 형태의 휴대전화                              |
| `cellphone`             | 커스텀   | E.164 형태의 휴대전화                              |
| `group_no`              | 커스텀   | 회원 등급 번호                                    |
| `group_name`            | 커스텀   | 회원 등급명                                      |
| `created_date`          | 커스텀   | 가입일 `yyyyMMdd` (KST)                        |
| `created_datetime`      | 커스텀   | 가입일시 `yyyy-MM-dd HH:mm:ss` (KST)            |
| `news_mail`             | 커스텀   | 뉴스메일 수신여부. `T` · `F`                        |
| `sms`                   | 커스텀   | 모바일 메시지 수신여부. `T` · `F`                     |
| `mall_id`               | 커스텀   | `mall_id`                                   |
| `birthday`              | 커스텀   | 생일 `yyyyMMdd`                               |
| `birthdate`             | 커스텀   | 생일 `MM-dd`                                  |
| `birthday_year`         | 커스텀   | 생일 `yyyy`                                   |
| `solar_calendar`        | 커스텀   | `양력` · `음력`                                 |
| `member_authentication` | 커스텀   | `T` 인증 · `F` 미인증 · `B` 특별관리회원 · `J` 14세미만회원 |
| `gender`                | 커스텀   | `M` 남자 · `F` 여자                             |
| `member_type`           | 커스텀   | `p` 개인 · `c` 사업자 · `f` 외국인                  |
| {% endstep %}           |       |                                             |
| {% endstepper %}        |       |                                             |

{% hint style="success" %}
핵클 사용을 위한 필수 설치가 완료되었습니다.
{% endhint %}


---

# 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/cafe-24/integration.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.