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

# Cafe24 Integration

If you run your store on Cafe24, you can install and use Hackle with just one click.

{% hint style="success" %}
Anyone can easily integrate Hackle with Cafe24, even without a developer!
{% endhint %}

{% stepper %}
{% step %}
**Install Hackle**

1. On the Cafe24 Store page, click **\[Install]**.

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

2. Agree to the access permissions required to install the store app.

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

3. After granting permissions, click **\[Start Integration]**.

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

An account is required to install the Hackle app. Sign up or log in with a Google account.

{% hint style="danger" %}
Do not delete the app from Cafe24 while using Hackle.

Deleting the app will disconnect the data integration.
{% endhint %}
{% endstep %}

{% step %}
**Configure the Workspace**

Configure the Workspace to link with your Cafe24 website.

You can change the Workspace name later.

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

{% step %}
**Install the SDK**

The SDK must be installed to use Hackle.\
After installation, you can collect visitor behavior data such as page views, clicks, and impressions.

{% hint style="info" %}
The Cafe24 integration is applied at the store level.\
It applies to the entire store, regardless of whether you use the live skin or a test skin.
{% endhint %}

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

* For details on the data collected after SDK installation, see [Cafe24 Event Description](https://docs.hackle.io/en/cafe-24/events.md).
* If you encounter issues during installation, contact <support@hackle.io>.
  {% endstep %}

{% step %}
**Configure Personal Data Processing Consignment**

In accordance with the Personal Information Protection Act, you must add a statement delegating personal data processing to Hackle as a third party.

1. In the Cafe24 admin page, click `[Store Settings] > [Basic Settings] > [Terms of Service Settings]`.

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

2. On the `[Privacy Policy]` tab, add the following content to the `Personal Data Processing Consignment` section and save.

> Recipient — Hackle Inc.\
> Purpose — Sending customized CRM campaigns based on user behavior and data analytics work\
> Items — \[General] Name, ID, mobile phone number, email address, user logs, etc.\
> Retention Period — Until termination of contract

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

{% hint style="warning" %}
Please complete the personal data processing consignment configuration.

Hackle is not responsible for any issues arising from the absence of the terms above.
{% endhint %}

3. Verify that the terms have been added correctly.

Check the checkbox and click **\[Complete Addition]**.

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

{% step %}
**Import Existing Members**

You need to import the users who signed up before integrating Hackle. (Users who sign up after the integration are imported automatically.)

In the Hackle Dashboard, go to `[Settings] > [External Integration]` and click the button shown in the image below.

<figure><img src="https://143363954-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FyAVlNQhS253reum0Ce94%2Fuploads%2Fgit-blob-5da8c354a078b90ab24e37bbd61b11e4c3f99954%2Fimage%20(23).png?alt=media" alt="" width="375"><figcaption></figcaption></figure>

Imported users may have the following properties.

| Property Key            | Property Type | Description                                                                        |
| ----------------------- | ------------- | ---------------------------------------------------------------------------------- |
| `$userId`               | Identifier    | Value corresponding to member\_id                                                  |
| `$phoneNumber`          | CRM           | Mobile phone number in E.164 format                                                |
| `name`                  | Custom        | Name                                                                               |
| `nick_name`             | Custom        | Nickname                                                                           |
| `email`                 | Custom        | Email                                                                              |
| `phone`                 | Custom        | Phone number in E.164 format                                                       |
| `cellphone`             | Custom        | Mobile phone number in E.164 format                                                |
| `group_no`              | Custom        | Member group number                                                                |
| `group_name`            | Custom        | Member group name                                                                  |
| `created_date`          | Custom        | Sign-up date `yyyyMMdd` (KST)                                                      |
| `created_datetime`      | Custom        | Sign-up date and time `yyyy-MM-dd HH:mm:ss` (KST)                                  |
| `news_mail`             | Custom        | Newsletter consent. `T` · `F`                                                      |
| `sms`                   | Custom        | Mobile message consent. `T` · `F`                                                  |
| `mall_id`               | Custom        | `mall_id`                                                                          |
| `birthday`              | Custom        | Birthday `yyyyMMdd`                                                                |
| `birthdate`             | Custom        | Birthday `MM-dd`                                                                   |
| `birthday_year`         | Custom        | Birthday `yyyy`                                                                    |
| `solar_calendar`        | Custom        | `양력` (solar) · `음력` (lunar)                                                        |
| `member_authentication` | Custom        | `T` Verified · `F` Unverified · `B` Specially managed member · `J` Member under 14 |
| `gender`                | Custom        | `M` Male · `F` Female                                                              |
| `member_type`           | Custom        | `p` Individual · `c` Business · `f` Foreigner                                      |
| {% endstep %}           |               |                                                                                    |
| {% endstepper %}        |               |                                                                                    |

{% hint style="success" %}
The required installation for using Hackle is now complete.
{% 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/en/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.
