콘텐츠로 건너뛰기

드래그 앤 드롭으로 인앱 메시지 만들기

드래그 앤 드롭 편집기는 대부분의 인앱 메시지를 만들 때 권장되는 방법입니다. 기존 편집기와 동일한 핵심 레이아웃으로 Modal 및 전체 화면 메시지를 작성할 수 있으며, 행, Content Blocks, 템플릿, 멀티 페이지 플로우를 통해 더 많은 커스텀이 가능합니다. 편집기 빌딩 블록에 대한 자세한 내용은 편집기 블록을 참조하세요.

기존 커스텀 HTML 템플릿이나 서드파티에서 만든 템플릿을 사용하려면 드래그 앤 드롭 편집기에서 다시 만들어야 합니다.

인앱 메시지를 Campaign으로 보낼지 Canvas로 보낼지 확실하지 않으신가요? Campaigns는 단일 타겟 메시지에 적합하고, Canvases는 다단계 사용자 여정에 적합합니다. 메시지를 작성할 위치를 선택한 후, 다음 단계에 따라 드래그 앤 드롭 인앱 메시지를 만드세요.

전제 조건

SDK 요구 사항

최소 SDK 버전 권장 SDK 버전
최소 SDK에 대한 추가 정보

드래그 앤 드롭 편집기로 만든 메시지는 최소 SDK 버전(이전 섹션의 표 참조)을 사용하는 사용자에게만 전송할 수 있습니다. 사용자가 애플리케이션을 업데이트하지 않은 경우(즉, 이전 SDK 버전을 사용하는 경우) 해당 사용자는 인앱 메시지를 받지 못합니다.

드래그 앤 드롭 편집기에서 제공하는 모든 기능을 활용하려면 SDK를 권장 SDK 버전으로 업데이트하세요. 업데이트하면 다음과 같은 추가 기능을 사용할 수 있습니다.

  • 메시지를 닫지 않는 텍스트 링크
  • 푸시 프라이머를 요청하는 버튼 동작

각 기능별 최소 SDK 요구 사항은 다음과 같습니다.

텍스트 링크* 푸시 프라이머 요청

*인앱 메시지에 URL로 리디렉션되는 링크를 포함했는데 최종사용자가 지정된 최소 SDK 버전을 사용하지 않는 경우, 링크를 선택하면 메시지가 닫히고 사용자는 양식을 제출하기 위해 메시지로 돌아갈 수 없습니다.

추가 전제 조건

  • 웹 SDK의 경우 초기화 옵션 allowUserSuppliedJavascript를 true로 설정해야 합니다. enableHtmlInAppMessages 옵션으로도 이러한 메시지가 작동하지만, 이 옵션은 더 이상 사용되지 않으므로 allowUserSuppliedJavascript로 업데이트해야 합니다.
  • Google Tag Manager를 사용하는 경우 GTM 구성에서 “Allow HTML In-App Messages”를 활성화해야 합니다.

1단계: 인앱 메시지 만들기

새 인앱 메시지 또는 캔버스 단계를 만든 다음, 편집 환경으로 드래그 앤 드롭 편집기를 선택합니다.

2단계: 템플릿 선택

편집 환경으로 드래그 앤 드롭 편집기를 선택한 후 다음 중 하나를 선택할 수 있습니다.

  • 빈 Modal 템플릿으로 시작하기
  • Braze 드래그 앤 드롭 인앱 메시지 템플릿 사용하기
  • 저장된 드래그 앤 드롭 인앱 메시지 템플릿 선택하기

메시지 작성을 선택하여 드래그 앤 드롭 편집기에서 인앱 메시지 디자인을 시작합니다.

기본, 배경 이미지, 전화번호 수집 또는 빈 템플릿을 선택할 수 있는 Braze 템플릿 섹션.

대시보드의 템플릿 섹션에서도 모든 템플릿에 액세스할 수 있습니다.

3단계: 추가 페이지 추가(선택 사항)

인앱 메시지에 페이지를 추가하면 온보딩 플로우나 환영 여정과 같은 순차적 플로우를 통해 사용자를 안내할 수 있습니다. 빌드 탭의 페이지 섹션에서 페이지를 관리할 수 있습니다.

세 개의 페이지로 구성된 헬스케어 회사의 인앱 메시지.

인앱 메시지는 기본적으로 한 페이지로 시작합니다. 새 페이지를 추가하려면:

  1. + 페이지 추가를 선택합니다.
  2. 커스텀 또는 Braze 제공 템플릿 목록에서 선택합니다.
  3. 의미 있는 이름을 지정합니다. 이렇게 하면 페이지를 서로 연결할 때 도움이 됩니다.

기존 페이지를 복제하려면:

  1. 목록에서 페이지 위에 마우스를 올리고 추가 옵션을 선택합니다.
  2. 복제를 선택합니다.
  3. 의미 있는 이름을 지정합니다. 이렇게 하면 페이지를 서로 연결할 때 도움이 됩니다.

페이지를 삭제하거나 이름을 변경하려면:

  1. 목록에서 페이지 위에 마우스를 올리고 추가 옵션을 선택합니다.
  2. 이름 변경 또는 삭제를 선택합니다.

3a단계: 페이지 연결

다중 페이지 인앱 메시지는 순차적이며, 사용자가 탭하거나 클릭하여 플로우의 다음 페이지로 이동하는 방식으로 메시지와 상호작용합니다.

페이지를 연결하려면:

  1. 시작 페이지를 선택합니다.
  2. 캔버스에서 버튼 또는 이미지 요소를 선택합니다.
  3. 클릭 시 동작을 페이지로 이동으로 설정합니다.
  4. 시작 페이지에서 연결할 페이지를 선택합니다.
  5. 모든 페이지가 연결될 때까지 계속합니다.

사용자가 인앱 메시지의 2페이지로 이동하도록 기본 동작 버튼을 편집하고 있습니다.

페이지가 다른 페이지에 연결되어 있지 않으면 메시지를 시작할 수 없습니다.

4단계: 인앱 메시지 빌드 및 디자인

이제 메시지가 브랜드 고유의 스타일을 입고 런웨이를 활보할 차례입니다. 편집기 블록과 스타일 설정을 조합하여 인앱 메시지를 커스텀하고 디자인할 수 있습니다.

5단계: 키-값 페어 추가(선택 사항)

키-값 페어를 추가하면 메시지와 함께 추가 커스텀 데이터를 사용자 기기로 보낼 수 있습니다. Braze는 메시지 페이로드에 페어를 담아 전달하므로, 앱에서 이를 읽고 그에 따라 동작할 수 있습니다. 예를 들어 앱은 키-값 페어를 사용하여 커스텀 스타일이나 레이아웃 로직을 적용하거나, 메시지를 앱의 특정 영역으로 라우팅하거나, 자체 분석에 메타데이터를 전달할 수 있습니다.

  1. 메시지 작성기에서 설정 탭을 선택합니다.
  2. 키-값 페어 탭을 선택한 다음 새 페어 추가를 선택합니다.
  3. 각 페어에 키와 값을 입력합니다. 다른 페어를 추가하려면 새 페어 추가를 다시 선택합니다.

앱에서 키-값 페어를 읽는 예시는 키-값 페어를 사용하여 메시지 스타일 커스텀하기를 참조하세요.

6단계: 인앱 메시지 테스트

미리보기 및 테스트 섹션에서는 다양한 기기에서 인앱 메시지를 미리 보고 내 기기로 테스트 메시지를 보낼 수 있습니다. 여기서 드래그 앤 드롭 인앱 메시지 Campaign의 세부 사항이 모든 플랫폼에서 일관되게 표시되는지 확인할 수 있습니다.

Campaigns를 보내기 전에 항상 인앱 메시지를 테스트하여 최종 메시지가 사용자 관점에서 어떻게 보일지 미리 확인하는 것이 중요합니다.

사용자 관점에서 메시지 미리보기

미리보기 및 테스트 탭에서 사용자의 입장에서 메시지를 미리 볼 수 있습니다. 특정 사용자나 무작위 사용자를 선택하거나 커스텀 사용자를 만들 수 있습니다.

  • 무작위 사용자: Braze가 데이터베이스에서 사용자를 무작위로 선택하고, 해당 사용자의 속성이나 이벤트 정보를 기반으로 인앱 메시지를 미리 보여줍니다.
  • 사용자 선택: 이메일 주소나 external_id를 기준으로 특정 사용자를 선택할 수 있습니다. 해당 사용자의 속성과 이벤트 정보를 기반으로 인앱 메시지가 미리 표시됩니다.
  • 커스텀 사용자: 사용자를 직접 커스텀할 수 있습니다. Braze가 사용 가능한 모든 속성과 이벤트에 대한 입력 필드를 제공합니다. 미리보기에서 확인하고 싶은 정보를 입력하세요.

테스트 체크리스트

인앱 메시지를 테스트할 때 다음 질문을 고려하세요.

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

자주 묻는 질문

분석 페이지에 본문 클릭이 표시되지 않는 이유는 무엇인가요?

드래그 앤 드롭 편집기로 만든 인앱 메시지에서는 본문 클릭이 자동으로 수집되지 않습니다. 자세한 내용은 iOS 및 Android의 SDK 체인지로그를 참조하세요.

버튼 클릭을 기준으로 세분화할 수 있나요?

예. 메시지에 있는 버튼 최대 2개까지 버튼 클릭을 기준으로 세분화할 수 있습니다. 이렇게 하려면 버튼의 보고용 식별자를 각각 “0”과 “1”로 설정하세요. 이 값은 각각 세분화 필터 “인앱 메시지 버튼 1 클릭함” 및 “인앱 메시지 버튼 2 클릭함”에 해당합니다.

"0" 값이 입력된 "보고용 식별자" 필드

커스텀 HTML이나 JavaScript로 인앱 메시지를 커스텀하거나 기존 HTML 메시지를 편집기로 옮길 수 있나요?

기존 HTML 메시지를 편집기로 직접 옮길 수는 없지만, 커스텀 코드 블록에 원시 HTML, CSS, JavaScript를 삽입할 수 있습니다. 커스텀 코드 블록을 사용하면 서드파티 비디오나 연결된 콘텐츠, 조건문 같은 고급 Liquid를 임베드할 수 있습니다. brazeBridge JavaScript 메서드와 클릭 추적 예시는 커스텀 HTML 인앱 메시지를 참조하세요.

드래그 앤 드롭 편집기의 작성기 화면이 최종 메시지와 다르게 보이는 이유는 무엇인가요?

드래그 앤 드롭 편집기는 작성기 안에서 메시지를 렌더링하며, 레이아웃을 구성하고 검토할 수 있도록 미리보기 전용 스타일과 기본값을 적용합니다. 이러한 처리는 편집하는 동안 구조와 입력 안내 콘텐츠를 확인하는 데 도움이 되며, 사용자가 받는 메시지에는 포함되지 않습니다.

편집기에서만 나타나는 동작의 일반적인 예시는 다음과 같습니다.

  • 편집기는 커스텀 코드 블록을 기본 min-height가 40px인 bz-html-code-block 컨테이너로 감싸므로, 비어 있거나 짧은 블록도 편집 중에 계속 표시됩니다.
  • 비어 있거나 Liquid가 포함된 이미지는 편집기에서 입력 안내 이미지로 표시됩니다.
  • 체크박스 그룹과 라디오 버튼은 활성 상태를 미리 볼 수 있도록 첫 번째 옵션이 미리 선택되어 있습니다.

편집기에서만 다르게 보인다면 대개 미리보기 동작입니다. 전송된 메시지의 문제를 해결할 때는 편집기 전용 프레임이나 미리보기 기본값이 아니라 메시지 블록의 스타일과 마크업을 검토하세요.

슬라이드업 인앱 메시지는 어떻게 만들 수 있나요?

현재 편집기는 Modal 및 전체 화면 메시지만 지원합니다. 메시지 스타일 패널의 메시지 컨테이너 섹션에서 표시 유형을 전환할 수 있습니다.

Campaign 또는 Canvas 내에서 인앱 메시지를 만든 후 템플릿으로 저장할 수 있나요?

예. 향후 Campaign이나 캔버스 단계에서 재사용하려는 인앱 메시지는 편집기를 종료한 후 사용할 수 있는 템플릿으로 저장 버튼을 사용하여 커스텀 템플릿으로 저장할 수 있습니다. 템플릿으로 저장하려면 먼저 Campaign을 시작하거나 초안으로 저장해야 합니다.

제품 둘러보기용 인앱 메시지 미리보기

콘텐츠 > 인앱 메시지로 이동하여 인앱 메시지 템플릿을 만들고 저장할 수도 있습니다.

페이지가 나뉜 인앱 메시지에서 Liquid 구문이 일반 텍스트로 표시되는 이유는 무엇인가요?

페이지가 나뉜 인앱 메시지를 테스트할 때 개인화된 콘텐츠 대신 Liquid 구문이 일반 텍스트로 표시된다면, 페이지 중 하나에 Liquid 구문 오류가 있을 수 있습니다. 한 페이지에 구문 오류가 있으면 메시지의 모든 페이지에서 Liquid 렌더링에 영향을 줍니다. 각 페이지는 독립적이지 않습니다.

문제를 해결하려면 다음을 수행하세요.

  1. 메시지의 모든 페이지에서 Liquid 구문 오류가 있는지 확인하세요. 한 페이지의 미리보기가 깨졌다고 해서 오류가 그 페이지에 있다는 의미는 아닙니다. 페이지가 독립적이지 않으므로 구문 오류는 메시지 어디에나 있을 수 있습니다.
  2. 모든 Liquid 태그가 올바르게 닫히고 형식이 맞는지 확인하세요.
New Stuff!