> 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/cafe24-faq.md).

# 카페24 FAQ

카페24 쇼핑몰을 핵클과 연동한 뒤 자주 묻는 질문입니다.

#### 어떻게 연동할 수 있나요?

쇼핑몰에 핵클 앱을 설치하면 됩니다.\
권한 동의, 워크스페이스 생성, 스크립트 설치를 모두 완료하면 연동됩니다.

[카페24 연동](/cafe-24/integration.md)에서 설치 단계를 확인하세요.

***

#### 인앱 메시지 타겟팅 가능 여부는 무엇인가요?

카페24 쇼핑몰이 동작하는 구조적 제약사항으로 인해 `인앱메시지 타겟팅 가능 여부` 가 X인 이벤트가 존재합니다.

`view_`로 시작하는 이벤트 사용을 권장합니다.

{% hint style="danger" %}
다음 이벤트는 인앱메시지 타겟팅 조건으로 설정할 수 없습니다.

* 브라우저가 아닌 서버에서 발생하는 이벤트
* 이벤트가 발생한 이후에 카페24에 의해 새로운 페이지로 이동되는 경우
  {% endhint %}

***

#### 스크롤 이벤트의 발생 빈도가 너무 높아요.

핵클 앱을 통해 설치된 스크롤 이벤트는 해당 페이지 총 스크롤 높이의 5% 단위마다 발생합니다.\\

발생 빈도 조절 방법은 [카페24 scroll 이벤트 조정](/cafe-24/events/cafe24-event-management.md)을 참고하세요.

***

#### 원하는 속성이 수집되지 않아요.

핵클 앱은 카페24 환경에서 속성을 수집합니다. 쇼핑몰 설정에 따라 일부 속성이 수집되지 않을 수 있습니다.

* 사용자 속성이 없다면 회원가입 항목이 **필수**인지 확인하세요.
* 이벤트 속성이 없다면 디자인과 모듈 설정을 확인하세요.

{% hint style="info" %}
속성이 수집되지 않을 때는 사용 중인 디자인, 모듈 등의 정보와 함께 핵클 팀에 문의해주세요.
{% 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 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://docs.hackle.io/cafe-24/cafe24-faq.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.