Enable access to your creative
Your creative should be available over HTTP/HTTPS for our worker. If your creative is auth protected, you can set a short lived access token and attach it to the URL of the creative you submit like:
https://mycreative.com/creative.html?accessToken=[shortLivedToken] before submitting the job to Omnirender. So only the worker will be able to access the creative.
Your creative must be sized responsively, either filling up horizontal or vertical space (envelope sizing). It enables you and Omnirender to scale up your creative. For example even if your creative is 600×300, if you show it in a responsive container, the banner will fill up vertical space and should maintain the 2:1 ratio in width. So when you submit the job and set width to 4000 and height to 2000, Omnirender will try to display the ad in a 4000×2000 HTML viewport rendering your AD in an upscaled state.
Autoplay, Start-Stop syncing
There are two methods of controlling how your creative starts and finishes.
Unsupervised scenario means Omnirenders built in webdriver loads the creative with all of its assets, waits for document ready event, cache it, reload and starts capturing immediately thus there will be no frame loss. This method requires that your creative autoplays right after it had downloaded all the neccessary assets. If you have a large embedded video in your creative, and you just start the playback of the creative on document ready without waiting for the embedded content to load, you might end up with a premature start of the creative and a missing element in the final output.
Unsupervised scenario requires
duration property to be set when submitting the conversion job request in milliseconds (for example if your creative is 5 secs long, add duration=5000)
Syncing requires the following to be implemented on your player:
- Expose your player object like
- Expose a public method
- Expose a public property
- Emit a
'playerReady'event once all of your assets finished loading and your player is ready to be started
- Omnirender will poll the
creativePlayer.readyproperty and subscribe to the
'playerReady'event so once either fullfills, Omnirender will invoke
- Creative playback starts, Omnirender subscribes to
'playerFinished'event, once your player is done and emits the
'playerFinished'event, Omnirender stops capturing
This methodology ignores duration, since start and stop events will controll the length as well.