o p e n me a su re m e n t s dk

Open Measurement SDK

Integration Validation Test Cases

Updated June 2021

copyright © 2021 IAB Technology Laboratory

OM SDK Test Cases

Executive Summary

The Open Measurement Software Development Kit (OM SDK) is designed to facilitate third

party viewability and verification measurement without requiring multiple Ad Verification Service

Provider (Measurement Provider) SDKs. We have SDKs for ads served to mobile apps and web

video applications that load and render all viewable content exclusively through HTML5.

The OM SDK consists of native libraries for iOS, Android, JavaScript (for web) as well as a

JavaScript API, named Open Measurement Interface Definition (OMID), that Integration Partners

develop into their mobile apps, ad SDKs, website or video player. The native library collects various

signals, such as ad container geometry and playback events in the case of video, using direct

communication with the mobile device’s native operating system (OS) and media players, and

publishes these signals via the OMID JavaScript API.

The collection, processing, analysis, and reporting of information surfaced by the OM SDK is

the responsibility of the Measurement Provider using their respective JavaScript tag that is

served with the ad creative.

Completing the SDK integration alone does not guarantee that it will be compatible with

Measurement Provider tags or be accepted as valid for the purposes of measurement;

implementation errors or other issues may interfere with compatibility. To ensure that the

Measurement Provider is collecting data from a reliable implementation of the integration partner's

OM SDK implementation, IAB Tech Lab has developed a certification program for validating the

integration. The certification program outlined in the Integration Validation Compliance document,

found here:

https://omsdk-files.s3-us-west-2.amazonaws.com/docs/Integration+Validation+Compliance+Gui

de.pdf is voluntary and serves to ensure that your integration is compatible with Measurement

Provider measurement tags.

This guide describes the test cases for each version of OM SDK Integration Validation Compliance

(OM IVC).

https://www.iabtechlab.com/omsdk Page 1 of 39

https://omsdk-files.s3-us-west-2.amazonaws.com/docs/Integration+Validation+Compliance+Guide.pdf

https://omsdk-files.s3-us-west-2.amazonaws.com/docs/Integration+Validation+Compliance+Guide.pdf

https://www.iab.com/omsdk

OM SDK Test Cases

OM SDK is developed and managed by the Open Measurement Working Group

AudienceThe test cases are for Ad SDK developers, App publishers, web publishers and video players

(Integration Partners) who have integrated the OM SDK in their products.

About IAB Tech Lab

The IAB Technology Laboratory is an independent, international, research and development

consortium charged with producing and helping companies implement global industry

technical standards. Comprised of marketers, advertising agencies, digital publishers and ad

technology firms, as well as other companies with interests in the interactive marketing arena,

the IAB Tech Lab’s goal is to reduce friction associated with the digital advertising and

marketing supply chain, while contributing to the safe and secure growth of the industry. Learn

more about IAB Tech Lab here.

More information available at: https://www.iabtechlab.com

Open Measurement Working Group

Commit Group Members

DoubleVerify Nielsen

Google Oracle’s Moat

Integral Ad Science Pandora


https://iabtechlab.com/working-groups/open-measurement-working-group/

https://www.iabtechlab.com/



OM SDK Test Cases

IAB Tech Lab

Working Group Members

AdColony IAB Tech Lab Protected Media

Adform InMobi Pubfinity

ADLOOX Innovid Publicis Media

Admixer EU Gmbh Integral Ad Science PubMatic

Adverty ironSource RTBAsia

Amazon Advertising Jun Group Sizmek by Amazon

AppNexus JW Player Smaato

BARC India KERV Interactive Smart AdServer

Bidstack Kochava Spark Foundry

Browsi Lucidity SpotX

Comscore Macromill, Inc. Taboola

Cyber Communications Inc. Magnite Tapjoy

Dailymotion Meetrics Teads

Display.io Microsoft Advertising TikTok

DoubleVerify Mintegral Timehop

Extreme Reach MoPub (a division of Twitter,

Inc.)TripleLift

Fiducia DLT Ltd NBCUniversal Twitter

Flipboard Nielsen UNICORN Inc.



OM SDK Test Cases

Forensiq Noqoush Unity

FreeWheel Ogury Verizon Media

Fyber OpenX Vlion

Google Oracle Data Cloud White Ops

Gridsum Pandora Xandr

GroupM Pixalate YOSPACE

* Working Group membership as of November 5, 2020

Learn more about Open Measurement Working Group here

(https://iabtechlab.com/working-groups/open-measurement-working-group/ )





OM SDK Test Cases

Change Log

Revision Description Author Date

Version 1.0 Document created to keepall version test casestogether instead of witheach integration guide

Jill Wittkopp([email protected])

11/05/2020

Version 2.0 Document updated withnew web video test casesto support access modes

Jill Wittkopp([email protected])

06/24/2021

Table of ContentsExecutive Summary 1

Audience 2

About IAB Tech Lab 2

Open Measurement Working Group 2Commit Group Members 2Working Group Members 3

Change Log 5

Table of Contents 5

Test Cases 6

1.3 Integration Test Cases 6

1.2 Test Cases 19

Web Video Test Cases 28



OM SDK Test Cases

Test Cases

These test cases have been developed based on the Open Measurement Interface

Definition (OMID) Application Programming Interface (API) to validate that the

integration of OM SDK has been performed properly and all the required elements are

functioning as expected. Please read the onboarding guide

(https://omsdk-files.s3-us-west-2.amazonaws.com/docs/WebVideo/Onboarding+Guid

e+for+Integrators.pdf ) for downloading the SDK and other integration instructions

1.3 Integration Test Cases

S.No. AdType

Test Case Scenario Event/ Signal Expected Result/ value/comment

1 All Set-up testing Confirm that the app canbe installed and from whatsourceShould testing be targetedto specific devices? Devicetypes?

App installation App installed without error,and can be opened

2 All Set-up testing Did the int partner provideany specific credentials fortesting?

Log-in screen Log-in successful

3 All Set-up testing Does the app re-use thesame code for multipleplacements, so that theycan be checked as a grouprather than individually?

Confirmation fromIntegrator

Confirmation from Integrator


https://omsdk-files.s3-us-west-2.amazonaws.com/docs/WebVideo/Onboarding+Guide+for+Integrators.pdf

https://omsdk-files.s3-us-west-2.amazonaws.com/docs/WebVideo/Onboarding+Guide+for+Integrators.pdf


OM SDK Test Cases

4 All Set-up testing Is the generic verificationscript trafficked with thead?

Check ad /impression events

Signals from genericverification script

5 All Set-up testing Only ads to be tested arebeing served with tracking



6 All Check OMIDcompatibilityand whetheractive

Load the app page with thead

OmidSupported[true] OmidSupported[true]

7 All Ad session iscorrectlyinstantiated

Load the page with the ador reload the page with thead

ad session id return new ad session-unique ad session id,timestampunique ad session value like:2196C74D-6A27-4807-A3D3-B08E4F6E0ABAand timestamp aue like1531749570462


Ad session context isestablished properly

environment app e.f"environment":"app",timestamp":"1531749570462"

9

All

Ad session iscorrectlyinstantiated adSessionType native or html


supports clid for all ad types except vlidfor video


omidNativeInfo partnerName (this is same asnamespace assigned at thetime of OM SDK download)and partnerVersion

{"partnerName":"someSDK","partnerVersion":"x.y"},timestamp":"1531749570462"


omidJsInfo serviceVersion,sessionClientVersion,partnerName,partnerVersion

E.g."omidJsInfo":{"serviceVersion":"1.1.2-iab443","omidimplementer":"omsdk"},timestamp":"1531749570462"



OM SDK Test Cases


app libraryVersion and appId(com.example.appname)

"app":{"appId":"com.example.ent","libraryVersion":"1.1.2-partnername"},timestamp":"1531749570462"


Device Info mobile device detailse.g."deviceInfo":{"deviceType":"iPhone7,2","os":"iOS","osVersion":"11.4.1"},timestamp":"1531749570462"


Impression Type for whatOMID impression eventyou are declaring.Required“definedByJavaScript” ifJavaScript layer is settingthe creativetype . SeeMigration Guide for moredetails.

impressionType “loaded”, “beginToRender”,“onePixel”, “viewable”,“audible”, “other”,“unspecified”,“definedByJavaScript”e.g. "impressionType":"viewable",


Value will be true for allvideo sessions and fordisplay sessions whereintegration uses new API.Value will be false fordisplay sessions whereintegration uses old API.

For 1.3 certification,integrations are required touse 1.3 API."supportsLoadedEvent"should be true for all 1.3certifiable integrations.

supportsLoadedEvent "supportsLoadedEvent": true"supportsLoadedEvent":false,


URL of top-level web page,as determined by OM SDKJS service. Null when JSservice is cross-domain orrunning in a mobile app.

pageUrl "pageUrl": www.domain.com


URL of top-level web page,as provided by OMintegration. Null whenintegration does not passcontentUrl parameter onContext constructor.

contentUrl "contentUrl":www.domain.com


https://omsdk-files.s3-us-west-2.amazonaws.com/docs/Migrating+to+OM+SDK+1.3.pdf




OM SDK Test Cases


verificationParameters

verification parameterprovided by the measurementproviderundefined for display ads e.g.verificationParameters":"undefined"Also displays access mode.Always limited when usingOM SDK"accessmode":"limited"For native and video adsverificationParameters":"iabtechlab or some text","accessmode":limited


customReferenceData (not required)

any string value

21 All Ad session haserrorinstantiating

errorType Generic or Video when videoads

22 All Ad session haserrorinstantiating

message string value describing theerror

23 All Ad session slowto instantiate

Ad is slow to load, eg fromthrottling

ad loaded Impression events fire onlyonce the ad has loaded. The"loaded" event should alsofire only after the ad hasloaded.

"""timestamp"":""1531376049725"",""type"":""impression"",""data"":{""creativeType"":""display"",""viewport"":undefined,""adView"":undefined,"

24 All Ad session hasfinished

End of ad session byclosing the ad or starting anew page in app that willdismiss the current ad

sessionFInish Finish

25 All Ad session startand loaded

Load the page with the ad loaded Ad is loaded and impressionoccurs

"timestamp":1571415828196,"type":"loaded","data":{"mediaType":"display","creativeType"



OM SDK Test Cases

:"nativeDisplay","impressionType":"onePixel"}}

26

All

Impression hasOccurred

Part of loaded event -check as part of loadedevent

mediaType display or video

{"adSessionId":"fb54e94d-5f26-443e-ba9a-6b54f44af9bf","timestamp":1571954146094,"type":"loaded","data":{"mediaType":"display","creativeType":"htmlDisplay","impressionType":"onePixel"}}

27 All Impression hasOccurred


creativeType htmlDisplay, nativeDisplay,video or audiodefinedByJavaScript forspecial casese.g. "creativeType":"nativeDisplay",

10/25/2019, 3:25:46AM::{"adSessionId":"fb54e94d-5f26-443e-ba9a-6b54f44af9bf","timestamp":1571954146094,"type":"loaded","data":{"mediaType":"display","creativeType":"htmlDisplay","impressionType":"onePixel"}}

28 All Impression hasOccurred

Impression Type for whatOMID impression eventyou are declaring.Part of loaded event -check as part of loadedevent

impressionType “loaded”, “beginToRender”,“onePixel”, “viewable”,“audible”, “other”,“unspecified”,“definedByJavaScript”e.g. "impressionType":"viewable","timestamp":1571415828196,"type":"loaded","data":{"mediaType":"display","creativeType":"nativeDisplay","impressionType":"onePixel"}}

29 Video Impression hasoccurred

Sunsetted videoEventAdaptorType

Empty / NULL - Does notapply for 1.3

30 Video Impression hasoccurred

Sunsetted videoEventAdaptorVersion (not required)

Empty / NULL - Does notapply for 1.3

31 All Impression hasoccurred

viewport viewport size of the device inheight and width



OM SDK Test Cases

32 All Impression hasoccurred

adView This is geometry changedata. E.g."""adView"":{""percentageInView"":100,""reasons"":[],""timestamp"":""1531376050520"",""geometry"":{""width"":351,""height"":351,""x"":12,""y"":80},""onScreenGeometry"":{""width"":351,""height"":351,""x"":12,""y"":80}"

33 All Ad session hasfinished



34 All GeometryChange data

All the geometry eventsare to be displayed for allads

percentageInView value between 0-100


geometry value like this: {x: 0,y: 0,width: 320, } height: 50


onScreenGeometry {}x: 0,y: 0,width: 320,height: 50,obstructions:[


Required for creativemeasurement. CreativeMeasurement is used forHTML creative

containerGeometry "containerGeometry":{"width":320,"height":49.818180084228516,"x":36.3636360168457,"y":451.6363525390625},


Required for creativemeasurement. CreativeMeasurement is used forHTML creative

onScreenContainerGeometry

"onScreenContainerGeometry":{"width":320,"height":49.818180084228516,"x":36.3636360168457,"y":451.6363525390625},

All GeometryChange data

Required for creativemeasurement. CreativeMeasurement is used forHTML creative.If true, the geometry ofboth the creative elementinside of the webview andof the native viewrepresenting that webvieware being measured. The

measuringElement boolean"measuringElement":true



OM SDK Test Cases

geometry of thenative-layer webview isprovided, in this case, asthe containerGeometry andonScreenContainerGeometry properties.


Obstruction is present inonScreen geometry

Obstruction data In addition to existing fields“x”, “y”, “width”, “height”, add:

“pixels”: integerCount of visible pixels in ad.This considers obstructions,just like the“percentageInView” field.


Reason for obstruction reason one or more of: notfound,hidden, backgrounded,viewport,obstructed, clipped


the number of friendlyobstructions declared bythe integrator for this adsession.

declaredFriendlyObstructions

"declaredFriendlyObstructions" : 1


the name of the nativeview class that isobstructing the ad

obstructionClass "friendlyObstructions":[{"x":339.4285583496094,"y":200,"width":56,"height":28,"obstructionClass":"android.support.design.widget.FloatingActionButton","obstructionPurpose":"OTHER"}

43 Native GeometryChange data

Classification for thefriendly obstruction.

obstructionPurpose "friendlyObstructions":[{"x":339.4285583496094,"y":200,"width":56,"height":28,"obstructionClass":"android.support.design.widget.FloatingActionButton","obstructionPurpose":"OTHER"}


Reason for obstruction detailedReason "friendlyObstructions":[{"x":339.4285583496094,"y":200,"width":56,"height":28,"obstructionClass":"android.support.design.widget.FloatingActionButton","detailedReason":"somereason"}

45 Video Video playerinteraction andevents

Events for video ads loaded {skippable: <boolean>,skipOffset: <float>,autoPlay: <boolean>,position: <string>}



OM SDK Test Cases

position values are -preroll,midroll, postroll,standalone (when it is not invideo content)


Start playing the video start {duration: <float>,videoPlayerVolume: <float>,deviceVolume: <float>}The videoPlayerVolumerange is between 0 and 1.The deviceVolume range isbetween 0 and 1.


Play at least 1/4 of videolength

firstquartile firstquartile


Play at least half of videolength

midpoint midpoint



thirdquartile thirdquartile


Play full video complete complete


Pause the video pause pause


Resume after the pause resume resume


Start playing video bufferstart bufferstart


bufferfinish bufferfinish


Use skip video is skip isavailable

skipped Only for skippable videos


Change player volume ordevice volume

volumeChange values are between 0 and 1- {videoPlayerVolume: <float>,deviceVolume: <float>}



mediaPlayerVolume values are between 0 and 1- {mediaPlayerVolume: <float>,deviceVolume: <float>



OM SDK Test Cases

}58 Video Video player

interaction andevents

Hide Video by scrolling orexpanding another pagecomponent sothe video ishidden

playerStateChange minimized


Change player volume volumeChange playerVolume should change,but deviceVolume should not

60 Video Change devicevolume

volumeChange deviceVolume shouldchange, butplayerVolume shouldnot


Mute player volume volumeChange {videoPlayerVolume: 0,deviceVolume: <float>

}62 Video Video player


Mute device volume volumeChange {videoPlayerVolume: <float>,deviceVolume: 0}


Minimize the video orreduce in size if ap allowsthat action

playerStateChange collapsed


Play video in player defaultsize

playerStateChange normal


Expand the player if appallows or the app expandsthe video when it plays thevideo

playerStateChange expanded


Tap on video to go fullscreen

playerStateChange fullscreen




CLick on video to openadvertiser landing page-execute click through

adUserInteraction {interactionType: <click> }


Tap on video to engagewith another ad experience

adUserInteraction {interactionType:<invitaitonAccept> }

70 Display

Banner adsession basiccheck

Load the banner ad Check all ad sessionand impressionevents have occured

see above for ad session andimpression event



OM SDK Test Cases

71 Display


Reload the banner ad Check all ad sessionand impressionevents have occured


72 Display


On Android rotate thebanner- this should start anew ad session

Check all ad sessionand impressionevents have occured


73 Display

Banner adviewabilitygeometry

Ad fully in view percentageInView this should be 100- alsocheck other geometry values-they should reflect devicesize in view port and ad sizein X,Y parameters

74 Display


Scroll ad partially out ofview < 50% in view

percentageInView value should be < 50

75 Display


Scroll ad partially back inview > 50% but < 100% inview

percentageInView value should be >50 and <100

76 Display


Scroll ad fully out of view percentageInView 0

77 Display


reason hidden and / or viewport

78 Display

Banner adobstructions

Background the application(go to another app or startcamera or lock the screen)

percentageInView between 0 and 100

79 Display


obstruction data as described above

80 Display


reason backgrounded

81 Display


Hide with another view byopening or expandinganother component on thepage in the app. e.g opena link that opens anotherweb view

reason obstructed and/ or hidden

82 Display

Banner adinteractions

Click to advertiser landingpage


83 Display

Banner adinteractions

Tap to engage with adcomponent like expand thead


84 Display

Ending the adsession

Tap on close button if thereis e.g. anchored banners

session Finish Finish



OM SDK Test Cases

or refresh the app page toget a fresh ad session

85 Interstitial

Pre loadscenario(confirm withapp if thisapplies)

Load the app Check all ad sessionand impressionevents have occured

see above for ad sessionevents

86 Interstitial

Ad shown in preload scenario

Go to the interstitial pagein the app (navigate fromone page to another untilinterstitial is shown)

Check all impressionoccurred events

see above for impressionevents

87 Interstitial

Ad load andshown at thesame time

GO to the interstitial pagein the app (please confirmnavigation with app owner)



88 Interstitial

Interstitial adviewabilitygeometry

Ad fully in view percentageInView 90% or greater

89 Interstitial

Interstitial adobstructions


percentageInView between 0 and 100

90 Interstitial



91 Interstitial


reason backgrounded

92 Interstitial

Interstitial adinteractions

Click to advertiser landingpage


93 Interstitial


Tap to engage with adcomponent like expand thead


94 Interstitial


Tap on close button if thereis or use app navigation tomove out of the interstitialad experience

session Finish Finish

95 Video Ad session startand impressionfor ads in videocontent

Play video content until preroll or mid roll or post roll



96 Video When video ad appearsadditional video eventsneed to be verified

loaded {skippable: <boolean>,skipOffset: <float>,autoPlay: <boolean>,position: <string>}position values are -preroll,midroll, postroll,standalone (when it is not invideo content)



OM SDK Test Cases

97 Video Ad session startand impressionfor standaloneads- autoplaynative oroutstream ads

Load the page with thevideo ad

loaded {skippable: <boolean>,skipOffset: <float>,autoPlay: <boolean>,position: <string>}position values are -preroll,midroll, postroll,standalone (when it is not invideo content)

98 Video Video adviewabilitygeometry forvideos inline ofthe view

Ad fully in view percentageInView this should be 100- alsocheck other geometry values-they should reflect devicesize in view port and ad sizein X,Y parameters






percentageInView value should be >50 and <100







percentageInView between 0 and 100, videoevents available



105 Video Video adviewabilitygeometry for

reason backgrounded



OM SDK Test Cases

videos inline ofthe view



reason obstructed and/ or hidden

107 Video Video playbackevents

Refer above test case forVideo player interactionand events and execute allscenarios

see Video playerinteraction andevents scenarios

see Video player interactionand events scenarios.

108 Video End session Click on close to close thevideo, stop the video ormove to another pagecreating a new app pagesession

Session Finish Finish

109 Native Native adviewability

Same as banner ads Ensure ad session type isnative and OMIDnative eventhas the right parameters

110 Audio Audio playerinteraction andevents

Play at least 1/4 of audiolength



Play at least half of audiolength

midpoint midpoint


Play at least 3/4 of audiolength



Play full audio complete complete


Pause the audio pause pause




Change player volume volumeChange mediaPlayerVolume shouldchange, but deviceVolumeshould not

117 Audio Change devicevolume

volumeChange deviceVolume shouldchange, butmediaPlayerVolumeshould not


Mute player volume volumeChange {mediaPlayerVolume : 0,deviceVolume: <float>



OM SDK Test Cases

}119 Audio Audio player


Mute device volume volumeChange {mediaPlayerVolume : <float>,deviceVolume: 0}


Audio is backgrounded andstill playing. when an appis backgrounded we stillget OMID events (such asquartiles and devicevolume changes). audiocan be 100% audible in thebackground

All Audio Eventsneed to be checked

quartiles and volume

121 Audio End session Click on close to close theaudio, stop the audio ormove to another pagecreating a new app pagesession


1.2 Test Cases

S.No.

AdType Test Case Scenario Event/ Signal

Expected Result/ value/comment

1 All Set-up testing

Confirm that the app canbe installed and from whatsourceShould testing be targetedto specific devices? Devicetypes? App installation

App installed without error,and can be opened


Did the int partner provideany specific credentials fortesting? Log-in screen Log-in successful


Does the app re-use thesame code for multipleplacements, so that theycan be checked as a grouprather than individually?

Confirmation fromIntegrator Confirmation from Integrator


Is the generic verificationscript trafficked with thead?


Signals from genericverification script

5 All Set-up testingOnly ads to be tested arebeing served with tracking

Confirmation fromIntegrator Confirmation from Integrator

6 All



OM SDK Test Cases

7 All

Check OMIDcompatibilityand whetheractive

Load the app page with thead

isCompatibleWithOmidApiVersion

version number of OMIDlibrary and applicationcontext.supported = 'yes'

8 All

Ad session iscorrectlyinstantiated

Load the page with the ador reload the page with thead ad session id

return new ad session-unique ad session id,timestampunique ad session value like:2196C74D-6A27-4807-A3D3-B08E4F6E0ABAand timestamp aue like1531749570462

9 All


Ad session context isestablished properly environment

app e.f"environment":"app",timestamp":"1531749570462"

10 All

Ad session iscorrectlyinstantiated adSessionType native or html

11 All

Ad session iscorrectlyinstantiated supports

clid for all ad types except vlidfor video

12 All

Ad session iscorrectlyinstantiated omidNativeInfo

partnerName (this is same asnamespace assigned at thetime of OM SDK download)and partnerVersion

{"partnerName":"someSDK","partnerVersion":"x.y"},timestamp":"1531749570462"

13 All

Ad session iscorrectlyinstantiated omidJsInfo

serviceVersion,sessionClientVersion,partnerName,partnerVersion


14 All

Ad session iscorrectlyinstantiated app

libraryVersion and appId(com.example.appname)

"app":{"appId":"com.example.ent","libraryVersion":"1.1.2-partnername"},timestamp":"1531749570462"

15 All

Ad session iscorrectlyinstantiated Device Info

mobile device detailse.g."deviceInfo":{"deviceType":"iPhone7,2","os":"iOS","osVersio



OM SDK Test Cases

n":"11.4.1"},timestamp":"1531749570462"

16 All


verificationParameters

verification parameterprovided by the measurementproviderundefined for display ads e.g.verificationParameters":"undefined"Also displays access mode.Always limited when usingOM SDK"accessmode":"limited"For native and video adsverificationParameters":"iabtechlab or some text","accessmode":limited

17 All


customReferenceData (not required) any string value

18 All

Ad session haserrorinstantiating errorType

Generic or Video when videoads

19 All

Ad session haserrorinstantiating message

string value describing theerror

20 AllAd session slowto instantiate

Ad is slow to load, eg fromthrottling ad loaded

Impression events fire onlyonce the ad has loaded"""timestamp"":""1531376049725"",""type"":""impression"",""data"":{""mediaType"":""display"",""viewport"":undefined,""adView"":undefined,"

21 AllAd session hasfinished

End of ad session byclosing the ad or starting anew page in app that willdismiss the current ad sessionFInish Finish

22 AllImpression hasoccurred

As soon as the ad isdisplayed on the page html display or video

23 VideoImpression hasoccurred

videoEventAdaptorType

jcustom or nativecustom if themedia type is video

24 VideoImpression hasoccurred

videoEventAdaptorVersion (not required)

version number is media typeis video

25 AllImpression hasoccurred viewport

viewport size of the device inheight and width



OM SDK Test Cases

26 AllImpression hasoccurred adView

This is geometry changedata. E.g."""adView"":{""percentageInView"":100,""reasons"":[],""timestamp"":""1531376050520"",""geometry"":{""width"":351,""height"":351,""x"":12,""y"":80},""onScreenGeometry"":{""width"":351,""height"":351,""x"":12,""y"":80}"

27 AllGeometryChange data

All the geometry eventsare to be displayed for allads percentageInView value between 0-100

28 AllGeometryChange data geometry

value like this: {x: 0,y: 0,width: 320, } height: 50

29 AllGeometryChange data onScreenGeometry

{}x: 0,y: 0,width: 320,height: 50,obstructions:[

30 AllGeometryChange data

Obstruction is present inonScreen geometry Obstruction data

{x: 0,y: 0,width: 320, } height: 50

31 AllGeometryChange data Reason for obstruction reason

one or more of: notfound,hidden, backgrounded,viewport,obstructed, clipped

32 Video

Video playerinteraction andevents Events for video ads loaded

{skippable: <boolean>,skipOffset: <float>,autoPlay: <boolean>,position: <string>}position values are -preroll,midroll, postroll,standalone (when it is not invideo content)

33 Video

Video playerinteraction andevents Start playing the video start

{duration: <float>,videoPlayerVolume: <float>,deviceVolume: <float>}The videoPlayerVolumerange is between 0 and 1.



OM SDK Test Cases

The deviceVolume range isbetween 0 and 1.

34 Video

Video playerinteraction andevents

Play at least 1/4 of videolength firstquartile firstquartile

35 Video


Play at least half of videolength midpoint midpoint

36 Video


Play at least 3/4 of videolength thirdquartile thirdquartile

37 Video

Video playerinteraction andevents Play full video complete complete

38 Video

Video playerinteraction andevents Pause the video pause pause

39 Video

Video playerinteraction andevents Resume after the pause resume resume

40 Video

Video playerinteraction andevents Start playing video bufferstart bufferstart

41 Video

Video playerinteraction andevents bufferfinish bufferfinish

42 Video


Use skip video is skip isavailable skipped Only for skippable videos

43 Video


Change player volume ordevice volume volumeChange

values are between 0 and 1- {videoPlayerVolume: <float>,deviceVolume: <float>}

44 Video


Hide Video by scrolling orexpanding another pagecomponent sothe video ishidden playerStateChange minimized

45 Video

Video playerinteraction andevents Change player volume volumeChange

playerVolume should change,but deviceVolume should not

46 VideoChange devicevolume volumeChange

deviceVolume shouldchange, butplayerVolume shouldnot

47 Video

Video playerinteraction andevents Mute player volume volumeChange

{videoPlayerVolume: 0,deviceVolume: <float>}



OM SDK Test Cases

48 Video

Video playerinteraction andevents Mute device volume volumeChange

{videoPlayerVolume: <float>,deviceVolume: 0}

49 Video


Minimize the video orreduce in size if ap allowsthat action playerStateChange collapsed

50 Video


Play video in player defaultsize playerStateChange normal

51 Video


Expand the player if appallows or the app expandsthe video when it plays thevideo playerStateChange expanded

52 Video


Tap on video to go fullscreen playerStateChange fullscreen

53 Video

Video playerinteraction andevents geometry

value like this: {x: 0,y: 0,width: 320, } height: 50

54 Video


CLick on video to openadvertiser landing page-execute click through adUserInteraction

{interactionType: <click> }

55 Video


Tap on video to engagewith another ad experience adUserInteraction

{interactionType:<invitaitonAccept> }

56 Display

Banner adsession basiccheck Load the banner ad



57 Display

Banner adsession basiccheck Reload the banner ad



58 Display


On Android rotate thebanner- this should start anew ad session



59 Display

Banner adviewabilitygeometry Ad fully in view percentageInView

this should be 100- alsocheck other geometry values-they should reflect devicesize in view port and ad sizein X,Y parameters

60 Display


Scroll ad partially out ofview < 50% in view percentageInView value should be < 50

61 Display


Scroll ad partially back inview > 50% but < 100% inview percentageInView

value should be >50 and <100



OM SDK Test Cases

62 Display

Banner adviewabilitygeometry Scroll ad fully out of view percentageInView 0

63 Display

Banner adviewabilitygeometry reason hidden and / or viewport

64 DisplayBanner adobstructions

Background the application(go to another app or startcamera or lock the screen) percentageInView between 0 and 100

65 DisplayBanner adobstructions obstruction data as described above

66 DisplayBanner adobstructions reason backgrounded

67 DisplayBanner adobstructions

Hide with another view byopening or expandinganother component on thepage in the app. e.g opena link that opens anotherweb view reason obstructed and/ or hidden

68 DisplayBanner adinteractions

Click to advertiser landingpage adUserInteraction


69 DisplayBanner adinteractions

Tap to engage with adcomponent like expand thead adUserInteraction


70 DisplayEnding the adsession

Tap on close button if thereis e.g. anchored bannersor refresh the app page toget a fresh ad session session Finish Finish

71Interstitial

Pre loadscenario(confirm withapp if thisapplies) Load the app



72Interstitial

Ad shown in preload scenario

Go to the interstitial pagein the app (navigate fromone page to another untilinterstitial is shown)

Check all impressionoccurred events

see above for impressionevents

73Interstitial

Ad load andshown at thesame time

GO to the interstitial pagein the app (please confirmnavigation with app owner)



74Interstitial

Interstitial adviewabilitygeometry Ad fully in view percentageInView 90% or greater

75Interstitial


Background the application(go to another app or startcamera or lock the screen) percentageInView between 0 and 100

76Interstitial

Interstitial adobstructions obstruction data as described above



OM SDK Test Cases

77Interstitial

Interstitial adobstructions reason backgrounded

78Interstitial


Click to advertiser landingpage adUserInteraction


79Interstitial


Tap to engage with adcomponent like expand thead adUserInteraction


80Interstitial


Tap on close button if thereis or use app navigation tomove out of the interstitialad experience session Finish Finish

81 Video

Ad session startand impressionfor ads in videocontent

Play video content until preroll or mid roll or post roll



82 Video

When video ad appearsadditional video eventsneed to be verified loaded


83 Video

Ad session startand impressionfor standaloneads- autoplaynative oroutstream ads

Load the page with thevideo ad loaded


84 Video

Video adviewabilitygeometry forvideos inline ofthe view Ad fully in view percentageInView

this should be 100- alsocheck other geometry values-they should reflect devicesize in view port and ad sizein X,Y parameters

85 Video

Video adviewabilitygeometry forvideos inline ofthe view

Scroll ad partially out ofview < 50% in view percentageInView value should be < 50

86 Video

Video adviewabilitygeometry for

Scroll ad partially back inview > 50% but < 100% inview percentageInView

value should be >50 and <100



OM SDK Test Cases

videos inline ofthe view

87 Video

Video adviewabilitygeometry forvideos inline ofthe view Scroll ad fully out of view percentageInView 0

88 Video

Video adviewabilitygeometry forvideos inline ofthe view reason hidden and / or viewport

89 Video


Background the application(go to another app or startcamera or lock the screen) percentageInView

between 0 and 100, videoevents available

90 Video

Video adviewabilitygeometry forvideos inline ofthe view obstruction data as described above

91 Video

Video adviewabilitygeometry forvideos inline ofthe view reason backgrounded

92 Video


Hide with another view byopening or expandinganother component on thepage in the app. e.g opena link that opens anotherweb view reason obstructed and/ or hidden

93 VideoVideo playbackevents



see Video player interactionand events scenarios.

94 Video End session

Click on close to close thevideo, stop the video ormove to another pagecreating a new app pagesession Session Finish Finish

95 NativeNative adviewability Same as banner ads

Ensure ad session type isnative and OMIDnative eventhas the right parameters



OM SDK Test Cases

Web Video Test Cases

S.No. Ad Type Test Case Scenario Event/ Signal Expected Result/ value/comment

1 All Set-up testing Player loads on page App installation Specific url for test - web pageload

2 All Set-up testing Did the int partner provideany specific credentials fortesting?

Log-in screen Log-in successful

3 All Set-up testing Can apply for in/outstream


Outstream - outstream urlinstream - instream urlURL Must be on a productionready url

4 All Set-up testing Is the generic verificationscript trafficked with thead?


Signals from generic verificationscript

5 All Set-up testing Only ads to be tested arebeing served with tracking



6 All Check OMIDcompatibilityand whetheractive

Load the app page withthe ad

OmidSupported[true]

OmidSupported[true]


Load the page with the ador reload the page with thead

ad session id return new ad session- unique adsession id, timestampunique ad session value like:2196C74D-6A27-4807-A3D3-B08E4F6E0ABAand timestamp aue like1531749570462


Ad session context isestablished properly

environment app e.f"environment":"web",timestamp":"1531749570462"

9

All

Ad session iscorrectlyinstantiated Video Ad Session adSessionType html



OM SDK Test Cases


supports vlid for video


omidJsInfo serviceVersion,sessionClientVersion,partnerName,partnerVersion



Impression Type for whatOMID impression eventyou are declaring

impressionType “loaded”, “beginToRender”,“onePixel”, “viewable”, “audible”,“other”, “unspecified”,“definedByJavaScript”e.g. "impressionType":"viewable",


Value will be true for allvideo sessions and fordisplay sessions whereintegration uses new API.Value will be false fordisplay sessions whereintegration uses old API.

For 1.3 certification,integrations are required touse 1.3 API."supportsLoadedEvent"should be true for all 1.3certifiable integrations.

supportsLoadedEvent

"supportsLoadedEvent": true"supportsLoadedEvent": false,


URL of top-level webpage, as determined byOM SDK JS service. Nullwhen JS service iscross-domain or running ina mobile app.

pageUrl "pageUrl": www.domain.com


URL of top-level webpage, as provided by OMintegration. Null whenintegration does not passcontentUrl parameter on

contentUrl "contentUrl": www.domain.com



OM SDK Test Cases

Context constructor.


underEvaluation default is true, for prod set tofalse (Compliance should betrue)

"underEvaluation": true


canMeasureVisibility

"canMeasureVisibility": true


videoElement DOM Video Element - Presentbut not parsed to avoid parseerror


For compliance testing, wewill need a web app ineach access mode toconfirm that this signalmay be reflective of thepublisher’s choice.

context"accessmode":"limited" “domain”or "full"


customReferenceData (not required)

any string value

21 All Ad sessionhas errorinstantiating

errorType Generic or Video when video ads



OM SDK Test Cases

22 All Ad sessionhas errorinstantiating

message string value describing the error

23 All Ad sessionslow toinstantiate

Ad is slow to load, eg fromthrottling

ad loaded Impression events fire only oncethe ad has loaded. The "loaded"event should also fire only afterthe ad has loaded."""timestamp"":""1531376049725"",""type"":""impression"",""data"":{""creativeType"":""display"",""viewport"":undefined,""adView"":undefined,"

24 All Ad sessionhas finished



25 All Ad sessionstart andloaded

Load the page with the ad loaded Ad is loaded and impressionoccurs

"timestamp":1571415828196,"type":"loaded","data":{"mediaType":"video","creativeType":"video","impressionType":"onePixel"}}

26 All Impressionhas Occurred


mediaType video

{"adSessionId":"fb54e94d-5f26-443e-ba9a-6b54f44af9bf","timestamp":1571954146094,"type":"loaded","data":{"mediaType":"video","creativeType":"video","impressionType":"onePixel"}}



creativeType video

10/25/2019, 3:25:46AM::{"adSessionId":"fb54e94d-5f26-443e-ba9a-6b54f44af9bf","tim



OM SDK Test Cases

estamp":1571954146094,"type":"loaded","data":{"mediaType":"video","creativeType":"video","impressionType":"onePixel"}}


Impression Type for whatOMID impression eventyou are declaring.Part of loaded event -check as part of loadedevent

impressionType “loaded”, “beginToRender”,“onePixel”, “viewable”, “audible”,“other”, “unspecified”,“definedByJavaScript”e.g. "impressionType":"viewable","timestamp":1571415828196,"type":"loaded","data":{"mediaType":"video","creativeType":"video","impressionType":"onePixel"}}

29 Video Impressionhas occurred

Sunsetted videoEventAdaptorType

Empty / NULL - Does not applyfor Web Video

30 Video Impressionhas occurred

Sunsetted videoEventAdaptorVersion (notrequired)


31 All Impressionhas occurred

Used to check that accessmodes are set correctly.If using creative accessmode, friendlyToTop mustbe false.

friendlyToTop True or falseIf testing full-creative accessmode, this must be false.


Results will vary based onfriendlyToTop and AccessMode. If certifying allaccess modes, this testmust be done in full andcreative access modes.

viewport viewport size is reported in fullaccess. It will be reported asundefined in creative accessmode.Limited and Domain could beeither reported or undefineddepending on whetherfriendlyToTop is true or false.



OM SDK Test Cases


Results will vary based onaccess mode andfriendlyToTop setting of alliframes in a nested iframesetup. If certifying allaccess modes, this testmust be done in full,creative and limitedaccess modes.

adView This is geometry change data.E.g."""adView"":{""percentageInView"":100,""reasons"":[],""timestamp"":""1531376050520"",""geometry"":{""width"":351,""height"":351,""x"":12,""y"":80},""onScreenGeometry"":{""width"":351,""height"":351,""x"":12,""y"":80}"

It will be reported as undefined increative access mode.Limited and Domain could beeither reported or undefineddepending on whetherfriendlyToTop is true or false.

34 All Ad sessionhas finished




All the geometry eventsare to be displayed for alladsAds need to scroll adcontainer all the way out ofview

percentageInView value between 0-100


viewport on the web maynot apply.



onScreenGeometry {}x: 0,y: 0,width: 320,height: 50,obstructions:[


Obstruction is present inonScreen geometry

Obstruction data Empty for Web Video


Reason for obstructionTab out of view orminimize browser. Tab notin focus or minimize

reason one or more of: notfound, hidden,backgrounded, viewport,clipped



OM SDK Test Cases


the number of friendlyobstructions declared bythe integrator for this adsession.

declaredFriendlyObstructions



the name of the nativeview class that isobstructing the ad

obstructionClass Empty / NULL - Does not applyfor Web Video


Reason for obstruction detailedReason Empty / NULL - Does not applyfor Web Video


Events for video ads loaded {skippable: <boolean>, skipOffset:<float>,autoPlay: <boolean>,position: <string>}position values are -preroll,midroll, postroll,standalone (when it is not invideo content)


Start playing the video start {duration: <float>,videoPlayerVolume: <float>,deviceVolume: <float>}The videoPlayerVolume range isbetween 0 and 1. ThedeviceVolume range is between0 and 1.





Play at least half of videolength

midpoint midpoint



OM SDK Test Cases





Play full video complete complete


Pause the video pause pause




Start playing video bufferstart bufferstart


bufferfinish bufferfinish


Use skip video is skip isavailable

skipped Only for skippable videos



volumeChange values are between 0 and 1- {videoPlayerVolume: <float>,deviceVolume: <float>}



mediaPlayerVolume values are between 0 and 1- {mediaPlayerVolume: <float>,deviceVolume: null}


Hide Video by scrolling orexpanding another pagecomponent sothe video ishidden

playerStateChange minimized, collapsed, normal,fullscreen,expanded


Change player volume volumeChange playerVolume should change, butdeviceVolume should not

58 Video Change devicevolume

volumeChange - Set to 1for Web Video

deviceVolume willbe set by omsdk to‘null’

This is auto set to ‘null’ for webvideo



OM SDK Test Cases


Mute player volume volumeChange {videoPlayerVolume: 0,deviceVolume: null}


Mute device volume - Thiswill be set to ‘null’ for Webvideo

volumeChange {videoPlayerVolume: <float>,deviceVolume: null}


Minimize the video orreduce in size if app allowsthat action

playerStateChange collapsed


Play video in player defaultsize

playerStateChange normal


Expand the player if appallows or the app expandsthe video when it plays thevideo

playerStateChange expanded


Tap on video to go fullscreen

playerStateChange fullscreen




Click on video to openadvertiser landing page-execute click through



Tap on video to engagewith another adexperience


68 Video Ad sessionstart andimpression forads in videocontent

Play video content untilpre roll or mid roll or postroll

Check all adsession andimpression eventshave occurred

see above for ad session events

69 Video When video ad appearsadditional video eventsneed to be verified

loaded {skippable: <boolean>, skipOffset:<float>,autoPlay: <boolean>,position: <string>



OM SDK Test Cases

}position values are -preroll,midroll, postroll,standalone (when it is not invideo content)

70 Video Ad sessionstart andimpression forstandaloneads- autoplaynative oroutstream ads

Load the page with thevideo ad

loaded {skippable: <boolean>, skipOffset:<float>,autoPlay: <boolean>,position: <string>}position values are -preroll,midroll, postroll,standalone (when it is not invideo content)


Ad fully in view percentageInView this should be 100- also checkother geometry values- theyshould reflect device size in viewport and ad size in X,Yparameters






percentageInView value should be >50 and < 100






Switch browser Tab orminimize

percentageInView between 0 and 100, video eventsavailable

77 Video Video adviewabilitygeometry forvideos inline of

obstruction data Empty / NULL - Does not applyfor Web Video



OM SDK Test Cases

the view


reason backgrounded



reason Empty / NULL - Does not applyfor Web Video

80 Video Videoplaybackevents



see Video player interaction andevents scenarios.

81 Video End session Click on close to close thevideo, stop the video ormove to another pagecreating a new app pagesession




o p e n me a su re m e n t s dk

Documents