메일침프 머지태그 종류 알아보기 (Merge Tag)

메일침프(Mailchimp)에서는 동적인 이메일을 손쉽게 만들기 위해 머지태그(Merge Tag)라는 기능을 제공합니다.

머지태그를 사용하면 이메일을 받은 구독자 각각의 정보(이름이나, 주소, 성별 등등)를 자동으로 불러 올 수 있는데, 이를 이메일 제목이나 본문에 넣어서 보다 개인화된 이메일 컨텐츠를 만드는데 도움을 줍니다.

머지태그 종류가 많기 때문에 굳이 외우실 필요는 없고, 필요하실 때마다 그때그때 찾아서 쓰시면 됩니다. (이 글은 메일침프 사이트의 All the Merge Tags Cheat Sheet를 참고했습니다.)

캠페인 (Campaigns)

아래는 대부분의 이메일 캠페인에서 사용할 수 있는 머지태그들 목록입니다.

캠페인 URL

*|ARCHIVE|*

해당 이메일 캠페인 페이지의 URL을 표시합니다.

<a href="*|ARCHIVE|*">웹 브라우저로 해당 이메일 보기</a>

캠페인 짧은 URL

*|ARCHIVE_LINK_SHORT|*

해당 이메일 캠페인 페이지의 짧은 URL을 표시합니다.


브랜드 로고

*|BRAND:LOGO|*

캠페인에 현재 디폴트 로고로 설정된 이미지 URL을 표시합니다.

<img src="*|BRAND:LOGO|*>

캠페인 고유 아이디

*|CAMPAIGN_UID|*

해당 캠페인의 고유 아아디(Unique ID)값을 표시합니다.


몽키 리워드 배지

*|REWARDS|*

몽키 리워드 배지(MonkeyRewards badge)를 붙입니다. 몽키 리워드 배지는 메일침프 로고가 있는 이미지 버튼으로, 신규 유저가 해당 배지를 통해 유료 플랜을 가입하면 원본 계정에 적립금을 돌려줍니다.

*|IF:REWARDS|* *|HTML:REWARDS|* *|END:IF|*

메일침프의 캠페인 푸터(Footer)에는 기본적으로 위와 같은 머지태그가 표시되어 있습니다. 이는 만약(IF) 몽키 리워드 배지를 보여주기로 설정했을 경우에만 메일침프 로고가 보여진다는 뜻입니다.

메일침프의 경우 무료 플랜에서는 몽키 리워드 배지를 감출 수 없지만, 유료 플랜에서는 몽키 리워드 배지를 보여줄지 말지 설정에서 계정 관리자가 선택할 수 있습니다.


몽키 리워드 배지 (텍스트 버전)

*|REWARDS_TEXT|*

*|REWARDS_TEXT|*는 텍스트로된 몽키 리워드 링크를 표시합니다.

텍스트 전용(text-only) 캠페인의 경우, 이미지 태그(<img>)를 사용할 수 없기 때문에, 메일침프 로고 이미지 버튼을 보여주는 *|REWARDS|* 머지태그 대신 텍스트 링크만 표시하는 *|REWARDS_TEXT|*를 사용해야 합니다.

Email Marketing Powered by Mailchimp http://www.mailchimp.com/monkey-rewards/?utm_source=freemium_newsletter&utm_medium=email&utm_campaign=monkey_rewards&aid=738cacbcb0a2ca62c5e0762ce&afl=1

*|REWARDS_TEXT|*를 사용할 경우 위의 예시와 같이 표기됩니다.


다국어 번역 링크

*|MC:TRANSLATE|*

캠페인 내용을 다양한 언어로 번역해서 볼 수 있도록, 구글 번역기와 연결된 언어별 링크들을 생성합니다.


특정 언어를 제외한 다국어 번역 링크

*|TRANSLATE:xx|*

*|MC:TRANSLATE|*와 거의 동일하나 xx 부분에 표기한 특정 언어만 제외한 언어별 링크들을 생성합니다. xx에는 제외하고자 하는 언어 코드를 넣습니다.

(언어 코드 예 : 영어는 en, 한국어는 ko 등등)


언어 코드

*|MC_LANGUAGE|*

해당 구독자가 사용하는 언어 코드를 표시합니다. 예를 들어, 해당 구독자의 언어가 영어라면 en, 한국어라면 ko라고 표시됩니다.

*|IF:MC_LANGUAGE=en|*
만약 구독자의 언어가 영어(en)라면 이 부분만 보입니다.
*|ELSEIF:MC_LANGUAGE=ko|*
만약 구독자의의 언어가 한국어(ko)라면 이 부분만 보입니다. 
*|ELSE:|*
그 외의 경우는 이 부분만 보입니다.
*|END:IF|*

만약 다국어를 지원하는 이메일 컨텐츠를 만들고 싶다면, 위의 예시와 같이 *|MC_LANGUAGE|*를 조건문 머지태그(IF, ELSEIF, ELSE 등)와 같이 쓰면 됩니다.


언어 이름

*|MC_LANGUAGE_LABEL|*

해당 구독자가 사용하는 언어 이름을 표시합니다. 예를 들어 해당 구독자의 언어가 영어라면 ‘English’, 한국어라면 ‘Korean’라고 표시됩니다.


현재 날짜

*|DATE:X|*

주어진 형식으로 현재 날짜를 표현합니다. x 위치에는 원하는 날짜 형식을 입력합니다. (참고 : PHP 날짜 형식)

*|DATE:Y/m/d|* 

예를 들어 위와 같이 입력하면 2019/06/04 이런 식으로 현재 날짜가 표시됩니다.


최근 보낸 캠페인 링크

*|LIST:RECENTX|*

지정한 개수(x) 만큼의 최근 캠페인 링크들을 보여줍니다. x 위치에는 표시하고 싶은 캠페인 최대 개수를 입력합니다. x 부분을 생략하면 최대 5개의 최근 캠페인 링크가 생성됩니다.


제목

*|MC:SUBJECT|*

해당 캠페인의 제목을 보여줍니다.


목차

*|MC:TOC|*

해당 캠페인의 목차를 생성합니다.

이때 목차의 내용은 오직 TOC_heading 스타일이 적용된 제목 태그(Heading Tag)들로만 구성되며, 해당 위치로 바로갈 수 있는 앵커 링크가 같이 생성됩니다. (일부 이메일 클라이언트에서는 앵커 링크 기능이 작동하지 않을 수도 있습니다.)


목차 (텍스트)

*|MC:TOC_TEXT|*

텍스트 전용(plain-text) 캠페인에서 사용하는 목차를 생성합니다.


미리보기 텍스트

*|MC_PREVIEW_TEXT|*

미리보기 텍스트를 표시합니다. 커스텀 코드 캠페인(custom-coded campaign)의 경우, 미리보기 텍스트 설정을 반영하려면 다음과 같이 캠페인 코드 내 해당 머지태그를 삽입해야만 합니다.

이때 미리보기 텍스트의 머지태그는 <body> 태그의 바로 다음에 위치해야 합니다.

<!--[if !gte mso 9]>
<!----><span class="mcnPreview Text" style="display:none; font-size:0px; line-height:0px; max-height:0px; max-width:0px; opacity:0; overflow:hidden; visibility:hidden; mso-hide:all;">*|MC_PREVIEW_TEXT|*</span>
<!--<![endif]--> 

또한 미리보기 텍스트를 노출하지 않기 위해서는 다음과 같이 스타일을 추가해줍니다.

.mcnPreviewText{display: none !important;}

.mcnPreviewText 클래스의 display 속성을 none !important;로 설정하면 해당 내용이 사용자에게 보이지 않습니다.


투표

*|POLL:RATING:x|* *|END:POLL|*

투표 머지태그를 사용하면 구독자가 직접 고를 수 있는 1~10까지의 선택지를 생성합니다. 이때 x 위치에는 투표하고자 하는 질문 내용을 넣습니다. 투표 결과는 캠페인 리포트(report)에 자동으로 기록됩니다.


할인 쿠폰

*|PROMO_CODE:[$store_id=x, $rule_id=x, $code_id=x]|*

캠페인 내 할인 쿠폰을 삽입합니다. 이를 사용하기 위해서는 먼저 해당 메일침프 계정이 온라인 스토어에 연동된 상태여야만 합니다.

  • $store_id : API로 설정된, 연동된 스토어 ID 값을 뜻합니다. API를 통해 해당 값을 확인할 수 있습니다.

  • $rule_id : API로 설정된, 해당 할인 쿠폰을 사용하기 위한 필수 조건들을 의미합니다. 예를 들면, 해당 할인 쿠폰의 할인율 등이 이에 속합니다. API를 통해 해당 값을 확인할 수 있습니다.

  • $code_id : API로 설정된, 해당 할인 코드를 뜻합니다. API를 통해 해당 값을 확인할 수 있습니다.

Feed 머지 태그

RSS 컨텐츠를 빠르게 캠페인 내 적용하고 싶다면 FeedBlock RSS 머지 태그를 사용하면 됩니다.


RSS 캠페인 (RSS Campaigns)

RSS 캠페인에서는 머지태그로 RSS 컨텐츠를 불러올 수 있습니다. 쉬운 방법으로 서식 지정된 RSS 태그(Preformatted RSS tag)를 사용할 수도 있고, 혹은 채널(Channel)과 아이템(Item) 태그를 사용해서 피드를 직접 구성할 수도 있습니다.

Preformatted RSS tags


개인화 (Personalization)

다음의 머지태그들은 구독자의 정보들을 캠페인에 표시합니다. 다음은 일반적으로 자주 쓰이는 개인화 머지태그입니다. 이외에도 다양한 개인화 머지태그가 가능합니다.

퍼스트 네임

*|FNAME|*

성을 제외한 이름을 삽입합니다. (First Name)


라스트 네임

*|LNAME|*

성 씨를 삽입합니다. (Last Name)


이메일

*|EMAIL|*

구독자의 이메일 주소를 삽입합니다.


연락처

*|PHONE|*

구독자의 연락처 번호를 삽입합니다.


주소

*|ADDRESS|*

구독자의 주소를 삽입합니다.


이메일 제목 라인

다음은 이메일 제목 라인에서 자주 쓰이는 머지태그 목록입니다. 이들은 일반적으로 이메일 제목 라인에서 종종 쓰이지만, 그외에도 이메일 본문이나 폼, 랜딩페이지 등에서도 쓰일 수 있습니다.

리스트명

*|LIST:NAME|*

오디언스(audience)명을 표시합니다.


회사명 (오디언스 설정)

*|LIST:COMPANY|*

오디언스 설정에서 지정한 회사명 혹은 조직명을 표시합니다.


구독자 수

*|LIST:SUBSCRIBERS|*

현재 해당 오디언스 내 구독자의 숫자를 표시합니다.


회사명 (프로필 설정)

*|USER:COMPANY|*

사용자 설정에서 지정한 회사명 혹은 조직명을 표시합니다.


현재 날짜

*|MC:DATE|*

계정 설정에서 지정한 포맷 (MM/DD/YYYY 혹은 DD/MM/YYYY)으로 현재 날짜를 표시합니다.


현재 연도

*|CURRENT_YEAR|*

현재 연도를 표시합니다. 카피라이트 문구에서 연도를 표현할 때 자주 사용됩니다.


이메일 푸터 (Email Footers)

다음은 이메일 푸터 컨텐츠에서 자주 쓰이는 머지태그 목록입니다. 이메일 푸터에서 필수적으로 표기해야 하는 정보들을 입력할 때 다음의 머지태그들을 사용합니다.

구독해지 링크

*|UNSUB|*

구독해지 URL을 생성합니다. 개인정보보호법에 의해, 이메일 하단에는 구독자가 언제든 구독을 해지할 수 있는 링크를 필수적으로 넣어야만 합니다.

<a href="*|UNSUB|*">구독해지를 원하시면 여기를 클릭하세요.</a>

*|UNSUB|* 머지태그를 사용해서 위의 예시와 같이 구독해지 링크를 넣을 수 있습니다.


퍼미션 리마인더 문구

*|LIST:DESCRIPTION|*

오디언스 설정에서 지정한 퍼미션 리마인더 문구를 표시합니다.


주소

*|HTML:LIST_ADDRESS_HTML|*

오디언스 설정에서 지정한 주소 정보와 함께, "Add us to your address book"라고 적인 링크를 생성합니다. 해당 링크를 클릭 시 주소록에 추가할 수 있는 vcard (.vcf) 파일을 다운로드 합니다.


리스트 어바웃 페이지

*|ABOUT_LIST|*

리스트 소개를 입력할 수 있는 리스트 어바웃 페이지(About Your List Page) 링크를 표시합니다.


오디언스 고유 아이디

*|LIST:UID|*

해당 오디언스의 고유 아이디(Unique ID) 값을 표시합니다.


웹사이트 URL

*|LIST:URL|*

오디언스 설정에서 지정한 오디언스 URL를 표시합니다.


발신처 주소

*|LIST:ADDRESS|*

오디언스 설정에서 지정한 발신처 주소(오프라인 주소)를 표시합니다.


발신처 주소 (한줄로 표기)

*|LIST:ADDRESSLINE|*

오디언스 설정에서 지정한 발신처 주소(오프라인 주소)를 한줄로 표시합니다.


회사 연락처

*|LIST:PHONE|*

회사 혹은 조직의 연락처 번호를 표시합니다.


회사명

*|LIST:COMPANY|*

회사 혹은 조직의 명칭을 표시합니다.


회사 이메일 주소

*|LIST:EMAIL|*

오디언스 설정에 지정한 이메일 정보를 표시합니다.


오디언스 폼 URL

*|LIST:SUBSCRIBE|*

오디언스 폼(hosted signup form) URL을 표시합니다.

// 예시
https://yourcompany.us1.list-manage.com/subscribe?u=738cacbcb0a2ca62c5e0762ce&id=204743b2d0

이때, 오디언스 폼의 u 파라미터 값은 계정 아이디(*|USER:UID|*), id는 오디언스 아이디 (*|LIST:UID|*)를 뜻합니다.


오디언스 호스트 URL

*|LIST_HOST|*

오디언스 폼(hosted signup form) URL 내 파라미터를 제외한 도메인 부분까지만 불러옵니다.

// 예시
https://yourcompany.us1.list-manage.com

구독자 프로필 수정하기 URL

*|UPDATE_PROFILE|*

구독자가 자신의 프로필 정보를 직접 수정할 수 있는 URL을 삽입합니다.


친구에게 추천하기 폼 URL

*|FORWARD|*

친구에게 추천하기 폼 URL을 삽입합니다.


구독 확인 페이지(Signup Confirmation Page)

다음은 구독했을 때 감사페이지와 환영 메일에서 자주 쓰이는 머지태그 목록입니다.

구독일

*|OPTIN_DATE|*

구독한 날짜를 표시합니다. 계정의 상세 설정(Details)에서 지정한 것에 따라 MM/DD/YYYY 혹은 DD/MM/YYYY 으로 보여집니다.


구독일시

*|OPTIN_DATETIME|*

구독한 날짜와 시각을 표시합니다.


계정 정보 (Account Information)

*|USER:UID|*

계정의 고유 아이디 값을 표시합니다.


소셜 공유 (Social Share)

트위터 전체 프로필

*|TWITTER:FULLPROFILE|*

연동한 트위터 계정의 아바타 정보와, 팔로워/ 트윗/ 팔로잉 숫자, 팔로우 링크, 가장 최신 트윗을 캠페인 내 불러옵니다.


트위터 프로필

*|TWITTER:PROFILE|*

연동한 트위터 계정의 아바타 정보와, 팔로워/ 트윗/ 팔로잉 숫자, 팔로우 링크를 캠페인 내 불러옵니다. 다만 이 머지태그는 가장 최신 트윗은 가져오지 않습니다.


트위터 프로필 URL

*|TWITTER:PROFILEURL|*

연동한 트위터 계정의 바로가기 URL 값을 삽입하니다. (예, http://www.twitter.com/mailchimp)


최신 트윗

*|TWITTER:TWEETSx|*

x 개 만큼의 최근 트윗을 불러옵니다. x를 생각하면 기본값으로 최대 5개의 최신 트윗을 보여줍니다.


특정 계정의 트위터 프로필

*|TWITTER:PROFILE:TWITTERUSERNAME|*

TWITTERUSERNAME에 트위터 계정명을 넣으면 해당 계정의 트위터 프로필을 불러옵니다.


트위터에 공유하기 버튼

*|TWITTER:TWEET|*

구독자가 캠페인 페이지 URL을 공유할 수 있도록, 트위터에 공유하기 버튼(트윗하기 버튼)을 생성합니다. 기본적으로 트윗 내용에 해당 캠페인의 제목 라인이 포함됩니다.


트위터에 공유하기 버튼 (텍스트 지정)

|TWITTER:TWEET [$text=my custom text here]|

구독자가 캠페인 페이지 URL을 공유할 수 있도록, 트위터에 공유하기 버튼(트윗하기 버튼)을 생성합니다. $text 값을 지정하면 트윗 내용 내 원하는 문구를 포함시킬 수 있습니다.


동영상 (Video)


조건 블록 태그 (Conditional Block Tags)


API

다음은 메일침프 API를 통해 컨텐츠를 만들 때 사용하는 머지태그 목록입니다.

*|EMAIL_UID|*

오디언스 폼(hosted form) URL이나 캠페인 추적 링크 등에서 e 파라미터 값으로 사용됩니다.


고유 아이디

*|UNIQID|*

API 함수 내의 $member->email->unique_id 값을 뜻합니다. 만약 캠페인 내에서 이 머지태그를 사용한다면, 구독자의 고유 아이디 값을 불러올 수 있습니다. 이를 통해 구독자 각각의 고유한 URL을 생성하는데 사용할 수 있습니다.


컨텐츠 인코딩 (Content Encoding)

HTML 타입

*|HTML:YOUR_MERGETAG|*

이 태그는 원본 html 코드를 사용할 때 변화없이 불러올 수 있도록 하는 태그입니다. 예를 들어, *|MYPARAMS|*이라는 머지태그를 사용하고 있고, 이 팔드값으로 ?id=1234&custom=awesome 값을 저장하고 있다면, 이를 원본 그대로 표현하기 위해 http://www.yourwebsite.com/*|HTML:MYPARAMS|*와 같이 쓸 수 있습니다.

// 출력 결과
http://www.yourwebsite.com/?id=1234&custom=awesome

그럼 위와 같이 해당 필드값 내 html 원본 그대로 출력됩니다.


URL 타입

*|URL:YOUR_MERGETAG|*

해당 머지태그 값을 URL 형태로 출력합니다. 예를 들어, 해당 필드 내 I love monkeys 값이 저장되어 있다면 *|URL:YOUR_MERGETAG|* 머지태그는 해당 값을 I+love+monkeys와 같은 형태로 바꿉니다.


타이틀로 바꾸기

*|TITLE:YOUR_MERGETAG|*

해당 머지태그 값을 영문 타이틀 형태로 출력합니다. (각 영어 단어의 첫 알파벳을 대문자로 변경합니다.)


소문자로 바꾸기

*|LOWER:YOUR_MERGETAG|*

해당 머지태그 값을 전부 영문 소문자 형태로 출력합니다.


대문자로 바꾸기

*|UPPER:YOUR_MERGETAG|*

해당 머지태그 값을 전부 영문 대문자 형태로 출력합니다.


자동화 (Automation)

자동화 메일의 번호를 텍스트로 표기

*|AUTOMATION:TOTALEMAILS(DIGIT)|*

자동화 메일의 번호를 숫자로 표시합니다. (1, 2, 3 등등)


자동화 메일의 번호를 텍스트로 표기

*|AUTOMATION:TOTALEMAILS(DIGITORDINAL)|*

자동화 메일의 번호를 서수로 표시합니다. (1st, 2nd, 3rd 등등)


자동화 메일의 번호를 텍스트로 표기

*|AUTOMATION:TOTALEMAILS(DIGITORDINAL)|*

자동화 메일의 번호를 텍스트로 표시합니다. (1st, 2nd, 3rd 등등)


자동화 메일의 번호를 서수 텍스트로 표기

*|AUTOMATION:TOTALEMAILS(TEXTORDINAL)|*

자동화 메일의 번호를 서수 텍스트로 표시합니다. (first, second, third 등등)


자동화 메일의 총 개수

*|AUTOMATION:TOTALEMAILS|*

해당 자동화 메일 내 총 이메일 개수를 표시합니다.


자동화 메일 내 현재 위치

*|AUTOMATION:CURRENTPOSITION|*

자동화 메일 내 현재 이메일 위치를 표시합니다.


자동화 메일 내 다음 위치

*|AUTOMATION:NEXTPOSITION|*

자동화 메일 내 다음 이메일 위치를 표시합니다.


자동화 메일 내 이전 위치

*|AUTOMATION:PREVIOUSPOSITION|*

자동화 메일 내 이전 이메일 위치를 표시합니다.


자동화 메일 내 다음 제목

*|AUTOMATION:NEXTSUBJECT|*

자동화 메일 내 다음 제목을 표시합니다.


자동화 메일 내 이전 제목

*|AUTOMATION:PREVIOUSSUBJECT|*

자동화 메일 내 이전 제목을 표시합니다.


자동화 메일을 시작하거나 종료하는 머지태그 (Leave and Join Automation Merge Tags)

자동화 메일의 워크플로 종료 URL

*|AUTOMATION:WORKFLOWREMOVEURL|*

구독자가 해당 자동화 메일을 종료할 수 있는 URL을 생성합니다.

자동화 메일의 워크플로 시작 URL

*|AUTOMATION:WORKFLOWADDURL(campaign_id)|*

구독자가 해당 자동화 메일을 시작할 수 있는 URL을 생성합니다. 이때 campaign_id 부분은 해당 자동화 메일 캠페인의 고유 아이디 값으로 대체하면 됩니다.

댓글 남기기

이메일은 공개되지 않습니다. 필수 입력창은 * 로 표시되어 있습니다