List of references for native ads (Beta)

List of supported API frameworks

The values in this table are recommended in version 1.0 of the native ads specification and are deprecated in version 1.1.

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"

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.

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

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.

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.

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

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.

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.