다국어 메시지
워크스페이스에 로캘을 추가한 후에는 하나의 푸시, 이메일, 웹훅, 배너, 인앱 메시지 또는 Content Block 안에서 다양한 언어를 사용하는 사용자를 타겟팅할 수 있습니다.
필수 조건
| 기능 | 필수 사용자 권한 |
|---|---|
| 다국어 로케일 | 다국어 로케일을 생성하고 관리하려면 다음 권한이 필요합니다:
|
| 기능 | 필요한 사용자 권한 |
|---|---|
| 메시지 유형 | Campaigns 및 Canvases에 로캘과 번역을 추가하려면 다음 권한이 필요합니다.
|
| 기능 | 필요한 사용자 권한 |
|---|---|
| 템플릿 | 로캘과 번역을 추가하려는 템플릿 유형에 대해 다음 권한이 필요합니다.
|
로캘 사용
1단계: 로캘 설정
메시지에 번역을 추가하려면 먼저 지원하려는 로캘을 생성해야 합니다. 로캘은 메시징에 사용할 수 있는 언어(및 선택적으로 지역) 배리언트를 정의합니다.
2단계: 번역할 콘텐츠 표시
번역하려는 텍스트를 Liquid 번역 태그 {% translation your_id_here %}와 {% endtranslation %}로 감싸고 태그 ID를 지정합니다. 번역 태그 ID는 메시지 내에서 고유해야 합니다. {% translation header %}처럼 텍스트를 명확하게 설명하는 의미 있는 ID 이름을 사용하는 것이 좋습니다. 메시지에 Content Blocks가 포함되어 있다면 고유성이 어떻게 적용되는지 번역이 포함된 Content Blocks를 참조하세요.
다음은 번역용으로 표시된 메시지 예시입니다: {% translation greeting %}Hello!{% endtranslation %}

번역할 텍스트를 강조 표시한 후 키보드 단축키 Cmd + Alt + L(macOS) 또는 Ctrl + Alt + L(Windows)을 사용하면 번역 태그로 감쌀 수 있습니다.
이 단축키는 이메일 및 Content Blocks용 드래그 앤 드롭 편집기를 제외하고 다국어 메시징을 지원하는 모든 채널에서 작동합니다. 해당 편집기에서는 개인화 추가 버튼을 사용해 번역 태그를 추가하세요.
URL 현지화
콘텐츠를 번역할 때 링크가 깨지지 않도록 URL은 특별히 처리해야 합니다.
표준(정적) URL
정적 URL은 편집기에 직접 입력하는 URL입니다(예: https://example.com). 다음 사항도 권장합니다.
| 권장 사항 | 이유 |
|---|---|
프로토콜(https://)은 번역 태그 밖에 두세요. 도메인과 경로만 감싸세요(예: example.com/en). |
번역가가 실수로 특수 문자를 변경하거나 삭제하여 링크가 깨질 수 있습니다. |
쿼리 파라미터(예: ?utm_source=promo)는 번역 태그 안에 포함하지 마세요. |
번역가가 실수로 특수 문자를 변경하거나 삭제하여 링크가 깨질 수 있습니다. |
두 가지 권장 사항을 모두 따르는 표준 URL은 다음과 같습니다.
<a href="https://{% translation id_1 %}example.shop.com{% endtranslation %}">Visit our store</a>
Liquid로 생성된 URL
URL이 Liquid로 생성되는 경우(예: {% landing_page_url %}) 다음 사항을 권장합니다.
| 권장 사항 | 이유 |
|---|---|
| Liquid로 생성된 URL은 현지화가 필요한 경우에만 번역 태그로 감싸세요. | Liquid 구문이 올바르게 렌더링되려면 신중하게 보존되어야 합니다. |
쿼리 파라미터(예: ?utm_source=promo)는 번역 태그 안에 포함하지 마세요. |
번역가가 실수로 특수 문자를 변경하거나 삭제하여 링크가 깨질 수 있습니다. |
두 가지 권장 사항을 모두 따르는 Liquid 생성 URL은 다음과 같습니다.
<a href="{% translation id_1 %}{% landing_page_url xyz %}{% endtranslation %}">View details</a>

HTML 속성 및 구조
사람이 읽을 수 있는 텍스트만 번역 태그로 감싸세요. HTML 속성(class, style, id 등)이나 기타 구조 코드는 감싸지 마세요. HTML 속성은 레이아웃, 스타일, 기능을 제어합니다. 이를 번역 태그로 감싸면 현지화된 메시지 버전에서 서식이나 스타일이 깨질 수 있습니다.
다음은 올바르게 감싼 텍스트입니다.
<p class="headline" style="color: red;">
{% translation id_1 %}Welcome to our sale{% endtranslation %}
</p>
잘못 감싼 텍스트
다음은 잘못 감싼 텍스트입니다.
{% translation id_1 %}
<p class="headline" style="color: red;">
Welcome to our sale
</p>
{% endtranslation %}
3단계: 메시지에 로캘 추가
메시지에 번역 태그를 추가한 후 편집기에서 언어 관리(이메일 및 Content Blocks용 드래그 앤 드롭 편집기에서는 언어)를 선택하고, 번역을 추가할 로캘을 하나 이상 선택합니다.

번역이 포함된 Content Blocks
번역 태그가 있는 Content Blocks는 블록 자체에 저장된 번역이 있는지 여부에 따라 다르게 작동합니다.
| Content Block 상태 | 번역 관리 위치 |
|---|---|
| 번역 태그는 있지만 로캘이나 저장된 번역이 없음 | 상위 메시지의 언어 관리 CSV |
| 번역 태그와 로캘, 저장된 번역이 있음 | Content Block 자체의 CSV 또는 번역 API |
저장된 번역이 있는 Content Blocks
메시지에 이미 번역이 저장된 Content Blocks가 포함되어 있다면 해당 번역을 다시 업로드할 필요가 없습니다. 저장된 번역은 Content Block을 메시지에 추가할 때 자동으로 적용됩니다. 이러한 블록은 자체 태그 ID를 유지하며, 상위 메시지와 비교해 고유할 필요가 없습니다. 블록 자체에 번역을 저장하는 방법은 Content Blocks에 번역 저장을 참조하세요.
언어 관리 Modal에서는 저장된 번역이 있는 Content Blocks가 지원하는 로캘과 함께 목록에 표시됩니다. 이를 통해 새 번역을 추가하기 전에 메시지의 어느 부분이 이미 현지화되어 있는지 확인할 수 있습니다.


각 Content Block에 메시지에 추가된 모든 로캘에 대한 번역이 포함되어 있는지 확인하세요. 추가한 로캘 중 하나에 대한 번역이 Content Block에 없으면, 해당 로캘의 사용자에게는 원래 언어로 표시됩니다.
번역 태그만 있는 Content Blocks
Content Block에 번역 태그는 있지만 로캘이나 저장된 번역이 없는 경우, 해당 태그는 상위 메시지에서 번역되지 않은 원본 콘텐츠로 처리됩니다. 상위 메시지의 언어 관리 내보내기에 해당 태그가 포함되며, 상위 CSV에서 그 번역을 제공해야 합니다. 이러한 태그는 상위 메시지의 다른 태그와 비교해 고유해야 합니다.
번역되지 않은 Content Block을 다른 메시지에서 재사용하면, 두 번째 메시지에서도 블록의 태그에 대한 번역을 제공해야 합니다. Content Block을 사용하는 모든 메시지에서 번역을 제공하지 않으려면 Content Block 자체에 로캘과 번역을 직접 추가하세요.
4단계: 번역 추가
로캘을 선택한 후 다음 방법 중 하나를 사용해 메시지에 번역을 추가합니다.

템플릿 다운로드를 선택하면 선택한 번역 ID와 로캘의 매트릭스가 담긴 CSV를 다운로드할 수 있습니다.

영어가 아닌 문자의 표시 문제를 방지하려면 번역 CSV 작업에 Excel을 사용하지 마세요.
템플릿을 작성할 때는 각 로캘의 텍스트 콘텐츠만 번역하세요. 다운로드한 템플릿에 HTML 태그가 있으면 그대로 두고 태그 안의 텍스트만 번역하세요.
예를 들어 템플릿에 다음 내용이 포함되어 있다면:
<p style="margin:0;margin-bottom:0">A charming bakery dedicated to crafting artisanal breads.</p>
A charming bakery dedicated to crafting artisanal breads. 텍스트만 번역하고, HTML 태그 <p style="margin:0;margin-bottom:0">와 </p>는 그대로 유지하세요.
그런 다음 완성된 파일을 업로드하면 번역이 메시지에 적용됩니다.

파트너 번역 API를 사용해 Campaigns, Canvases, Content Blocks, 이메일 템플릿, 웹훅 템플릿의 번역을 관리하고 업데이트할 수 있습니다. 외부 시스템으로 현지화를 진행하거나 번역 파트너와 직접 연결하려는 경우에 유용합니다.
Canvases에서 번역 엔드포인트를 사용하려면 다음 파라미터를 포함하세요.
workflow_idstep_idmessage_variation_id

Canvas 출시 이후에 생성된 캔버스 단계에서 번역 API를 사용하는 경우, API에 전달하는 message_variation_id는 비어 있거나 공백입니다.
5단계: 번역 미리보기
메시지를 미리 보려면 사용자로 미리보기 드롭다운에서 다국어 사용자 옵션을 선택합니다. 이렇게 하면 여러 로캘 정의 간에 전환하며 메시지의 모든 번역을 미리 볼 수 있습니다.

번역 관리
Canvas 단계 또는 Campaign 복제와 번역
캔버스 단계, Campaign 또는 배리언트를 복제하면 번역도 함께 복제됩니다. 대상 워크스페이스에 해당 로캘이 정의되어 있다면 워크스페이스 간에 복사할 때도 마찬가지입니다. Canvas 또는 Campaign을 수정할 때는 번역도 함께 검토하고 업데이트하세요.
Content Blocks에 번역 저장
Content Blocks는 메시지와 같은 방식으로 다국어를 지원합니다. Content Blocks를 만들거나 편집할 때 번역할 콘텐츠에 태그를 지정하고, 로캘을 추가하고, CSV 또는 번역 API를 사용해 번역을 업로드할 수 있습니다.
저장된 번역은 해당 콘텐츠 블록에 연결된 상태로 유지됩니다. 블록을 메시지에 추가하면 번역이 자동으로 포함됩니다.
오른쪽에서 왼쪽으로 쓰는 메시지
아랍어처럼 오른쪽에서 왼쪽으로 쓰는 언어의 번역 파일을 작성할 때는 올바른 형식으로 표시되도록 번역을 span으로 감싸세요.
{% translation your_id_here %}<span dir='rtl'>default text</span>{% endtranslation %}
이메일 링크 추적
이메일 Campaigns에서 Braze는 각 URL에 추적 정보(쿼리 매개변수)를 추가해 링크를 추적합니다. 이 동작은 링크 별칭 지정과 링크 템플릿을 모두 지원합니다.
URL이 번역 태그로 감싸져 있으면 Braze가 추적 정보를 어디에 추가해야 할지 판단하지 못할 수 있습니다. 이 기능이 올바르게 작동하도록 하려면 URL 끝에 추적을 추가할 위치를 나타내는 특수 문자를 넣어야 합니다.
URL에서는 두 가지 특수 문자로 이 동작을 제어합니다.
?는 아직 추적 정보가 없는 URL에 추적을 추가합니다.&는 URL에 이미?가 있을 때 추가 추적을 덧붙입니다. URL에는?가 하나만 포함될 수 있습니다.
| URL | ? 포함 여부 |
설명 | 예시 |
|---|---|---|---|
| 표준 URL | 아니요 | URL에 ?가 없다면 닫는 번역 태그 뒤에 ?를 추가하세요. |
<a href="https://{% translation id_1 %}example.com{% endtranslation %}?">Shop Now</a> |
| 표준 URL | 예 | URL에 이미 ?가 있다면 URL 끝(닫는 번역 태그 뒤)에 &를 사용하세요. |
<a href="https://{% translation id_1 %}example.com{% endtranslation %}?ref=4&">Shop Now</a> |
| Liquid로 생성된 URL | 아니요 | 생성된 URL에 ?가 없다면 닫는 번역 태그 뒤에 ?를 사용하세요. |
<a href="{% translation id_1 %}{{ product_url }}{% endtranslation %}?">Shop Now</a> |
| Liquid로 생성된 URL | 예 | 생성된 URL에 이미 ?가 있다면 닫는 번역 태그 뒤에 &를 사용하세요. |
<a href="{% translation id_1 %}{% landing_page_url xyz %}{% endtranslation %}&">Shop Now</a> |
언어 설정 및 접근성
WCAG 관련 내용, 채널 및 편집기별 동작(랜딩 페이지 포함), 메시지 수준의 접근성 설정은 접근성 문서의 접근성 언어부터 확인하세요.
다국어 메시지를 사용할 때는 현지화된 발송이 적절한 언어를 선언하도록 각 로캘에 맞춰 접근성 언어를 설정하세요.
접근성 언어 구성
접근성 언어는 두 가지 수준에서 설정할 수 있습니다.
메시지 수준
메시지 수준에서는 메시지 설정의 접근성 섹션에서 접근성 언어를 설정합니다. 언어 선택, Liquid 사용 방법, 채널별 제한 사항은 접근성 언어를 참조하세요.
로캘 수준
다국어 메시지의 경우 현지화 설정에서 로캘별로 접근성 언어를 설정합니다. 접근성 섹션에서 {{accessibility_language}}를 사용하면 문서 또는 카드 언어가 해당 로캘 값에 매핑됩니다.
새 메시지에 이 토큰이 기본으로 표시되는지는 채널과 편집기에 따라 다릅니다. 예를 들어 인앱 메시지와 배너는 랜딩 페이지 및 드래그 앤 드롭 이메일과 다르게 동작합니다. 자세한 내용은 접근성 언어를 참조하세요.
자주 묻는 질문
번역 태그에는 어떤 제한이 있나요?
번역 태그를 사용할 때는 다음 제한이 적용됩니다.
- 각 메시지에는 최대 200개의 번역 태그를 사용할 수 있습니다.
- 각 기본값 텍스트(번역 태그 사이의 콘텐츠)는 최대 2,000자까지 사용할 수 있습니다.
- 로캘별 번역은 최대 409,600바이트(약 409.6 KB)까지 사용할 수 있습니다.
다국어 이메일 템플릿을 다운로드할 때 오류가 발생하는 이유는 무엇인가요?
다국어 이메일 템플릿을 다운로드할 때 오류가 발생한다면, 번역 태그가 Braze의 이메일 본문 처리 방식과 충돌하는 HTML 속성이나 CSS 스타일을 감싸고 있을 수 있습니다.
Braze는 HTML 본문과 일반 텍스트 본문을 같은 메시지의 별도 구성 요소로 취급합니다. 번역 태그에 href 참조와 CSS 스타일이 포함되면 태그가 서로 충돌하여 템플릿이 올바르게 다운로드되지 않을 수 있습니다.
이 문제를 해결하려면 다음을 따르세요.
- 번역 태그에서
href참조와 CSS 스타일을 제외합니다. - HTML 속성 및 구조에 설명된 대로 사람이 읽을 수 있는 텍스트 콘텐츠만 번역 태그로 감쌉니다.
- URL의 경우 URL 현지화의 안내를 따릅니다.
로캘 중 하나에서 번역된 문구를 변경할 수 있나요?
예. 먼저 CSV에서 수정한 다음, 파일을 다시 업로드하면 번역된 문구가 변경됩니다.
Braze에서 번역을 제공하나요?
아니요. CSV를 업로드하거나 번역 API를 사용하여 직접 번역을 제공해야 합니다.
번역 태그를 중첩할 수 있나요?
아니요.
HTML 메시지 전체를 번역 태그로 감쌀 수 있나요?
아니요. 모범 사례로서, 사람이 읽을 수 있는 텍스트나 현지화가 필요한 콘텐츠만 감싸는 것이 좋습니다. 이렇게 하면 서식, 링크 또는 기타 텍스트가 아닌 요소가 깨지는 것을 방지할 수 있습니다.
또한 정확한 번역을 만들고 성능이나 크기 제한을 피하려면 의미상 관련된 작은 단위의 텍스트를 감싸는 것을 고려하세요.
로캘 중 하나에서 번역된 문구를 변경할 수 있나요?
예. CSV를 사용하는 경우 먼저 파일에서 수정한 다음, 다시 업로드하면 번역된 문구가 변경됩니다. 번역 API를 사용하는 경우 업데이트 엔드포인트를 사용하여 변경하세요.
Braze는 어떤 유효성 검사나 추가 확인을 수행하나요?
| 시나리오 | Braze의 유효성 검사 |
|---|---|
| 메시지에 서로 다른 텍스트에 매핑되는 동일한 번역 ID가 두 개 이상 포함되어 있습니다. | 이 번역 파일은 다운로드되지 않습니다. |
| 번역 파일에 하나 이상의 번역 태그 ID가 누락되어 있습니다. | 이 번역 파일은 업로드되지 않습니다. |
| 번역 파일에 메시지에 없는 로캘이 포함되어 있습니다. | 이 번역 파일은 업로드되지 않습니다. |
| 번역 템플릿을 다운로드하기 전에 메시지에 번역 태그를 추가해야 합니다. | 이 번역 파일은 다운로드되지 않습니다. |
| 업로드한 파일에 있는 번역 태그가 메시지에 없습니다. | 추가 번역은 메시지에 저장되지 않습니다. |
메시지에 손상된 Liquid 태그가 하나 이상 포함되어 있습니다. 태그를 열 때는 {% translation your_id_here %}를 사용하고, 번역 태그를 닫을 때는 {% endtranslation %}를 사용하세요. |
이 번역 파일은 다운로드되지 않습니다. |
| 번역 파일에 메시지의 내용과 일치하지 않는 기본값 텍스트가 포함되어 있습니다. | 번역은 추가되지만 원본 메시지 텍스트는 업데이트되지 않습니다. |
| 메시지의 로캘 중 하나 이상이 설정에서 삭제되어 더 이상 존재하지 않습니다. | 이미 추가된 번역은 메시지 내에 계속 존재합니다. 메시지에서 삭제하면 번역이 손실됩니다. |
| 번역 태그에 전체 URL 또는 Liquid로 생성된 URL이 포함되어 있습니다. | 링크 깨짐이나 링크 추적 문제가 발생할 경우에 대비하여 URL이 포함된 번역 태그가 식별됩니다. |
| 번역 태그에 쿼리 매개변수가 포함되어 있습니다. | 링크 깨짐이나 링크 추적 문제가 발생할 경우에 대비하여 쿼리 매개변수가 포함된 번역 태그가 식별됩니다. |
| 번역 태그에 HTML 속성 또는 구조가 포함되어 있습니다. | 스타일 및 서식 문제가 발생할 경우에 대비하여 HTML 속성 또는 구조가 포함된 번역 태그가 식별됩니다. |