사용 가이드
CSV 준비부터 오류 확인까지
발송 전은 문구의 변수와 수신자 CSV가 맞는지 확인하는 독립 도구입니다. 실제 발송이나 플랫폼 소재 등록은 하지 않습니다.
검사 중에 이 가이드를 새 탭으로 열었다면, 입력한 CSV와 결과가 남아 있는 원래 검사 탭으로 돌아가세요. 이 페이지의 ‘새 검사 시작’ 링크는 빈 검사 화면을 엽니다.
첫 줄에 열 이름
CSV 첫 줄을 이름,혜택,고객ID처럼 적습니다. 같은 열 이름, 빈 열 이름, 열 이름 앞뒤의 공백은 사용할 수 없습니다.
문구에 변수 넣기
검사기에서 {{이름}}처럼 열 이름을 감쌉니다. 철자와 띄어쓰기는 CSV 첫 줄과 정확히 같아야 합니다.
행별 결과 확인
CSV를 고르고 검사합니다. 빈 변수와 선택한 식별 열의 누락·중복을 행 번호로 찾습니다. 선택한 한 행의 치환 문구도 미리 볼 수 있습니다.
CSV 예시
첫 데이터 행은 통과할 수 있고, 다음 행은 이름 빈값으로 표시됩니다. 쉼표가 들어 있는 값은 큰따옴표로 감싸세요.
이름,혜택,고객ID
가상고객A,10% 쿠폰,A-001
,무료배송 쿠폰,A-002이 CSV는 발송 전 도구의 검사용 예시입니다. 카카오모먼트의 공식 수신자 업로드 양식이라는 뜻이 아닙니다. 파일 20MB, 데이터 50,000행·총 500,000칸, 열 100개가 상한입니다. 문구가 길면 검사 작업량에 따라 CSV를 나누어야 합니다.
오류 행 수정과 CSV 다운로드
검사 화면에서 데이터 행 번호와 열을 고르고 한 칸의 값을 바꿉니다. ‘변경 적용 및 재검사’를 누르면 현재 규칙으로 결과를 다시 계산합니다. 적용하지 않은 초안은 다른 칸으로 이동할 때 확인을 거칩니다. 원본 파일은 수정하지 않으며, 편집 내용은 이 탭을 닫으면 사라집니다.
수정본 CSV는 원래 열·행 순서와 수정하지 않은 칸의 문자열 값을 유지합니다. 출력은 UTF-8이며 CP949 입력도 UTF-8로 바뀝니다. 쉼표·따옴표·줄바꿈이 들어 있는 값은 CSV 형식에 맞게 다시 기록되므로 원본 파일의 바이트 형태와 같지는 않습니다.
선행 0이나 긴 숫자는 CSV 데이터에는 문자열로 유지되지만, Excel에서 파일을 직접 열면 숫자처럼 자동 변환될 수 있습니다. 확인할 때 해당 열을 텍스트로 가져오세요. 수식으로 해석될 수 있는 헤더나 값은 위치와 개수를 먼저 보여 주며, 위험 확인 없이는 수정본을 내려받을 수 없습니다. 내려받은 파일은 발송 플랫폼의 공식 업로드 형식과 개인정보 보관 기준을 따로 확인하세요.
검사 기준 선택
카카오 공식 신규 메시지 안내에는 기존 ‘개인화메시지 × 도달’ 캠페인의 종료가 예정되어 있다고 적혀 있습니다. 현재 이용하는 상품의 최신 기준을 확인하세요. 기존 소재 가이드 · 신규 메시지 안내
URL 탐지는 완전하지 않고 글자 수는 유니코드 코드포인트 기준입니다. 이모지나 결합 문자는 실제 발송 플랫폼에서 다시 확인하세요.
파일과 결과 처리
선택한 CSV와 이미지는 브라우저 메모리에서만 읽고 서버에 업로드하지 않습니다. 검사 결과 CSV에는 행 번호, 오류 설명, 검사 기준과 이미지 검사 상태만 담고 수신자 값은 넣지 않습니다. 별도로 내려받는 수정본 CSV에는 수신자 값이 포함됩니다. 브라우저 창을 닫으면 검사에 사용한 데이터는 사라집니다.
제품 개선을 위해 예시 실행, 실제 CSV 검사, 실제 편집 적용, 수정본 다운로드 시작 요청을 UTC 날짜별 합계로 저장합니다. 현재 탭에서 같은 종류의 반복 요청을 줄입니다. 요청에는 고정된 실행 종류만 들어가며 CSV 내용·파일명·열 이름·행 수를 넣지 않습니다. 앱은 IP나 쿠키를 읽거나 데이터베이스에 저장하지 않습니다. 이 횟수는 사용자 수나 실제 다운로드 완료 수가 아닙니다. 집계에 실패해도 검사와 편집은 계속 사용할 수 있습니다.
수신 동의, 플랫폼 계정 권한, 소재 심사, 발송 시간·잔액, 버튼 랜딩 URL, 변수 이미지 URL은 확인하지 않습니다. 검사 결과가 실제 발송 성공을 보장하지 않습니다.
기존 검사를 진행 중이라면 원래 검사 탭으로 돌아가세요.