Skip to content

현지화

여러 국가에 고객을 보유한 기업의 경우, Braze 여정 초기에 현지화를 처리하면 시간과 리소스를 절약할 수 있습니다.

작동 방식

로케일 정보는 Braze SDK(자동) 또는 REST API를 사용하여 수집한 데이터를 기반으로 사용자 프로필에 저장됩니다. 로케일에는 언어와 지역 식별자가 포함됩니다. 이 정보는 Braze 세분화 툴에서 국가 및 언어 항목으로 확인할 수 있습니다.

번역 관리

번역을 관리하기 위한 다음 접근 방식을 고려해 보세요.

모든 언어에 하나의 템플릿

이 접근 방식에서는 Liquid을 사용하여 Braze의 단일 템플릿에 현지화를 적용합니다. 발송 후 대시보드에서 집계된 Campaign 분석을 제공합니다. 사용자 수준의 참여는 커스텀 Segment 퍼널을 사용하여 측정할 수 있습니다. 예를 들어 국가와 수신한 Campaign 필터를 결합하는 방식입니다.

국가별 하나의 템플릿

이 접근 방식에서는 템플릿을 서로 다른 발송 로케일로 분리합니다. 발송 후 대시보드에서 각 국가별로 발송 분석을 별도로 보고하며, 다운스트림 사용자 수준의 Currents 이벤트도 특정 Campaign에 연결됩니다.

  • 템플릿은 유지 관리 및 추적 목적으로 태그를 구현하면 유용합니다.
  • Campaigns는 동일한 Braze 템플릿 및 Content Blocks(Liquid을 포함하는 이메일 템플릿 등)의 구성을 상속받을 수 있습니다.
  • 기존 Campaigns와 템플릿을 복제하여 더 빠르게 가치를 실현할 수 있습니다.

모든 언어에 하나의 여정

이 접근 방식에서는 Canvas 기본 사항과 Liquid을 활용하여 각 사용자에 대한 메시징을 정의합니다.

Canvas가 발송된 후 대시보드에서 집계된 Canvas 분석을 제공하며, 사용자 수준의 참여는 커스텀 Segment 퍼널을 통해 측정할 수 있습니다. 예를 들어 국가와 수신한 캔버스 단계 필터를 결합하는 방식입니다.

국가별 하나의 여정

이 접근 방식에서는 Canvas 여정 빌더가 여러 Canvas 구성요소를 통해 사용자 여정을 생성할 수 있는 유연성을 제공합니다. 이러한 구성요소는 구성요소 수준 및 전체 여정 수준에서 복제할 수 있습니다.

현지화는 다음 방법으로 달성할 수 있습니다:

  • 국가별 별도 Canvases - 오디언스 필터를 사용하여 퍼널 상단에서 복잡한 사용자 여정을 정의합니다.
  • 국가별 맞춤 사용자 여정 - 오디언스 경로를 구현하여 각 여정에 대해 대규모로 사용자를 직관적으로 세분화하고, 단일 Canvas 내에서 각 국가별로 별도의 메시지 스레드를 생성합니다.

발송 후 대시보드에서 국가별 동적 분석을 제공하며, 사용자 수준의 Currents 이벤트에서도 고객의 현재 위치를 기반으로 분석할 수 있습니다.

번역된 메시지 발송

사용자의 언어, 로케일 또는 커스텀 속성을 기반으로 개인화된 메시지를 발송하려면 다음 방법 중 하나를 사용하세요.

번역 Liquid 태그(권장)

Braze는 {% translation salutation %}Hello!{% endtranslation %} Liquid 태그를 지원하여 단일 메시지로 다양한 언어의 사용자를 타겟팅할 수 있습니다.

전체 안내는 번역 태그 사용 가이드를 참조하세요.

대안적 접근 방식

콘텐츠를 메시지 본문에 직접 붙여넣고 Liquid을 사용하여 수신자에게 올바른 언어를 조건부로 표시할 수 있습니다. 이를 위해:

  1. 메시지를 작성한 다음 언어를 선택하여 선택한 각 언어에 대한 Liquid 조건 로직을 생성합니다.

  2. 다음 Liquid 템플릿을 사용하여 메시지를 작성할 수 있습니다. 템플릿이 있는 각 필드에 대해 괄호로 묶인 템플릿 세그먼트 뒤에 변형을 입력해야 합니다. 변형은 앞의 괄호에 참조된 언어 코드에 해당해야 합니다.

    1
2
3
4
5
6
7
8
9

     {% if ${language} == 'en' %}
 This is a message in English from Braze!
 {% elsif ${language} == 'es' %}
 Este es un mensaje en español de Braze !
 {% elsif ${language} == 'zh' %}
 这是一条来自Braze的中文消息。
 {% else %}
 This is a message from Braze! This will go to anyone who does not match the other specified languages!
 {% endif %}
  3. 발송 전에 사용자의 ID 또는 이메일을 입력하여 언어에 따라 개인에게 메시지가 어떻게 표시되는지 확인하여 메시지를 테스트하세요.

Braze Content Blocks는 재사용 가능한 콘텐츠 블록입니다. 블록이 변경되면 해당 블록에 대한 모든 참조가 변경됩니다. 예를 들어, 이메일 헤더나 푸터에 대한 업데이트가 모든 이메일에 반영되거나 번역을 보관하는 데 사용할 수 있습니다. 이러한 블록은 REST API를 사용하여 생성 및 업데이트할 수도 있으며, 사용자가 프로그래밍 방식으로 번역을 업로드할 수 있습니다.

대시보드에서 Campaign을 구축할 때 {{content_blocks.${name_of_content_block}}} 태그를 사용하여 Content Blocks를 참조할 수 있습니다. 이러한 블록에는 옵션 1에서 보여준 것처럼 각 언어에 대한 조건 로직 내에 모든 번역을 포함하거나, 각 언어별로 별도의 블록을 사용할 수 있습니다.

Content Blocks는 번역 관리 프로세스로도 활용할 수 있습니다. 번역이 필요한 콘텐츠를 Content Block에 보관하고, 가져오고, 번역한 다음 업데이트합니다:

  1. 대시보드에서 “Needs Translation” 태그가 있는 Content Block을 수동으로 생성합니다.
  2. 서비스가 /content_blocks/list 엔드포인트를 사용하여 모든 Content Blocks를 야간에 가져옵니다.
  3. 서비스가 /content_blocks/info 엔드포인트를 통해 각 Content Block의 세부 정보를 가져와 번역 태그가 지정된 블록을 확인합니다.
  4. 번역 서비스가 모든 “Needs Translation” Content Blocks의 본문을 번역합니다.
  5. 서비스가 /content_block/update 엔드포인트를 호출하여 번역된 콘텐츠를 업데이트하고 태그를 “Translation Complete”로 변경합니다.

카탈로그를 사용하면 API 및 CSV 파일을 통해 가져온 JSON 오브젝트의 데이터에 액세스하여 커스텀 속성이나 커스텀 이벤트 등록정보와 유사하게 Liquid을 통해 메시지를 보강할 수 있습니다. 예를 들어:

다음 API 호출을 통해 카탈로그를 생성합니다:

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29

curl --location --request POST 'https://your_api_endpoint/catalogs' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer YOUR-REST-API-KEY' \
--data-raw '{
 "catalogs": [
   {
     "name": "translations",
     "description": "My localization samples",
     "fields": [
       {
         "name": "id",
         "type": "string"
       },
       {
         "name": "context",
         "type": "string"
       },
       {
         "name": "language",
         "type": "string"
       },
       {
         "name": "body",
         "type": "string"
       }
     ]
   }
 ]
}'

다음 API 호출을 통해 항목을 추가합니다:

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31

curl --location --request POST 'https://your_api_endpoint/catalogs/translations/items' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer YOUR-REST-API-KEY' \
--data-raw '{
 "items": [
   {
     "id": "1",
     "context": "1",
     "language": "en",
     "body": "Hey"
   },
   {
     "id": "2",
     "context": "1",
     "language": "es",
     "body": "Hola"
   },
   {
     "id": "3",
     "context": "1",
     "language": "pt",
     "body": "Oi"
   },
   {
     "id": "4",
     "context": "1",
     "language": "de",
     "body": "Hallo"
   }
 ]
}'

다음 형식으로 CSV를 생성합니다:

이러한 카탈로그 항목은 아래에 표시된 개인화 또는 데이터 그룹을 생성할 수 있는 선택을 사용하여 참조할 수 있습니다.

1
2
3

{% catalog_items translations 1 %}
{{items[0].body}}
//returns “Hey”

많은 Braze 파트너가 Transifex 및 Crowdin을 포함한 현지화 솔루션을 제공합니다. 일반적으로 사용자는 내부 팀 및 번역 에이전시와 함께 플랫폼을 사용합니다. 이러한 번역은 업로드된 후 REST API를 통해 액세스할 수 있습니다. 이러한 서비스는 종종 연결된 콘텐츠를 활용하여 사용자가 API를 통해 번역을 가져올 수 있도록 합니다.

예를 들어, 다음 연결된 콘텐츠 호출은 Transifex와 Crowdin을 호출하여 번역을 가져오며, {{${language}}}를 활용하여 특정 사용자에 대한 올바른 번역을 식별합니다. 이 번역은 JSON 블록 “strings”에 저장되고 참조됩니다.

1
2

{% connected_content https://www.transifex.com/api/2/project/example/resource/example/translation/{{${language}}}/strings :basic_auth semc :save strings %}
{{strings[0].translation}}

1
2

{% connected_content https://api.crowdin.com/api/project/braze-test/export-file?key=you_api_key&language={{${language}}}&file=test.json&export_translated_only=1 :save response %}
{{response.value_1}}

스프레드시트에 번역을 호스팅한 다음, 다음 방법 중 하나를 사용하여 해당 언어로 메시지를 발송합니다.

번역 에이전시와 협력하여 Google 스프레드시트에 번역을 저장하고, Braze 연결된 콘텐츠를 사용하여 이 콘텐츠를 쿼리할 수 있습니다. 메시지를 발송하면 각 사용자의 선택된 언어에 따라 해당 번역이 Campaign 본문에 가져와집니다.

이 옵션은 Google Sheets를 연결된 콘텐츠를 통해 쿼리되는 JSON 오브젝트로 변환하는 대안적 방법을 제공합니다. 스프레드시트를 SheetDB를 통해 JSON API로 변환하면 API 호출 빈도에 따라 여러 구독 티어에서 선택할 수 있습니다.

스프레드시트 구조는 옵션 4의 단계를 따르지만, SheetDB는 오브젝트를 쿼리하기 위한 추가 필터도 제공합니다.

일부 사용자는 SheetDB의 검색 메서드를 GET 요청 호출에 구현하여 {{${language}}} Liquid 태그를 기반으로 JSON 오브젝트를 필터링함으로써, 대규모 조건 블록을 구축하는 대신 단일 언어에 대한 결과를 자동으로 반환하는 방식으로 Liquid 및 연결된 블록 종속성을 줄여 SheetDB를 구현하는 것을 선호할 수 있습니다.

1단계: Google 시트 형식 지정

먼저 언어가 서로 다른 오브젝트가 되도록 Google 시트를 구성합니다:

2단계: 연결된 콘텐츠 호출에서 언어 Liquid 태그 사용

다음으로 연결된 콘텐츠 호출 내에서 {{${language}}} Liquid 태그를 구현합니다. SheetDB는 스프레드시트를 생성할 때 sheet_id를 자동으로 생성합니다.

1

{% connected_content https://sheetdb.io/api/v1/[sheet_id]/search?language={{${language}}} :save result%}

3단계: 메시지 템플릿 작성

마지막으로 Liquid을 사용하여 메시지를 템플릿화합니다:

1
2

{{result[0].title1}} //returns “Hey”
{{result[0].title2}} //returns “Hey2”
고려 사항
  • {{${language}}} 필드는 모든 사용자에 대해 정의되어야 합니다. 그렇지 않으면 언어가 없는 사용자를 위한 대체 핸들러로 Liquid 조건 블록을 포함해야 합니다.
  • Google Sheets 내의 데이터 모델링은 메시지 오브젝트를 갖는 것과 달리 언어 기반의 세로 방향을 따라야 합니다.
  • SheetDB는 제한된 무료 계정과 Campaign 전략에 따라 고려해야 할 여러 유료 옵션을 제공합니다.
  • 연결된 콘텐츠 호출은 캐시할 수 있습니다. API 호출의 예상 빈도를 측정하고 검색 메서드를 사용하는 대신 기본 SheetDB 엔드포인트를 호출하는 대안적 접근 방식을 조사하는 것을 권장합니다.
New Stuff!