Nielsen Ad Intel: Most-used fields

The table below gives information about most-used fields that you can import from Nielsen Ad Intel. Other fields might also be available in Adverity.

The fields that you can fetch in Adverity are updated regularly to reflect updates to data source APIs.

API name	Adverity UI name	Description	Use in Adverity
Advertiser	advertiser	The company or entity that is placing the advertisement. This field is used as a filter in both Creative and Spend Reports.	dimension
AdvertisingSite	advertising_site	The specific website or digital platform where the advertisement was displayed.	dimension
BannerFormat	banner_format	The specific format or layout of a digital banner advertisement.	dimension
BannerSize	creative_bannersize	The dimensions (width and height) of a digital banner advertisement.	dimension
BannerType	creative_bannertype	The category or type of a digital banner advertisement (e.g., static, animated, rich media).	dimension
Brand	brand	The specific brand being advertised within the creative. This field is used as a filter in both Creative and Spend Reports.	dimension
Channel	channel	The specific broadcast or publication channel where the advertisement appeared. This field is used in the ‘ChannelSpendList’ for the Spend Report.	dimension
CostEUR	creative_cost_eur	The estimated cost of the creative’s placement in Euros. This field is explicitly mentioned as an occurrence in the Creative Report.	metric
Country	country	The country where the advertisement was displayed or broadcast.	dimension
CreativeReference	creative_reference	A unique identifier or reference code assigned to the creative.	metric
CreativeUrl	creative_url	The URL directly linking to the creative asset or its source.	dimension
Date	date	The date associated with the advertising event or data record.	dimension
EventDate	creative_event_date	The date component when the creative event occurred. This field is used in date-scoping filters for the Creative Report.	dimension
EventDateTime	creative_event_datetime	The combined date and time when the advertising event related to the creative occurred. This field is explicitly mentioned as an occurrence in the Creative Report and used for date-scoping filters.	dimension
EventTime	creative_event_time	The time component when the creative event occurred.	dimension
Extension	media_extension	The file extension of the creative media file (e.g., jpg, mp4).	dimension
FileType	media_file_type	The type of the creative media file, such as image, video, or audio.	dimension
GfkAdBreak	creative_gfk_ad_break	An identifier for a specific advertising break as categorized by GfK.	dimension
Market	market	The geographical or commercial market where the advertisement was placed. This field is used as a dimension in the Spend Report and within sector filters for the Creative Report.	dimension
Media	media	The broad category of media through which the advertisement was delivered (e.g., TV, Digital, Print, Radio).	dimension
Product	product	The specific product associated with the advertisement. This field is used as a filter in both Creative and Spend Reports.	dimension
PublicationChannel	creative_publication_channel	The specific channel within a media type where the creative was published (e.g., a particular TV station, website, or magazine title). This field is explicitly mentioned as an occurrence in the Creative Report.	dimension
PublicationType	creative_publication_type	The general type of publication (e.g., ‘Newspaper’, ‘Magazine’, ‘Website’) where the creative was displayed.	dimension
Publisher	creative_publisher	The entity or organization responsible for publishing or broadcasting the advertisement.	dimension
Sector	sector	The industry sector to which the advertiser belongs. This field is used as a filter in both Creative and Spend Reports.	dimension
StaticDynamic	static_dynamic	Indicates whether the creative is static (e.g., a fixed image) or dynamic (e.g., animated, video, or interactive).	dimension
SubMarket	sub_market	A more granular classification within a market sector. This field is used within sector filters for the Creative Report.	dimension
Title	title	The title or headline of the creative content.	dimension
VirtualDirectoryPath	media_file_path	The virtual directory path where the creative media file is stored.	dimension
WebCategory	creative_web_category	The classification of the website or online content where the creative was displayed.	dimension
ad_class	AdClass	Classification or category of the advertisement.	metric
ad_type	AdType	The specific type or format of the advertisement.	metric
advertiser	Advertiser	The company or entity responsible for the advertisement. This field can also be used as a filter in both Creative and Spend Reports.	metric
advertising_site	AdvertisingSite	The specific website or platform where the advertisement was displayed.	metric
banner_format	BannerFormat	The layout or structural format of a banner advertisement.	metric
brand	Brand	The brand associated with the advertisement. This field is available in the Spend Report data.	metric
channel	Channel	The specific medium or platform through which the advertisement was delivered, such as TV, digital, print, or radio.	metric
country	Country	The country where the advertisement was aired or displayed.	metric
creative_bannersize	BannerSize	The dimensions (e.g., width x height) of a banner advertisement.	metric
creative_bannertype	BannerType	The specific classification of a banner advertisement, e.g., static, animated.	metric
creative_colour_bw	Colourbw	Indicates whether the creative content is in color or black and white.	metric
creative_computed_volume	ComputedVolume	The calculated volume or size associated with the creative, representing its overall presence or impact.	metric
creative_cost_eur	CostEUR	The estimated cost of the creative in Euros.	metric
creative_daypart	DayPart	The specific time segment of the day (e.g., ‘morning’, ‘prime time’) during which an ad was aired or published.	metric
creative_event_date	EventDate	The date when the creative event (e.g., ad airing) occurred. This field can also be used as a filter in the Creative Report.	metric
creative_event_datetime	EventDateTime	The specific date and time when the creative event (e.g., ad airing) occurred. This field can also be used as a filter in the Creative Report.	metric
creative_event_time	EventTime	The specific time when the creative event occurred.	metric
creative_gfk_ad_break	GfkAdBreak	Identifies the GfK-specific ad break in which the creative was placed.	metric
creative_impressions	Impressions	The total number of times an ad creative appeared or was viewed by an audience.	metric
creative_next_programme	NextProgramme	The name of the television or radio program scheduled immediately after the ad placement.	metric
creative_page_equivalent	PageEquivalent	The equivalent space the creative occupies, often expressed in terms of pages for print media.	metric
creative_page_number	PageNumber	The page number within a publication where the creative appeared.	metric
creative_percentage_found	PercentageFound	The percentage indicating how frequently a specific creative was identified or detected within the monitored media.	metric
creative_position	Position	The placement position of the creative within the media where it appeared.	metric
creative_position_in_ad_break	PositionInAdBreak	The sequential position of the creative within a television or radio advertising break.	metric
creative_previous_programme	PreviousProgramme	The name of the television or radio program scheduled immediately before the ad placement.	metric
creative_publication_channel	PublicationChannel	The specific channel of publication (e.g., magazine, newspaper, TV channel) where the creative appeared.	metric
creative_publication_group	PublicationGroup	The categorization or group to which the publication belongs where the creative was displayed.	metric
creative_publication_half	PublicationHalf	Indicates whether the creative appeared in the first or second half of a print publication.	metric
creative_publication_quarter	PublicationQuarter	Indicates whether the creative appeared in a specific quarter of a print publication.	metric
creative_publication_type	PublicationType	The general category of publication (e.g., print, digital, broadcast).	metric
creative_publisher	Publisher	The entity responsible for publishing the creative.	metric
creative_reference	CreativeReference	A unique identifier or reference code for the creative.	metric
creative_section	Section	The specific section of a publication (e.g., ‘News’, ‘Sports’) where the creative was placed.	metric
creative_space	Space	The allocated space or area used by the creative within the publication.	metric
creative_spots_in_ad_break	SpotsInAdBreak	The total number of advertising spots within a television or radio ad break.	metric
creative_url	CreativeUrl	The URL where the creative asset can be accessed or viewed.	metric
creative_web_category	WebCategory	The categorization of the website or digital platform where the creative was displayed.	metric
customfield_display_name	DisplayName	The user-friendly name for a custom field associated with an ad creative. Custom fields allow for capturing additional, flexible data points not covered by standard fields.	metric
customfield_name	FieldName	The programmatic or internal name of a custom field defined within the Nielsen Ad Intel API, used for identifying specific custom data points.	metric
customfield_value	Value	The actual value stored in a custom field for a particular ad creative. This provides the specific data captured for the defined custom field.	metric
date	Date	The date associated with the advertising event or data record.	metric
description	Description	A textual description providing details about the creative or an associated event.	metric
duration	Duration	The length of time the creative was displayed or broadcast, particularly for video or audio ads.	metric
end_line	EndLine	The concluding text or tagline of an advertisement.	metric
first_recorded_date	FirstRecordedDate	The earliest date when the creative was observed and recorded by Nielsen Ad Intel.	metric
incentives	Incentives	Information about any promotional offers or incentives included in the creative.	metric
landing_page	LandingPage	The URL of the destination page that users are directed to after clicking a digital creative.	metric
last_recorded_date	LastRecordedDate	The most recent date when the creative was observed and recorded by Nielsen Ad Intel.	metric
market	Market	The specific geographical or demographic market where the advertisement was targeted. This field is available in the Spend Report data.	metric
media	Media	The type of media (e.g., TV, digital, print, radio) used for the advertisement. This field is available in both Creative and Spend Reports.	metric
media_agency	MediaAgency	The media agency responsible for planning and purchasing media placements for the advertisement.	metric
media_agency_group	MediaAgencyGroup	The larger corporate group to which the media agency belongs.	metric
media_extension	Extension	The file extension of the media asset (e.g., .jpg, .mp4).	metric
media_file_path	VirtualDirectoryPath	The virtual directory path where the media file for the creative is stored.	metric
media_file_type	FileType	The specific type of media file (e.g., image, video, audio).	metric
media_thumbnail	Thumbnail	A small preview image or graphic representing the creative content. This field is explicitly available in the Creative Report.	metric
nielsen_code	NielsenCode	A unique identification code assigned by Nielsen to an ad creative. This field is available in the Creative Report data.	metric
postcode	Postcode	The postal code associated with the location where the advertisement was displayed or targeted.	metric
product	Product	The specific product being advertised. This field is available in the Spend Report data.	metric
sector	Sector	The industry sector to which the advertiser or product belongs. This field is available in the Spend Report data and can be used as a filter in both Creative and Spend Reports.	metric
static_dynamic	StaticDynamic	Indicates whether the creative is static (unchanging) or dynamic (interactive/changing).	metric
story_line	StoryLine	A brief narrative or plot summary of the creative content.	metric
sub_market	SubMarket	A more granular subdivision of the primary market.	metric
target_page	TargetPage	The specific page number or digital URL that the advertisement directs to or appears on.	metric
title	Title	The main title or headline of the advertisement. This field is available in the Creative Report data.	metric
translation_description	TransDescription	A translated version of the advertisement’s description, available within the Creative Report’s ‘Translations’ data.	metric
translation_end_line	TransEndLine	A translated version of the advertisement’s concluding text or tagline, available within the Creative Report’s ‘Translations’ data.	metric
translation_title	TransTitle	A translated version of the advertisement’s main title, available within the Creative Report’s ‘Translations’ data.	metric
version	Version	The version identifier of the creative, indicating different iterations or variations.	metric