Skip to content

테스트 메시지 보내기

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

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

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

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

테스트 사용자를 구성하는 편리한 방법은 콘텐츠 테스트 그룹을 만드는 것입니다. 이 그룹에는 Campaigns에서 테스트 메시지를 받을 사용자 그룹이 포함됩니다. Campaign의 테스트 수신자 아래 콘텐츠 테스트 그룹 추가 필드에 이 테스트 그룹을 추가하면 개별 테스트 사용자를 만들거나 추가하지 않고도 테스트를 시작할 수 있습니다.

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

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

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

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

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

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

테스트 체크리스트

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

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

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

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

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

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

테스트 Content Card

미리보기

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

테스트 체크리스트

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

깨진 이미지 문제 해결

Content Card 이미지가 렌더링되지 않거나 깨져 보이는 경우:

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

디버그

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

일반적인 사용 사례는 사용자가 특정 Content Card를 볼 수 없는 이유를 디버그하는 것입니다. 이를 위해 이벤트 사용자 로그에서 세션 시작 시 SDK에 전달된 Content Cards를 확인하되 노출 이전의 것을 찾아 특정 Campaign으로 추적할 수 있습니다:

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

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

    1
2
3
4
5
6
7
8
9
10
11
12

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

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

    1

     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 검색

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

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

  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 메시지를 만든 후 휴대폰에 테스트 메시지를 보내 실시간으로 어떻게 보이는지 확인할 수 있습니다.

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

테스트 SMS

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

테스트 웹훅

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

테스트 WhatsApp 메시지.

개인화된 Campaign 테스트하기

사용자 데이터를 채우거나 커스텀 이벤트 속성정보를 사용하는 Campaign을 테스트하는 경우 추가 또는 다른 단계를 수행해야 합니다.

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

메시지에 개인화를 사용하는 경우 Campaign을 올바르게 미리보고 사용자 데이터가 콘텐츠에 올바르게 채워지는지 확인하기 위해 추가 단계를 수행해야 합니다.

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

개인화된 메시지 테스트

기존 사용자 선택하기

기존 사용자를 선택하는 경우 검색 필드에 특정 사용자 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 환경설정 센터를 보면 환경설정 저장 버튼이 회색으로 비활성화됩니다.
  • 인앱 메시지 및 Content Cards 테스트의 경우 타겟 사용자는 타겟 기기에 대한 푸시 토큰이 있어야 합니다.
  • 이메일의 구독 취소 링크를 테스트하려면 테스트 사용자의 이메일 주소가 해당 워크스페이스에 있는지 확인하세요.
  • List-Unsubscribe 헤더는 테스트 메시지 기능으로 전송된 이메일에 포함되지 않습니다.

문제 해결

인앱 메시지

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

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

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

실행 기반 인앱 메시지 Campaign이 전달되려면 REST API가 아닌 Braze SDK를 통해 커스텀 이벤트를 기록해야 사용자가 기기에서 직접 적격한 인앱 메시지를 받을 수 있습니다. 사용자는 세션 중에 이벤트를 수행하면 인앱 메시지를 받습니다.
New Stuff!