Spotwatch: Most-used fields

The table below gives information about most-used fields that you can import from Spotwatch. 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
ad_id	ad_id	A unique identifier for an advertisement. This ID is used to retrieve specific ad details or link broadcasts to their respective ads.	dimension
ad_image_url	ad_image_url	The URL or path to an image associated with the advertisement, such as a preview or grid image.	dimension
ad_media_url	ad_media_url	The URL to the media asset (e.g., video or image) associated with an advertisement.	dimension
block_channel	block_channel	The name of the broadcast channel where the ad block was aired.	dimension
block_finish	block_finish	The end time of the broadcast block.	dimension
block_genre	block_genre	The genre of the TV program within which the ad block was broadcast.	dimension
block_id	block_id	A unique identifier for the broadcast block, which contains one or more ad spots.	dimension
block_length	block_length	The total number of broadcasts (ad spots) within a specific broadcast block.	metric
block_program	block_program	The name of the TV program during which the ad block was broadcast.	dimension
block_region	block_region	The region code (e.g., country code) where the broadcast block was aired.	dimension
block_start	block_start	The start time of the broadcast block.	dimension
block_subgenre	block_subgenre	The subgenre of the TV program within which the ad block was broadcast.	dimension
blockindex	blockindex	The zero-based position of a specific broadcast within its corresponding broadcast block.	metric
brand	brand	The name of the advertised brand.	dimension
categories	categories	A list of categories associated with the advertisement (e.g., ‘telecommunication’).	dimension
date	date	The date component of various timestamps related to ad creation, last seen, or broadcast times. It is used to specify date ranges in API requests. This field is derived from API timestamp fields.	dimension
description	description	A short description of the advertised content.	dimension
duration	duration	The duration of the advertisement in seconds.	metric
nbroadcasts	nbroadcasts	The total number of times an ad has been broadcast.	metric
time	time	The exact start time of a broadcast, as provided by the ‘time’ field within a Broadcast object. By default, timestamps are in ISO 8601 format in UTC.	dimension