Salesforce CMS 콘텐츠 유형 설계, 이렇게 해야 나중에 덜 고생한다

Salesforce CMS를 처음 설정할 땐 “일단 콘텐츠부터 만들자”는 마음이 앞서기 쉽습니다.
하지만 콘텐츠 유형(Content Type) 설계 없이 시작하면,
나중에 Experience Cloud, Commerce Cloud, 또는 Headless API 연동할 때
데이터 구조가 꼬이고, 콘텐츠 관리가 비효율적이 되는 경우가 많습니다.

이번 글에서는 Salesforce CMS에서 콘텐츠 유형을 설계할 때
실무에서 반드시 지켜야 할 7가지 핵심 원칙과 실전 예시를 알려드릴게요.


CMS 콘텐츠 유형이란?

CMS에서 말하는 **Content Type(콘텐츠 유형)**은
‘뉴스’, ‘이벤트’, ‘FAQ’, ‘제품 카드’ 등 콘텐츠의 데이터 구조와 필드 정의를 의미합니다.

예를 들어 뉴스 콘텐츠라면 다음과 같은 필드가 있을 수 있습니다:

  • 제목 (Text)
  • 본문 (Rich Text)
  • 이미지 (Media)
  • 게시일 (Date)
  • 작성자 (Reference 또는 Text)

이러한 콘텐츠 구조를 사전에 설계하고 등록해두면,
콘텐츠 작성자들은 해당 유형으로 일관되게 콘텐츠를 만들 수 있습니다.


콘텐츠 유형 설계 시 꼭 지켜야 할 7가지 원칙

① 콘텐츠의 ‘재사용 대상’을 먼저 정의하라

→ 이 콘텐츠가 어디에서 재사용될지부터 생각합니다.

  • Experience Cloud 페이지에서 카드 형식으로 노출될지
  • 이메일에서 요약본이 나갈지
  • 외부 앱에서 헤드리스 방식으로 불러올지

예시: “이벤트 카드”는 사이트 메인, 모바일 앱, 커뮤니티 공지에 모두 들어가야 하므로 간결하고 재사용 가능한 구조로 설계되어야 합니다.


② ‘필수 필드’와 ‘선택 필드’를 명확히 구분하라

→ 모든 콘텐츠에 반드시 필요한 정보는 Required로 체크합니다.

  • 제목, 이미지, CTA 링크 → 필수
  • 부제목, 썸네일 설명 → 선택

불필요한 필드를 만들면 작성자 부담이 늘고, 콘텐츠가 느려집니다.
필드 수는 가능하면 10개 이하로 유지하는 것이 좋습니다.


③ ‘리치 텍스트’ 필드는 최소화하라

→ Rich Text 필드는 유연하지만, 관리가 어렵고 API 사용에 불리합니다.

  • HTML이 들어가면 외부 앱에서 분기 처리 필요
  • 번역 시에도 레이아웃 깨짐 발생 가능

가능하면 제목, 본문, 요약 등은 Plain Text 필드 + 이미지로 나누는 것이 좋습니다.


④ 다국어 지원을 고려한 구조 설계

→ Salesforce CMS는 기본적으로 다국어 콘텐츠를 지원하지만,
필드 내 HTML 또는 이미지에 텍스트가 포함되면 번역 자동화에 방해가 됩니다.

좋은 예:

  • title_ko, title_en
  • description_ko, description_en

나쁜 예:

  • description (안에 한국어+영어 혼합)

💡 CMS 설정에서 “Enable Translation”을 체크하면, 콘텐츠별 번역 버전 관리가 가능합니다.


⑤ API로 쓰일 콘텐츠는 ‘스키마 통일성’을 확보하라

→ CMS 콘텐츠를 Headless 방식으로 API 호출할 경우,
스키마가 불규칙하면 프론트엔드에서 파싱이 어렵습니다.

예:

  • title, summary, imageUrl, link모든 콘텐츠 유형에서 공통으로 유지
  • 각 콘텐츠 유형마다 다른 필드명을 쓰지 않도록 설계

API 연동이 필요한 경우엔 GraphQL 스키마 사전 정의도 함께 고려하세요.


⑥ 콘텐츠 유형은 ‘업무 주제별’로 나눠라

→ 혼합형 콘텐츠 유형은 관리에 불리합니다.
예:
❌ “뉴스+공지+이벤트 통합 유형”
✅ “News”, “Notice”, “Event”로 구분

이렇게 해야 게시 위치, 콘텐츠 흐름, 통계 집계까지 관리가 쉬워집니다.


⑦ 콘텐츠 유형 명은 짧고 직관적으로

→ 개발자, 마케터, 디자이너가 모두 이해할 수 있는 이름으로 정합니다.

나쁜 예좋은 예
CMS_CT_1BlogPost
Contents_AProductCard
InfoBox123FAQItem

Salesforce CMS는 워크스페이스, 콘텐츠 유형, 채널 이름이 모두 연결되기 때문에
구조적으로 정돈된 명칭이 중요합니다.


실전 예시: 기업에서 가장 많이 사용하는 CMS 유형 5가지

유형필드 예시
BlogPosttitle, author, thumbnail, body, tags, publishDate
ProductCardtitle, image, price, discountRate, detailUrl
Eventtitle, image, date, location, registrationLink
FAQquestion, answer
Bannerimage, CTA text, CTA link, background color

이런 기본 유형을 먼저 만들어 두고, 필요에 따라 변형하거나 확장하면 CMS 운영이 매우 편해집니다.


FAQ

Q. Salesforce CMS에서 콘텐츠 유형은 어디서 만드나요?
A. Setup → “CMS Content Type” 또는 CMS 워크스페이스 내부에서 생성 가능합니다.

Q. 콘텐츠 유형은 하나로 통합하는 게 좋지 않나요?
A. 관리 측면에서는 좋지만, 채널별 출력 방식이 다르면 나누는 것이 더 효율적입니다.

Q. 콘텐츠 유형 수정 시 기존 콘텐츠는 유지되나요?
A. 필드 추가는 안전하지만, 필드 삭제 또는 필드 타입 변경 시 데이터 손실 가능성 있습니다. 테스트 환경에서 먼저 변경해 보세요.

Q. Salesforce CMS 콘텐츠 유형은 API로도 불러올 수 있나요?
A. 네. GraphQL 또는 REST API를 통해 콘텐츠 유형 기반으로 데이터 호출이 가능합니다.


참고자료

  • Salesforce CMS 공식 문서
  • Salesforce Developer Guide – Content Management
  • Trailhead: Structure Your CMS Content
  • Experience Cloud CMS 컴포넌트 설정 가이드

CMS는 ‘콘텐츠 설계’가 80%입니다.
한 번 잘 만들면 마케터, 디자이너, 개발자가 모두 효율적으로 작업할 수 있지만
처음에 엉성하게 구성하면 나중에 유지보수 비용이 몇 배로 커질 수 있어요.

세일즈포스 CMS는 설계 중심의 CMS입니다.
지금 당장 유형 설계를 다듬는 것이, 콘텐츠 자동화의 첫 걸음이 될 수 있습니다.