이커머스를 위한 다국어 상품 콘텐츠
해외 판매를 한다는 것은 모든 상품 제목, 설명, 카테고리, 결제 흐름이 고객의 언어로 작동해야 한다는 의미입니다. better-i18n은 이커머스 팀이 다국어 상품 콘텐츠를 관리할 수 있도록 구조화된 콘텐츠 레이어와 번역 파이프라인을 제공합니다. 단, 플랫폼과의 통합에는 개발 작업이 필요합니다.
솔직하게 말씀드리겠습니다. better-i18n은 플러그 앤 플레이 방식의 이커머스 현지화 도구가 아닙니다. Shopify, WooCommerce, Magento와의 기본 제공 연동은 없습니다. 대신, 개발팀이 스토어에 꼭 맞는 연동을 구축할 수 있는 강력한 API와 Content SDK를 제공합니다.
Content SDK: 상품 카탈로그 모델링
Content SDK(@better-i18n/sdk)를 사용하면 상품 데이터에 맞는 콘텐츠 모델을 정의할 수 있습니다. 다음과 같은 모델을 생성할 수 있습니다:
- 상품 — 제목, 설명, 특징, 사양
- 카테고리 — 이름, 설명, 내비게이션 레이블
- 결제 흐름 — 버튼 텍스트, 폼 레이블, 오류 메시지, 확인 문구
- 마케팅 콘텐츠 — 배너, 프로모션, 시즌 캠페인
각 항목은 모든 대상 로케일의 번역을 지원합니다. 쿼리 빌더를 통해 프론트엔드에서 적절한 언어의 적절한 콘텐츠를 효율적으로 가져올 수 있습니다.
이것은 헤드리스 CMS 접근 방식입니다. 콘텐츠 구조를 정의하고, 로케일별로 번역을 관리하며, 스토어프론트 프론트엔드에서 필요한 것을 쿼리합니다.
용어집 기반 AI 번역
상품 콘텐츠에는 고유한 용어 요구사항이 있습니다. 용어집 기능으로 다음을 정의할 수 있습니다:
- 번역하면 안 되는 브랜드명
- 언어별 승인된 번역이 있는 상품 용어 (예: 사이즈 용어, 소재명)
- 카탈로그 전체에서 일관된 번역이 필요한 카테고리명
AI 번역 엔진은 이러한 용어집 규칙을 준수하여 전체 상품 카탈로그에 걸쳐 일관된 초벌 번역을 제공합니다. 품질 요구사항에 따라 대시보드에서 AI 모델을 선택할 수 있습니다.
수백 또는 수천 개의 상품이 있는 카탈로그의 경우, 용어집 기반 AI 번역은 수동 번역 부담을 획기적으로 줄여줍니다.
CDN: 전 세계 고속 콘텐츠 전송
번역된 콘텐츠는 Cloudflare 엣지 네트워크를 통해 cdn.better-i18n.com/{org}/{project}/{locale}/{namespace}.json으로 제공됩니다. 이커머스에 주는 이점:
- 낮은 지연 시간 — 고객에게 가장 가까운 엣지 노드에서 콘텐츠 제공
- 재배포 불필요 — 상품 설명 번역을 업데이트하면 즉시 반영
- 네임스페이스 구성 — 상품 콘텐츠, 결제 문구, 마케팅 카피를 분리
번역 업데이트를 게시하면 배포 파이프라인을 건드리지 않고도 전 세계에서 즉시 사용할 수 있습니다.
REST API: 연동 구축
REST API는 Bearer 토큰 인증을 통한 완전한 CRUD 접근을 제공합니다. 개발팀이 활용할 수 있는 방법:
- 상품 데이터 동기화 — 이커머스 플랫폼에서 better-i18n으로 상품 콘텐츠를 푸시하여 번역
- 번역 가져오기 — 번역된 콘텐츠를 스토어프론트로 페치
- 워크플로 자동화 — 새 상품 추가 시 번역 트리거
- 커스텀 도구 구축 — 팀의 워크플로에 맞는 관리 인터페이스 생성
API는 이커머스 플랫폼과의 주요 연동 포인트입니다. 기본 제공 커넥터가 없으므로 스토어와 better-i18n 사이의 브릿지는 팀이 직접 구축합니다.
MCP로 개발자 생산성 향상
MCP 연동(2개 서버, 28개 도구)을 통해 개발자는 Claude, Cursor, Windsurf, Zed 같은 AI 코딩 어시스턴트에서 번역을 관리할 수 있습니다. 다음과 같은 상황에서 유용합니다:
- 초기 연동 구축 시 키를 빠르게 생성/업데이트해야 할 때
- 개발 중 대시보드로 전환하지 않고 번역을 관리하고 싶을 때
- API를 프로그래밍 방식으로 탐색하고 싶을 때
이커머스를 위한 네임스페이스 구성
스토어프론트에 맞게 번역을 구조화하세요:
products/titles— 상품명products/descriptions— 상품 설명categories— 내비게이션 및 카테고리 페이지checkout— 구매 흐름emails— 주문 확인 및 배송 알림marketing/banners— 프로모션 콘텐츠
각 네임스페이스는 독립적으로 로드되므로 각 페이지에 필요한 번역만 가져와 스토어프론트를 빠르게 유지합니다.
스토어프론트용 프레임워크 SDK
스토어프론트가 지원되는 프레임워크로 구축된 경우 퍼스트파티 SDK를 사용하세요:
@better-i18n/next— Next.js 스토어프론트용@better-i18n/use-intl— Vite 기반 스토어프론트용@better-i18n/expo— Expo/React Native 모바일 커머스 앱용 (오프라인 캐싱 지원)
SDK는 CDN에서 번역을 가져와 컴포넌트에서 사용할 수 있도록 처리합니다.
대시보드 가시성
대시보드는 팀에 다음을 제공합니다:
- 커버리지 추적 — 어떤 상품과 로케일의 번역이 완료되었는지 확인
- 키 관리 — 번역 키 검색, 편집, 정리
- 감사 로그 — 책임 추적을 위한 모든 변경 사항 기록
- RBAC — 프로젝트 설정을 노출하지 않고 콘텐츠 매니저에게 번역 관리 접근 권한 부여
제공하지 않는 기능
better-i18n이 무엇이 아닌지 투명하게 알려드립니다:
- Shopify, WooCommerce, Magento 연동 없음 — 이커머스 플랫폼용 기본 제공 플러그인이나 커넥터가 없습니다. 연동에는 API를 사용한 커스텀 개발이 필요합니다.
- CSV 가져오기/내보내기 없음 — 콘텐츠는 API, 대시보드, Content SDK를 통해 관리됩니다. 상품 카탈로그의 대량 CSV 업로드 기능은 없습니다.
- hreflang 관리 없음 — better-i18n은 번역된 콘텐츠를 전달하지만, hreflang 태그와 SEO 설정은 스토어프론트에서 개발팀이 처리합니다.
- 비주얼 에디터 없음 — 상품 페이지에서 번역이 어떻게 보이는지 인컨텍스트 미리보기가 없습니다. 콘텐츠는 키와 네임스페이스로 관리됩니다.
- 번역 메모리 없음 — 일관성은 용어집 적용과 AI 번역을 통해 유지됩니다.
- JSON 전용 — 모든 번역 데이터는 JSON 형식입니다. XLIFF, PO, CSV 형식은 지원하지 않습니다.
이것은 개발자 우선 플랫폼입니다. 스토어와 better-i18n 간의 연동을 구축하고 유지할 수 있는 개발자가 이커머스 팀에 있을 때 가장 효과적입니다.
어떤 팀에 적합한가요?
better-i18n은 다음과 같은 이커머스 팀에 가장 적합합니다:
- 커스텀 또는 헤드리스 스토어프론트를 보유 (Next.js, Vite, React Native)
- API 연동을 구축할 수 있는 개발자 보유
- 단순 문자열 번역을 넘어선 구조화된 다국어 콘텐츠 관리 필요
- 브랜드 용어 적용이 포함된 AI 기반 번역 활용 희망
Shopify나 WooCommerce의 원클릭 플러그인을 찾고 계신다면, 현재 better-i18n은 적합한 도구가 아닙니다. 하지만 커스텀 이커머스 경험을 구축하고 있고 본격적인 콘텐츠 현지화 레이어가 필요하다면, 충분히 검토할 가치가 있습니다.
시작하기
계정을 생성하고 Content SDK와 API를 탐색하여 better-i18n이 이커머스 아키텍처에 어떻게 맞는지 확인하세요.