Native Ad Matrix View

The programmatic Native & Search service for Ads provides you with methods for adding, updating, and retrieving ads, as described in the section below.

Definitions of ad types, such native standard, carousel and video app install, are also provided, with links to more detailed information and example use cases.

Matrix View of Required Fields

The following table is a matrix view of required fields when serving different ad types:

Ad Type Campaign-Channel Campaign-Objective Campaign-defaultLandingUrl Bid types Ad-imageUrl Ad-imageUrlHQ Ad-videoPrimaryUrl Assets Ad-mailAssetUrl Ad-imageUrlThumbnail Ad-videoPreviewStartTime
Search Ad Search, Search_and_Native VISIT_WEB   CPC              
Yahoo Mail Ad Native VISIT_WEB, MAIL_SPONSORED   CPC         required required  
Native Stream Ad Native, Search_and_Native VISIT_WEB, PROMOTE_BRAND   CPC, CPM required for CPM required for CPM          
Native Magazine Ad Native, Search_and_Native VISIT_WEB, PROMOTE_BRAND   CPC, CPM required required          
Video Ad (Native) Native PROMOTE_BRAND, VISIT_WEB   CPM, CPV, CPC required required required        
Video Ad (App Install) Native INSTALL_APP app store url CPC required required required        
Install App Native INSTALL_APP app store url CPC required required          
Reengage App Native REENGAGE_APP app store url CPC required required          
Native Carousel Ad Native VISIT_WEB, PROMOTE_BRAND   CPC, CPM required required   required      
Yahoo Mail Trailer Video Ad Native VISIT_WEB, MAIL_SPONSORED   CPV, CPC required required required     required recommended

Important

The programmatic Native & Search API does not rely explicitly on ad types, but rather on a combination of assets and objectives when targeting users and serving ads. This combination is based on campaign settings and objectives, targeting attributes and bid types, as well as landing page URLs, and other required fields used to serve Native & Search ads.

For more information on the Ad object, refer to Ad.