문자 변수(치환) 활용 가이드 총정리
문자 변수 활용의 모든 것! 변수 태그 작성법부터 엑셀 매칭, 자주 하는 실수, 활용 예시까지 실전 가이드입니다.
한줄설명
문자 변수 활용 4단계와 실수 방지 팁을 제공합니다. [이름]님처럼 수신자별 맞춤 메시지를 자동으로 만들어주는 핵심 기능!
소개
문자 변수(치환) 기능은 "[이름]님 생일 축하드려요"처럼 대괄호 안에 넣은 태그를 엑셀 데이터의 실제 값으로 자동 치환해, 수천 명에게 각기 다른 개인화된 문자를 한 번에 보낼 수 있게 해주는 기능입니다.
문자 변수의 가장 큰 장점은 이름·생일·주문번호·잔여포인트 등 수신자마다 다른 정보를 담아 발송해도, 발송 작업 자체는 단 한 번으로 끝난다는 점입니다.
문자 변수는 엑셀 파일의 열(컬럼) 제목과 메시지 안의 [태그]가 글자 하나까지 정확히 일치해야 정상적으로 치환되며, 하나라도 다르면 태그가 그대로 노출되는 오류가 발생합니다.
이 글에서는 문자 변수 활용의 4단계 실전 방법과 엑셀 매칭 시 자주 하는 실수, 여러 개 변수를 조합하는 예시까지 상세히 다룹니다.
주소록 엑셀업로드 가이드, 문자 API 연동 가이드와 함께 확인하세요.
활용 분야
- 생일·기념일 개인화 축하 메시지
- 주문번호·배송상태 맞춤 안내
- 잔여 포인트·쿠폰번호 개인화 발송
- 예약시간·담당자명 등 상세 안내
- 회원 등급별 차별화된 혜택 안내
문자 변수 활용 4단계
- 1. 엑셀 파일에 변수 열 만들기
이름·생일·쿠폰번호 등 원하는 항목을 엑셀 열 제목으로 지정 - 2. 메시지에 변수 태그 삽입
"[이름]님 [생일]을 축하드려요"처럼 열 제목을 그대로 대괄호 안에 입력 - 3. 엑셀 업로드 & 자동 매칭 확인
파일 업로드 후 미리보기에서 변수가 정확히 치환되는지 확인 - 4. 테스트 발송으로 최종 검증
본인 번호로 1건 테스트 발송 → 변수 값이 올바르게 들어갔는지 확인 후 본 발송
상황별 발송 전략 / 포인트
- 열 제목과 태그는 완전히 동일하게: 띄어쓰기 하나만 달라도 치환되지 않음
- 특수문자·공백 최소화: 변수명은 한글·영문·숫자로 간단하게 만드는 것이 안전
- 빈 값 대비: 엑셀에 값이 비어있는 셀이 있으면 치환 결과가 빈칸으로 나가니 사전 점검 필수
- 여러 변수 조합 활용: [이름]·[포인트]·[등급]처럼 여러 태그를 함께 써서 개인화 수준을 높임
- 테스트 발송 필수: 대량 발송 전 반드시 1건 이상 테스트로 치환 여부 확인
- 긴 변수값 주의: 변수 값이 너무 길면 전체 메시지가 SMS 글자수 한도를 초과할 수 있음
활용 예시
- [변수 삽입 예시] [이름]님 생신을 축하드립니다! [쿠폰코드] 코드로 30% 할인 받으세요.
- [주문 안내 예시] [이름]님 주문번호 [주문번호] 배송이 시작되었습니다.
- [치환 전/후 비교] 치환 전: [이름]님 [포인트]점 적립 치환 후: 홍길동님 1,200점 적립
- [오류 예시] 엑셀 열 제목: 고객명 / 메시지 태그: [이름] → 불일치로 치환 실패
자주 묻는 질문 Q&A
-
Q1: 변수 태그가 치환되지 않고 그대로 발송됐어요. 왜 그런가요?
A1: 가장 흔한 원인은 엑셀 열 제목과 메시지 속 [태그] 이름이 정확히 일치하지 않는 경우입니다. 띄어쓰기, 전각·반각 문자, 앞뒤 공백까지 완전히 같아야 하니 복사·붙여넣기로 통일하는 것이 안전하며, 발송 전 테스트 1건으로 반드시 확인하세요.
-
Q2: 변수를 몇 개까지 넣을 수 있나요?
A2: 변수 개수 자체에는 제한이 거의 없어 이름·생일·주문번호·담당자 등 필요한 만큼 조합할 수 있습니다. 다만 변수 값이 길어질수록 전체 메시지 글자수가 늘어나 SMS(90자) 한도를 넘으면 자동으로 LMS·MMS 요금으로 전환될 수 있으니 유의하세요.