> 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/moment/messagead/personalizedmessage/content-guide.md).

# 개인화 메시지 제작가이드

{% hint style="info" %}
**변수 치환 후에는 메시지 유형 및 영역별 가이드를 준수**하여야 발송 가능합니다.
{% endhint %}

## 1. 메시지 소재 구성 가이드

### 1-1. 와이드이미지형

<figure><img src="/files/4StguTktatZDgKEGcQHS" alt=""><figcaption></figcaption></figure>

| 구성 요소           | 상세 안내                                                                                                                                |
| --------------- | ------------------------------------------------------------------------------------------------------------------------------------ |
| ① 이미지           | <ul><li>파일형식 : JPG, JPEG, PNG</li><li>사이즈/용량 : 800x600 (4:3비율) 권장 / 10MB</li><li>고정 이미지 또는 변수 이미지 (URL등록)</li></ul>                  |
| ② 내용            | <ul><li>치환 후 최대 76자</li><li>링크 입력 불가, 줄바꿈 1회 가능</li><li>변수 항목 입력 가능</li></ul>                                                        |
| ③ 버튼 1          | <ul><li>치환 후 최대 8자</li><li>랜딩 유형 : URL, 소식, 쿠폰, 웹임베드 채널 / URL에 한하여 변수값 지원</li></ul>                                                  |
| ④ 버튼 2          | <ul><li>치환 후 최대 8자</li><li>랜딩 유형 : URL, 소식, 쿠폰, 애드뷰, 비즈니스폼, 웹임베드 채널 / URL에 한하여 변수값 지원</li></ul><p>※ 비즈니스폼 연동시 강조형 버튼(노란색 버튼) 적용됨</p> |
| ⑤ 쿠폰 강조 버튼 (선택) | 변수값 입력 가능 : 쿠폰 URL, 할인금액/할인율, 쿠폰 상세 내용                                                                                               |

### 1-2. 와이드리스트형

<figure><img src="/files/OLWejjr6RK5XMY4X3Ovf" alt=""><figcaption></figcaption></figure>

| 구성 요소           | 상세 안내                                                                                                                                |
| --------------- | ------------------------------------------------------------------------------------------------------------------------------------ |
| ① 타이틀           | 치환 후 최대 20자, 변수 항목 입력 가능                                                                                                             |
| ② 리스트1 이미지      | <ul><li>파일형식 : JPG, JPEG, PNG</li><li>사이즈/용량 : 800x400 (2:1 비율) 권장 / 10MB</li><li>고정 이미지 또는 변수 이미지 (URL등록)</li></ul>                 |
| ③ 리스트1 홍보문구     | 치환 후 최대 25자, 변수 항목 입력 가능                                                                                                             |
| ④ 리스트2\~5 이미지   | <ul><li>파일형식 : JPG, JPEG, PNG</li><li>사이즈/용량 : 800x800 (1:1 비율) 권장 / 10MB</li><li>고정 이미지 또는 변수 이미지 (URL등록)</li></ul>                 |
| ⑤ 리스트2\~5 홍보문구  | 치환 후 최대 30자, 변수 항목 입력 가능                                                                                                             |
| ⑥ 버튼 1          | <ul><li>치환 후 최대 8자</li><li>랜딩 유형 : URL, 소식, 쿠폰, 웹임베드 채널 / URL에 한하여 변수값 지원</li></ul>                                                  |
| ⑦ 버튼 2          | <ul><li>치환 후 최대 8자</li><li>랜딩 유형 : URL, 소식, 쿠폰, 애드뷰, 비즈니스폼, 웹임베드 채널 / URL에 한하여 변수값 지원</li></ul><p>※ 비즈니스폼 연동시 강조형 버튼(노란색 버튼) 적용됨</p> |
| ⑧ 쿠폰 강조 버튼 (선택) | 변수값 입력 가능 : 쿠폰 URL, 할인금액/할인율, 쿠폰 상세 내용                                                                                               |

### 1-3. 기본텍스트형

<figure><img src="/files/3Jj6pmwRzxg9Yub2NzA1" alt=""><figcaption></figcaption></figure>

| 구성 요소           | 상세 안내                                                                                                                                                                                |
| --------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| ① 이미지           | <ul><li>파일형식 : JPG, JPEG, PNG</li><li>사이즈/용량 : <br>ㄴ 800x400(2:1 비율) 권장/10MB <br>ㄴ 800x800(1:1 비율) 권장 / 10MB <br>ㄴ 800x600(4:3비율) 권장/10MB</li><li>고정 이미지 또는 변수 이미지 (URL등록)</li></ul> |
| ② 내용            | <ul><li>이미지 미 첨부 시 치환 후 최대 400자</li><li>이미지 첨부 시 치환 후 최대 300자</li><li>링크 입력 불가, 줄바꿈 29회 가능</li><li>변수 항목 입력 가능</li></ul>                                                             |
| ③ 버튼 1          | <ul><li>치환 후 최대 8자</li><li>랜딩 유형 : URL, 소식, 쿠폰, 웹임베드 채널 /  URL에 한하여 변수값 지원</li></ul>                                                                                                 |
| ④ 버튼 2          | <ul><li>치환 후 최대 8자</li><li>랜딩 유형 : URL, 소식, 쿠폰, 애드뷰, 비즈니스폼, 웹임베드 채널 /  URL에 한하여 변수값 지원</li></ul><p>※ 비즈니스폼 연동시 강조형 버튼(노란색 버튼) 적용됨</p>                                                |
| ⑤ 쿠폰 강조 버튼 (선택) | 변수값 입력 가능 : 쿠폰 URL, 할인금액/할인율, 쿠폰 상세 내용                                                                                                                                               |

### 1-4. 캐러셀 피드형

<figure><img src="/files/lwvUNji08qn2zLVy3iEt" alt=""><figcaption></figcaption></figure>

| 구성 요소           | 상세 안내                                                                                                                                                                                                              |
| --------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| ① 홍보이미지         | <ul><li>파일형식 : JPG, JPEG, PNG</li><li>사이즈/용량 : <br>ㄴ 800x400 (2:1 비율) 권장 / 10MB <br>ㄴ 800x600 (4:3비율) 권장 / 10MB</li></ul><p>※ 캐러셀 1\~6 영역의 홍보이미지는 동일한 비율의 이미지로 등록 필요</p><ul><li>고정 이미지 또는 변수 이미지 (URL등록)</li></ul> |
| ② 타이틀           | <ul><li>치환 후 최대 20자, 링크 입력 불가</li><li>변수 항목 입력 가능</li></ul>                                                                                                                                                        |
| ③ 홍보문구          | 치환 후 최대 180자, 변수 항목 입력 가능                                                                                                                                                                                          |
| ④ 버튼 1          | <ul><li>버튼명 : 치환 후 최대 8자 </li><li>랜딩 유형 : URL, 소식, 쿠폰, 웹임베드 채널 / URL에 한하여 변수값 지원</li></ul>                                                                                                                         |
| ⑤ 버튼 2 (선택)     | <ul><li>버튼명 : 치환 후 최대 8자</li><li>랜딩 유형 : URL, 소식, 쿠폰, 애드뷰, 비즈니스폼, 웹임베드 채널 / URL에 한하여 변수값 지원</li></ul><p>※ 비즈니스폼 연동시 강조형 버튼(노란색 버튼) 적용됨</p>                                                                         |
| ⑥ 쿠폰 강조 버튼 (선택) | 변수값 입력 가능 : 쿠폰 URL, 할인금액/할인율, 쿠폰 상세 내                                                                                                                                                                              |

**더보기 영역 (선택 입력)**&#x200B;

| ① 더보기 (선택) | 랜딩 유형 : URL, 소식, 쿠폰, 웹임베드 채널 / URL에 한하여 변수값 지원 |
| ---------- | ---------------------------------------------- |

### 1-5. 캐러셀 커머스형

<figure><img src="/files/FTiD2qwUZK1DWx68FHAT" alt=""><figcaption></figcaption></figure>

**Intro 영역 (선택 입력)**

<table data-header-hidden><thead><tr><th width="317">구성 요소</th><th>상세 안내</th></tr></thead><tbody><tr><td>구성 요소</td><td>상세 안내</td></tr><tr><td>① 홍보이미지</td><td><ul><li>파일형식 : JPG, JPEG, PNG</li><li>사이즈/용량 : <br>ㄴ 800x400 (2:1 비율) 권장 / 10MB <br>ㄴ 800x800 (1:1 비율) 권장 / 10MB <br>ㄴ 800x600 (4:3비율) 권장 / 10MB</li><li>고정 이미지 또는 변수 이미지 (URL등록)</li></ul></td></tr><tr><td>     ㄴ 랜딩 (선택)</td><td>랜딩 유형 : URL, 웹임베드 채널 / URL에 한하여 변수값 지원</td></tr><tr><td>② 홍보타이틀</td><td>치환 후 최대 20자, 변수 항목 입력 가능</td></tr><tr><td>③ 홍보문구</td><td>치환 후 최대 50자, 변수 항목 입력 가능</td></tr></tbody></table>

**캐러셀 영역 (필수 입력)**

<table data-header-hidden><thead><tr><th width="316">구성 요소</th><th>상세 안내</th></tr></thead><tbody><tr><td>구성 요소</td><td>상세 안내</td></tr><tr><td>① 홍보이미지</td><td><ul><li>파일형식 : JPG, JPEG, PNG</li><li>사이즈/용량 : <br>ㄴ 800x400 (2:1 비율) 권장 / 10MB <br>ㄴ 800x800 (1:1 비율) 권장 / 10MB <br>ㄴ 800x600 (4:3비율) 권장 / 10MB</li><li>고정 이미지 또는 변수 이미지 (URL등록)</li></ul></td></tr><tr><td>② 타이틀</td><td>치환 후 최대 25자, 변수 항목 입력 가능</td></tr><tr><td>③ 가격정보</td><td><ul><li>원화/엔화: 정수만 입력 가능(0~99999999까지 입력)</li><li>달러/유로: 소수점 2자리까지 표기(3자리 이하 절사)</li><li>통화 : 원화(원),달러($), 엔화(￥), 유로(€)</li><li>가격 변수 입력 가능</li></ul></td></tr><tr><td>④ 할인가격정보 (선택)</td><td><ul><li>원화/엔화: 정수만 입력 가능(0~99999999까지 입력)</li><li>달러/유로: 소수점 2자리까지 표기(3자리 이하 절사)</li><li>통화 : 원화(원),달러($), 엔화(￥), 유로(€)</li><li>가격 변수 입력 가능</li></ul><p>※ 가격정보에 입력한 값 미만으로 입력 가능</p></td></tr><tr><td>⑤ 할인율 (자동)</td><td><p>가격정보와 할인가격정보 입력 시 할인율이 자동계산되어 적용</p><p>※ 정수 형태로 표시됨 (1%~100%), 소수점 이하 절사</p></td></tr><tr><td>⑥ 구매하기</td><td>랜딩 유형 : URL, 웹임베드 채널 / URL에 한하여 변수값 지원</td></tr><tr><td>⑦ 버튼2 (선택)</td><td><ul><li>버튼명 : 치환 후 최대 8자</li><li>랜딩 유형 : URL, 소식, 쿠폰, 애드뷰, 비즈니스폼, 웹임베드 채널 / URL에 한하여 변수값 지원</li></ul><p>※ 비즈니스폼 연동시 강조형 버튼(노란색 버튼) 적용됨</p></td></tr></tbody></table>

**더보기 영역 (선택 입력)**

<table data-header-hidden><thead><tr><th width="316">구성 요소</th><th>상세 안내</th></tr></thead><tbody><tr><td>구성 요소</td><td>상세 안내</td></tr><tr><td>① 더보기 (선택)</td><td>랜딩 유형 : URL, 소식, 쿠폰, 웹임베드 채널 / URL에 한하여 변수값 지원</td></tr></tbody></table>

{% hint style="info" %}
카카오톡 채널 서비스를 이용하여 메시지 광고를 운영함에 있어 '채널 메시지 집행 가이드' 및 '채널 메시지 발송 유의사항'을 준수하여야 합니다.

* **채널 메시지 집행 가이드 ▶︎**[ **바로가기**](https://kakaobusiness.gitbook.io/main/ad/moment/messagead/guide)
* **채널 메시지 발송 유의사항 ▶︎** [**바로가기**](https://kakaobusiness.gitbook.io/main/ad/moment/messagead/operations)
  {% endhint %}

{% hint style="danger" %}
**개인화 메시지 내 변수를 이용하여 수신자의 개인정보를 침해하거나 개인적인 특성이나 민감한 정보를 언급 또는 암시하여 타인의 권리를 침해할 수 있는 내용이 포함된 메시지를 발송한 채널은 카카오광고 운영정책에 따라 한시적 또는 영구적으로 메시지 발송이 제한될 수 있습니다.**
{% endhint %}

{% hint style="danger" %}
**URL 내 UTF-8 코드로 인코딩되지 않은 특수문자나 한글이 있을 경우, iOS 기기 > 카카오톡 인앱브라우저에서 광고가 정상 랜딩되지 않을 수 있습니다.**\
랜딩 오류가 발생할 수 있는 특수문자를 미리 참고하여 URL을 셋팅해주세요.

* %
* \| (vertical bar)
* “
  {% endhint %}

{% hint style="danger" %}
파라미터/매크로 치환이 필요한 딥링크 형식의 URL은 DA광고에서만 지원되며, 메시지 광고에서는 지원하고 있지 않아 정상 동작하지 않을 수 있습니다.

해당 내용 참고하시어 **메시지 소재 내 딥링크 형식의 URL 설정은 지양하여 주시기 바랍니다.**
{% endhint %}

다른 문의사항이 있으실까요? 카카오톡 채널 혹은 고객센터를 통해 문의하실 수 있습니다.&#x20;

{% tabs %}
{% tab title="채널 문의" %}
[카카오비즈니스 채널](https://pf.kakao.com/_WekxcC)을 추가하시면 카카오톡으로 채팅 상담을 시작하실 수 있습니다. \
모바일에서 편리하게 묻고 빠르게 답변을 받아보세요.

* 카카오톡 채널 상담 운영 시간 : 평일 오전 9시 \~ 오후 6시 (주말 및 공휴일 제외)
  {% endtab %}
  {% endtabs %}


---

# 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://kakaobusiness.gitbook.io/main/ad/moment/messagead/personalizedmessage/content-guide.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.