List of references for native ads (Beta)

List of supported API frameworks

Value Description

1

VPAID 1.0

2

VPAID 2.0

3

MRAID-1

4

ORMMA

5

MRAID-2

6

MRAID-3

7

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

1

Content wall

2

App wall

3

News feed

4

Chat list

5 Carousel
6 Content stream
7 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

1

Paid search units

2 Recommendation widgets
3 Promoted listings
4 In-Ad (IAB standard) with native element units
5 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

1

Content-centric context such as newsfeed, article, image gallery, or video gallery.

2 Social-centric context such as social network feed, email, or chat.
3 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

10

General or mixed content

11 Primarily article content
12 Primarily video content
13 Primarily audio content
14 Primarily image content
15 User-generated content through forums, comments, or other sources
20 General social content such as a general social network
21 Primarily email content
22 Primarily chat or IM content
30 Content focused on selling digital or physical products
31 Application store or marketplace
32 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

1

In the feed of the content such as an item inside a feed, grid, listing, or carousel.

2

In the atomic unit of the content such as in the article page or single image page.

3

Outside the core content such as in the ad's section on the right rail or as a banner-style placement near the content.

4

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

1

icon

Icon image. It is recommended to use a 1:1 aspect ratio.

2

logo

Logo image for the brand or app. This type ID was removed in version 1.2 of the native ads specification.

3

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.

Type ID Name Description Format

1

sponsored

Sponsored by message where the response should contain the brand name of the sponsor. A maximum of 25 characters is allowed.

text

2

desc

Descriptive text associated with the product or service being advertised. A maximum of 90 characters is allowed.

text

3

rating

Rating of the product being offered to the user. A rating of 0-5 is recommended.

number formatted as string
4

likes

Number of social ratings or likes. This asset type is not currently used. number formatted as string

5

downloads

Number of downloads or installs of the product. This asset type is not currently used.

number formatted as string

6

price

Price of the product . A maximum of 15 characters is allowed.

number formatted as string

7

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

8

phone

The phone number. This asset type is not currently used.

number formatted as a string

9

address

The address. This asset type is not currently used.

text

10

desc2

Additional descriptive text. This asset type is not currently used.

text
11

displayurl

Display URL for the text ad. This asset type is not currently used. text

12

ctatext

Desired user action. A maximum of 15 characters is allowed.

text

List of supported event types

Type ID Name Description

1

impression

This is an impression.

2

viewable-mrc50

Visible impression using Media Rating Council (MRC) definition at 50% in view for one second.
This event type is not currently supported.

3

viewable-mrc100

100% in view for one second (GroupM standard). This event type is not currently supported.

4

viewable-video50

Visible impression for video using MRC definition at 50% in view for two seconds. This event type is not currently supported.

555

omid

This is for OMID tracking.

List of supported event tracking methods

Type ID Name Description

1

img

Image-pixel tracking. The URL provided will be inserted as a 1x1 pixel at the time of the event.

2

js

JavaScript-based tracking. The URL provided will be inserted as a js tag at the time of the event.