> 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/integration/ko/generating-ads/banner-x-responsive/video-ads-banner-x.md).
# Banner X 비디오 광고
광고주와 리테일러는 웹사이트나 앱에 직접 표시되는 배너에 홍보 동영상을 업로드할 수 있습니다. 이러한 동영상은 매력적인 방식으로 상품을 선보임으로써 구매 결정에 영향을 미칩니다. 대화형 동영상을 통해 소비자는 **장바구니 담기** 또는 **지금 구매** 옵션을 활용하여 동영상에서 직접 상품을 탐색하고 구매할 수 있습니다.
## 웹사이트에 동영상 광고를 도입해야 하는 이유는 무엇일까요?
온사이트 동영상을 통해 광고주는 웹사이트에서 쇼핑객과 더 깊게 소통할 수 있으며, 더욱 매력적인 쇼핑 경험을 조성하고 쇼핑객이 사이트에서 옵션을 탐색하며 보내는 시간을 늘릴 수 있습니다.
| 이유 | 설명 |
| --------------- | --------------------------------------------------------------------------------------------- |
| 브랜드 스토리 홍보 | 참여도가 높은 동영상 광고는 광고주의 전체 스토리 또는 특정 상품 스토리의 매력적이고 관련성 높은 부분을 선보여 리테일 브랜드와 쇼핑객을 더 깊게 연결해 줍니다. |
| 신상품 출시 | 광고주는 동영상을 활용하여 단순한 디스플레이 광고보다 더 깊이 있게 신상품을 소개할 수 있습니다. 동영상을 통해 신상품이 제공하는 가치로 쇼핑객과 소통할 수 있습니다. |
| 브랜드 인지도 | 새로운 카테고리 또는 새로운 메시지로 인지도를 제고하려는 광고주는 사이트의 주요 위치에서 동영상을 활용하여 쇼핑객과 직접 소통할 수 있습니다. |
| 리테일 브랜드와의 연결 강화 | 동영상은 쇼핑객의 마음속에서 광고주와 리테일 브랜드 간의 연결을 더욱 깊게 만들어 줄 수 있습니다. |
## 동영상 사양
* 최대 파일 크기\*\*: 300MB
* **허용되는 파일 형식**: Video/mp4, video/quicktime, video/x-msvideo
* **선택적 코덱 검증**: H.264, H.265
* **높이 및 너비**: 리테일러가 픽셀 단위로 정의
* 길이 제한\*\*: 없음
* **캠페인 검토**: 동영상 요소를 포함하는 배너 X 캠페인의 경우 필수
* **태그 지원**: 다음 형식으로 제공되는 표준 VAST 태그 `adm` 광고 응답 내
## 동영상 광고 연동
다음과 매끄럽게 연동되는 대화형 배너 X 동영상 광고를 생성할 수 있습니다. [VAST 4.0](https://iabtechlab.com/wp-content/uploads/2016/05/VAST4.0_Updated_April_2016.pdf) 호환 동영상 플레이어를 통해 리테일러에게 최소한의 노력으로 배포를 간소화하는 대화형 광고 형식을 제공합니다.
Banner X 동영상 광고는 VAST(Digital Video Ad Serving Template) 4.0 표준을 준수하여 지원되는 동영상 플레이어와 원활하고 호환 가능한 연동을 보장합니다.
동영상 광고를 캠페인에 포함할 때 광고 응답에는 이름이 다음과 같은 필드가 포함됩니다. `adm`. 이 필드에는 VAST 4.0 준수에 필요한 XML 태그가 포함되어 있어 동영상 플레이어에 쉽게 임베드할 수 있습니다.
### 연동 요건
#### 광고 요청
광고 요청을 당사의 Banner X 엔드포인트로 전송해야 합니다. 동영상 및 기타 배너 콘텐츠는 동영상과 배너 콘텐츠가 구성된 캠페인에 대해서만 제공됩니다. `adm` 개체가 포함된 광고를 받으려면 먼저 동영상 자산이 구성된 캠페인이 있는지 확인해야 합니다.
광고 요청 방법에 대한 자세한 내용은 다음에서 확인할 수 있습니다. [배너 X 광고 생성](/retail-media-interface/integration/ko/integration/bannerx.md)
#### 동영상 플레이어 (광고 렌더링)
Epsilon Retail Media 배너 X 응답의 `adm` 개체로 당사의 광고 응답에서 VAST 태그(Video Ad Server Template)를 제공합니다. 따라서 VAST 태그를 구문 분석하고 동영상 광고를 렌더링하려면 동영상 플레이어가 필요할 수 있습니다.
{% hint style="info" %}
**동영상 플레이어가 없으신가요?** 다양한 오픈 소스 동영상 플레이어를 사용할 수 있습니다. Video JS 또는 Clappr와 같이 이용 가능한 유료 및 오픈 소스 옵션을 검토하는 것이 좋습니다. VAST 태그를 구문 분석하려면 추가 플러그인이 필요할 수 있습니다.
{% endhint %}
#### Banner X 미리보기 기능
캠페인을 생성, 관리 및 검토할 때 광고 미리보기가 올바르게 렌더링되도록 배너 X 미리보기 기능을 업데이트하세요. 다음을 참조하세요. [배너 X 미리보기 기능](/retail-media-interface/integration/ko/generating-ads/banner-x-responsive/integrating-your-banner-x-previewer.md).
#### 추적 및 리포팅
다양한 추적(노출 수, 클릭 수, 진행 상황 및 상호작용)이 모두 가능합니다. 다음 가이드를 참조하세요. [배너 X 동영상 상호작용 리포팅](/retail-media-interface/integration/ko/data-api/api-overview/ad-interaction-events-reporting/integrate-banner-x-video-interaction-reporting.md)
### 추적 요소
추적 목적으로 [Video Ad Serving Template](https://iabtechlab.com/standards/vast/) (VAST)을 사용합니다. VAST 태그에는 몇 가지 추적 메커니즘이 포함되어 있습니다.
* 노출 추적
* 클릭 추적
* 진행 상황 추적 (start, firstQuartile, midpoint, thirdQuartile, complete)
* **1분위 (25% 시청)**: 초기 참여의 초기 지표
* **중간 지점 (50% 시청)**: 콘텐츠 재생 중간 지점까지 지속된 시청자 관심도 표시
* **3분위 (75% 시청)**: 콘텐츠에 대한 시청자의 강한 몰입도 표시
* **완료 (100% 시청)**: 시청자가 전체 동영상을 시청했음을 확인하며, 최대 참여도를 나타냄
* 상호작용 추적 (mute, unmute, pause, resume, fullscreen)
* **Mute**: 사용자가 동영상 오디오를 음소거함
* **Unmute**: 사용자가 동영상 오디오 음소거를 해제함
* **Pause**: 사용자가 동영상 재생을 일시 중지함
* **Resume**: 사용자가 일시 중지 후 동영상 재생을 다시 시작함
{% hint style="info" %}
**상호작용 추적을 위한 연동 가이드 보기** 다음 가이드를 참조하세요. [배너 X 동영상 상호작용 리포팅](/retail-media-interface/integration/ko/data-api/api-overview/ad-interaction-events-reporting/integrate-banner-x-video-interaction-reporting.md)
{% endhint %}
### 동영상 광고에 대한 광고 응답 예시
다음은 VAST 관련 정보를 포함하여 동영상 광고 응답이 어떻게 보이는지에 대한 스니펫입니다.
```
{
"ads": [
{
"contentStandardId": "00000000-0000-0000-0000-000000000001",
"slotId": "Double_Tile",
"banners": [
{
"citrusAdId": "example_ad_id_AbCdEfGhIjKlMnOpQrStUvWxYz0123456789",
"citrusCampaignName": "Example-Campaign-Name",
"citrusContentStandardId": "00000000-0000-0000-0000-000000000001",
"citrusSlotId": "Double_Tile",
"citrusExpiry": "2026-12-31T00:00:00.000000000Z",
"headingText": "Example heading text",
"bannerText": "Example banner text",
"bannerTextColour": "000000",
"tags": {},
"gtins": [
"00000000000000"
],
"sellerId": "",
"position": 1,
"metadata": {},
"adm": "
CitrusAdexample_ad_id_AbCdEfGhIjKlMnOpQrStUvWxYz0123456789
00000000-0000-0000-0000-000000000002
00000000-0000-0000-0000-000000000003
",
"videoTranscriptFiles": [
{
"videoFileId": "00000000-0000-0000-0000-000000000002",
"format": "txt",
"url": "https://example.com/media/example-transcript.txt",
"language": "en"
}
]
}
]
}
]
}
```
---
# 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/integration/ko/generating-ads/banner-x-responsive/video-ads-banner-x.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.