Braze 카탈로그로 현지화된 콘텐츠 관리하기

현지화된 문자열과 URL을 카탈로그에 저장하면 로케일별 배리언트를 별도로 만들지 않고도 단일 Campaign 또는 Canvas에서 각 사용자에게 해당 언어의 문구를 전달할 수 있습니다.

이 예제에 대해

가상의 의류 소매업체인 PantsLabyrinth는 북미와 유럽 전역에서 제품을 판매합니다. 제품명, 가격, 히어로 이미지는 언어에 따라 다르지만, 마케팅 팀은 발송 시점에 개인화되는 하나의 이메일 또는 푸시 템플릿을 원합니다.

이 예제에서는 SDK가 기기 로캘에서 수집하는 사용자의 ${language} 표준 속성을 읽는 세 가지 카탈로그 패턴을 다룹니다.

• JSON 오브젝트 필드: 항목당 하나의 행에 모든 로캘 포함
• 언어별 플랫 열: header_en, header_fr 등
• 언어별 별도 카탈로그: pantslabyrinth-promo-en과 같은 동적 카탈로그 이름

현지화된 콘텐츠가 구조화된 데이터(제품, 프로모션, 이미지 URL)인 경우 카탈로그를 사용하세요. 이메일이나 푸시에서 자유 형식의 메시지 문구가 필요한 경우, 채널이 지원한다면 다국어 메시지를 사용하는 것이 좋습니다. 현지화 패턴을 더 폭넓게 비교하려면 번역 관리를 참고하세요.

고려 사항

• 예시는 설명 목적입니다. 카탈로그 키나 접미사를 지정하기 전에 사용자 기반에서 ${language}의 대소문자 및 형식을 확인하세요.
• 방법 1과 2의 경우, ${language}가 비어 있거나 카탈로그 키 또는 필드와 일치하지 않으면 현지화된 출력이 비어 있을 수 있습니다. 각 필드를 개별적으로 확인하고 기본값(예: 영어)으로 대체하세요.
• 방법 3의 경우, 카탈로그 이름을 작성하기 전에 지원되는 언어 코드를 허용 목록에 추가하세요. 누락된 카탈로그는 메시지를 중단시킵니다.
• 카탈로그의 JSON 객체는 API 또는 카탈로그용 클라우드 데이터 수집(CDI)을 통해 생성하거나 업데이트할 수 있으며, CSV 업로드로는 불가합니다.
• 방법 2는 CSV 유지 관리를 지원하지만 언어가 늘어날수록 열이 증가합니다. CSV 파일은 최대 1,000개 열을 지원합니다.
• 방법 3은 catalog_items 태그에 도달하는 모든 언어 코드에 대해 카탈로그가 필요합니다. 카탈로그가 존재하지 않으면 Braze가 메시지를 중단합니다. 기존 카탈로그에서 항목 ID가 누락되면 빈 항목 배열이 반환됩니다.
• 카탈로그 Liquid 태그는 재귀적으로 사용할 수 없습니다.
• 카탈로그 셀렉션은 최대 10개의 필터를 지원하며 최대 50개의 항목을 반환합니다. 카탈로그 스키마에 맞게 필터를 검증하세요.
• 대규모 다중 로케일 제품 피드를 유지 관리하는 경우 카탈로그 스토리지 티어를 검토하세요.

설정

1단계: 카탈로그 구조 선택

아래 표의 안내를 참고하여 카탈로그 구조를 선택합니다.

2단계: 카탈로그 및 항목 생성

1. 데이터 설정 > 카탈로그로 이동하여 카탈로그를 생성합니다(방법 3의 경우 여러 카탈로그).
2. 선택한 구조에 따라 필드와 항목을 추가합니다. 카탈로그 생성을 참조하세요.
3. (선택 사항) 카탈로그 선택을 생성하여 항목을 필터링합니다. 예를 들어, 사용자 커스텀 속성과 일치하는 category 기준으로 필터링할 수 있습니다.

• 방법 1: json 필드
• 방법 2: 플랫 필드
• 방법 3: 언어별 카탈로그

3단계: 메시지에 Liquid 추가

1단계에서 선택한 카탈로그 구조에 맞는 Liquid 패턴을 선택합니다.

• 방법 1: json 필드
• 방법 2: 플랫 필드
• 방법 3: 언어별 카탈로그

모든 로캘을 단일 카탈로그 행의 JSON 오브젝트 필드에 저장한 다음, property_accessor 필터를 사용하여 ${language}(대문자로 정규화)에 맞는 name 및 price 키를 읽습니다. 각 필드를 독립적으로 확인하고, 해당 필드가 비어 있으면 EN으로 대체합니다. 따라서 이름은 있지만 가격이 없는 로캘은 영어 가격을 표시합니다.

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

{% catalog_items PantsLabyrinth_Product_Copy trail-runner-001 %}
{% assign lang = ${language} | upcase %}
{% assign localized_name = items[0].name | property_accessor: lang %}
{% assign localized_price = items[0].price | property_accessor: lang %}
{% if localized_name == blank %}
  {% assign localized_name = items[0].name | property_accessor: 'EN' %}
{% endif %}
{% if localized_price == blank %}
  {% assign localized_price = items[0].price | property_accessor: 'EN' %}
{% endif %}
Product: {{ localized_name }}
Price: {{ localized_price }}

Property accessor 필터를 참조하세요.

${language}(소문자로 정규화)를 사용하여 동적 필드 이름을 구성한 다음, 대괄호 조회를 통해 항목에서 해당 필드를 읽습니다. 예를 들어, items[0][header_field]는 확인된 언어에 대한 헤더를 읽습니다. 각 필드를 독립적으로 확인하고, 해당 필드가 비어 있으면 영어 열로 대체합니다. 따라서 헤더는 있지만 본문이 없는 로캘은 영어 본문 텍스트를 표시합니다.

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

{% catalog_items PantsLabyrinth_Promo_Copy spring-sale %}
{% assign lang = ${language} | downcase %}
{% assign header_field = 'header_' | append: lang %}
{% assign body_field = 'body_' | append: lang %}
{% assign cta_field = 'cta_text_' | append: lang %}
{% assign img_field = 'img_src_' | append: lang %}
{% assign header_val = items[0][header_field] %}
{% assign body_val = items[0][body_field] %}
{% assign cta_val = items[0][cta_field] %}
{% assign img_val = items[0][img_field] %}
{% if header_val == blank %}
  {% assign header_val = items[0].header_en %}
{% endif %}
{% if body_val == blank %}
  {% assign body_val = items[0].body_en %}
{% endif %}
{% if cta_val == blank %}
  {% assign cta_val = items[0].cta_text_en %}
{% endif %}
{% if img_val == blank %}
  {% assign img_val = items[0].img_src_en %}
{% endif %}
<img src="{{ img_val }}" alt="" />
<h2>{{ header_val }}</h2>
<p>{{ body_val }}</p>
<a href="#">{{ cta_val }}</a>

경고

catalog_items에 전달한 카탈로그 이름이 존재하지 않으면 Braze가 메시지를 중단합니다. 카탈로그 이름을 구성하기 전에 지원되는 언어 코드를 허용 목록에 추가하세요. 기존 카탈로그에서 항목 ID가 누락되면 빈 items 배열이 반환되며, 이 경우에만 영어 카탈로그로 대체할 수 있습니다.

일치하는 카탈로그가 있는 언어 코드(여기서는 en, fr, de)를 허용 목록에 추가하고, 지원되지 않거나 빈 값은 en으로 기본 설정한 다음 항목을 조회합니다. 해당 카탈로그에서 항목 ID가 누락되면 영어 카탈로그로 대체합니다.

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

{% assign lang = ${language} | downcase %}
{% assign supported = 'en,fr,de' | split: ',' %}
{% if supported contains lang %}{% else %}{% assign lang = 'en' %}{% endif %}
{% assign theCatalog = 'pantslabyrinth-promo-' | append: lang %}
{% catalog_items {{ theCatalog }} spring-sale %}
{% if items[0] == blank %}
  {% catalog_items pantslabyrinth-promo-en spring-sale %}
{% endif %}
<img src="{{ items[0].img_src }}" alt="" />
<h2>{{ items[0].header }}</h2>
<p>{{ items[0].body }}</p>
<a href="#">{{ items[0].cta_text }}</a>

카탈로그 이름에 템플릿 사용 및 메시지 중단을 참조하세요.

선택 사항: 카테고리별 카탈로그 선택

개인화 전에 항목을 필터링합니다. 예를 들어, preferred_category = footwear인 사용자에게 신발 프로모션을 표시합니다:

1
2
3
4

{% catalog_selection_items PantsLabyrinth_Product_Copy footwear_promos %}
{% for item in items %}
  {{ item.name }}
{% endfor %}

대시보드에서 category 열과 필요에 따라 사용자 속성에 대한 필터를 사용하여 선택을 정의합니다.

4단계: 미리보기 및 테스트

1. 서로 다른 ${language} 값을 가진 고객 프로필로 사용자로 미리보기를 사용합니다.
2. 언어가 누락되거나 지원되지 않는 경우, 부분 로캘(예: 이름은 있지만 가격이 없는 경우)을 포함하여 대체 카피가 올바르게 표시되는지 확인합니다.
3. 방법 3의 경우, 허용 목록에 있는 모든 언어에 일치하는 카탈로그가 있는지, 지원되지 않는 언어 코드가 전송을 중단하지 않고 기본값 카탈로그에 매핑되는지 확인합니다.

관련 문서

• 카탈로그
• 카탈로그 사용
• 셀렉션
• 카탈로그 만들기
• 고급 Liquid 필터
• 현지화
• 다국어 메시지
• 카탈로그 데이터 동기화 및 삭제
• Liquid 메시지 중단