콘텐츠로 건너뛰기

테스트 메시지 보내기

사용자에게 메시징 캠페인을 보내기 전에, 메시지가 올바르게 표시되고 의도한 대로 작동하는지 확인하기 위해 테스트하는 것을 권장합니다. Braze 대시보드의 도구를 사용하여 선택한 기기 또는 팀원에게 테스트 메시지를 생성하고 보낼 수 있습니다.

1단계: 테스트 사용자 식별하기

메시징 캠페인을 테스트하기 전에 테스트 사용자를 식별하는 것이 중요합니다. 테스트 사용자는 기존 사용자 ID 또는 이메일 주소일 수도 있고, 메시징 캠페인 테스트 전용으로 사용하는 신규 사용자일 수도 있습니다.

선택 사항: 콘텐츠 테스트 그룹 만들기

테스트 사용자를 편리하게 관리하려면 콘텐츠 테스트 그룹을 만드세요. 콘텐츠 테스트 그룹에는 캠페인에서 테스트 메시지를 받을 사용자 그룹이 포함됩니다. 캠페인의 테스트 수신자 아래 콘텐츠 테스트 그룹 추가 필드에 이 테스트 그룹을 추가하면, 개별 테스트 사용자를 만들거나 추가하지 않고도 테스트를 시작할 수 있습니다.

2단계: 채널별 테스트 메시지 보내기

테스트 메시지를 보내는 단계는 해당 채널의 다음 섹션을 참조하세요.

배너 메시지를 만든 후 배너를 미리 보거나 테스트 메시지를 보낼 수 있습니다.

  1. 배너 메시지 초안을 작성합니다.
  2. 미리보기를 선택하여 배너를 미리 보거나 테스트 메시지를 보냅니다.
  3. 테스트 메시지를 보내려면 콘텐츠 테스트 그룹 또는 한 명 이상의 개별 사용자를 테스트 수신자로 추가한 다음 테스트 보내기를 선택합니다.

기기에서 최대 5분 동안 테스트 메시지를 확인할 수 있습니다.

배너 작성기의 미리보기 탭.

테스트 체크리스트

  • 배너 캠페인이 배치에 할당되어 있나요?
  • 이미지와 미디어가 타겟 기기 유형과 화면 크기에서 예상대로 표시되고 작동하나요?
  • 링크와 버튼이 사용자를 올바른 위치로 안내하나요?
  • Liquid가 예상대로 작동하나요? Liquid가 정보를 반환하지 않는 경우를 대비해 기본 속성 값을 고려했나요?
  • 문구가 명확하고 간결하며 정확한가요?

테스트 Content Cards는 푸시 알림을 통해 전달됩니다. 카드는 푸시 페이로드에 패키징되며, 푸시가 수신되면 SDK가 이를 추출하여 로컬에 캐시합니다.

이 프로세스는 일반적인 카드 전달 시스템을 우회하므로, 콘텐츠 카드를 테스트하는 경우에도 푸시가 활성화되어 있어야 합니다.

테스트 Content Cards는 전송 후 약 5분 뒤에 만료됩니다.

콘텐츠 카드를 만든 후 앱에 테스트 콘텐츠 카드를 보내 실시간으로 어떻게 보이는지 확인할 수 있습니다.

  1. 콘텐츠 카드 초안을 작성합니다.
  2. 테스트 탭을 선택하고 이 테스트 메시지를 받을 콘텐츠 테스트 그룹 또는 개별 사용자를 하나 이상 선택합니다.
  3. 테스트 보내기를 선택하여 콘텐츠 카드를 앱으로 보냅니다.

테스트 콘텐츠 카드

미리보기

미리보기 탭에서 카드를 작성하면서 미리 볼 수 있습니다. 이를 통해 사용자 관점에서 최종 메시지가 어떻게 보일지 시각적으로 확인할 수 있습니다.

테스트 체크리스트

  • 테스트 사용자가 유효한 푸시 토큰으로 푸시에 옵트인되어 있나요?
  • 이미지와 미디어가 예상대로 표시되고 작동하나요?
  • Liquid가 예상대로 작동하나요? Liquid가 정보를 반환하지 않는 경우를 대비해 기본 속성 값을 고려했나요?
  • 문구가 명확하고 간결하며 정확한가요?
  • 링크가 사용자를 올바른 위치로 안내하나요?
  • 테스트 사용자가 유효한 푸시 토큰으로 푸시에 옵트인되어 있나요?

깨진 이미지 문제 해결

콘텐츠 카드 이미지가 렌더링되지 않거나 깨져 보이는 경우:

  • URL이 올바르고 URL 인코딩되어 있는지 확인하세요: URL의 특수 문자(예: 공백 또는 쿼리 매개변수)는 올바르게 인코딩되어야 합니다. 그렇지 않으면 이미지 요청이 실패합니다.
  • 콘텐츠 보안 정책을 확인하세요: 조직에 콘텐츠 보안 정책(CSP) 또는 내부 IT 보안 규칙이 있는 경우 해당 정책이 이미지 도메인을 차단할 수 있습니다. 이미지 URL의 도메인이 CSP에서 허용되는지 확인하세요.
  • HTTPS를 사용하세요: 브라우저와 앱에서 혼합 콘텐츠 차단을 피하려면 이미지 URL에 http:// 대신 https://를 사용해야 합니다.
  • 브라우저에서 URL을 직접 열어보세요: 브라우저에서 이미지가 로드되지 않으면 Braze가 아니라 이미지 URL 또는 호스팅에 문제가 있는 것입니다.

디버그

Content Cards가 전송된 후 개발자 콘솔의 이벤트 사용자 로그에서 문제를 분석하거나 디버그할 수 있습니다.

일반적인 사용 사례는 사용자가 특정 콘텐츠 카드를 볼 수 없는 이유를 디버그하는 것입니다. 이렇게 하려면 이벤트 사용자 로그에서 세션 시작 시 노출 전에 SDK로 전달된 Content Cards를 찾아 특정 캠페인까지 추적할 수 있습니다.

  1. 설정 > 이벤트 사용자 로그로 이동합니다.
  2. 테스트 사용자의 SDK 요청을 찾아 펼칩니다.
  3. 원시 데이터를 클릭합니다.

  4. 세션의 id를 찾습니다. 다음은 발췌 예시입니다.

    


     [
   {
     "session_id": "D1B051E6-469B-47E2-B830-5A728D1D4AC5",
     "data": {
       "ids": [
         "NDg2MTY5MmUtNmZjZS00MjE1LWJkMDUtMzI1NGZiOWU5MDU3"
       ]
     },
     "name": "cci",
     "time": 1636106490.155
   }
 ]

  1. Base64 Decode and Encode와 같은 디코딩 도구를 사용하여 Base64 형식의 id를 디코딩하고 연결된 campaign_id를 찾습니다. 이 예시에서는 다음과 같은 결과가 나옵니다.

    


     4861692e-6fce-4215-bd05-3254fb9e9057_$_cc=c3b25740-f113-c047-4b1d-d296f280af4f&mv=6185005b9d9bee79387cce45&pi=cmp

    여기서 4861692e-6fce-4215-bd05-3254fb9e9057이 campaign_id입니다.

  2. Campaigns 페이지로 이동하여 campaign_id를 검색합니다.

Campaigns 페이지에서 campaign_id 검색

여기에서 메시지 설정과 콘텐츠를 검토하여 사용자가 특정 콘텐츠 카드를 볼 수 없는 이유를 살펴보고 파악할 수 있습니다.

앱과 테스트 기기에 푸시 알림이 설정되어 있다면, 앱에 테스트 인앱 메시지를 보내 실시간으로 어떻게 보이는지 확인할 수 있습니다.

  1. 인앱 메시지 초안을 작성합니다.
  2. 테스트 탭을 선택하고 개별 사용자 추가 필드에 이메일 주소 또는 사용자 ID를 추가합니다.
  3. 테스트 보내기를 선택하여 푸시 메시지를 기기로 보냅니다.

기기 화면 상단에 테스트 푸시 메시지가 표시됩니다.

테스트 인앱 메시지

푸시 메시지를 직접 클릭하여 열면 앱으로 이동하며, 여기서 인앱 메시지 테스트를 확인할 수 있습니다. 이 인앱 메시지 테스트 기능은 사용자가 테스트 푸시 알림을 클릭해야 인앱 메시지가 트리거된다는 점에 유의하세요. 따라서 테스트 푸시 알림이 성공적으로 전달되려면 사용자가 해당 앱에서 푸시 알림을 받을 수 있는 자격을 갖추고 있어야 합니다.

미리보기

미리보기 탭에서 인앱 메시지를 작성하면서 미리 볼 수 있습니다. 이를 통해 사용자 관점에서 최종 메시지가 어떻게 보일지 시각적으로 확인할 수 있습니다. 무작위 사용자, 특정 사용자 또는 커스텀 사용자에게 메시지가 어떻게 보일지 미리 볼 수 있습니다. 또한 모바일 기기 또는 태블릿용 메시지를 미리 볼 수도 있습니다.

인앱 메시지를 작성할 때 메시지가 어떻게 보일지 미리보기를 표시하는 작성 탭. 사용자가 선택되지 않았으므로 본문 섹션에 추가된 Liquid가 그대로 표시됩니다.

Braze에서는 세 가지 세대의 인앱 메시지를 사용할 수 있습니다. 지원하는 세대에 따라 메시지를 보낼 기기를 세밀하게 조정할 수 있습니다.

인앱 메시지를 미리 볼 때 세대 간 전환하기.

테스트 체크리스트

  • 이미지와 미디어가 예상대로 표시되고 작동하나요?
  • Liquid가 예상대로 작동하나요? Liquid가 정보를 반환하지 않는 경우를 대비해 기본 속성 값을 고려했나요?
  • 문구가 명확하고 간결하며 정확한가요?
  • 버튼이 사용자를 올바른 위치로 안내하나요?

접근성 스캐너

접근성 모범 사례를 지원하기 위해 Braze는 기존 HTML 편집기로 만든 인앱 메시지의 콘텐츠를 접근성 표준에 따라 자동으로 스캔합니다. 이 스캐너는 웹 콘텐츠 접근성 지침(WCAG) 표준을 충족하지 않을 수 있는 콘텐츠를 식별하는 데 도움이 됩니다. WCAG는 장애가 있는 사람들이 웹 콘텐츠에 더 쉽게 접근할 수 있도록 W3C(World Wide Web Consortium)에서 개발한 국제적으로 인정받는 기술 표준입니다.

접근성 스캔 결과

작동 방식

스캐너는 커스텀 HTML 메시지에서 자동으로 실행되며 전체 HTML 메시지를 WCAG 2.1 AA 규칙 세트 전체에 대해 평가합니다. 플래그가 지정된 각 문제에 대해 다음을 표시합니다.

  • 관련된 특정 HTML 요소
  • 접근성 문제에 대한 설명
  • 추가 맥락 또는 해결 가이드 링크

자동화된 접근성 테스트 이해하기

자동 접근성 테스트를 통해 대체 텍스트 누락이나 WCAG 레벨 AA 표준에 따른 낮은 색상 대비와 같은 일반적인 문제를 발견할 수 있습니다. 이는 보다 포용적인 메시지를 만들기 위한 강력한 출발점입니다.

하지만 자동화로 모든 것을 파악할 수는 없습니다. 포커스 순서가 합리적인지, 링크와 버튼에 명확한 레이블이 있는지, 안내 사항을 쉽게 따라갈 수 있는지 등 사람의 눈이 필요한 문제도 있습니다. 이러한 점검은 최종 판단이 아닌 진단 도구로 생각하세요. 플래그가 지정된 이슈는 수동으로 검토하고, “검토 필요”로 표시된 항목에 대해서는 최선의 판단을 내리는 것을 권장합니다.

추가 지원이 필요하다면, Braze의 접근성 가이드에서 모든 사용자가 콘텐츠를 더 쉽게 이용할 수 있도록 하는 실용적인 팁을 확인할 수 있습니다. 주요 내용은 다음과 같습니다:

자동화된 테스트와 신중한 수동 검토를 결합하면 더 많은 문제를 발견하고, 모든 사용자에게 더 나은 경험을 제공할 수 있습니다.

  1. LINE 메시지를 만듭니다.
  2. 테스트 탭을 선택하고 이 테스트 메시지를 받을 콘텐츠 테스트 그룹 또는 개별 사용자를 하나 이상 선택합니다.
  3. 테스트 보내기를 선택하여 메시지를 보냅니다.

테스트 LINE 메시지.

모바일 푸시

  1. 모바일 푸시 초안을 작성합니다.
  2. 테스트 탭을 선택하고 개별 사용자 추가 필드에 이메일 주소 또는 사용자 ID를 추가합니다.
  3. 테스트 보내기를 선택하여 작성한 메시지를 기기로 보냅니다.

테스트 푸시

선택한 사용자 중 일치하는 푸시 토큰을 가진 사용자가 없다는 오류가 표시되면, 테스트 사용자에게 선택한 플랫폼에 대한 유효한 푸시 토큰이 없는 것입니다. 사용자는 앱에서 세션을 시작하고 해당 기기에서 푸시를 활성화해야 합니다. 자세한 내용은 푸시 활성화 및 푸시 구독을 참조하세요.

웹 푸시

  1. 웹 푸시를 만듭니다.
  2. 테스트 탭을 선택합니다.
  3. 나에게 테스트 보내기를 선택합니다.
  4. 테스트 보내기를 선택하여 웹 푸시를 웹 브라우저로 보냅니다.

테스트 웹 푸시

Braze 대시보드의 푸시 메시지를 이미 수락한 경우 메시지가 화면 모서리에 표시됩니다. 그렇지 않은 경우 메시지가 표시되면 허용을 선택하면 메시지가 표시됩니다.

선택한 사용자 중 웹 푸시에 대해 일치하는 푸시 토큰을 가진 사용자가 없다는 오류가 표시되면, 테스트 사용자에게 선택한 플랫폼에 대한 유효한 푸시 토큰이 등록되어 있는지 확인하세요. 푸시 토큰을 받으려면 사용자가 기기에서 해당 앱의 푸시 알림을 받도록 설정되어 있어야 합니다. 자세한 내용은 푸시 활성화 및 푸시 구독을 참조하세요.

SMS, MMS 또는 RCS 메시지를 만든 후 휴대폰으로 테스트 메시지를 보내 실시간으로 어떻게 보이는지 확인할 수 있습니다. 수신자는 테스트를 보낼 때 선택한 SMS 구독 그룹에 속해 있어야 하고, 유효한 전화번호가 있어야 하며, 지리적 권한에서 하나 이상의 국가가 선택되어 있어야 합니다. 자세한 내용은 SMS FAQ를 참조하세요.

  1. SMS, MMS 또는 RCS 메시지 초안을 작성합니다.
  2. 테스트 탭을 선택하고 이 테스트 메시지를 받을 콘텐츠 테스트 그룹 또는 개별 사용자를 하나 이상 선택합니다.
  3. 테스트 보내기를 선택하여 테스트 메시지를 보냅니다.

테스트 SMS 메시지

웹훅을 만든 후 테스트 발송을 통해 웹훅 응답을 확인할 수 있습니다. 테스트 탭을 선택하고 테스트 보내기를 선택하면 제공된 웹훅 URL로 테스트 발송이 전송됩니다. 개별 사용자를 선택하여 특정 사용자 기준으로 응답을 미리 볼 수도 있습니다.

  1. WhatsApp 메시지를 만듭니다.
  2. 테스트 탭을 선택하고 이 테스트 메시지를 받을 콘텐츠 테스트 그룹 또는 개별 사용자를 하나 이상 선택합니다.
  3. 이 메시지에 사용하는 구독 그룹과 연결된 전화번호로 WhatsApp 메시지를 보내 대화 창을 시작합니다. 연결된 전화번호는 테스트 탭의 알림에 표시되어 있습니다.
  4. 테스트 보내기를 선택하여 메시지를 보냅니다.

테스트 WhatsApp 메시지.

개인화된 Campaign 테스트

사용자 데이터를 채우거나 커스텀 이벤트 속성을 사용하는 Campaign(캠페인)을 테스트하는 경우, 추가 단계나 다른 단계를 거쳐야 합니다.

사용자 속성으로 개인화된 Campaign 테스트

메시지에 개인화를 사용하는 경우, Campaign을 제대로 미리 보고 사용자 데이터가 콘텐츠에 올바르게 채워지는지 확인하려면 추가 단계를 거쳐야 합니다. 작성기, Inbox Vision, Canvas 전반의 미리보기 제한 사항은 개인화 미리보기를 참조하세요.

테스트 메시지를 보낼 때는 기존 사용자 선택 옵션을 선택하거나 커스텀 사용자로 미리 보기를 선택하세요.

개인화된 메시지 테스트

기존 사용자 선택

기존 사용자를 선택하는 경우, 검색 필드에 특정 사용자 ID나 이메일을 입력합니다. 그런 다음 대시보드 미리보기를 사용하여 해당 사용자에게 메시지가 어떻게 표시되는지 확인하고, 해당 사용자가 보게 될 내용을 반영한 테스트 메시지를 기기로 보낼 수 있습니다.

사용자 선택

커스텀 사용자 선택

커스텀 사용자로 미리 보는 경우, 사용자의 이름이나 커스텀 속성 등 개인화에 사용할 수 있는 다양한 필드에 텍스트를 입력합니다. 이번에도 본인의 이메일 주소를 입력하여 기기로 테스트를 보낼 수 있습니다.

커스텀 사용자

기존 사용자 사용자 지정

무작위 사용자나 기존 사용자의 개별 필드를 편집하여 메시지 내 동적 콘텐츠를 테스트할 수 있습니다. 편집을 선택하면 선택한 사용자를 수정 가능한 커스텀 사용자로 전환할 수 있습니다.

"편집" 버튼이 있는 "사용자로 미리보기" 탭

커스텀 이벤트 속성으로 개인화된 Campaign 테스트

커스텀 이벤트 속성으로 개인화된 Campaign을 테스트하는 방법은 앞서 설명한 다른 유형의 Campaign 테스트와 약간 다릅니다.

방법 1: Campaign 수동 트리거

커스텀 이벤트 속성으로 개인화된 Campaign을 확실하게 테스트하려면 Campaign을 직접 트리거할 수 있습니다.

  1. 이벤트 속성이 포함된 문구를 작성합니다.

속성을 사용하여 테스트 메시지 작성

  1. 실행 기반 전달을 사용하여 이벤트가 발생할 때 Campaign이 전달되도록 합니다.

테스트 메시지 전달 설정

  1. 테스트 필터를 사용하거나 본인의 이메일 주소를 타겟팅하는 등 테스트할 때와 같은 방식으로 사용자를 타겟팅하고 Campaign 생성을 마칩니다.

테스트 메시지 타겟팅

  1. 앱으로 이동하여 커스텀 이벤트를 완료합니다.

Campaign이 트리거되어 이벤트 속성으로 맞춤화된 메시지가 표시됩니다.

테스트 메시지 예시

방법 2: 본인에게 테스트 메시지 보내기

또는 커스텀 사용자 ID를 저장하고 있다면, 본인에게 맞춤화된 테스트 메시지를 보내 Campaign을 테스트할 수도 있습니다.

  1. Campaign 문구를 작성합니다.
  2. 테스트 탭을 선택하고 맞춤형 사용자를 선택합니다.
  3. 페이지 하단에 커스텀 이벤트 속성을 추가하고, 상단 상자에 사용자 ID나 이메일 주소를 추가합니다.
  4. 테스트 전송을 선택하면 해당 속성으로 개인화된 메시지를 받을 수 있습니다.

맞춤형 사용자를 사용한 테스트

방법 3: Liquid 사용

Liquid로 값을 직접 입력하여 커스텀 이벤트 속성을 테스트할 수 있습니다.

  1. 메시지 편집기에서 커스텀 이벤트 속성 값을 입력합니다.
  2. 사용자로 미리보기 탭을 선택하여 올바른 메시지가 표시되는지 확인합니다.

제한 사항

테스트 메시지가 실제 사용자에게 보내는 Campaigns 또는 Canvases와 다르게 작동하는 경우가 몇 가지 있습니다. 이런 경우에는 제한된 테스트 사용자 그룹을 대상으로 Campaign 또는 Canvas를 실행하여 동작을 검증하는 것이 좋습니다.

  • 테스트 메시지에서 Braze 환경설정 센터를 열면 Save Preferences 버튼이 비활성화됩니다. 환경설정 센터 Liquid 태그가 유효한 링크로 변환되지 않을 수도 있습니다. 이는 예상된 동작입니다. 포괄적으로 테스트하려면 환경설정 센터 테스트를 참조하세요.
  • 인앱 메시지와 Content Cards를 테스트하려면 대상 사용자가 대상 기기에 대한 푸시 토큰을 가지고 있어야 합니다.
  • 이메일의 탈퇴 링크를 테스트할 때 {{${set_user_to_unsubscribed_url}}}는 수신자 이메일 주소에 워크스페이스 내 외부 ID가 있는 고객 프로필이 연결된 경우에만 전체 URL로 렌더링됩니다. 고객 프로필이나 외부 ID가 없으면 이 태그는 <a href="#">Unsubscribe</a>로 렌더링됩니다. 테스트 사용자의 이메일 주소에 해당 워크스페이스의 기존 프로필이 있는지 확인하세요.
  • 테스트 메시지 기능으로 보낸 이메일에는 List-Unsubscribe 헤더가 포함되지 않습니다.
  • 시드 그룹 사용자에게 보낸 이메일은 고객 프로필의 Campaign Received 목록을 업데이트하지 않으며, 대시보드 분석의 전송 수(Sends)도 증가시키지 않습니다.

문제 해결

인앱 메시지

인앱 메시지 캠페인이 푸시 캠페인에 의해 트리거되지 않는 경우, 인앱 캠페인 세분화를 확인하여 사용자가 푸시 메시지를 받기 전에 타겟 오디언스 조건을 충족하는지 확인하세요.

Android 및 iOS에서 테스트 전송 시, 클릭 시 동작으로 푸시 권한 요청을 사용하는 인앱 메시지가 일부 기기에서 표시되지 않을 수 있습니다. 해결 방법은 다음과 같습니다.

  • Android: 기기가 Android 13 및 Android SDK 버전 21.0.0을 사용해야 합니다. 또 다른 원인으로는 인앱 메시지가 표시되는 기기에 이미 시스템 수준의 프롬프트가 있기 때문일 수 있습니다. 다시 묻지 않음을 선택했을 수 있으므로, 다시 테스트하기 전에 앱을 재설치하여 알림 권한을 초기화해야 할 수 있습니다.
  • iOS: 개발팀에서 앱의 푸시 알림 구현을 검토하고 푸시 권한을 요청하는 코드를 수동으로 제거하는 것을 권장합니다. 자세한 내용은 푸시 프라이머 인앱 메시지를 참조하세요.

실행 기반 인앱 메시지 캠페인이 전달되려면 REST API가 아닌 Braze SDK를 통해 커스텀 이벤트를 기록해야 합니다. 그래야 사용자가 자격 요건을 충족하는 인앱 메시지를 기기에서 직접 받을 수 있습니다. 사용자가 세션 중에 이벤트를 수행하면 인앱 메시지를 받게 됩니다.

Braze 고객 참여 플랫폼 문서.

리소스
법적 고지
회사
© 2026 Braze, Inc. All rights reserved.
브레이즈 상태 확인
New Stuff!