List of supported API frameworks
| Value | Description |
|---|---|
| VPAID 1.0 |
| VPAID 2.0 |
| MRAID-1 |
| ORMMA |
| MRAID-2 |
| MRAID-3 |
| OMID-1 |
List of supported native layout IDs
The values in this table are recommended in version 1.0 of the native ads specification and are deprecated in version 1.1.
| Layout ID | Description |
|---|---|
| Content wall |
| App wall |
| News feed |
| Chat list |
| Carousel |
| Content stream |
| Grid adjoining the content |
List of supported native ad unit IDs
The values in this table are recommended in version 1.0 of the native ads specification and are deprecated in version 1.1.
| Ad unit ID | Description |
|---|---|
| Paid search units |
| Recommendation widgets |
| Promoted listings |
| In-Ad (IAB standard) with native element units |
| Custom or "can't be contained" |
List of supported context type IDs
The context in which the ad appears. It specifies the type of content that is surrounding the ad on the page at a high level.
| Context type ID | Description |
|---|---|
| Content-centric context such as newsfeed, article, image gallery, or video gallery. |
| Social-centric context such as social network feed, email, or chat. |
| Product context such as product listings, details, recommendations, or reviews. |
List of supported context sub type IDs
Next-level context in which the ad appears.
| Context sub type ID | Description |
|---|---|
| General or mixed content |
| Primarily article content |
| Primarily video content |
| Primarily audio content |
| Primarily image content |
| User-generated content through forums, comments, or other sources |
| General social content such as a general social network |
| Primarily email content |
| Primarily chat or IM content |
| Content focused on selling digital or physical products |
| Application store or marketplace |
| Product review sites |
List of supported placement type IDs
The format of the ad that you are purchasing and that is separate from the surrounding content.
| Placement type ID | Description |
|---|---|
| In the feed of the content such as an item inside a feed, grid, listing, or carousel. |
| In the atomic unit of the content such as in the article page or single image page. |
| Outside the core content such as in the ad's section on the right rail or as a banner-style placement near the content. |
| Recommendation widget that is most commonly presented below the article content. |
List of supported image asset types
Note:Media Owners are responsible for sizing the image as follows:
- Crop the main image symmetrically by up to 20% in one dimension (height or width).
- Scale the image without changing its aspect ratio.
- Images that have aspect ratios substantially different than those implied by the height and width may be filtered.
| Type ID | Name | Description |
|---|---|---|
| icon | Icon image. It is recommended to use a 1:1 aspect ratio. |
| logo | Logo image for the brand or app. This type ID was removed in version 1.2 of the native ads specification. |
| main | Large image preview of the ad which is typically 1200px x 627px. |
List of supported data asset types
Note: If the text length exceeds the maximum number of characters, the text may be truncated or ellipsized by the Media Owner.
| Type ID | Name | Description | Format |
|---|---|---|---|
| sponsored | Sponsored by message where the response should contain the brand name of the sponsor. A maximum of 25 characters is allowed. | text |
| desc | Descriptive text associated with the product or service being advertised. A maximum of 90 characters is allowed. | text |
| rating | Rating of the product being offered to the user. A rating of 0-5 is recommended. | number formatted as string |
| likes | Number of social ratings or likes. This asset type is not currently used. | number formatted as string |
| downloads | Number of downloads or installs of the product. This asset type is not currently used. | number formatted as string |
| price | Price of the product . A maximum of 15 characters is allowed. | number formatted as string |
| saleprice | Sale price that can be used in conjunction with the price to indicate a discounted price. This asset type is not currently used. | number formatted as string |
| phone | The phone number. This asset type is not currently used. | number formatted as a string |
| address | The address. This asset type is not currently used. | text |
| desc2 | Additional descriptive text. This asset type is not currently used. | text |
| displayurl | Display URL for the text ad. This asset type is not currently used. | text |
| ctatext | Desired user action. A maximum of 15 characters is allowed. | text |
List of supported event types
| Type ID | Name | Description |
|---|---|---|
| impression | This is an impression. |
| viewable-mrc50 | Visible impression using Media Rating Council (MRC) definition at 50% in view for one second. |
| viewable-mrc100 | 100% in view for one second (GroupM standard). This event type is not currently supported. |
| viewable-video50 | Visible impression for video using MRC definition at 50% in view for two seconds. This event type is not currently supported. |
| omid | This is for OMID tracking. |
List of supported event tracking methods
| Type ID | Name | Description |
|---|---|---|
| img | Image-pixel tracking. The URL provided will be inserted as a 1x1 pixel at the time of the event. |
| js | JavaScript-based tracking. The URL provided will be inserted as a js tag at the time of the event. |
