Beta feature
This feature is currently in beta and may change. We encourage your feedback to help refine it.
Advertisers and retailers can upload promotional videos to their banners, which are displayed directly on their website or app. These videos influence purchasing decisions by showcasing products in an engaging manner. Interactive videos enable consumers to explore and purchase products directly from the video, featuring add to cart or buy now options.
Why video ads for your site?
Onsite video allows your advertisers to engage more deeply with your shoppers on your website, creating more inviting shopper experiences and increasing the time shoppers spend on your site, exploring their options.
| Reasons | Description |
|---|---|
| Promote a brand story | High-engagement video ads showcase an engaging and relevant part of an advertiser’s overall or product-specific story, connecting them more deeply to your retail brand. |
| New product launches | Advertisers can use video to introduce new products more deeply than they could with simple display. Video allows them to connect with shoppers on the value new products may bring. |
| Brand awareness | Advertisers looking to promote awareness in a new category or with new messaging can use video in key locations on your site to communicate directly with your shoppers. |
| Deepen connection to your retail brand | Video can deepen the connection between an advertiser and your retail brand in the minds of shoppers. |
Video specifications
- Maximum file size: 300MB
- Accepted file types: Video/mp4, video/quicktime, video/x-msvideo
- Optional codec validation: H.264, H.265
- Heights and widths: Defined by the retailer in pixels
- Duration limit: None
- Campaign review: Mandatory for banner X campaigns that contain a video element
- Tag support: Standard VAST tag served as
admin the ad response
Integrate video ads
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.
Banner X video ads adhere to the Digital Video Ad Serving Template (VAST) 4.0 standard, ensuring smooth and compatible integration with supported video players.
When incorporating video ads into campaigns, the ad response includes a field named adm. This field contains the XML tags required for VAST 4.0 compliance, allowing easy embedding in video players.
Integration Requirements
Ad request
You will need to send an ad request to our Banner X endpoint. Video and other banner content will only be served for campaigns that have videos and banner content configured. You will need to ensure there are campaigns that are configured with video assets before you will receive ads with the adm object provided.
You can see more about how to request ads in Generate banner X ads
Video player (ad rendering)
Epsilon Retail Media serves a VAST tag (Video Ad Server Template) in our ad response as the adm object of the banner X response. As such, you will likely need a video player to parse the VAST tag and render the video ad.
Don't have a video player?
A variety of open-source video players can be used. We recommend to review available paid as well as open source options such as Video JS or Clappr. Note that additional plugins may be required to parse VAST tags.
Banner X previewer
Update your banner x previewer to ensure ad previewing is correctly rendered when creating, managing, and reviewing campaigns. See Banner X previewer.
Tracking & reporting
A variety of tracking (impressions, clicks, progress, and interaction) are all possible via VAST tags, only impression and click tracking is possible in beta. This is in addition to standard order reporting.
Future Capabilities
Progress and interaction reporting is planned for a future release.
Tracking elements
Uses the Video Ad Serving Template (VAST) for tracking purposes. The VAST tag includes several tracking mechanisms:
- Impression tracking
- Click tracking
- Progress tracking (start, firstQuartile, midpoint, thirdQuartile, complete)
- First quartile (25% Watched): Early indicator of initial engagement
- Midpoint (50% Watched): Indicates sustained viewer interest halfway through the content
- Third quartile (75% Watched): Shows strong viewer commitment to the content
- Complete (100% Watched): Confirms viewer watched the entire video, indicating maximum engagement
- Interaction tracking (mute, unmute, pause, resume, fullscreen)
- Mute: The user has muted the video audio
- Unmute: The user has unmuted the video audio
- Pause: The user has paused video playback
- Resume: The user has resumed video playback after pausing
Example ad response for video ads
Here is a snippet of how the video ad response would look like including VAST-related information:
{
"ads": [
{
"contentStandardId": "c47c9ca2-ad3b-48cc-880b-e899c1661726",
"slotId": "Top_Banner",
"banners": [
{
"citrusAdId": "shotgun_8SvgA7OvvuwtZkkOKR0vr8AXMvQKFgoURmluZ2VybGltZTI2LWZkeHZxMjcSABoMCO30r70GEKPplJQCIgIIAQ==",
"citrusCampaignName": "Ads:74-330-96832622ed499dafb3da8de8b76340a2",
"citrusContentStandardId": "c47c9ca2-ad3b-48cc-880b-e899c1661726",
"citrusSlotId": "Top_Banner",
"citrusExpiry": "2025-02-12T01:33:33.579155107Z",
"headingText": "recusandae 3205",
"bannerText": "placeat 2825",
"bannerTextColour": "ffffff",
"ctaFlag": true,
"ctaText": "CTA text",
"ctaTextAccessibility": "call to action accessibility text",
"ctaLink": http://citrusad.com ,
"backgroundColour": "000000",
"backgroundImage": https://dev3.flavedo.io./citrus/8de07ed9-60b4-4611-8bd5-3f1f0c0b6be4,
"secondaryBackgroundImage": https://dev3.flavedo.io./citrus/b7a70785-1366-42c6-8134-c7fe47a30c34,
"secondaryBackgroundImagePosition": "rightaligned",
"heroImage": https://dev3.flavedo.io./citrus/26798ca9-1022-422d-9100-1a3687c88372,
"heroImageAltText": "hero image alt text",
"secondaryHeroImage": https://dev3.flavedo.io./citrus/c4ee18b4-bf51-44d7-9eb6-eeb1dc4c422f,
"secondaryHeroImageAltText": "secondary hero image alt text",
"secondaryHeroMode": "landscape",
"tags": {},
"additionalFields": [
{
"id": "text-1",
"value": "sed 5731"
}
],
"gtins": [
"Fingerlime26-fdxvq27",
"Oranges5-qgxeb6",
"Cherries9-adkoj11",
"Incaberries20-ppscn21",
"Banana14-simfk15"
],
"sellerId": "seller_id_772_659",
"position": 1,
"metadata": {
"advertiserInfo": {
"advertiser": "Bob's advertising agency",
"onBehalfOf": "Brand company inc"
}
},
"adm": "<?xml version=\"1.0\" encoding=\"UTF-8\"?>\n<VAST version=\"4.0\">\n <Ad id=\"1\">\n <InLine>\n <AdSystem>CitrusAd</AdSystem>\n <Impression><![CDATA[https://integration.BASE-URL.citrusad.com/v1/resource/first-i/shotgun_2DbJUbTdlM3HFvLuF75YoA2FgpwKBQoDMTIzEgAaCwjHsuG_BhD7sqZzIgIIAQ==]]></Impression>\n <ViewableImpression>\n <Viewable><![CDATA[https://integration.BASE-URL.citrusad.com/v1/resource/first-i/shotgun_2DbJUbTdlM3HFvLuF75YoA2FgpwKBQoDMTIzEgAaCwjHsuG_BhD7sqZzIgIIAQ==]]></Viewable>\n <NotViewable></NotViewable>\n <ViewUndetermined></ViewUndetermined>\n </ViewableImpression>\n <AdTitle>VAST-4.0-Short-Intro.mp4</AdTitle>\n <Creatives>\n <Creative>\n <UniversalAdId idRegistry=\"http://citrusad.com \" idValue=\"VAST-4.0-Short-Intro.mp4\">VAST-4.0-Short-Intro.mp4</UniversalAdId>\n <Linear>\n <Duration></Duration>\n <MediaFiles>\n <MediaFile delivery=\"progressive\" type=\"video/mp4\" width=\"0\" height=\"0\" bitrate=\"0\" codec=\"\"><![CDATA[https://cdn.flavedo.io./citrus/VAST-4.0-Short-Intro.mp4]]></MediaFile>\n <Mezzanine><![CDATA[https://cdn.flavedo.io./citrus/VAST-4.0-Short-Intro.mp4]]></Mezzanine>\n </MediaFiles>\n <VideoClicks>\n <ClickTracking><![CDATA[https://integration.BASE-URL.citrusad.com/v1/resource/second-c/shotgun_2DbJUbTdlM3HFvLuF75YoA2FgpwKBQoDMTIzEgAaCwjHsuG_BhD7sqZzIgIIAQ==]]></ClickTracking>\n <ClickThrough><![CDATA[a/a-national/everything/browse]]></ClickThrough>\n </VideoClicks>\n </Linear>\n </Creative>\n </Creatives>\n </InLine>\n </Ad>\n</VAST>"
}
]
}
]
}
Example full VAST tag
This contains fields we don't currently serve.
Tracking is planned for a future update.
The following example illustrates an online video ad setup, detailing the definition of creatives, URLs for click-through, and tracking events.
<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>