파트너 API
API 참조

Banner X video ads

📘

베타 기능

이 기능은 현재 베타 버전으로 추후 변경될 수 있습니다. 귀하의 피드백은 기능 개선에 큰 도움이 됩니다.

광고주와 소매업체는 홍보 동영상을 배너광고에 업로드할 수 있으며 이 배너광고는 웹사이트나 앱에 직접 표시됩니다. 이러한 동영상은 제품을 흥미롭고 유익하게 보여줌으로써 구매 결정에 영향을 미칩니다. 소비자들은 상호작용형 동영상을 통해 영상 내에서 직접 제품을 탐색하고 구매할 수 있으며 동영상 광고에는 장바구니에 추가 또는 지금 구매 옵션 등이 제공됩니다.

귀하의 사이트에 동영상 광고가 효과적인 이유는 무엇일까요?

사이트 내 동영상 광고는 광고주가 귀하의 웹사이트에서 쇼핑객과 더 깊이 소통할 수 있게 하여 보다 매력적인 쇼핑 경험을 창출하며 쇼핑객이 사이트에 머무르며 옵션을 탐색하는 시간을 늘릴 수 있습니다.

이유설명
브랜드 스토리 홍보참여도가 높은 동영상 광고는 광고주의 전체 또는 제품광고 스토리에서 매력적이고 관련성 있는 부분을 보여주어 귀하의 리테일 브랜드와 더 깊이 연결됩니다.
신제품 출시광고주는 동영상을 사용하여 단순한 디스플레이보다 더 깊이 있게 신제품을 소개할 수 있습니다. 동영상 광고는 신제품이 가진 가치를 쇼핑객에게 보다 효과적으로 전달할 수 있는 수단이 됩니다.
브랜드 인지도새로운 카테고리나 새로운 메시지로 인지도를 높이고자 하는 광고주는 귀하의 사이트의 주요 위치에서 동영상 광고를 사용하여 쇼핑객과 직접 소통할 수 있습니다.
소매 브랜드와의 연결 강화동영상은 쇼핑객의 인식 속에서 광고주와 귀하의 소매 브랜드 간의 연결을 더욱 깊이 있게 만들어줄 수 있습니다.

동영상 사양

  • 최대 파일 크기: 300MB
  • 허용되는 파일 형식: Video/mp4, video/quicktime, video/x-msvideo
  • 선택적 코덱 검증: H.264, H.265
  • 높이 및 너비: 소매업체가 픽셀 단위로 정의함
  • 기간 제한: 없음
  • 캠페인 검토: 동영상 요소가 포함된 배너광고 X 캠페인의 경우 필수 사항
  • 태그 지원: 광고 응답에서 다음으로 표준 VAST 태그 제공: adm

동영상 광고 통합

You can create interactive banner X video ads that seamlessly integrate with VAST 4.0 compatible video players, providing retailers with an interactive advertising format that streamlines deployment with minimal effort.

배너광고 X 동영상 광고는 디지털 동영상 광고 송출 템플릿(VAST) 4.0 표준을 준수하여 지원되는 동영상 플레이어와의 원활하고 호환성 높은 통합을 보장합니다.

동영상 광고를 캠페인에 통합할 때 광고 응답에는 adm이라는 필드가 포함됩니다. 이 필드에는 VAST 4.0 준수를 위한 XML 태그가 포함되어 있어 동영상 플레이어에 쉽게 삽입할 수 있습니다.

통합 요구 사항

광고 요청

귀하는 Epsilon의 배너광고 X 엔드포인트로 광고 요청을 보내야 합니다. 동영상 및 기타 배너 콘텐츠는 동영상 및 배너 콘텐츠가 구성된 캠페인에 한해 제공됩니다. adm 객체가 포함된 광고를 수신하려면 먼저 동영상 자산으로 구성된 캠페인이 존재해야 합니다.

You can see more about how to request ads in Generate banner X ads

동영상 플레이어(광고 렌더링)

Epsilon Retail Media는 광고 응답에서 VAST 태그(동영상 광고 서버 템플릿)를 배너광고 X 응답의 adm 객체로 제공합니다. 따라서 VAST 태그를 파싱하고 동영상 광고를 렌더링하려면 동영상 플레이어가 필요할 수 있습니다.

📘

동영상 플레이어가 없으신가요?

다양한 오픈 소스 동영상 플레이어를 사용할 수 있습니다. Video JS 또는 Clappr과 같은 오픈 소스 옵션 및 사용 가능한 유료 옵션을 검토할 것을 권장합니다. VAST 태그를 파싱하려면 추가 플러그인이 필요할 수 있습니다.

배너광고 X 미리보기

Update your banner x previewer to ensure ad previewing is correctly rendered when creating, managing, and reviewing campaigns. See Banner X previewer.

추적 & 보고

VAST 태그를 통해 노출, 클릭, 진행 상황, 상호작용 등 다양한 추적이 가능합니다. 단, 베타 버전에서는 노출 및 클릭 추적만 가능하며 이는 표준 주문 보고에 추가되는 사항입니다.

🚧

향후 서비스 예정

진행 상황 및 상호작용 보고 기능은 향후 릴리스에서 제공될 예정입니다.

추적 요소

Uses the Video Ad Serving Template (VAST) for tracking purposes. The VAST tag includes several tracking mechanisms:

  • 노출 추적
  • 클릭 추적
  • 진행 추적(시작, 퍼스트 쿼타일, 미드포인트, 서드 쿼타일, 완료)
    • 퍼스트 쿼타일(25% 시청): 초기 시청자 참여도를 내타내는 지표
    • 미드포인트(50% 시청): 콘텐츠 중간까지 시청자가 관심을 유지하고 있음을 나타내는 지표
    • 서드 쿼타일(75% 시청): 콘텐츠에 대한 시청자의 높은 몰입도와 지속적인 관심을 보여주는 지표
    • 완료(100% 시청): 시청자가 콘텐츠 전체를 시청했음을 나타내며 최대 수준의 참여도를 보여주는 지표
  • 상호작용 추적(음소거, 음소거 해제, 일시 정지, 다시 시작, 전체 화면)
    • 음소거: 사용자가 동영상의 소리를 끔
    • 음소거 해제: 사용자가 동영상의 소리를 다시 켬
    • 일시 중지: 사용자가 비디오 재생을 멈춤
    • 재개: 사용자가 동영상을 일시 정지 후 다시 재생을 시작함

동영상 광고에 대한 광고 응답 예시

다음은 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": "<?xml version=\"1.0\" encoding=\"UTF-8\"?>
<VAST version=\"4.0\">
    <Ad id=\"1\">
        <InLine>
            <AdSystem>CitrusAd</AdSystem>
            <Impression><![CDATA[https://example.com/v1/resource/first-i/example_ad_id_AbCdEfGhIjKlMnOpQrStUvWxYz0123456789]]></Impression>
            <ViewableImpression>
                <Viewable><![CDATA[https://example.com/v1/resource/first-i/example_ad_id_AbCdEfGhIjKlMnOpQrStUvWxYz0123456789]]></Viewable>
                <NotViewable></NotViewable>
                <ViewUndetermined></ViewUndetermined>
            </ViewableImpression>
            <AdTitle>example_ad_id_AbCdEfGhIjKlMnOpQrStUvWxYz0123456789</AdTitle>
            <Creatives>
                <Creative>
                    <UniversalAdId
                        idRegistry=\"citrusad.com\"
                        idValue=\"00000000-0000-0000-0000-000000000002\">
                        00000000-0000-0000-0000-000000000002
                    </UniversalAdId>
                    <Linear>
                        <Duration></Duration>
                        <MediaFiles>
                            <ClosedCaptionFiles>
                                <ClosedCaptionFile type=\"text/vtt\" language=\"en\">
                                    <![CDATA[https://example.com/media/example-transcript.vtt]]>
                                </ClosedCaptionFile>
                            </ClosedCaptionFiles>
                            <Mezzanine>
                                <![CDATA[https://example.com/media/example-video-1.mp4]]>
                            </Mezzanine>
                            <MediaFile
                                delivery=\"progressive\"
                                type=\"video/mp4\"
                                width=\"160\"
                                height=\"128\"
                                bitrate=\"3552\"
                                codec=\"h264\">
                                <![CDATA[https://example.com/media/example-video-1.mp4]]>
                            </MediaFile>
                        </MediaFiles>
                        <VideoClicks>
                            <ClickTracking>
                                <![CDATA[https://example.com/v1/resource/second-c/example_ad_id_AbCdEfGhIjKlMnOpQrStUvWxYz0123456789]]>
                            </ClickTracking>
                            <ClickThrough></ClickThrough>
                        </VideoClicks>
                    </Linear>
                </Creative>

                <Creative>
                    <UniversalAdId
                        idRegistry=\"citrusad.com\"
                        idValue=\"00000000-0000-0000-0000-000000000003\">
                        00000000-0000-0000-0000-000000000003
                    </UniversalAdId>
                    <Linear>
                        <Duration></Duration>
                        <MediaFiles>
                            <Mezzanine>
                                <![CDATA[https://example.com/media/example-video-2.mp4]]>
                            </Mezzanine>
                            <MediaFile
                                delivery=\"progressive\"
                                type=\"video/mp4\"
                                width=\"1920\"
                                height=\"1080\"
                                bitrate=\"832398\"
                                codec=\"h264\">
                                <![CDATA[https://example.com/media/example-video-2.mp4]]>
                            </MediaFile>
                        </MediaFiles>
                        <VideoClicks>
                            <ClickTracking>
                                <![CDATA[https://example.com/v1/resource/second-c/example_ad_id_AbCdEfGhIjKlMnOpQrStUvWxYz0123456789]]>
                            </ClickTracking>
                            <ClickThrough></ClickThrough>
                        </VideoClicks>
                    </Linear>
                </Creative>
            </Creatives>
        </InLine>
    </Ad>
</VAST>",
          "videoTranscriptFiles": [
            {
              "videoFileId": "00000000-0000-0000-0000-000000000002",
              "format": "txt",
              "url": "https://example.com/media/example-transcript.txt",
              "language": "en"
            }
          ]
        }
      ]
    }
  ]
}

전체 VAST 태그 예시

📘

현재 지원되지 않는 필드가 포함되어 있습니다.

추적 기능은 향후 업데이트에서 제공될 예정입니다.

다음은 온라인 동영상 광고 설정의 예시이며 크리에이티브 정의, 클릭 유도 URL, 추적 이벤트에 대해 자세히 설명합니다.

<VAST version="4.0" xmlns="http://www.iab.com/VAST">

  <Ad id="inArticle_123" sequence="1">

    <InLine>

      <AdSystem version="1.0">InArticleAdServer</AdSystem>

      <AdTitle>In-Article Video Ad</AdTitle>

      <Description>Video ad that plays within article content</Description>

      <Impression><![CDATA[http://example.com/track/impression]]></Impression>

      <Creatives>

        <Creative>

          <Linear>

            <Duration>00:00:15</Duration>

            <MediaFiles>

              <MediaFile delivery="progressive" type="video/mp4" width="640" height="360">

                <![CDATA[https://example.com/video/ad.mp4]]>

              </MediaFile>

            </MediaFiles>

            <VideoClicks>

              <ClickThrough>https://advertiser.com/landing</ClickThrough>

            </VideoClicks>

            <TrackingEvents>

              <Tracking event="start">http://example.com/tracking/start</Tracking>

              <Tracking event="firstQuartile">http://example.com/tracking/firstQuartile</Tracking>

              <Tracking event="midpoint">http://example.com/tracking/midpoint</Tracking>

              <Tracking event="thirdQuartile">http://example.com/tracking/thirdQuartile</Tracking>

              <Tracking event="complete">http://example.com/tracking/complete</Tracking>

              <Tracking event="progress" offset="00:00:10">http://example.com/tracking/progress-10</Tracking>

              <Tracking event="creativeView">http://example.com/tracking/creativeView</Tracking>

              <Tracking event="mute">http://example.com/tracking/mute</Tracking>

              <Tracking event="unmute">http://example.com/tracking/unmute</Tracking>

              <Tracking event="pause">http://example.com/tracking/pause</Tracking>

              <Tracking event="resume">http://example.com/tracking/resume</Tracking>

              <Tracking event="fullscreen">http://example.com/tracking/fullscreen</Tracking>

              <Tracking event="exitFullscreen">http://example.com/tracking/exitFullscreen</Tracking>

          </TrackingEvents>

          </Linear>

        </Creative>

      </Creatives>

    </InLine>

  </Ad>

</VAST>

업데이트됨 9일 전

다음 단계

업데이트됨 9일 전

다음 단계