Video creative requirements

SmartyAds DSP video creative is a video file embedded into an application or website page with video content and played before the main video content (pre-roll).

We support all video resolutions but notice that non-standard resolutions may achieve fewer impressions than standard resolutions (such as 300x250, 480x320, 480x360, 640x360, 720x1280, etc.).

Video Library requirements

Parameter Allowed values
Video player size/resolution Not limited
Landscape aspect ratio Not limited
Vertical aspect ratio Not limited
Max file size 64Mb
Allowed video format .mp4, .webm
Duration No minimum, max 30 seconds
Video max frames 30fps

Third-party tag requirements

SmartyAds DSP allows users to set video creatives using 3rd party tags instead of downloading the video files.

A third-party tag can be configured in two ways: by the XML tag that describes the video and sets its parameters, or by a link that leads to an XML tag or a video file.

See the examples of 3rd party tags below.


XML tag

Create a tag using XML syntax: set its parameters in simple tags, such as
<AdTitle> Product5 Video Advertising </AdTitle>.

Tags such as AdTitle, Description, Duration, and other containing common parameters should be arranged sequentially, one after another. The constructed sequence then should be wrapped in service tags, such as VAST, InLine, Ad.


After all, wrap it by such tag:

<?xml version=“1.0” encoding=“UTF-8"?>

where the XML version and encoding format is specified.


See the example below:

<VAST version="2.0">

    <Ad id="[HASH]">

        <InLine>

            <AdSystem>Smarty

            </AdSystem>

            <AdTitle>Smartyads Video Ad

            </AdTitle>

            <Description>RTB Video Ad

            </Description>

            <Creatives>

                <Creative AdID="123455">

                    <Linear>

                        <Duration>00:00:30

                        </Duration>

                        <VideoClicks>

                            <ClickThrough>

                                <![CDATA[https://adsite.com/link/link2/]]>

                            </ClickThrough>

                        </VideoClicks>

                        <MediaFiles>

                            <MediaFile delivery="streaming" type="video/mp4" width="1920" height="1080">
                                <![CDATA[https://library.adsite.com/video/11345_672c784e075030353f247b171eb7a0c3.mp4]]>

                            </MediaFile>

                        </MediaFiles>

                    </Linear>

                </Creative>

            </Creatives>

        </InLine>

    </Ad>

</VAST>


From this example of the ad tag, you can learn the following information about this advertising:

Its AdSystem is “Smarty”, Ad title is “Smartyads Video Ad”, ad Description is “RTB Video Ad”.

Inside the Creatives tag, we see the Creative tag that presents one example of the creative. Inside of it, we see the following info: the creative AdID is “123456”, the ad is linear, with duration of 30 seconds. Click on the ad redirects the user to a link, specified in the ClickThrough tag (grouped by VideoClicks section tag).


Note: there are CDATA wrappers in the ClickThrough and MediaFile tags. That’s because the VAST specification requires all URIs (or any other free text fields containing potentially dangerous characters) contained in the VAST document to be wrapped in CDATA blocks.


Media file is described within tag, where you can also see such properties as delivery, type, and size specified.


Note: Creatives, MediaFiles, VideoClicks tags are for grouping the same types of tags (so more than one tag can be placed in there).


All of these tags are externally wrapped in tag Ad. This tag defines the id parameter, which, when the tag is going to be sent to the specific user, will receive the value using the [HASH] macro.

Third-party tags may be significantly different. They may contain different sets of parameters (for example. tracking options). Parameters may be specified as plain text (for example, <AdSystem>Smarty</AdSystem>) or as a javascript object or a link to a script.

And finally, all of it wrapped by the VAST tag that specifies the VAST version.

More information you can find in the IAB VAST specification.


Link


https://ads.smartyads.com/a927ac2d/vpaid/vast.xml?&iosAdvId=[IFA]&campaignId=[CAMPAIGN_ID]&externalSiteId=[SITE_ID]&gpsLat=[GEO_LAT]&gpsLng=[GEO_LON]&advertiserid=[ADVERTISER_ID]


This link leads to an XML tag with the video’s creative file and data.

Follow such link (paste it to a web browser) and you will see the XML tag opened:


<VAST version="2.0">

    <Ad id="123ab456cd">

        <InLine>

            <AdSystem>

                <![CDATA[ Smarty ]]>

            </AdSystem>

            <AdTitle>

                <![CDATA[ Smarty HTML5 Ad ]]>

            </AdTitle>

            <Description>

                <![CDATA[ Smarty HTML5 Ad ]]>

            </Description>

            <Error>

                <![CDATA[https://track.smarty.com/pixel.gif?sessionId=s1468324240dec5469dfd41714d35617938&accountId=b3b5792f&stream=adEvents&name=vastError&code=[ERRORCODE]]]>

            </Error>

            <Impression>

                <![CDATA[ about:blank ]]>

            </Impression>

            <Creatives>

                <Creative sequence="1" id="123ab456cd" AdID="123ab456cd">

                    <Linear>

                        <Duration>00:00:10</Duration>

                        <TrackingEvents/>

                        <AdParameters></AdParameters>

                        <MediaFiles>

                            <MediaFile id="123ab456cd" width="1080" height="1920" type="application/javascript"
                                       delivery="progressive" maintainAspectRatio="true" scalable="true"
                                       apiFramework="VPAID">

                                <![CDATA[https://ads.smarty.com/a927ac2d/vpaid.js?sessionId=s1579624240xec5369afd41714x25477938&scriptId=blank-script-id&eventIndex=0&iosAdvId=%5Bidfa%5D&androidAdvId=%5Badid%5D&externalAdServer=SServ12&tagVersion=6&externalCreativeId=%5Bcreative%5D&externalSiteId=%5Bsite%5D&externalCampaignId=%5Boffer%5D&gpsLat=%5Blatitude%5D&gpsLng=%5Blongitude%5D&smarty_transactionid=%5Btransaction_id%5D&smarty_advertiserid=%5Badvertiser%5D]]>

                            </MediaFile>

                        </MediaFiles>

                    </Linear>

                </Creative>

            </Creatives>

        </InLine>

    </Ad>

</VAST>

As in the case of setting the tag directly, you can set many parameters in this tag to provide more information about the video and setting additional functions, for example, tracking.