사용자 언어 및 로캘 설정

소비자가 받는 언어를 결정할 신호를 정한 다음, 현지화된 Campaigns와 Canvases가 올바른 오디언스를 타겟팅하도록 고객 프로필에 해당 값을 설정합니다.

이 예시에 대하여

가상의 여행 브랜드인 UponVoyage는 12개 시장의 소비자에게 개인화된 메시지를 보냅니다. 마케팅 팀은 소비자가 출국 여행을 예약하는 국가로 설정된 market 커스텀 속성에서 언어를 도출합니다. 이 속성은 언어가 아니라 지역에 매핑되므로, 다국어 국가에서 예약하거나 자국이 아닌 국가에서 예약하는 소비자는 잘못된 언어로 메시지를 받을 수 있습니다.

이 예시에서는 소비자의 언어를 나타내는 세 가지 신호를 비교하고, 각 신호를 프로필에 설정하는 방법을 보여드립니다.

• SDK가 수집한 언어: 기기 또는 브라우저 로캘에서 수집되는 language 표준 속성
• 명시적인 언어 기본 설정: 소비자가 앱이나 사이트에서 선택한 값으로, SDK 또는 REST API를 통해 설정
• 시장 또는 지역 커스텀 속성: market과 같은 비즈니스 속성으로, 콘텐츠가 언어가 아니라 지역에 따라 달라질 때 사용

Braze에서 language와 country는 별개의 표준 속성입니다. 지역별 변형이 중요한 경우(예: 유럽 스페인어와 라틴 아메리카 스페인어), 결합된 로캘 문자열을 저장하는 대신 두 속성을 모두 타겟팅하세요.

이 예시는 언어 신호를 선택하고 프로필에 설정하는 방법을 보여드립니다. 번역된 문구를 저장하고 전송하는 방법은 번역 방식 비교를 참조하세요.

고려 사항

• 국가는 IP 지리 위치를 우선으로 합니다. Braze는 IP 주소 지리 위치로 country를 식별합니다. 지리 위치를 사용할 수 없으면 Braze는 기기 로캘로 country를 식별합니다. country를 기기가 보고한 값으로 취급하지 마세요. 자세한 내용은 SDK 데이터 수집을 참조하세요.
• 언어 수집은 선택 사항이며 끌 수 있습니다. language는 기본적으로 수집되는 선택적 데이터이므로, 최소 통합이나 기기 속성정보 허용 목록에서 제외될 수 있습니다. 이 값에 의존하기 전에 통합에서 여전히 수집되고 있는지 확인하세요. 자세한 내용은 저장소를 참조하세요.
• 가장 최근 기기 로캘이 없을 수 있습니다. 모든 소비자에게 값이 있는 것은 아니므로, 이 값을 사용하는 메시지에는 대체 언어를 계획하세요.
• 값을 명시적으로 설정하면 자동 수집이 중단됩니다. SDK, REST API 또는 CSV 가져오기를 통해 language 또는 country를 설정하면, Braze는 해당 소비자의 그 필드를 더 이상 자동으로 업데이트하지 않습니다. 소비자가 나중에 기본 설정을 변경하는 방법을 미리 계획하세요.
• 명시적인 값은 데이터 포인트를 소모합니다. SDK 및 API 속성 업데이트는 데이터 포인트를 기록하지만, 자동 수집은 기록하지 않습니다. 자세한 내용은 데이터 포인트를 참조하세요.
• language는 ISO 639-1 코드여야 합니다. en 또는 nl과 같은 두 글자 코드를 사용하세요. 지원되는 코드 목록은 언어 코드를 참조하세요. country는 GB 또는 BE와 같은 ISO 3166-1 alpha-2 코드를 사용합니다.
• 언어 모델을 변경하면 기존 에셋에 영향을 줍니다. 커스텀 속성에서 표준 속성으로 전환할 때는 이전 속성을 폐기하기 전에 해당 속성을 참조하는 Campaigns, Canvases, Segments, Liquid를 점검하세요.

설정

1단계: 언어를 결정할 신호 선택

명시적인 기본 설정을 수집할 수 있다면 이를 기본 신호로 사용하고, SDK가 수집한 language를 대체 값으로 사용하세요. 벨기에, 캐나다, 스위스와 같은 다국어 국가에서는 market 속성으로 언어를 추론하기 어렵습니다.

2단계: 통합에서 이미 수집하고 있는 데이터 확인

1. 오디언스 > 사용자 검색으로 이동하여 소비자 프로필을 열고 언어 및 국가 필드를 확인합니다.
2. 여러 프로필에서 언어가 비어 있다면, SDK 통합에서 기기 속성정보 수집 대상에서 이 값을 제외하지 않았는지 확인합니다.
3. 가장 최근 기기 로캘이 채워져 있는지 확인합니다. 이 값은 진단용으로 사용하고, 대체 값 없이 이 값으로 타겟팅하지 마세요.

3단계: 명시적인 언어 기본 설정 지정

이 단계는 1단계에서 명시적인 언어 기본 설정을 선택한 경우에만 진행하세요. SDK가 수집한 language를 사용하는 경우 2단계에서 수집 여부를 확인한 후 타겟팅으로 건너뛰세요. market 또는 지역 커스텀 속성을 사용하는 경우 SDK 또는 REST API를 통해 해당 속성을 설정한 후, 필요에 따라 4~6단계를 진행하세요.

소비자가 언어를 선택하면, 자동 수집보다 우선 적용되도록 해당 선택을 Braze로 보내세요.

선택이 앱이나 사이트에서 이루어지는 경우 SDK를 통해 값을 설정하세요. 플랫폼별 메서드 이름은 사용자 속성 설정을 참조하세요.

자체 시스템에 저장된 기본 설정의 경우 /users/track 엔드포인트를 통해 표준 속성을 보내세요.

1
2
3
4
5
6
7
8
9

{
  "attributes": [
    {
      "external_id": "{YOUR_EXTERNAL_ID}",
      "language": "nl",
      "country": "BE"
    }
  ]
}

YOUR_EXTERNAL_ID를 기본 설정이 변경된 소비자의 식별자로 바꾸세요.

4단계: 소비자가 지역을 알려줄 때 국가 설정

소비자가 자신의 지역을 알려줄 때(예: 국가별 사이트를 탐색하거나 가입 시 시장을 선택할 때) country를 명시적으로 설정하세요. 이전 단계와 동일한 /users/track 요청 또는 SDK 메서드를 사용합니다.

IP 기반 국가가 계속 업데이트되기를 원한다면 country를 명시적으로 설정하지 마세요. 소비자별로 하나의 소스를 선택하고 일관되게 적용하세요.

5단계: 언어 및 국가로 메시지 타겟팅

1. 결합된 로캘 속성 대신 언어 및 국가 필터로 Segments를 구성합니다.
2. 같은 언어 내에서 지역별로 달라지는 메시지의 경우 두 속성을 모두 필터링합니다. 예를 들어 language가 es이고 country가 ES인 경우입니다.
3. 로캘별로 렌더링되는 하나의 메시지를 보내려면 기본 언어 및 국가 속성을 사용하여 로캘을 추가한 다음, 다국어 메시지를 참조하세요.
4. 지역별 콘텐츠를 위해 market 속성을 유지하는 경우, 해당 속성을 언어에 매핑하는 대신 커스텀 속성을 기반으로 로캘을 추가하세요.

6단계: 시장 기반 언어 모델에서 마이그레이션

1. 워크스페이스에서 market 속성을 참조하는 Campaigns, Canvases, Segments, Content Blocks를 검색합니다.
2. 소비자의 기본 설정을 이미 알고 있는 경우 CSV 가져오기 또는 API를 통해 기존 프로필의 language를 채웁니다.
3. 언어로 필터링하도록 에셋을 업데이트하고, 콘텐츠가 지역에 따라 달라지는 경우에만 market 속성을 유지합니다.
4. 이전 속성을 폐기하기 전에 사용자로 메시지 미리보기를 사용하여 각 로캘이 예상대로 렌더링되는지 확인합니다.

관련 문서

• 표준 속성
• SDK 데이터 수집
• 언어 코드
• 사용자 속성 설정
• 사용자 속성 객체
• 현지화 설정
• 다국어 메시지
• 번역 방식 비교