Awario: Most-used fields

The table below gives information about most-used fields that you can import from Awario. 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
Total Mentions	mentions	The total count of all social media and web mentions for a specific alert or query within a given period. This is an aggregated analytics metric.	metric
alert_id	alert_id	A unique identifier for the monitoring alert that collected the mentions or insights.	dimension
alert_name	alert_name	The name of the monitoring alert configured in Awario.	dimension
alert_type	alert_type	The type of monitoring alert, indicating whether it’s for mentions or leads.	dimension
countries_mentions	countries_mentions	The count of mentions originating from a specific country. This is an aggregated insight related to geographical distribution.	metric
countries_name	countries_name	The name of the country associated with aggregated social listening data, indicating geographic distribution of mentions.	dimension
date	date	The date when the social media mention was created or published.	dimension
end_date	end_date	The end date of the time period for which mentions or insights data is retrieved.	dimension
incomplete_period	incomplete_period	Indicates if the current time period for which insights are provided is incomplete (e.g., the current day, week, or month that has not fully passed).	dimension
mention_author_audience	mention_author_audience	The estimated audience size or reach of the author who published the mention, indicating their influence.	metric
mention_author_avatar	mention_author_avatar	The URL to the author’s avatar or profile picture.	dimension
mention_author_description	mention_author_description	A description of the author’s profile or bio, providing context about the person or entity making the mention.	dimension
mention_author_entities_name_highlighted_text_0_end_index	mention_author_entities_name_highlighted_text_0_end_index	The end index of the first highlighted text within the author’s name, indicating where a specific keyword or entity ends.	dimension
mention_author_entities_name_highlighted_text_0_start_index	mention_author_entities_name_highlighted_text_0_start_index	The start index of the first highlighted text within the author’s name, indicating where a specific keyword or entity begins.	dimension
mention_author_entities_name_highlighted_text_0_text	mention_author_entities_name_highlighted_text_0_text	The actual text that was highlighted within the author’s name, often corresponding to keywords being monitored.	dimension
mention_author_name	mention_author_name	The name or username of the author who published the social media mention.	dimension
mention_author_url	mention_author_url	The URL to the author’s profile or page on the respective social media platform or website.	dimension
mention_author_written_by	mention_author_written_by	The name of the author or contributor, often provided for mentions from news and blog sources.	dimension
mention_done	mention_done	A flag indicating whether the mention has been marked as ‘done’ or processed within the Awario platform.	dimension
mention_id	mention_id	A unique identifier for each individual social media mention.	dimension
mention_language	mention_language	The language in which the social media mention was written.	dimension
mention_location_country	mention_location_country	The country from which the social media mention originated or was geographically associated.	dimension
mention_location_latitude	mention_location_latitude	The geographical latitude coordinate associated with the mention’s location, if available.	metric
mention_location_longitude	mention_location_longitude	The geographical longitude coordinate associated with the mention’s location, if available.	metric
mention_reach	mention_reach	The potential visibility or audience reach of the social media mention.	metric
mention_sentiment	mention_sentiment	The sentiment of the mention, typically categorized as positive, neutral, or negative.	dimension
mention_snippet	mention_snippet	A short excerpt or snippet of the content of the social media mention.	dimension
mention_source	mention_source	The platform or source where the social media mention was found (e.g., Facebook, Twitter, news, blogs).	dimension
mention_starred	mention_starred	A flag indicating whether the mention has been marked as ‘starred’ or important within the Awario platform.	dimension
mention_title	mention_title	The title of the social media mention, often applicable to articles, blog posts, or web pages.	dimension
mention_url	mention_url	The direct URL to the social media mention or the web page where it was found.	dimension
mentions_count	mentions_count	The aggregated count of mentions for a given period or filter.	metric
project_id	project_id	A unique identifier for the project under which alerts are managed in Awario.	dimension
project_name	project_name	The name of the project associated with the alerts in Awario.	dimension
sentiment_negative	sentiment_negative	The count of mentions classified with a negative sentiment.	metric
sentiment_neutral	sentiment_neutral	The count of mentions classified with a neutral sentiment.	metric
sentiment_positive	sentiment_positive	The count of mentions classified with a positive sentiment.	metric
start_date	start_date	The start date of the time period for which mentions or insights data is retrieved.	dimension
timestamp	timestamp	The exact date and time (timestamp) when the social media mention was created or identified.	dimension
topic_cloud_mentions	topic_cloud_mentions	The count of mentions associated with a specific topic within the Topic Cloud.	metric
topic_cloud_name	topic_cloud_name	The name of a topic identified in the Topic Cloud, representing key themes in mentions.	dimension