워크스페이스 생성 및 관리
이 문서에서는 워크스페이스를 생성, 설정 및 관리하는 방법을 다룹니다.
섹션 문서
워크스페이스란 무엇인가요?
Braze에서 수행하는 모든 작업은 워크스페이스 내에서 이루어집니다. 워크스페이스는 관련된 모바일 앱이나 웹사이트의 인게이지먼트를 추적하고 관리할 수 있는 공유 환경입니다. 워크스페이스는 동일하거나 매우 유사한 앱을 하나로 묶습니다. 예를 들어 모바일 앱의 Android 버전과 iOS 버전을 함께 묶을 수 있습니다.
워크스페이스 생성
1단계: 계획 세우기
시작하기 전에 팀 및 Braze 온보딩 매니저와 함께 사용 사례에 가장 적합한 워크스페이스 구성을 결정했는지 확인하세요. Braze에서 워크스페이스를 계획하는 방법에 대해 자세히 알아보려면 시작하기: 워크스페이스 가이드를 참조하세요.

모범 사례: 워크스페이스마다 전용 Firebase 프로젝트 사용
Braze에서는 동일한 Firebase 서비스 계정 JSON을 여러 워크스페이스에 업로드할 수 있지만, 동일한 Google 프로젝트 ID를 사용하는 모든 워크스페이스는 Firebase 클라우드 메시징의 기본 사용량 제한인 분당 600,000건의 메시지를 공유합니다. 대량 발신자는 여러 워크스페이스에서 Campaign을 동시에 시작할 때 “할당량 초과” 오류가 발생할 수 있습니다.
전달 가능성과 할당량을 독립적으로 관리하려면 각 Braze 워크스페이스에 별도의 전용 Firebase 프로젝트를 사용하세요.
2단계: 워크스페이스 추가
글로벌 헤더의 워크스페이스 드롭다운에서 새 워크스페이스를 생성하거나 기존 워크스페이스 간에 전환할 수 있습니다.
- 워크스페이스 드롭다운을 선택한 다음 워크스페이스 생성을 선택합니다.

- 워크스페이스 이름을 지정합니다.

회사의 다른 사람들이 워크스페이스를 쉽게 찾을 수 있도록 명명 규칙을 도입하는 것이 좋습니다. 예를 들어 “Upon Voyage US – Production”, “Upon Voyage US – Staging”과 같이 지정할 수 있습니다.
- 생성을 선택합니다. Braze가 워크스페이스를 생성하는 데 몇 초 정도 걸릴 수 있습니다.

앱 인스턴스 추가를 시작할 수 있도록 앱 설정 페이지로 이동합니다. 이 페이지는 언제든지 설정 > 앱 설정에서 액세스할 수 있습니다.

3단계: 앱 인스턴스 추가
워크스페이스 내에 모인 여러 사이트와 앱을 “앱 인스턴스”라고 합니다.
- 앱 설정 페이지에서 + 앱 추가를 선택합니다.
- 앱 인스턴스 이름을 지정하고 이 앱 인스턴스가 실행되는 플랫폼을 하나 이상 선택합니다. 여러 플랫폼을 선택하면 Braze는 플랫폼마다 앱 인스턴스를 하나씩 생성합니다.

- 앱 추가를 선택하여 확인합니다.
앱 API 키
앱 인스턴스를 추가하면 해당 API 키에 액세스할 수 있습니다. API 키는 앱 인스턴스와 Braze API 간에 요청을 보낼 때 사용됩니다. 또한 API 키는 Braze SDK를 앱 또는 웹사이트와 통합할 때도 중요합니다.


각 플랫폼의 앱 버전마다 별도의 앱 인스턴스를 생성해야 합니다. 예를 들어 iOS와 Android 모두에 무료 버전과 Pro 버전의 앱이 있다면 워크스페이스 내에 앱 인스턴스 4개(무료 iOS 앱, 무료 Android 앱, Pro iOS 앱, Pro Android 앱)를 생성하세요. 그러면 앱 인스턴스마다 하나씩, 총 4개의 API 키를 사용할 수 있습니다.
실시간 SDK 버전
특정 앱의 앱 설정 페이지에 표시되는 실시간 SDK 버전은 전체 일일 세션의 5% 이상을 차지하면서 지난 하루 동안 세션이 500개 이상인 가장 높은 앱 버전입니다.
이 필드는 Braze SDK를 앱 또는 웹사이트와 통합한 후에 표시됩니다. 해당 플랫폼에서 사용할 수 있는 최신 버전의 Braze SDK가 있으면 “최신 버전 사용 가능” 태그와 함께 여기에 표시됩니다.

4단계: 필요에 따라 반복
계획에 필요한 만큼 워크스페이스를 설정하려면 2단계와 3단계를 반복하세요. 모범 사례로, 통합 및 Campaign 테스트를 위한 테스트용 워크스페이스를 생성하는 것을 권장합니다.

테스트용 워크스페이스 추가
특정 사용자를 프로덕션 인스턴스로부터 완전히 샌드박스 처리하여 앱 테스트를 수행할 수 있습니다. 새 워크스페이스를 생성하고, 애플리케이션을 게시할 때 Braze가 사용하는 API 키를 테스트용 워크스페이스가 아닌 프로덕션 워크스페이스의 API 키와 일치하도록 변경하세요.
워크스페이스 관리
즐겨찾기 추가
자주 사용하는 워크스페이스를 즐겨찾기에 추가하면 더욱 빠르게 액세스할 수 있습니다.

즐겨찾는 워크스페이스를 추가하려면 다음 단계를 따르세요.
- 프로필 드롭다운을 선택한 다음 계정 관리를 선택합니다.
- 계정 프로필 섹션에서 즐겨찾는 워크스페이스 필드를 찾습니다.
- 목록에서 워크스페이스를 선택합니다.
- 변경 사항 저장을 선택합니다.
즐겨찾기에 추가할 수 있는 워크스페이스 수에는 제한이 없지만, 편의를 위해 목록을 짧게 유지하는 것을 권장합니다.
워크스페이스 이름 변경
워크스페이스 이름을 변경하려면 다음 단계를 따르세요.
- 설정 > 앱 설정으로 이동합니다.
- 워크스페이스 이름 위로 마우스를 가져간 다음 편집을 선택합니다.
- 워크스페이스에 새 이름을 지정한 다음 저장을 선택합니다.

워크스페이스 및 앱 인스턴스 삭제
워크스페이스 또는 앱 인스턴스를 삭제하려면 다음 단계를 따르세요.
- 설정 > 앱 설정으로 이동합니다.
- 해당 워크스페이스를 삭제하려면 워크스페이스 삭제를 선택하고, 앱 인스턴스를 삭제하려면 해당 앱 인스턴스 옆의 휴지통 아이콘을 선택합니다.
현재 사용자 타겟팅에 사용 중이거나 사용자가 1,000명을 초과하는 앱 인스턴스 또는 워크스페이스는 삭제할 수 없습니다. 삭제를 시도하면 오류 메시지가 표시됩니다. 계속 진행하여 삭제하려면 대시보드 링크와 삭제할 앱 인스턴스 또는 워크스페이스의 이름을 포함하여 지원 케이스를 생성하세요.

워크스페이스를 삭제할 때는 주의하세요! 워크스페이스는 삭제한 후에는 복원할 수 없습니다.

자주 묻는 질문
업데이트된 앱을 출시할 때 새 워크스페이스를 만들어야 하나요?
이는 앱을 업데이트하는지, 아니면 완전히 새로운 앱을 만드는지에 따라 다릅니다.
앱 업데이트
앱을 업데이트하는 경우에는 같은 워크스페이스 안에 새 앱 인스턴스를 만들어 이전 버전과 새 버전을 구분해야 합니다. 이렇게 하면 세분화 과정에서 해당 앱을 선택해 새 버전 사용자를 효과적으로 타겟팅할 수 있습니다. 이전 버전 사용자에게 메시지를 보내려면 필터를 사용해 이전 앱 버전을 타겟팅할 수 있습니다.
새 워크스페이스를 만들면 사용자가 이전 워크스페이스와 새 워크스페이스 두 곳에 존재하게 됩니다. 두 워크스페이스에서 같은 푸시 토큰을 가질 수도 있습니다. 그러면 사용자가 이미 업그레이드했더라도 이전 워크스페이스 사용자만을 대상으로 한 마케팅 메시지를 받게 될 수 있습니다.
새 앱 출시
완전히 새로운 앱을 앱 스토어에 출시하는 경우에는 새 워크스페이스를 만들어야 합니다. 새 워크스페이스를 만들면 이전 앱 버전의 과거 데이터와 고객 프로필이 새 워크스페이스에 존재하지 않습니다. 따라서 기존 사용자가 새 앱 버전으로 업그레이드하면 이전 앱의 행동 데이터가 전혀 없는 새 프로필이 생성됩니다.
한 워크스페이스에 여러 앱 인스턴스가 있습니다. 메시지가 하나의 앱만 타겟팅하도록 하려면 어떻게 해야 하나요?
메시지가 특정 앱만 타겟팅하도록 하려면 선택한 앱 인스턴스의 사용자만 타겟팅하는 Segment를 추가하세요. 이는 같은 워크스페이스 안에서 한 사용자가 서로 다른 앱 인스턴스에 대해 두 개의 푸시 토큰을 가질 수 있는 경우에 특히 중요합니다. 이런 상황에서는 사용자가 현재 사용 중인 앱이 아닌 다른 앱의 알림을 받을 수 있습니다. 바람직한 경험이 아니겠죠!
기본값으로 Segment는 워크스페이스의 모든 앱과 웹사이트를 타겟팅합니다. 하나의 앱 또는 웹사이트만 타겟팅하는 Segment를 설정하려면 다음과 같이 하세요.
- 의미 있는 이름으로 Segment를 만듭니다. Braze에서는 “All Users ({Name} {Platform})” 형식을 사용합니다. 예를 들면 “All Users (Upon Voyage iOS)”와 같습니다.
- 타겟팅된 앱 및 웹사이트에서 특정 앱의 사용자를 선택합니다.
- 특정 앱 드롭다운에서 앱 또는 사이트를 선택합니다.

그런 다음 이 Segment를 메시지에 추가하고, 필요하면 추가 Segments와 필터로 오디언스를 더 세밀하게 조정할 수 있습니다.
Campaigns
Campaign의 경우, 작성기의 타겟 오디언스 단계에 Segment를 추가하세요.
Canvas
Canvas에서는 메시지 단계의 전달 유효성 검사 섹션에 Segment를 추가하세요. 전달 유효성 검사는 메시지 발송 시점에 오디언스가 전달 기준을 충족하는지 다시 한번 확인합니다. 올바른 앱으로 전달되도록 각 메시지 단계마다 전달 유효성 검사를 지정해야 한다는 점을 기억하세요. 항목 수준에서는 세분화할 필요가 없습니다.
원래 Canvas 워크플로의 단계를 보려면 펼치세요
원래 Canvas 워크플로에서는 오디언스 섹션에서 Canvas 컴포넌트 수준에 Segment를 추가하세요. 항목 수준에서는 세분화할 필요가 없습니다.
다음 단계
워크스페이스를 생성한 후 다음과 같이 구성하세요.