다국어 메시지

다국어 메시지를 사용하면 하나의 캠페인이나 유저 여정에서 사용자 언어에 맞는 메시지를 보낼 수 있습니다. 사용자의 언어에 해당하는 메시지가 없으면 기본 메시지를 발송합니다.

지원 채널

앱 푸시
웹 푸시
인앱 팝업
웹 팝업

이메일, 문자, 카카오톡 등 나머지 채널은 현재 다국어 메시지를 지원하지 않습니다.

1. 다국어 메시지 사용하기

먼저 메시지를 작성할 캠페인이나 유저 여정에서 다국어 메시지 사용을 켭니다.

캠페인

캠페인 생성 화면에서 앱 푸시, 웹 푸시, 인앱 팝업 또는 웹 팝업 채널을 선택합니다.
고급 설정을 엽니다.
다국어 메시지 사용을 켭니다.

유저 여정

메시지 노드를 추가하거나 기존 메시지 노드를 엽니다.
앱 푸시, 웹 푸시, 인앱 팝업 또는 웹 팝업 채널을 선택합니다.
다국어 메시지 사용을 켭니다.

설정을 켜면 메시지 작성 화면에 기본 언어가 표시됩니다.

2. 푸시 메시지 작성하기

앱 푸시와 웹 푸시는 메시지 작성 화면에서 기본 메시지와 언어별 메시지를 직접 작성합니다.

2-1. 기본 메시지 작성하기

기본에서 모든 사용자가 받을 수 있는 제목과 내용을 작성합니다. $locale과 기기 또는 브라우저 언어에 모두 일치하는 메시지가 없을 때 기본 메시지를 발송합니다. 기본 메시지만 받아도 내용을 이해하고 액션을 수행할 수 있도록 작성해 주세요.

2-2. 언어 추가하기

언어 추가를 누릅니다.
언어 이름이나 언어 코드로 검색합니다.
추가할 언어를 선택합니다.
해당 언어로 보낼 메시지를 입력합니다.

입력이 끝난 언어에는 완료 표시가 나타납니다. 필수 내용이 비어 있거나 Liquid 문법에 오류가 있으면 확인 필요 표시가 나타납니다.

2-3. 번역 초안 자동으로 채우기

기본 메시지를 바탕으로 추가한 언어의 제목과 내용을 자동으로 채울 수 있습니다.

기본 메시지의 제목과 내용을 입력합니다.
필요한 언어를 추가합니다.
언어 N개 자동 채우기를 누릅니다.
생성된 번역을 검토하고 수정합니다.

이미 입력한 제목이나 내용은 덮어쓰지 않고 비어 있는 항목만 채웁니다.

자동으로 생성된 번역은 발송용 초안입니다. 브랜드 표현, 변수 위치, 링크와 Liquid 문법을 직접 확인한 뒤 저장해 주세요.

2-4. 광고성 메시지 작성하기

다국어 메시지에서는 광고성 메시지 여부를 자동으로 처리하지 않습니다.각 언어별 메시지에 필요한 광고 표기와 수신거부 안내를 직접 반영해 주세요. 관련 법령 준수 책임은 발송자에게 있습니다.

3. 팝업 템플릿 연결하기

인앱 팝업과 웹 팝업은 메시지 작성 화면에서 내용을 직접 입력하지 않습니다. 언어별로 팝업 템플릿을 만든 뒤 각 언어에 맞는 템플릿을 선택합니다.

사용할 언어마다 팝업 템플릿을 만듭니다.
- 인앱 팝업: 인앱 팝업 템플릿 제작
- 웹 팝업: 웹 팝업 템플릿 제작
메시지 작성 화면의 기본에서 기본으로 노출할 템플릿을 선택합니다.
언어 추가를 눌러 언어를 추가합니다.
추가한 언어를 선택한 뒤 해당 언어로 만든 템플릿을 선택합니다.

사용자의 언어에 해당하는 팝업 템플릿이 없으면 기본에서 선택한 템플릿을 노출합니다. 팝업 템플릿은 자동 번역되지 않습니다.

4. 사용자 언어 설정하기

노티플라이는 메시지를 발송할 때 다음 순서로 사용자 언어를 확인합니다.

사용자 속성 $locale
SDK에서 마지막으로 수집한 기기 또는 브라우저 언어
기본 메시지

서비스에서 사용자가 직접 언어를 선택할 수 있다면 $locale을 설정하는 방식을 권장합니다. $locale이 없거나 일치하는 언어별 메시지가 없으면 기기 또는 브라우저 언어를 확인합니다. 여기에도 일치하는 메시지가 없으면 기본 메시지를 발송합니다.

4-1. `$locale` 저장하기

사용자가 로그인하거나 서비스 언어를 변경할 때 노티플라이 SDK의 setUserProperties를 호출하여 $locale을 저장합니다.

Android
iOS
JavaScript
React Native
Flutter

Notifly.setUserProperties(
    context,
    mapOf("\$locale" to "zh-TW")
)

Notifly.setUserProperties(
    userProperties: ["$locale": "zh-TW"]
)

notifly.setUserProperties({
  "$locale": "zh-TW",
});

notifly.setUserProperties({
  "$locale": "zh-TW",
});

await NotiflyPlugin.setUserProperties({
  r'$locale': 'zh-TW',
});

로그인 직후 설정한다면 setUserId로 사용자를 식별한 다음 setUserProperties를 호출해 주세요. 사용자가 앱이나 웹사이트에서 언어를 변경한 경우에도 $locale을 다시 저장합니다. SDK별 자세한 호출 방법은 Android SDK, iOS SDK, JavaScript SDK, React Native SDK, Flutter SDK 가이드를 참고해 주세요.

4-2. 언어 코드 형식

$locale에는 BCP 47 형식의 언어 코드를 저장합니다. 메시지 작성 화면에서 추가한 언어와 같은 코드를 사용하는 것이 가장 안전합니다.

언어	권장 코드
한국어	`ko`
영어	`en`
일본어	`ja`
프랑스어	`fr`
중국어 간체	`zh-CN`
중국어 번체	`zh-TW`

en-US, ko-KR, ja-JP처럼 국가 코드가 포함된 값도 사용할 수 있습니다. 노티플라이는 먼저 전체 코드를 확인하고, 일치하는 메시지가 없으면 언어 부분만 다시 확인합니다. 예를 들어 $locale이 en-US라면 다음 순서로 메시지를 찾습니다.

영어(미국) en-US
영어 en
기본 메시지

중국어는 메시지 작성 화면에서 사용하는 zh-CN과 zh-TW로 저장해 주세요.

중국어 간체: zh-CN
중국어 번체: zh-TW
사용하지 않는 형식: zh-Hans, zh-Hant, zh-Hans-TW

zh-Hans와 zh-Hant도 BCP 47에서 사용하는 언어 태그지만, 현재 노티플라이의 중국어 메시지 코드와 직접 일치하지 않습니다.

4-3. 언어 선택 예시

`$locale`	작성한 언어별 메시지	발송되는 메시지
`ko`	`ko`	한국어
`ko-KR`	`ko`	한국어
`en-US`	`en`	영어
`zh-CN`	`zh-CN`	중국어 간체
`zh-TW`	`zh-TW`	중국어 번체
`zh-Hant`	`zh-TW`	기본 메시지
`ja`	일본어 메시지 없음	기본 메시지
`$locale` 없음	기기 언어가 `en-US`, `en` 메시지 있음	영어
`$locale`과 기기 언어 없음	해당 없음	기본 메시지

5. 발송 전 확인하기

푸시

기본 메시지만 받아도 내용을 이해할 수 있는지 확인합니다.
추가한 모든 언어에 완료 표시가 있는지 확인합니다.
Liquid 변수, 이미지와 링크를 언어별로 확인합니다.
자동 번역을 사용했다면 표현과 변수 위치를 직접 검토합니다.
광고성 메시지라면 각 언어의 광고 표기와 수신거부 안내를 확인합니다.

팝업

기본과 추가한 모든 언어에 올바른 템플릿을 선택했는지 확인합니다.
템플릿의 문구, 이미지, 버튼과 링크가 해당 언어에 맞는지 확인합니다.

푸시와 팝업 모두 사용자 속성의 언어 코드와 추가한 언어가 맞는지 확인해 주세요.

A/B 테스트 캠페인

A/B 테스트에서도 다국어 메시지를 사용할 수 있습니다. 각 실험군마다 언어별 푸시 메시지를 작성하거나 팝업 템플릿을 선택해 주세요. 대조군에는 메시지가 발송되지 않습니다.

시작하기 전에

캠페인

유저 여정

데이터

채널

분석

연동

콘솔 메뉴

Resources

지원 채널

1. 다국어 메시지 사용하기

캠페인

유저 여정

2. 푸시 메시지 작성하기

2-1. 기본 메시지 작성하기

2-2. 언어 추가하기

2-3. 번역 초안 자동으로 채우기

2-4. 광고성 메시지 작성하기

3. 팝업 템플릿 연결하기

4. 사용자 언어 설정하기

4-1. `$locale` 저장하기

4-2. 언어 코드 형식

4-3. 언어 선택 예시

5. 발송 전 확인하기

푸시

팝업

A/B 테스트 캠페인

​지원 채널

​1. 다국어 메시지 사용하기

​캠페인

​유저 여정

​2. 푸시 메시지 작성하기

​2-1. 기본 메시지 작성하기

​2-2. 언어 추가하기

​2-3. 번역 초안 자동으로 채우기

​2-4. 광고성 메시지 작성하기

​3. 팝업 템플릿 연결하기

​4. 사용자 언어 설정하기

​4-1. $locale 저장하기

​4-2. 언어 코드 형식

​4-3. 언어 선택 예시

​5. 발송 전 확인하기

​푸시

​팝업

​A/B 테스트 캠페인

지원 채널

1. 다국어 메시지 사용하기

캠페인

유저 여정

2. 푸시 메시지 작성하기

2-1. 기본 메시지 작성하기

2-2. 언어 추가하기

2-3. 번역 초안 자동으로 채우기

2-4. 광고성 메시지 작성하기

3. 팝업 템플릿 연결하기

4. 사용자 언어 설정하기

4-1. `$locale` 저장하기

4-2. 언어 코드 형식

4-3. 언어 선택 예시

5. 발송 전 확인하기

푸시

팝업

A/B 테스트 캠페인