> For the complete documentation index, see [llms.txt](https://help.citrusad.com/retail-media-interface/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.citrusad.com/retail-media-interface/partner/ko/campaign-management-api/bannerxcampaign-1.md).
# 배너 X 캠페인
Banner X 은 소매업체의 웹사이트에 매끄럽게 통합되어 온라인 쇼핑 환경을 개선하는 다중 구성요소 응답형 배너 광고를 제공합니다. Epsilon Retail Media 은 구성요소를 제공하는 반면, 소매업체의 프론트엔드는 스타일을 관리하여 사이트의 전자상거래 디자인과의 일관성을 보장합니다. 이 접근 방식은 고객에게 효과적으로 참여를 유도하는 동시에 브랜드 무결성을 유지하는 데 도움이 됩니다.
## 주요 혜택
* **네이티브 통합**: 광고가 상품 캐러셀 내에 자연스럽게 맞춰져 사이트의 스타일을 유지합니다.
* **개인화**: 사용자의 관심사에 맞춤화된 실시간 개인화 광고를 전달합니다.
* **참여도 향상**: 매력적인 CTA를 통해 상품 노출도를 개선하고 고객 참여를 유도하며 매출을 증대합니다.
## Banner X 구성요소
디자인이 소매업체 표준을 준수하도록 배너 X의 구성요소를 이해합니다. 각 구성요소는 시각적 일관성과 기능을 유지하는 데 필수적입니다.
### 기본 배경 이미지
기본 배경은 장치 전반에 걸쳐 디자인 명확성과 일관성을 보장하는 단순한 배경입니다. 특히 다양한 장치 및 브라우저 너비에서 잘림 문제를 방지하기 위해 상품 이미지를 삽입하거나 콘텐츠를 과도하게 강조하지 마세요. 사용할 수 있는 6가지 기본 배경 구성은 다음과 같습니다.
* 반복
* 채우기
* 상단 정렬
* 하단 정렬
* 우측 정렬
* 좌측 정렬
### 보조 배경 이미지
배너에 추가 장식을 적용하려면 보조 배경 이미지를 사용하세요. 사용할 수 있는 6가지 보조 배너 구성은 다음과 같습니다.
* 반복
* 채우기
* 상단 정렬
* 하단 정렬
* 우측 정렬
* 좌측 정렬
### 배너 텍스트
배너 텍스트는 배너 광고에 표시되는 텍스트로, 굵은 글씨를 위한 `strong` 및 기울임꼴을 위한 `i` 과 같은 제한된 HTML 태그를 지원합니다. 텍스트 색상을 맞춤 설정할 수도 있습니다. 예를 들어,
### 히어로 이미지
히어로 이미지는 일반적으로 상품이나 로고를 표시하는 데 사용되는 기본 프로모션 이미지입니다. 히어로 이미지에 사용할 수 있는 두 가지 구성은 다음과 같습니다.
* 가로
* 세로
### 보조 히어로 이미지
상품이나 로고를 표시하려면 보조 히어로 이미지를 사용하세요. 사용할 수 있는 두 가지 구성은 다음과 같습니다.
* 가로
* 블록(너비와 높이가 동일한 이미지)
### 콜투액션(CTA)
콜투액션(CTA)은 사용자가 구매를 하거나 다른 페이지를 방문하는 등의 작업을 수행하도록 유도하는 클릭 가능한 텍스트 또는 버튼입니다. CTA는 참여도를 높이기 위해 명확하고 행동 지향적이며 시각적으로 눈에 띄어야 합니다. 예를 들어 "지금 쇼핑하기"는 구매를 독려합니다.
## 광고 게재위치 유형
Banner X 은 소매업체 웹사이트에서 다음과 같은 다양한 전략적 [광고 게재위치](https://developers.citrusad.com/integration/docs/introduction-to-placement-types) 를 지원합니다.
* **검색**: 고객이 캠페인에 구성된 초콜릿과 같은 검색어를 입력할 때 광고를 표시합니다. 자세한 내용은 다음을 참조하세요: [검색 게재위치](https://developers.citrusad.com/integration/docs/introduction-to-placement-types#search).
* **카테고리**: 상품과 관련된 카테고리 페이지에 광고를 표시합니다. 다음과 같은 관련 분류 세부정보를 제공하여 특정 카테고리를 타겟팅하세요: `Category:Cupboard/Snacks`. 자세한 내용은 다음을 참조하세요: [카테고리 게재위치](https://developers.citrusad.com/integration/docs/introduction-to-placement-types#category).
* **카테고리 및 검색**: 고객이 상품과 관련된 카테고리 페이지를 방문하거나 캠페인에 구성된 검색어를 사용할 때 광고를 표시합니다.
* **카테고리 교차 판매**: 카테고리 교차 판매 게재위치를 통해 광고주는 상품의 기본 카테고리 외에도 보완적인 카테고리를 타겟팅할 수 있습니다. 이 접근 방식은 소매업체 사이트의 유제품 섹션에 커피 상품을 노출하는 것과 같이 관련 카테고리에서 상품의 노출도를 높입니다. 자세한 내용은 다음을 참조하세요: [교차 판매 게재위치](https://help.citrusad.com/retail-media-interface/integration/ko/feature-integrations/category-cross-sell/difference-between-category-and-category-cross-sell-placements).
* **확장 검색**: 특정 카테고리나 검색어에 연결되지 않은 트래픽이 많은 페이지에 광고를 표시합니다. 홈페이지나 결제 페이지와 같은 일반적인 위치에 이상적입니다. 자세한 내용은 다음을 참조하세요: [확장 검색 게재위치](https://help.citrusad.com/retail-media-interface/integration/ko/generating-ads/banner-x-responsive/requesting-banner-x-ads#broad-match-placements).
## 지원되는 광고 슬롯 형식
Banner X 은 다음 형식으로 배포될 수 있습니다.
* 단일 타일
* 이중 타일
* 풀 배너
## 배너 X 광고 구현
배너 X 광고를 설정하려면 다음 단계를 따르세요.
### 1단계: 소매업체의 콘텐츠 표준 검토
콘텐츠 표준은 웹사이트나 디지털 플랫폼의 지정된 공간 내에 Banner X 광고가 표시되어야 하는 방식을 규정하는 지침 및 기술 매개변수입니다. 이러한 표준에는 다음이 포함될 수 있습니다.
* **크기 및 사이즈**: 배너의 정확한 너비와 높이에 대한 사양입니다.
* **파일 형식**: JPEG, JPG, PNG, SVG 또는 GIF와 같이 허용되는 이미지 또는 비디오 파일 형식입니다.
* **파일 크기 제한**: 빠른 로딩 시간과 웹페이지에서의 최적의 성능을 보장하기 위해 허용되는 최대 파일 크기입니다.
* **해상도 및 화질**: 배너가 선명하고 전문적으로 보이도록 하는 최소 해상도 요구사항입니다.
* **위치 지정 및 정렬**: 사용 가능한 공간 내에서 배너를 정렬하는 방법에 대한 지침입니다.
* **콘텐츠 제한**: 배너 내에 포함될 수 있거나 포함될 수 없는 콘텐츠에 대한 규칙(예: 불쾌감을 주는 콘텐츠 금지, 필수 법적 고지 사항 포함).
* **상호작용성**: 해당되는 경우 클릭 가능한 영역, 애니메이션 또는 사용자 유발 이벤트와 같은 대화형 요소에 대한 사양입니다.
캠페인을 시작하려면 소매업체의 콘텐츠 표준 지침을 숙지하세요. 이러한 지침에는 예시 URL, 페이지 위치 지정 및 특정 아트워크 콘텐츠 제한 사항이 포함되어 있습니다. 사용 가능한 배너 X 슬롯 및 해당 사양에 대한 자세한 내용은 CIE(Customer Integration Engineer)에 문의하세요. 예시는 다음과 같습니다.
### 2단계: 크리에이티브 자산 준비
소매업체의 콘텐츠 표준에 따라 크리에이티브 자산을 개발합니다. 여기에는 기본 배경, 보조 배경, 히어로 이미지, 보조 히어로 이미지와 같은 요소가 포함됩니다. 콘텐츠 표준의 세부정보를 검색하려면 [Get Banner X content standard details](/retail-media-interface/partner/ko/campaign-management-api/bannerxcontentstandard/getbannerxcontentstandard-1.md) API를 사용하세요.
### 3단계: 광고 슬롯 형식 식별
배포할 광고 슬롯 형식을 결정합니다. 이 형식은 풀 배너, 단일 타일 또는 이중 타일일 수 있습니다.
### 4단계: 크리에이티브 자산 업로드
크리에이티브 자산을 생성하고 광고 슬롯 형식을 식별한 후 다음을 사용하여 업로드하세요. [Upload the creative asset](/retail-media-interface/partner/ko/team-user-api/user-1/uploadfile-1.md) API. API는 업로드된 이미지의 파일 ID 및 URL을 반환합니다.
* **파일 ID**: 파일 ID는 배너 X 캠페인을 생성할 때 필요합니다. 주 배경, 보조 배경, 히어로 이미지, 보조 히어로 이미지와 같은 각 에셋 유형에 대해 특정 파일 ID를 제공해야 합니다.
* **URL**: URL은 주로 업로드된 이미지를 미리 보는 데 사용됩니다.
### (선택 사항) 5단계: 이미지의 공개 URL 가져오기
다음 API를 사용하십시오. [파일 URL 가져오기 API](/retail-media-interface/partner/ko/campaign-management-api/creativeassets/getcampaignfileurl.md) 를 사용하여 이미지의 공개 URL을 얻습니다. 이 URL을 사용하여 이미지를 확인하거나 이해관계자와 공유할 수 있습니다.
### 6단계: 배너 X 캠페인 생성
다음 API를 사용하여 배너 X 캠페인을 생성합니다. [배너 X 캠페인 생성](/retail-media-interface/partner/ko/campaign-management-api/bannerxcampaign-1/createbannerxcampaign-1.md) API. 다음이 있는지 확인하십시오. `backgroundImageId`, `secondaryBackgroundImageId`, `heroImageId`, 및 `secondaryHeroImageId`이 것들은 다음 API에서 반환된 파일 ID입니다. [Upload the creative asset](/retail-media-interface/partner/ko/team-user-api/user-1/uploadfile-1.md) API.
---
# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.
## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.
Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:
```
GET https://help.citrusad.com/retail-media-interface/partner/ko/campaign-management-api/bannerxcampaign-1.md?ask=&goal=
```
`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.
Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.