OperaAds

# Quick Start

# Steps

  1. Create an app/site

  2. Create a video ad placement

  3. Generate VAST Tag

# Request Parameters

Parameter Mandatory Type Desc
uid N string User unique id
plc Y string Placement key for media
floor N int Floor price, unit is 0.001$, for example, floor=1500 means floor is $1.5
channel N string Channel of the media content (e.g., Cartoon)
tag N string Tag of the media content (e.g., Krtek)
badv N string array Block list of advertisers by their domains (e.g., “ford.com”).
bundleid N string App Bundle ID. For example, com.opera.browser
appversion N string App version
appname N string App name
site N string The domain where advertisement will be displayed
url N string The full page URL where advertisement will be displayed
ref N string The referer of the page where advertisement will be displayed
pagetitle N string The page title where advertisement will be displayed
vpw N int The viewport width of the page where advertisement will be displayed
vph N int The viewport height of the page where advertisement will be displayed
dt N enum string Device type. Optional values:
UNKNOWN
PHONE
TABLET
DESKTOP
CONNECTED_DEVICE
STB
os N enum string Optional values:
ANDROID
IOS
WEBOS
osv N string OS version. For example, 5.0
ua N string Client user agent
make N string Device vendor. For example, Samsung
model N string Device model. For example, SM-G965U
dw N int Device screen width. For example, 1080
dh N int Device screen height. For example, 1920
adid N string Advertising ID - Unhashed Apple IDFA or Google AdId
ip Y string User's ip address
mccmnc N string Mobile operator MCC+MNC Code, like : 62120, see https://en.wikipedia.org/wiki/Mobile_country_code
network N enum string Optional values:
UNKNOWN
WIFI
CELLULAR_2G
CELLULAR_3G
CELLULAR_4G
CELLULAR_5G
lon N double Longitude of user's current position
lat N double Latitude of user's current position
ts N int Unix timestamp in seconds of this request
consent N string Flag to signify that the end user has given consent to use and process their data. Omission indicates no consent. true or false or unknown or a GDPR user consent string defined by IAB, see GDPR-Transparency-and-Consent-Framework (opens new window).

# Tag Url Example

The tag below will get test ads returned.

# tag used in webpage

https://s.adx.opera.com/tag/ortb/v2/video?uid=fad3d048-981d-4f13-9b96-4136b17e187a&plc=s5732691266752&channel=Cartoon&tag=Krtek&badv=ford1.com&badv=ford2.com&ts=1621654401&site=opera.com&url=https%3A%2F%2Fwww.opera.com%2Fnews%2Fp1&ref=https%3A%2F%2Fwww.opera.com&dt=PHONE&os=ANDROID&osv=9.1&ua=Opera%20News%2F7.4.2254.148299%2F52.0.2743.10%20%28Android%209%29&dw=1920&dh=1080

# tag used in app

https://s.adx.opera.com/tag/ortb/v2/video?uid=fad3d048-981d-4f13-9b96-4136b17e187a&plc=s5732694217216&ts=1621654401&dt=PHONE&os=ANDROID&osv=9.1&ua=Opera%20News%2F7.4.2254.148299%2F52.0.2743.10%20%28Android%209%29&dw=1920&dh=1080&bundleid=com.opera.browser&appversion=53.1

# Response Example

<VAST version="3.0">
    <Ad id="20009">
        <InLine>
            <AdSystem version="4.0">
                <![CDATA[iabtechlab]]>
            </AdSystem>
            <AdTitle>
                <![CDATA[iabtechlab video ad]]>
            </AdTitle>
            <Impression id="Impression-ID">
                <![CDATA[http://example.com/track/impression]]>
            </Impression>
            <Impression>
                <![CDATA[https://t-odx.op-mobile.opera.com/impr?a=a5732565818112&b=com.opera.browser&cc=HK&cm=1&crid=0.5095064opg&dvt=PHONE&ext=3DmWo3YVRy_l5UoQXm2DbknwrY67jgunoAXd4vjpkGqu7Z3upwIJBcorh6n9P7QOmck65_4UvWWD5w237BZpng%3D%3D&gi=fad3d048-981d-4f13-9b96-4136b17e187a&iabCat=IAB9-31%2CIAB8&impr_dl=1631962624641&m=m5732970023104&ot=ANDROID&pubId=pub5732585605376&rip=103.104.171.114&s=s5732694217216&se=00100538191c0f37e800&u=ed6e7cb11152951d]]>
            </Impression>
            <Creatives>
                <Creative id="crid:a5732565818112:0.5095064opg" sequence="1">
                    <Linear skipoffset="00:00:05">
                        <Duration>00:00:16</Duration>
                        <TrackingEvents>
                            <Tracking event="start">
                                <![CDATA[http://example.com/tracking/start]]>
                            </Tracking>
                            <Tracking event="firstQuartile">
                                <![CDATA[http://example.com/tracking/firstQuartile]]>
                            </Tracking>
                            <Tracking event="midpoint">
                                <![CDATA[http://example.com/tracking/midpoint]]>
                            </Tracking>
                            <Tracking event="thirdQuartile">
                                <![CDATA[http://example.com/tracking/thirdQuartile]]>
                            </Tracking>
                            <Tracking event="complete">
                                <![CDATA[http://example.com/tracking/complete]]>
                            </Tracking>
                            <Tracking event="progress" offset="00:00:10">
                                <![CDATA[http://example.com/tracking/progress-10]]>
                            </Tracking>
                            <Tracking event="creativeView">
                                <![CDATA[https://t-odx.op-mobile.opera.com/video?a=a5732565818112&b=com.opera.browser&cc=HK&cm=1&crid=0.5095064opg&dvt=PHONE&ext=3DmWo3YVRy_l5UoQXm2DbknwrY67jgunoAXd4vjpkGqu7Z3upwIJBcorh6n9P7QOmck65_4UvWWD5w237BZpng%3D%3D&gi=fad3d048-981d-4f13-9b96-4136b17e187a&iabCat=IAB9-31%2CIAB8&impr_dl=1631962624641&m=m5732970023104&ot=ANDROID&pubId=pub5732585605376&rip=103.104.171.114&s=s5732694217216&se=00100538191c0f37e800&u=ed6e7cb11152951d&evt=creativeview]]>
                            </Tracking>
                            <Tracking event="start">
                                <![CDATA[https://t-odx.op-mobile.opera.com/video?a=a5732565818112&b=com.opera.browser&cc=HK&cm=1&crid=0.5095064opg&dvt=PHONE&ext=3DmWo3YVRy_l5UoQXm2DbknwrY67jgunoAXd4vjpkGqu7Z3upwIJBcorh6n9P7QOmck65_4UvWWD5w237BZpng%3D%3D&gi=fad3d048-981d-4f13-9b96-4136b17e187a&iabCat=IAB9-31%2CIAB8&impr_dl=1631962624641&m=m5732970023104&ot=ANDROID&pubId=pub5732585605376&rip=103.104.171.114&s=s5732694217216&se=00100538191c0f37e800&u=ed6e7cb11152951d&evt=start]]>
                            </Tracking>
                            <Tracking event="firstQuartile">
                                <![CDATA[https://t-odx.op-mobile.opera.com/video?a=a5732565818112&b=com.opera.browser&cc=HK&cm=1&crid=0.5095064opg&dvt=PHONE&ext=3DmWo3YVRy_l5UoQXm2DbknwrY67jgunoAXd4vjpkGqu7Z3upwIJBcorh6n9P7QOmck65_4UvWWD5w237BZpng%3D%3D&gi=fad3d048-981d-4f13-9b96-4136b17e187a&iabCat=IAB9-31%2CIAB8&impr_dl=1631962624641&m=m5732970023104&ot=ANDROID&pubId=pub5732585605376&rip=103.104.171.114&s=s5732694217216&se=00100538191c0f37e800&u=ed6e7cb11152951d&evt=firstquartile]]>
                            </Tracking>
                            <Tracking event="midpoint">
                                <![CDATA[https://t-odx.op-mobile.opera.com/video?a=a5732565818112&b=com.opera.browser&cc=HK&cm=1&crid=0.5095064opg&dvt=PHONE&ext=3DmWo3YVRy_l5UoQXm2DbknwrY67jgunoAXd4vjpkGqu7Z3upwIJBcorh6n9P7QOmck65_4UvWWD5w237BZpng%3D%3D&gi=fad3d048-981d-4f13-9b96-4136b17e187a&iabCat=IAB9-31%2CIAB8&impr_dl=1631962624641&m=m5732970023104&ot=ANDROID&pubId=pub5732585605376&rip=103.104.171.114&s=s5732694217216&se=00100538191c0f37e800&u=ed6e7cb11152951d&evt=midpoint]]>
                            </Tracking>
                            <Tracking event="thirdQuartile">
                                <![CDATA[https://t-odx.op-mobile.opera.com/video?a=a5732565818112&b=com.opera.browser&cc=HK&cm=1&crid=0.5095064opg&dvt=PHONE&ext=3DmWo3YVRy_l5UoQXm2DbknwrY67jgunoAXd4vjpkGqu7Z3upwIJBcorh6n9P7QOmck65_4UvWWD5w237BZpng%3D%3D&gi=fad3d048-981d-4f13-9b96-4136b17e187a&iabCat=IAB9-31%2CIAB8&impr_dl=1631962624641&m=m5732970023104&ot=ANDROID&pubId=pub5732585605376&rip=103.104.171.114&s=s5732694217216&se=00100538191c0f37e800&u=ed6e7cb11152951d&evt=thirdquartile]]>
                            </Tracking>
                            <Tracking event="complete">
                                <![CDATA[https://t-odx.op-mobile.opera.com/video?a=a5732565818112&b=com.opera.browser&cc=HK&cm=1&crid=0.5095064opg&dvt=PHONE&ext=3DmWo3YVRy_l5UoQXm2DbknwrY67jgunoAXd4vjpkGqu7Z3upwIJBcorh6n9P7QOmck65_4UvWWD5w237BZpng%3D%3D&gi=fad3d048-981d-4f13-9b96-4136b17e187a&iabCat=IAB9-31%2CIAB8&impr_dl=1631962624641&m=m5732970023104&ot=ANDROID&pubId=pub5732585605376&rip=103.104.171.114&s=s5732694217216&se=00100538191c0f37e800&u=ed6e7cb11152951d&evt=complete]]>
                            </Tracking>
                            <Tracking event="mute">
                                <![CDATA[https://t-odx.op-mobile.opera.com/video?a=a5732565818112&b=com.opera.browser&cc=HK&cm=1&crid=0.5095064opg&dvt=PHONE&ext=3DmWo3YVRy_l5UoQXm2DbknwrY67jgunoAXd4vjpkGqu7Z3upwIJBcorh6n9P7QOmck65_4UvWWD5w237BZpng%3D%3D&gi=fad3d048-981d-4f13-9b96-4136b17e187a&iabCat=IAB9-31%2CIAB8&impr_dl=1631962624641&m=m5732970023104&ot=ANDROID&pubId=pub5732585605376&rip=103.104.171.114&s=s5732694217216&se=00100538191c0f37e800&u=ed6e7cb11152951d&evt=mute]]>
                            </Tracking>
                            <Tracking event="unmute">
                                <![CDATA[https://t-odx.op-mobile.opera.com/video?a=a5732565818112&b=com.opera.browser&cc=HK&cm=1&crid=0.5095064opg&dvt=PHONE&ext=3DmWo3YVRy_l5UoQXm2DbknwrY67jgunoAXd4vjpkGqu7Z3upwIJBcorh6n9P7QOmck65_4UvWWD5w237BZpng%3D%3D&gi=fad3d048-981d-4f13-9b96-4136b17e187a&iabCat=IAB9-31%2CIAB8&impr_dl=1631962624641&m=m5732970023104&ot=ANDROID&pubId=pub5732585605376&rip=103.104.171.114&s=s5732694217216&se=00100538191c0f37e800&u=ed6e7cb11152951d&evt=unmute]]>
                            </Tracking>
                            <Tracking event="pause">
                                <![CDATA[https://t-odx.op-mobile.opera.com/video?a=a5732565818112&b=com.opera.browser&cc=HK&cm=1&crid=0.5095064opg&dvt=PHONE&ext=3DmWo3YVRy_l5UoQXm2DbknwrY67jgunoAXd4vjpkGqu7Z3upwIJBcorh6n9P7QOmck65_4UvWWD5w237BZpng%3D%3D&gi=fad3d048-981d-4f13-9b96-4136b17e187a&iabCat=IAB9-31%2CIAB8&impr_dl=1631962624641&m=m5732970023104&ot=ANDROID&pubId=pub5732585605376&rip=103.104.171.114&s=s5732694217216&se=00100538191c0f37e800&u=ed6e7cb11152951d&evt=pause]]>
                            </Tracking>
                            <Tracking event="resume">
                                <![CDATA[https://t-odx.op-mobile.opera.com/video?a=a5732565818112&b=com.opera.browser&cc=HK&cm=1&crid=0.5095064opg&dvt=PHONE&ext=3DmWo3YVRy_l5UoQXm2DbknwrY67jgunoAXd4vjpkGqu7Z3upwIJBcorh6n9P7QOmck65_4UvWWD5w237BZpng%3D%3D&gi=fad3d048-981d-4f13-9b96-4136b17e187a&iabCat=IAB9-31%2CIAB8&impr_dl=1631962624641&m=m5732970023104&ot=ANDROID&pubId=pub5732585605376&rip=103.104.171.114&s=s5732694217216&se=00100538191c0f37e800&u=ed6e7cb11152951d&evt=resume]]>
                            </Tracking>
                            <Tracking event="rewind">
                                <![CDATA[https://t-odx.op-mobile.opera.com/video?a=a5732565818112&b=com.opera.browser&cc=HK&cm=1&crid=0.5095064opg&dvt=PHONE&ext=3DmWo3YVRy_l5UoQXm2DbknwrY67jgunoAXd4vjpkGqu7Z3upwIJBcorh6n9P7QOmck65_4UvWWD5w237BZpng%3D%3D&gi=fad3d048-981d-4f13-9b96-4136b17e187a&iabCat=IAB9-31%2CIAB8&impr_dl=1631962624641&m=m5732970023104&ot=ANDROID&pubId=pub5732585605376&rip=103.104.171.114&s=s5732694217216&se=00100538191c0f37e800&u=ed6e7cb11152951d&evt=rewind]]>
                            </Tracking>
                            <Tracking event="fullscreen">
                                <![CDATA[https://t-odx.op-mobile.opera.com/video?a=a5732565818112&b=com.opera.browser&cc=HK&cm=1&crid=0.5095064opg&dvt=PHONE&ext=3DmWo3YVRy_l5UoQXm2DbknwrY67jgunoAXd4vjpkGqu7Z3upwIJBcorh6n9P7QOmck65_4UvWWD5w237BZpng%3D%3D&gi=fad3d048-981d-4f13-9b96-4136b17e187a&iabCat=IAB9-31%2CIAB8&impr_dl=1631962624641&m=m5732970023104&ot=ANDROID&pubId=pub5732585605376&rip=103.104.171.114&s=s5732694217216&se=00100538191c0f37e800&u=ed6e7cb11152951d&evt=fullscreen&isfullscreen=1]]>
                            </Tracking>
                            <Tracking event="exitFullscreen">
                                <![CDATA[https://t-odx.op-mobile.opera.com/video?a=a5732565818112&b=com.opera.browser&cc=HK&cm=1&crid=0.5095064opg&dvt=PHONE&ext=3DmWo3YVRy_l5UoQXm2DbknwrY67jgunoAXd4vjpkGqu7Z3upwIJBcorh6n9P7QOmck65_4UvWWD5w237BZpng%3D%3D&gi=fad3d048-981d-4f13-9b96-4136b17e187a&iabCat=IAB9-31%2CIAB8&impr_dl=1631962624641&m=m5732970023104&ot=ANDROID&pubId=pub5732585605376&rip=103.104.171.114&s=s5732694217216&se=00100538191c0f37e800&u=ed6e7cb11152951d&evt=fullscreen&isfullscreen=0]]>
                            </Tracking>
                            <Tracking event="acceptInvitationLinear">
                                <![CDATA[https://t-odx.op-mobile.opera.com/video?a=a5732565818112&b=com.opera.browser&cc=HK&cm=1&crid=0.5095064opg&dvt=PHONE&ext=3DmWo3YVRy_l5UoQXm2DbknwrY67jgunoAXd4vjpkGqu7Z3upwIJBcorh6n9P7QOmck65_4UvWWD5w237BZpng%3D%3D&gi=fad3d048-981d-4f13-9b96-4136b17e187a&iabCat=IAB9-31%2CIAB8&impr_dl=1631962624641&m=m5732970023104&ot=ANDROID&pubId=pub5732585605376&rip=103.104.171.114&s=s5732694217216&se=00100538191c0f37e800&u=ed6e7cb11152951d&evt=acceptinvitationlinear]]>
                            </Tracking>
                            <Tracking event="closeLinear">
                                <![CDATA[https://t-odx.op-mobile.opera.com/video?a=a5732565818112&b=com.opera.browser&cc=HK&cm=1&crid=0.5095064opg&dvt=PHONE&ext=3DmWo3YVRy_l5UoQXm2DbknwrY67jgunoAXd4vjpkGqu7Z3upwIJBcorh6n9P7QOmck65_4UvWWD5w237BZpng%3D%3D&gi=fad3d048-981d-4f13-9b96-4136b17e187a&iabCat=IAB9-31%2CIAB8&impr_dl=1631962624641&m=m5732970023104&ot=ANDROID&pubId=pub5732585605376&rip=103.104.171.114&s=s5732694217216&se=00100538191c0f37e800&u=ed6e7cb11152951d&evt=closelinear]]>
                            </Tracking>
                            <Tracking event="skip">
                                <![CDATA[https://t-odx.op-mobile.opera.com/video?a=a5732565818112&b=com.opera.browser&cc=HK&cm=1&crid=0.5095064opg&dvt=PHONE&ext=3DmWo3YVRy_l5UoQXm2DbknwrY67jgunoAXd4vjpkGqu7Z3upwIJBcorh6n9P7QOmck65_4UvWWD5w237BZpng%3D%3D&gi=fad3d048-981d-4f13-9b96-4136b17e187a&iabCat=IAB9-31%2CIAB8&impr_dl=1631962624641&m=m5732970023104&ot=ANDROID&pubId=pub5732585605376&rip=103.104.171.114&s=s5732694217216&se=00100538191c0f37e800&u=ed6e7cb11152951d&evt=skip]]>
                            </Tracking>
                            <Tracking event="progress" offset="00:00:02">
                                <![CDATA[https://t-odx.op-mobile.opera.com/video?a=a5732565818112&b=com.opera.browser&cc=HK&cm=1&crid=0.5095064opg&dvt=PHONE&ext=3DmWo3YVRy_l5UoQXm2DbknwrY67jgunoAXd4vjpkGqu7Z3upwIJBcorh6n9P7QOmck65_4UvWWD5w237BZpng%3D%3D&gi=fad3d048-981d-4f13-9b96-4136b17e187a&iabCat=IAB9-31%2CIAB8&impr_dl=1631962624641&m=m5732970023104&ot=ANDROID&pubId=pub5732585605376&rip=103.104.171.114&s=s5732694217216&se=00100538191c0f37e800&u=ed6e7cb11152951d&evt=progress&offset=2s]]>
                            </Tracking>
                            <Tracking event="progress" offset="00:00:15">
                                <![CDATA[https://t-odx.op-mobile.opera.com/video?a=a5732565818112&b=com.opera.browser&cc=HK&cm=1&crid=0.5095064opg&dvt=PHONE&ext=3DmWo3YVRy_l5UoQXm2DbknwrY67jgunoAXd4vjpkGqu7Z3upwIJBcorh6n9P7QOmck65_4UvWWD5w237BZpng%3D%3D&gi=fad3d048-981d-4f13-9b96-4136b17e187a&iabCat=IAB9-31%2CIAB8&impr_dl=1631962624641&m=m5732970023104&ot=ANDROID&pubId=pub5732585605376&rip=103.104.171.114&s=s5732694217216&se=00100538191c0f37e800&u=ed6e7cb11152951d&evt=progress&offset=15s]]>
                            </Tracking>
                            <Tracking event="progress" offset="97%">
                                <![CDATA[https://t-odx.op-mobile.opera.com/video?a=a5732565818112&b=com.opera.browser&cc=HK&cm=1&crid=0.5095064opg&dvt=PHONE&ext=3DmWo3YVRy_l5UoQXm2DbknwrY67jgunoAXd4vjpkGqu7Z3upwIJBcorh6n9P7QOmck65_4UvWWD5w237BZpng%3D%3D&gi=fad3d048-981d-4f13-9b96-4136b17e187a&iabCat=IAB9-31%2CIAB8&impr_dl=1631962624641&m=m5732970023104&ot=ANDROID&pubId=pub5732585605376&rip=103.104.171.114&s=s5732694217216&se=00100538191c0f37e800&u=ed6e7cb11152951d&evt=progress&offset=97p]]>
                            </Tracking>
                        </TrackingEvents>
                        <VideoClicks>
                            <ClickThrough id="blog">
                                <![CDATA[https://iabtechlab.com]]>
                            </ClickThrough>
                            <ClickTracking>
                                <![CDATA[http://example.com/trackingurl/clickTracking]]>
                            </ClickTracking>
                            <ClickTracking>
                                <![CDATA[https://t-odx.op-mobile.opera.com/click?a=a5732565818112&b=com.opera.browser&cc=HK&cm=1&crid=0.5095064opg&dvt=PHONE&ext=3DmWo3YVRy_l5UoQXm2DbknwrY67jgunoAXd4vjpkGqu7Z3upwIJBcorh6n9P7QOmck65_4UvWWD5w237BZpng%3D%3D&gi=fad3d048-981d-4f13-9b96-4136b17e187a&iabCat=IAB9-31%2CIAB8&impr_dl=1631962624641&m=m5732970023104&ot=ANDROID&pubId=pub5732585605376&rip=103.104.171.114&s=s5732694217216&se=00100538191c0f37e800&u=ed6e7cb11152951d]]>
                            </ClickTracking>
                            <CustomClick>
                                <![CDATA[https://t-odx.op-mobile.opera.com/click?a=a5732565818112&b=com.opera.browser&cc=HK&cm=1&crid=0.5095064opg&dvt=PHONE&ext=3DmWo3YVRy_l5UoQXm2DbknwrY67jgunoAXd4vjpkGqu7Z3upwIJBcorh6n9P7QOmck65_4UvWWD5w237BZpng%3D%3D&gi=fad3d048-981d-4f13-9b96-4136b17e187a&iabCat=IAB9-31%2CIAB8&impr_dl=1631962624641&m=m5732970023104&ot=ANDROID&pubId=pub5732585605376&rip=103.104.171.114&s=s5732694217216&se=00100538191c0f37e800&u=ed6e7cb11152951d]]>
                            </CustomClick>
                        </VideoClicks>
                        <MediaFiles>
                            <MediaFile id="5241" delivery="progressive" type="video/mp4" codec="0" bitrate="500" minBitrate="360" maxBitrate="1080" width="400" height="300" scalable="true" maintainAspectRatio="true">
                                <![CDATA[https://iab-publicfiles.s3.amazonaws.com/vast/VAST-4.0-Short-Intro.mp4]]>
                            </MediaFile>
                        </MediaFiles>
                    </Linear>
                </Creative>
            </Creatives>
            <Description></Description>
            <Survey></Survey>
            <Error>
                <![CDATA[http://example.com/error]]>
            </Error>
            <Error>
                <![CDATA[https://t-odx.op-mobile.opera.com/video?a=a5732565818112&b=com.opera.browser&cc=HK&cm=1&crid=0.5095064opg&dvt=PHONE&ext=3DmWo3YVRy_l5UoQXm2DbknwrY67jgunoAXd4vjpkGqu7Z3upwIJBcorh6n9P7QOmck65_4UvWWD5w237BZpng%3D%3D&gi=fad3d048-981d-4f13-9b96-4136b17e187a&iabCat=IAB9-31%2CIAB8&impr_dl=1631962624641&m=m5732970023104&ot=ANDROID&pubId=pub5732585605376&rip=103.104.171.114&s=s5732694217216&se=00100538191c0f37e800&u=ed6e7cb11152951d&evt=error]]>
            </Error>
            <Pricing model="cpm" currency="USD">
                <![CDATA[ 25.00 ]]>
            </Pricing>
            <Extensions>
                <Extension type="iab-Count">
                    <total_available>
                        <![CDATA[ 2 ]]>
                    </total_available>
                </Extension>
                <Extension type="Tracking">
                    <CustomTracking>
                        <Tracking event="skip" offset="00:00:05">
                            <![CDATA[https://t-odx.op-mobile.opera.com/video]]>
                        </Tracking>
                    </CustomTracking>
                </Extension>
            </Extensions>
        </InLine>
    </Ad>
</VAST>

←