개요

브랜드 페이지란 무엇입니까?

브랜드 페이지는 귀하의 웹사이트에 존재하는 특정 브랜드 콘텐츠를 소개하는 사용자 지정 랜딩 페이지 경험입니다. 이는 UI 컴포넌트를 사용해 도메인에서 호스팅되고 렌더링됩니다.

Brand Pages are managed separately from standard ad campaigns in the Epsilon platform.
Although they use a similar creation and review workflow, they represent branded landing page experiences on a retailer’s site, not traditional advertisements.

예시: 사용자가 yoursite.com/brands/nike에 방문하여 나이키 제품이 있는 나이키 브랜드 페이지를 보지만, 해당 페이지는 웹사이트의 일부처럼 보이고 느껴집니다.

귀하가 구축할 내용

소매 엔지니어로서, 귀하는 다음과 같은 업무를 수행하게 됩니다:

브랜드 페이지 URL에 대한 경로를 추가하세요(예: /brands/{slug}).

📘
소매업체는 각 브랜드 페이지에 대해 URL을 제공할 필요가 없습니다. URL은 플랫폼에서 자동으로 관리합니다.
그러나 브랜드 페이지 기본 URL(접두사 포함)은 온보딩 중에 구성되어야 합니다(예: 소매업체 스타일 가이드). 전체 URL 또는 접두사가 제공되지 않으면 설정 페이지에 브랜드 페이지 URL이 채워지지 않습니다.

추출된 슬러그를 사용하여 브랜드 페이지 API를 호출하십시오.
반환된 콘텐츠 모듈을 렌더링하십시오.
노출, 클릭 및 장바구니 추가‑추적‑기능을 구현하십시오.
퍼스트‑파티 추적을 위한 리버스 프록시를 구성하십시오.

📘
이 단계는 클라이언트 측 추적에만 필요합니다.

귀하의 책임 대 Epsilon의 책임

귀하는 다음을 처리	Epsilon는 다음을 제공
✅ 콘텐츠 가져오기를 위한 API 통합	✅ 브랜드 페이지 콘텐츠 및 템플릿
✅ 귀하의 사이트에서 콘텐츠를 렌더링	✅ 추적 인프라
✅ 리버스 프록시를 설정합니다	✅ 분석 및 보고
✅ 스타일 가이드 제공	✅ 캠페인 관리 도구
✅ 테스트 및 검증	✅ 기술 지원

브랜드 페이지 작동 방법

엔드투엔드 플로우

📘
브랜드 페이지 콘텐츠는 Epsilon UI에서 구성되고 미리보기할 수 있습니다. 소매업체는 독점으로 API를 통해서만 브랜드 페이지를 통합하며, 사이트에서 최종 경험을 렌더링할 책임이 있습니다.

검토 과정에서 소매업체는 승인 전에 구성된 브랜드 페이지 콘텐츠를 미리 볼 수 있습니다.

템플릿 & 모듈

온보딩에서, Epsilon은 귀하의 팀과 협력하여 다음을 정의하는 템플릿을 생성합니다:

The content modules available (such as hero, product grid, text, and images), with module names configurable in the UI to align with your retailer taxonomy.
The constraints for each module (character limits, image dimensions, etc.).
귀하의 브랜드 가이드라인에 부합하는 스타일링입니다.

브랜드는 캠페인을 생성할 때 템플릿을 선택한 다음, 해당 제약 조건 내에서 콘텐츠를 채웁니다.

📘
브랜드 페이지 API는 콘텐츠 모듈과 추적 URL을 반환합니다. 소매업체는 자체 UI 구성 요소와 디자인 시스템을 사용하여 스타일링을 적용할 책임이 있습니다.

예시

다음 예시는 브랜드가 브랜드 페이지를 생성할 때 일반적인 콘텐츠 모듈을 어떻게 채울 수 있는지 보여줍니다. 이들은 단지 샘플 입력일 뿐이며 선택된 템플릿과 캠페인 목표에 따라 조정될 수 있습니다.

HERO 모듈

헤드라인: 최신 여름 컬렉션을 확인하십시오
부제목: 모든 경우에 어울리는 새로운 스타일을 만나보세요.
CTA: 지금 쇼핑하십시오

텍스트 모듈

새로운 제품을 만나보십시오. 편안함, 스타일, 성능을 위해 설계된 이 제품들은 일상적인 착용에 적합합니다.

이미지 모듈

Caption: New arrivals now available
Alt text: Model wearing the summer collection
URL: https://example-cdn.com/summer-collection.jpg

PRODUCT_GRID 모듈

제품 그리드를 활용하여 베스트‑셀러 또는 시즌 상품을 선보이고 고객 참여와 전환율을 높이십시오.

모듈 구성:

모듈	설명	구성 가능한 요소(요약)
HERO	이미지, 헤드라인 및 CTA가 포함된 전체 너비 배너	헤드라인, 부제목, CTA, 이미지, 오버레이
PRODUCT_GRID	제품 그리드 또는 캐러셀	제품, 섹션 제목, 설명, CTA
텍스트	Text content block (headline, body copy)	Text fields, CTA
이미지	옵션 링크가 포함된 단일 이미지입니다.	이미지, 캡션, 대체 텍스트, 선택적 링크
IMAGE_GALLERY	그리드 레이아웃 내 여러 이미지	Images, captions, alt text, section title, description
FILTER_MENU	제품 격자용 가로 필터 탭	필터 라벨 및 정렬
SPLIT_LAYOUT	Multi-column layout with nested modules	Layout structure and nested modules

📘
각 구성 가능한 요소는 모듈 및 소매업체의 요구 사항에 따라 필수, 선택(허용) 또는 비활성화로 설정할 수 있습니다.
일부 필드는 필수 또는 허용으로 표시될 경우 최대 문자 수 제한을 강제할 수도 있습니다.

Module Tags

Templates may include an optional tags field on each module — a list of short string labels (e.g., ["header"]) that your integration can use for layout decisions, analytics, or mapping modules to your own components.

How tags work in the API response

When a module has tags, they appear as a tags array on the corresponding item in contentData.
When a module has no tags, the tags property is omitted entirely from the response - it will not appear as "tags": [].
Treat a missing tags field the same as "no tags" - do not throw an error if it is absent.
Tags are also supported on nested modules within SPLIT_LAYOUT - not only on the root split module.

📘
중요
Tags are opaque labels agreed upon between the retailer and their integration team. They are not related to ad tracking tags or any other system — always refer to these as "module tags" or "brand page module tags" to avoid confusion.

Example response module with a tag

{
  "id": "image-1",
  "contentType": "IMAGE",
  "order": 1,
  "tags": ["header"],
  "imageUrl": "https://example.com/images/banner.jpg"
}

Example response module with no tag (tags property omitted):

{
  "id": "image-2",
  "contentType": "IMAGE",
  "order": 2,
  "imageUrl": "https://example.com/images/promo.jpg"
}

What this means for the API response

The POST /ads/v3/brand-pages response reflects these same rules: a module type only appears in contentData when it is part of the live template and the brand page has configured content for that module.

Fields inside a module may be missing from the JSON, null, or empty when the template marks them optional or disabled, or when the brand leaves them unset - this is expected and does not indicate a defective payload.

Implement rendering with optional types and safe accessors - for example, only render a CTA block when ctaText and a navigation target are present; hide hero media when mediaUrlis absent.

trackersat the page level or on a node may be omitted when there is no trackable interaction. Compose URLs only when you have both an applicable template key from trackingTypes and the corresponding trackers..params, when provided by the API.