Braze 이메일 캠페인 발송 가이드

Braze로 이메일 캠페인을 생성·발송할 때 필요한 계정/워크스페이스 준비, 유저 등록, 메시지 작성과 수신거부 링크 설정, 타겟팅 필터, 발송량 관리 절차와 필수 체크리스트

목적

Braze를 사용하여 이메일 캠페인을 발송할 때 사용 방법과 유의사항을 파악한다.

(참고 문서: Braze 한국어 가이드 — https://drive.google.com/file/d/1pjOYTcZq5K5brNv4kXfiHAYNTZ-9uzwv/view?usp=drive_link)

필수 체크리스트 (발송 전 반드시 확인)

보내려는 메일 발송량에 맞는 도메인을 선정했는가
메일 작성 시 수신거부 링크를 맞게 설정하고 테스트했는가
메일 생성 시 타겟 오디언스에 필수 필터값을 제외/포함했는가
메일 발송 전 슬랙 #도구_브레이즈_마이메일러에 공유했는가
최대 발송 수, 분당 메시지 수를 설정했는가
기타 문의 사항 발생 시 슬랙 #도구_브레이즈_마이메일러에 남긴다

사전 조건

계정 생성 — Braze가 처음이면 "중요 정보 시스템 계정 및 권한 변경 신청 프로세스"에 따라 계정 생성을 요청한다. 신청 계정 ID는 회사 이메일 주소이며, 필요 권한은 "[Braze] Permission, Role" 문서를 참고해 이름을 기입한다(복수 할당 가능). 회사 메일로 초대장이 오면 Activate My Account 버튼으로 계정을 활성화한다.

워크스페이스 선택 — 메일 보내려는 도메인에 맞는 워크스페이스를 선택한다. Development가 붙은 워크스페이스는 개발용이다. 도메인 변경사항은 별도 구글시트에서 확인한다(https://docs.google.com/spreadsheets/d/1K8sqhF-KQTre728fUmgjQ_VdiNb077OVi8TagAJOpow/edit?gid=0#gid=0).

수행 방법

1. 유저(수신자) 등록 (CSV 업로드)

사용자 필터링(필수) — 메일 대상자에서 하드바운스 유저와 유효하지 않은 이메일 주소가 제외됐는지 MA 담당자에게 아래 조건으로 확인받는다.

-- 유효한 이메일 주소만
WHERE email RLIKE '^[A-Za-z0-9_\-\^+\$''&#/!%*=?`|~]+(\.[A-Za-z0-9_\-\^+\$''&#/!%*=?`|~]+)*@[a-z\d]([a-z\d-]{0,61}[a-z\d])?(\.[a-z\d]([a-z\d-]{0,61}[a-z\d])?)+$'

-- 하드바운스 유저 제외 조건 (2025-07-01 최종 업데이트)
WHERE email not in (select f.email from temp.temp_hashin.mymailer_fail_0701 f)

Custom Attributes(필수) — CSV에 넣을 컬럼은 아래를 지켜 중복·정합성 붕괴를 막는다.

miricanvas_kr 워크스페이스, 미리캔버스 사용자 대상: 미리캔버스 사용자 정보가 Databricks에서 매일 Braze DB로 동기화되므로 external_id(미리캔버스 account_id) 컬럼만 넣으면 이메일·이름 등 속성이 자동으로 맵핑된다. 기존 custom attributes를 함께 올리면 정합성이 깨지므로 가능한 external_id만 사용한다.
miricanvas_kr 워크스페이스, 비사용자 대상: external_id에 맵핑된 정보가 없으므로 email·name 등 필요한 속성을 컬럼으로 직접 추가한다.
bizhows 워크스페이스, 비즈하우스 사용자 대상: external_id(비즈하우스 owner 값)만으로 이메일·이름 등이 자동 맵핑된다. 마찬가지로 가능한 external_id만 사용한다.
새 컬럼 추가 시 워크스페이스에 없는 이름이면 Custom Attribute가 자동 생성된다. 먼저 좌패널 Data Settings > Custom Attributes 목록에서 기존 속성을 확인하고 재사용한다. 새로 추가해야 하면 영어 소문자와 _만 사용하고 띄어쓰기를 금지하며(예: custom_attributes), 추가 후 [...] > Edit > Description에 추가일/추가자/목적을 기록한다.

CSV Import 단계

Audience > Import Users로 이동
Select the type of user information you want to import에서 Attributes를 선택하고 CSV 첨부 (위 주의사항을 반드시 지킨다)
업로드 후 다이얼로그에서 타겟팅 필터 생성 및 새 세그먼트 추가 옵션 선택 후 Import 실행 (권장)
Segments 메뉴에서 생성된 세그먼트를 확인하고, 해당 세그먼트를 수신자로 지정해 메일을 발송한다

2. 메일 생성

캠페인 생성 — 좌패널 캠페인 탭 > 우측 상단 캠페인 생성 > 원하는 채널 선택(default는 이메일).

캠페인 설정

캠페인 제목/설명: 수신자에게 보이지 않으며 운영자가 캠페인 목록에서 구분하기 위한 용도
캠페인 태그(필수, 2025-09-16부터): 발송 도메인별 이력 추적을 위해 반드시 설정한다. Analytics > Report Builder에서 태그 기준 집계 리포트(바운스율·오픈율·전달율·스팸율·클릭률)를 볼 수 있다. 예: hello@mkt.miricanvas.co.kr로 발송하면 mkt.miricanvas.co.kr 태그 선택
이메일 베리언트(옵션): 하나의 캠페인 안에 여러 테스트군(실험군)을 + 버튼으로 추가 가능

메시지 편집 방법 선택 — Drag-and-drop editor / HTML code editor / Templates(저장된 템플릿) 중 선택

메시지 작성 및 수신거부 링크 추가(필수)

광고성 메일 발송 시 수신거부 링크가 필수다. 반드시 실제 동작하는 수신거부 링크를 포함하고 테스트 발송으로 동작 여부를 확인한다. 미리캔버스 수신거부 링크와 Braze 권고 태그를 둘 다 포함해야 한다.

서비스별 수신거부 링크:

서비스	대상	링크
미리캔버스	국내	`https://www.miricanvas.com/mail/unsubscribe?u={{custom_attribute.${uuid}}}` (Braze UUID 속성 필요)
미리캔버스	글로벌	Braze 권고 태그를 그대로 수신거부 링크로 사용: `<a href="{{${set_user_to_unsubscribed_url}}}"></a>` — 이 경우 아래 Braze 권고 태그 추가는 생략 가능
비즈하우스	국내	`https://www.bizhows.com/mail/include/rcv_mail_confirm.jsp?{{custom_attribute.${deny_recv_key_uri}}}`
비즈하우스	글로벌	미리캔버스 글로벌과 동일

Braze 권고 태그: {{${set_user_to_unsubscribed_url}}}. 아래처럼 hidden div로 감싸면 실제 수신함에서 시각적으로는 노출되지 않지만 태그는 포함된다.

<div hidden>
  <a href="{{${set_user_to_unsubscribed_url}}}"></a>
</div>

왜 필요한가 — 미국 CAN-SPAM Act of 2003는 상업성 이메일에 회사 실주소와 수신거부 링크 포함을 의무화하며, {{${set_user_to_unsubscribed_url}}}가 이 필수 수신거부 링크를 나타낸다. AB180 안내에 따르면 이 태그를 무조건 포함해 발송해야 하며, 포함하지 않으면 실제 미리캔버스 수신거부 링크가 있어도 Unsubscribe link 관련 경고가 표시된다.

발송 정보 수정 — 메시지 편집 후 Done > Edit sending info에서 Subject(메일 제목), From display name/address(발신자), Reply-to address(회신 주소), 원클릭 목록 구독취소, BCC 주소를 편집한다. 소속 팀·발송 목적·목표 발송량에 따라 적절한 이메일 도메인을 위 도메인 매핑 시트에서 선택한다.

미리보기 및 테스트(필수) — Preview and test에서 테스트 메일을 발송하고 실제 수신함에서 수신거부 링크가 정상 동작하는지 반드시 확인한다.

수행 방법 — Schedule Delivery

전달 타입

Send immediately: 즉시 발송
지정한 시간에 발송(추천): Send는 '한 번'으로, 시작 시간과 예정일을 매번 새로 설정
실행 기반 / API 트리거링: 현재 사용하지 않음(미캔은 회원가입 이벤트만 가능)

전달 제어(전달 빈도) — 사용자가 받을 메시지 수를 관리하는 옵션으로 '최대 게재빈도' 설정을 '켜기'로 유지한다. 단, IP Warming 기간에는 유저에게 안 보내질 확률이 있어 이 옵션을 끄고 보내는 것을 권장한다.

수행 방법 — Target Audience

타겟 세그먼트 선택 — 등록한 세그먼트를 선택한다.

필수 필터 설정(필수) — 워크스페이스와 대상에 따라 아래 필터를 반드시 설정한다.

워크스페이스/대상	반드시 포함해야 할 필터
miricanvas, 미리캔버스 사용자 대상	Segment Membership Not included: 미리캔버스 소프트바운스 유저(1개월 이내) / Custom Attributes mc_status = ACTIVE / Custom Attributes mc_email_receiption = YES(광고 메일인 경우)
miricanvas, 비사용자 대상	Segment Membership Not included: 미리캔버스 소프트바운스 유저(1개월 이내)
bizhows	Segment Membership Not included: 비즈하우스 소프트바운스 유저(1개월 이내) / Custom Attributes biz_email_receiption = YES(광고 메일인 경우)
printhub	Segment Membership Not included: 프린트허브 소프트바운스 유저(1개월 이내)
designhub	Segment Membership Not included: 디자인허브 소프트바운스 유저(1개월 이내)

Suppression List 자동 제외(2025-12-15부터) — 아래 조건에 해당하는 사용자는 별도 필터 없이 자동 제외된다: 미리캔버스 하드바운스 유저(CSV 250701 포함), 미리캔버스 하드바운스 유저 세그먼트, [AB180] Hard Bounced, Retargeting > Email > Hard bounced = true, Custom Attributes email_valid = false.

ELV 이메일 유효성(필수) — 제외 그룹(Exclusion group) > 커스텀 속성 > elv_email_valid "다음에 해당함" false. 모든 국내·해외 발송에 기본 적용하되 프린트 허브 유저는 제외한다.

수신거부 사용자 포함 여부 설정(필수)

공지성 메일(개인정보처리방침 변경, 결제내역, 알림 등): all users including unsubscribed users
광고성 메일(프로모션, 이벤트, 상품 소개 등): users who are subscribed or opted in

랜덤 버킷(대량 발송 시) — 한 캠페인당 최대 발송 가능 건수는 100만 건이다. 100만 건 이상이면 filter에 random bucket(0~~9999)을 추가해 구간화한 뒤 여러 캠페인으로 나눠 발송한다. 예: news.miricanvas.co.kr의 하루 최대 발송량 200만 건 → 1차 randombucket 4000 미만, 2차 4000 이상~~7000 미만, 3차 7000 이상.

메일 최대 발송량 및 속도 설정 — 하나의 도메인당 하루 최대 발송량은 200만 건을 넘을 수 없다(타 부서와 도메인 공용 시 합계 기준). 분당 메시지 수는 아래를 참고해 설정한다.

시기	권장 속도
IP Warming 중	~~1,000msg/min 완전 안전 / 1,000~~2,000 안정적 확장 / 2,000~~3,000 안정권 / 3,000~~4,000 주의(평판 좋은 발신자 기준, 스팸률·바운스 관리 필수)
IP Warming 후	3,000~~5,000 대다수 서비스 안정권 / 6,000~~8,000 수개월 이상 High 평판 고품질 발신자 한정 / 10,000 이상 상위 1~3% 발신자 한정

수행 방법 — Assign Conversions

캠페인 최초 세팅 시 전환 이벤트를 할당한다. 전환 기한은 기본 7일을 권장한다.

이메일 열람: 유저가 이메일을 열람(오픈)했을 때 기록
이메일 클릭: 유저가 이메일 내 링크를 클릭했을 때 기록
사용자 지정 이벤트: SDK 설치 이후 집계되며 별도 설치가 없으면 수집되지 않을 수 있음
세션 시작: 유저가 세션을 시행했을 때 기록

수행 방법 — Review Summary

세팅이 잘 되었는지 확인하는 마지막 단계다. 도달 가능한 사용자 수(케파)와 메시지를 수신할 수 있는 최대 사용자 수(발송하려는 수치)가 맞는지 확인한 뒤 우측 하단 캠페인 업데이트로 적용한다.

데이터 보는 방법

지표	내용
오디언스	A/B 테스트 시 몇 %로 분배해서 발송했는지
발송 수	발송하고자 했던 메일 수
전달 수	실질적으로 유저가 전달받은 메일 수
반송 수	반송된 메일 수(소프트+하드바운스)
스팸 신고	스팸신고된 메일 수. 실제 유저가 신고하지 않는 이상 0%가 기본값
총 열람 수	유저가 이메일을 오픈한 수(중복 포함)
고유 열람	유저가 이메일을 오픈한 수(중복 제외)
총 클릭 수	유저가 이메일 내 링크를 클릭한 수(중복 포함)
고유 클릭 수	유저가 이메일 내 링크를 클릭한 수(중복 제외)
열람율 대비 클릭	고유 열람 수 대비 고유 클릭 수

이메일 템플릿 설정

좌패널 템플릿 > 이메일 템플릿에서 저장된 이메일 템플릿을 수정·생성할 수 있다.

확인 방법

발송 후 Analytics > Report Builder에서 캠페인 태그 기준으로 바운스율·오픈율·전달율·스팸율·클릭률 등 상세 리포트를 확인한다.

미리보기/테스트 단계에서 테스트 발송을 하고, 실제 이메일 수신함에서 수신거부 링크를 클릭해 아래 정상/비정상 패턴으로 동작을 확인한다.

정상: 수신거부 확인 https://www.miricanvas.com/mail/unsubscribe?u=<uuid>, 수신거부 성공/이미 수신거부/이메일 수신 https://www.miricanvas.com/mail/unsubscribe/complete?u=<uuid> (동일 UI, 상황별 텍스트·이미지만 다름)
비정상: 빈 화면(UUID 값이 없는 사용자) / 미리캔버스 메인 페이지로 이동(수신거부 API 응답 실패 또는 UUID 오류)

실패 / 예외 / Escalation

수신거부 링크가 정상 동작하지 않으면 메시지에 포함시킨 링크를 다시 확인한다.
기타 문의 사항은 슬랙 #도구_브레이즈_마이메일러에 남긴다.

부록

메일 세팅 시연 영상(mp4)은 원문 Confluence 페이지의 [부록] 절 첨부파일을 참고한다. 이 문서에는 파일을 이관하지 않았다.