VAST
Video Ad Serving Template
We support VAST 2.0 & VAST 3.0 for Apps & CTV.
Example tag and required macros are listed below and our account managers ([email protected]) will help you with the final ad code.
For Apps -
https://aex.ingage.tech/v1/tag/video?screensize=1920x1080&adUnitId=[AD_UNIT_ID]&publisherId=[PUB_ID]&mimes=video/mp4&mimes=video/ogg&mimes=video/webm&mimes=application/javascript&width=[WIDTH]&height=[HEIGHT]&bidFloor=0.5&bundleId=[BUNDLE_ID]&uid=[IFA_TYPE_MACRO]&plcmt=[PLCMT]&placement=[PLACEMENT]&minduration=1&maxduration=120&minbitrate=1&maxbitrate=10000
For Web -
https://ex.ingage.tech/v1/tag/video?screensize=1920x1080&adUnitId=[AD_UNIT_ID]&publisherId=[PUB_ID]&mimes=video/mp4&mimes=video/ogg&mimes=video/webm&mimes=application/javascript&width=[WIDTH]&height=[HEIGHT]&bidFloor=0.5&page=[PAGE_URL]&plcmt=[PLCMT]&uid=[UUID]&placement=[PLACEMENT]&minduration=1&maxduration=120&minbitrate=1&maxbitrate=10000
Except adUnitId _and _PublisherId all other value can be inserted dynamically. Our Publisher success team will help you with adUnitId & PublisherId
Additionally, please ensure that the &page parameter contains the full URL, including https://. The final root URL should be formatted as https://www.domain.com/. If the value sent to our server is already in this format, you may disregard this instruction.
Required & Recommended Macros
| key | value | description | required | recommended |
|---|---|---|---|---|
| id | string | site/app id | Yes | Yes |
| adUnitId | string | Id of the ad unit | Yes | Yes |
| isApp | boolean | (OPTIONAL) Denotes whether the request is from Site / App. Use bundleId instead. | ||
| bundleId | string | App Id (If present, the tag refers to app ) | Yes | Yes (For Apps Only) |
| page | string | Site page ( if present, the tag refers to site request ) | Yes (For Sites Only) | |
| width | integer | Width of the video player in device independent pixels (DIPS). | Yes | |
| height | integer | Height of the video player in device independent pixels (DIPS). | Yes | |
| bidFloor | number | "minimum": 0, only numeric values allowed | Yes | Yes |
| screensize | string | "pattern": "\d+x\d+" | Yes | |
| uid | string | user id from browser traffic and ifa type for apps | Yes | |
| placement | integer | 1 (In-Stream) 2 (In-Banner) 3 (In-Article) 4 (In-Feed) 5 (Interstitial/Slider/Floating) | Yes | |
| mimes | string[] | Yes | ||
| format | string[] | "pattern": "\d+x\d+" | Use Width and height instead | ||
| wrapperType | ''iframe'' | "html" | html is used by default for banners. Videos will always be returned in xml format | ||
| plcmt | integer | 1 (In-Stream) 2 (In-Banner) 3 (In-Article) 4 (In-Feed) 5 (Interstitial/Slider/Floating) | Yes | |
| protocols | integer[] | We support [2,3,5,6,7,8]. Array of supported video protocols. Refer to List 5.8 in oRTB spec v2.5. At least one supported protocol must be specified in either the protocol or protocols attribute | Yes | |
| minduration | integer | Minimum video ad duration in seconds. | Yes | |
| maxduration | integer | Maximum Video ad duration in seconds. | Yes | |
| api | integer[] | List of supported API frameworks for this impression. Refer to List 5.6 in oRTB spec v2.5. | Yes | |
| linearity | integer | We have default of 1, as we support that only for now. It Indicates if the impression must be linear, nonlinear, etc. If none specified, assume all are allowed | ||
| skip | integer | Indicates if the player will allow the video to be skipped, where 0 = no, 1 = yes. | ||
| skipmin | integer | Videos of total duration greater than this number of seconds can be skippable; only applicable if the ad is skippable. | ||
| skipafter | integer | Number of seconds a video must play before skipping is enabled; only applicable if the ad is skippable. | ||
| sequence | integer | If multiple ad impressions are offered in the same bid request, the sequence number will allow for the coordinated delivery of multiple creatives | ||
| battr | integer[] | Blocked creative attributes. Refer to List 5.3 in oRTB spec v2.5 | ||
| maxextended | integer | Maximum extended ad duration if extension is allowed. If blank or 0, extension is not allowed. If -1, extension is allowed, and there is no time limit imposed. If greater than 0, then the value represents the number of seconds of extended play supported beyond the maxduration value. | ||
| minbitrate | integer | Minimum bit rate in Kbps. | Yes | |
| maxbitrate | integer | Maximum bit rate in Kbps. | Yes | |
| playbackmethod | integer[] | Playback methods that may be in use. If none are specified, any method may be used. Refer to List 5.10 in oRTB spec v2.5 | ||
| playbackend | integer | The event that causes playback to end. Refer to List 5.11 in oRTB spec v2.5 | ||
| delivery | integer[] | Supported delivery methods (e.g., streaming, progressive). If none specified, assume all are supported. Refer to List 5.15. | ||
| pos | integer | Ad position on screen. Refer to List 5.4. | Yes |
Quality guidance:
We recommend following the quality guidance to improve monetization outcomes.
Additional resources:
Reporting: https://documentation.insticator.com/docs/analytics-date-range
How to establish the appropriate format specifications for CTV bundles. - https://iabtechlab.com/wp-content/uploads/2020/08/IAB-Tech-Lab-OTT-store-assigned-App-Identification-Guidelines-2020.pdf
Updated 4 months ago