Emplifi: Most-used fields

The table below gives information about most-used fields that you can import from Emplifi. 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
attachments.{NUM}.attachments.{NUM}.description	attachments.{NUM}.attachments.{NUM}.description	Description or caption of the attachment associated with a social media post. This provides context or details about the attached content.	dimension
attachments.{NUM}.attachments.{NUM}.image_url	attachments.{NUM}.attachments.{NUM}.image_url	URL pointing to an image attachment associated with a social media post, allowing direct access to the image content.	dimension
attachments.{NUM}.attachments.{NUM}.title	attachments.{NUM}.attachments.{NUM}.title	The title of a nested attachment within a carousel ad or a complex media post. This is particularly relevant for Facebook Ads that feature carousel formats, where each card in the carousel can have its own title.	dimension
attachments.{NUM}.attachments.{NUM}.type	attachments.{NUM}.attachments.{NUM}.type	The type of attachment associated with a social media post, such as ‘image,’ ‘video,’ or ‘link,’ categorizing the content.	dimension
attachments.{NUM}.attachments.{NUM}.url	attachments.{NUM}.attachments.{NUM}.url	The URL of an attachment associated with a social media post, such as a link to an image, video, or external content.	dimension
attachments.{NUM}.description	attachments.{NUM}.description	The description of a sub-attachment within a main attachment, such as for an item in a carousel or other multi-content posts.	dimension
attachments.{NUM}.image_url	attachments.{NUM}.image_url	The URL of an image associated with a post or an attachment within a post. This field appears in various post types (e.g., Facebook, Instagram, Pinterest, TikTok, Snapchat) and also for Facebook Ads to provide the image URL of the creative.	dimension
attachments.{NUM}.title	attachments.{NUM}.title	The title of an attachment associated with a post or ad.	dimension
attachments.{NUM}.type	attachments.{NUM}.type	The type of content for an attachment, such as ‘photo’, ‘video’, or ‘link’.	dimension
attachments.{NUM}.url	attachments.{NUM}.url	The URL associated with an attachment, linking to the content described by the attachment.	dimension
author.name	author.name	The name of the author or profile associated with the content.	dimension
author.url	author.url	The URL of the author or profile associated with the content.	dimension
channel.id	channel.id	The unique identifier for the YouTube channel associated with a video.	dimension
channel.name	channel.name	The name of the YouTube channel associated with a video.	dimension
channel.url	channel.url	The URL of the YouTube channel associated with a video.	dimension
comments	comments	The total number of comments received on a social media post.	metric
comments_sentiment.negative	comments_sentiment.negative	The total number of negative sentiment comments for a post.	metric
comments_sentiment.neutral	comments_sentiment.neutral	The total number of neutral sentiment comments for a post.	metric
comments_sentiment.positive	comments_sentiment.positive	The total number of positive sentiment comments for a post.	metric
content	content	The main text or description content of the social media post.	dimension
content_type	content_type	The specific type of content for a social media post (e.g., post, story, video).	dimension
created_time	created_time	The date and time when the content was created or uploaded.	dimension
date	date	Represents the date associated with the collected data, used for temporal aggregation and filtering.	dimension
date.month	date.month	A dimension representing the month in which the data was collected or aggregated.	metric
description	description	A textual description of a video, content collection, or asset.	dimension
engagement_rate	engagement_rate	The rate at which content or an ad receives interactions. For posts, it is calculated as the average number of interactions per fan. For Facebook Ads, it represents the rate at which an ad receives interactions.	metric
fans_change	fans_change	The absolute change in the total number of fans (likes) for a page or profile.	metric
fans_lifetime	fans_lifetime	The total number of fans (likes) a page or profile has accumulated over its lifetime.	metric
ff_ratio	ff_ratio	The ratio of total followers to total following for a Twitter profile.	metric
followers_change	followers_change	The absolute change in the number of followers for a profile or page across platforms like Instagram, Twitter, LinkedIn, and Pinterest.	metric
followers_lifetime	followers_lifetime	The total number of followers a profile or page has accumulated over its lifetime across platforms like Instagram, Twitter, LinkedIn, and Pinterest.	metric
following_change	following_change	The absolute change in the number of profiles or users that a given account is following.	metric
following_lifetime	following_lifetime	The total number of profiles or users that a given account follows over its lifetime.	metric
grade	grade	A grade score assigned to a post, indicating its performance or quality.	dimension
hidden	hidden	Indicates whether the social media post has been hidden.	dimension
id	id	A unique identifier for various entities such as profiles, posts, labels, or ads.	dimension
insights_clicks	insights_clicks	The total number of clicks received on a post or an advertisement during its lifetime.	metric
insights_comments	insights_comments	The total number of comments received on a post or video during its lifetime.	metric
insights_content_impressions	insights_content_impressions	The total number of times content was viewed or displayed on a social media platform during its lifetime.	metric
insights_engaged_users	insights_engaged_users	The number of unique people who clicked anywhere in your posts or engaged with your page.	metric
insights_engagement	insights_engagement	The total number of times users engaged with a post, story, or video during its lifetime.	metric
insights_engagement_by_engagement_type.comments	insights_engagement_by_engagement_type.comments	The number of comments received as a specific breakdown of the total engagements for a post.	metric
insights_engagement_by_engagement_type.likes	insights_engagement_by_engagement_type.likes	The number of likes received as a specific breakdown of the total engagements for an Instagram post.	metric
insights_engagement_by_engagement_type.saves	insights_engagement_by_engagement_type.saves	The number of saves received as a specific breakdown of the total engagements for an Instagram post.	metric
insights_engagements	insights_engagements	The total number of times users engaged with posts or content from a profile or with a specific post, including likes, comments, and shares.	metric
insights_fans_lifetime	insights_fans_lifetime	The total number of fans or followers a profile or page has accumulated over its lifetime.	metric
insights_followers	insights_followers	The total number of followers for a user profile by day.	metric
insights_impressions	insights_impressions	The total number of times any content associated with a page or post has been seen.	metric
insights_impressions_28_days	insights_impressions_28_days	The total number of times posts and stories from a profile were viewed in the past 28 days.	metric
insights_impressions_7_days	insights_impressions_7_days	The total number of times posts and stories from a profile were viewed in the past 7 days.	metric
insights_impressions_engagement_rate	insights_impressions_engagement_rate	The percentage of users who engaged with a post or content, relative to the total number of impressions it received.	metric
insights_interactions	insights_interactions	The sum of reactions, comments, and shares on a social media post.	metric
insights_media_views	insights_media_views	The total number of times media content (videos, images, stories, reels, gifs) was viewed or displayed to a user across various platforms.	metric
insights_post_clicks	insights_post_clicks	The number of clicks on all the content published on your page or on elements within your posts without generating an activity.	metric
insights_post_impressions	insights_post_impressions	The total number of times all posts from a page or profile have been viewed.	metric
insights_post_reach	insights_post_reach	The number of unique people who saw any of the posts from a page or profile.	metric
insights_reach	insights_reach	The number of unique people who have seen any content associated with a page or post.	metric
insights_reach_28_days	insights_reach_28_days	The number of unique people who have seen any content associated with a page or profile in the past 28 days.	metric
insights_reach_7_days	insights_reach_7_days	The number of unique people who have seen any content associated with a page or profile in the past 7 days.	metric
insights_reach_by_post_attribution	insights_reach_by_post_attribution	The number of people who saw your post, broken down by post attribution (e.g., paid, organic, viral).	dimension
insights_reach_by_post_attribution.organic	insights_reach_by_post_attribution.organic	The number of people who saw your post through organic reach.	metric
insights_reach_by_post_attribution.paid	insights_reach_by_post_attribution.paid	The number of people who saw your post through paid reach.	metric
insights_reach_by_post_attribution.viral	insights_reach_by_post_attribution.viral	The number of people who saw your post through viral reach.	metric
insights_reach_engagement_rate	insights_reach_engagement_rate	The percentage of users who engaged with a post or page given its reach.	metric
insights_reactions	insights_reactions	The total number of reactions on any of your content.	metric
insights_saves	insights_saves	The number of times an Instagram post has been saved by unique users.	metric
insights_video_views	insights_video_views	The total number of times a video content has been viewed for a specified duration (e.g., 3+ seconds, 2+ seconds, 30+ seconds depending on platform).	metric
insights_video_views_complete	insights_video_views_complete	The number of times a video has been viewed for about 95% of its length.	metric
insights_view_time	insights_view_time	The total amount of time that users watched a video during its lifetime, across supported social media platforms. This metric is available for individual posts and aggregated data. For LinkedIn, it includes views shorter than 3 seconds.	dimension
insights_views	insights_views	The total number of times a social media page or profile has been viewed by both logged-in and logged-out users.	metric
interactions	interactions	The sum of reactions, comments, and shares on a social media post.	metric
interactions_per_1k_fans	interactions_per_1k_fans	The interaction count for every 1000 fans or followers.	metric
likes	likes	The total number of likes received on a post or video.	metric
media_type	media_type	The specific type of media used in a social media post (e.g., video, photo, link).	dimension
network	network	The social media network or platform where the content was published or the profile is active.	dimension
number_of_comments	number_of_comments	The total number of comments received on aggregated page posts.	metric
origin	origin	The source of the content, indicating whether it originated from a user (User-Generated Content) or the brand (Brand’s Content).	dimension
page.id	page.id	The unique identifier of the social media page.	dimension
page.name	page.name	The name of the social media page.	dimension
page.url	page.url	The URL of the social media page.	dimension
page_posts	page_posts	The total number of posts published by a page or profile.	metric
page_replies	page_replies	The total number of replies made by a Twitter profile.	dimension
page_shares	page_shares	The total number of times content was retweeted or shared by a page or profile.	dimension
post_labels	post_labels	Content labels assigned to a post, video, or message for categorization and filtering.	dimension
post_labels.{NUM}.id	post_labels.{NUM}.id	The unique identifier of a content label assigned to the post.	dimension
post_labels.{NUM}.name	post_labels.{NUM}.name	The name of a content label assigned to the post.	dimension
profile	profile	An object containing details about the social media profile, such as its ID, name, and URL.	dimension
profile_id	profile_id	The unique identifier of the social media profile associated with the content or metric.	dimension
profile_insights_enabled	profile_insights_enabled	Indicates whether insights metrics are available for the social media profile.	dimension
profile_labels	profile_labels	A list of labels assigned to the social media profile for categorization or filtering.	dimension
profile_name	profile_name	The unique name of the profile on the social network.	dimension
profile_picture	profile_picture	The URL of the profile picture on the social network.	dimension
profile_timezone	profile_timezone	The timezone configured for this profile within the Emplifi product.	dimension
profile_tweets	profile_tweets	The total number of original tweets (excluding replies and retweets) posted by a Twitter profile.	metric
published	published	Indicates whether the social media post is published.	dimension
reactions	reactions	The total number of reactions received on a social media post.	metric
reactions_by_type.anger	reactions_by_type.anger	The total number of ‘anger’ reactions received on a Facebook post or ad.	metric
reactions_by_type.haha	reactions_by_type.haha	The total number of ‘haha’ reactions received on a Facebook post or ad.	metric
reactions_by_type.like	reactions_by_type.like	The total number of ‘like’ reactions received on a Facebook post or ad.	metric
reactions_by_type.love	reactions_by_type.love	The total number of ‘love’ reactions received on a Facebook post or ad.	metric
reactions_by_type.sorry	reactions_by_type.sorry	The total number of ‘sorry’ reactions received on a Facebook post or ad.	metric
reactions_by_type.wow	reactions_by_type.wow	The total number of ‘wow’ reactions received on a Facebook post or ad.	metric
sentiment	sentiment	The overall sentiment of the social media post, comment, or care case (e.g., positive, neutral, negative).	dimension
sentiment_manual_auto	sentiment_manual_auto	The breakdown of sentiment (Positive, Negative, or Neutral) for all comments associated with posts. This metric is designed to be used with the sentiment dimension to provide insights into the overall emotional tone.	metric
shares	shares	The total number of times a post or ad has been shared on its platform.	metric
url	url	A direct URL to the social media post, profile, or associated content.	dimension
user_posts	user_posts	The total number of incoming posts from users directed to a page or profile.	metric
user_posts_average_response_time	user_posts_average_response_time	The average time taken to respond to incoming user posts on a page or profile.	dimension
user_posts_responded	user_posts_responded	The number of incoming user posts (excluding those from administrators) that have received a response from the page or profile.	dimension
user_posts_response_rate	user_posts_response_rate	The ratio of responded user posts to the total number of incoming user posts.	metric
user_questions	user_questions	The total number of incoming page posts identified as questions from users.	dimension
user_questions_average_response_time	user_questions_average_response_time	The average time taken to respond to incoming user questions on a page or profile.	dimension
user_questions_responded	user_questions_responded	The number of incoming user questions (excluding those from administrators) that have received a response from the page or profile.	dimension
user_questions_response_rate	user_questions_response_rate	The ratio of responded user questions to the total number of incoming user questions.	dimension
video_view_time	video_view_time	The total accumulated time, in seconds, that a video has been watched.	metric
video_views	video_views	The total number of times a video has been viewed.	metric