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 Interactive Advertising Bureau (IAB). An advertising business organization that develops industry standards, conducts research, and provides legal support for the online advertising industry. 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: Publishers 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 publisher The owner of a website or app where advertisements are served..
| 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. |
