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.
attachments.{NUM}.attachments.{NUM}.image_url Dimension
URL pointing to an image attachment associated with a social media post, allowing direct access to the image content.
attachments.{NUM}.attachments.{NUM}.type Dimension
The type of attachment associated with a social media post, such as 'image,' 'video,' or 'link,' categorizing the content.
attachments.{NUM}.attachments.{NUM}.url Dimension
The URL of an attachment associated with a social media post, such as a link to an image, video, or external content.
attachments.{NUM}.image_url Dimension
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.
attachments.{NUM}.type Dimension
The type of content for an attachment, such as 'photo', 'video', or 'link'.
attachments.{NUM}.url Dimension
The URL associated with an attachment, linking to the content described by the attachment.
author.name Dimension
The name of the author or profile associated with the content.
author.url Dimension
The URL of the author or profile associated with the content.
channel.id Dimension
The unique identifier of a YouTube channel.
channel.name Dimension
The name of a YouTube channel.
channel.url Dimension
The URL link to a YouTube channel.
comments Metric
The total number of comments received on a social media post.
comments_sentiment.negative Metric
The total number of negative sentiment comments for a post.
comments_sentiment.neutral Metric
The total number of neutral sentiment comments for a post.
comments_sentiment.positive Metric
The total number of positive sentiment comments for a post.
content Dimension
The main text or description content of the social media post.
content_type Dimension
The specific type of content for a social media post (e.g., post, story, video).
created_time Dimension
The date and time when the content was created or uploaded.
date Dimension
Represents the date associated with the collected data, used for temporal aggregation and filtering.
date.month Metric
A dimension representing the month in which the data was collected or aggregated.
description Dimension
The textual content providing details about a social media post, a video, or an attachment within a post (e.g., for a link, image, or video). It can also refer to the detailed information of an asset or a collection within the Emplifi content hub.
dislikes Metric
The number of dislikes for a YouTube video. Note: Dislike counts are no longer available as of December 13, 2021.
duration Metric
The length of a video in seconds, applicable to platforms like YouTube and TikTok.
engagement_rate Metric
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.
fans_change Metric
The absolute change in the number of fans for a Facebook page.
fans_lifetime Metric
The total number of likes, also known as fans, for a Facebook page.
ff_ratio Metric
The ratio of total followers to total following for a Twitter profile.
followers_change Metric
The absolute change in the number of followers for a profile or page across platforms like Instagram, Twitter, LinkedIn, and Pinterest.
followers_lifetime Metric
The total number of followers a profile or page has accumulated over its lifetime across platforms like Instagram, Twitter, LinkedIn, and Pinterest.
following_change Metric
The absolute change in the number of profiles or users that a given account is following.
following_lifetime Metric
The total number of profiles or users that a given account follows over its lifetime.
grade Dimension
A grade score assigned to a post, indicating its performance or quality.
hidden Dimension
Indicates whether the social media post has been hidden.
id Dimension
A unique identifier for various entities such as profiles, posts, labels, or ads.
insights_clicks Metric
The total number of clicks on a social media post during its lifetime.
insights_comments Metric
The total number of comments received on a social media post during its lifetime.
insights_content_impressions Metric
The total number of times content was viewed or displayed on a social media platform during its lifetime.
insights_engaged_users Metric
The number of unique people who clicked anywhere in your posts or engaged with your page.
insights_engagement Metric
The total number of times users engaged with a post, story, or video during its lifetime.
insights_engagement_by_engagement_type.comments Metric
The number of comments received as a specific breakdown of the total engagements for a post.
insights_engagement_by_engagement_type.likes Metric
The number of likes received as a specific breakdown of the total engagements for an Instagram post.
insights_engagement_by_engagement_type.saves Metric
The number of saves received as a specific breakdown of the total engagements for an Instagram post.
insights_engagements Metric
The total number of times users engaged with posts or content from a profile or with a specific post, including likes, comments, and shares.
insights_fans_lifetime Metric
The total number of fans or followers a social media profile has accumulated over its lifetime. This metric is used as a base for calculating engagement rates.
insights_followers Metric
The total number of followers for a user profile by day.
insights_impressions Metric
The total number of times any content associated with a page or post has been seen.
insights_impressions_28_days Metric
The total number of times posts and stories from a profile were viewed in the past 28 days.
insights_impressions_7_days Metric
The total number of times posts and stories from a profile were viewed in the past 7 days.
insights_impressions_engagement_rate Metric
The percentage of users who engaged with a social media post or content during its lifetime, calculated based on the total impressions received.
insights_interactions Metric
The sum of reactions, comments, and shares on a social media post.
insights_media_views Metric
The total number of times media content (videos, images, stories, reels, gifs) was viewed or displayed to a user across various platforms.
insights_post_clicks Metric
The number of clicks on all the content published on your page or on elements within your posts without generating an activity.
insights_post_impressions Metric
The total number of times content, such as a post, was seen by users across social media platforms. Note: This metric has deprecation notices for Facebook and Instagram, being replaced by media views.
insights_post_reach Metric
The number of unique users who saw a post on a social media page.
insights_reach Metric
The number of unique people who have seen any content associated with a page or post.
insights_reach_28_days Metric
The number of unique people who have seen any content associated with a page or profile in the past 28 days.
insights_reach_7_days Metric
The number of unique people who have seen any content associated with a page or profile in the past 7 days.
insights_reach_by_post_attribution Dimension
The number of people who saw your post, broken down by post attribution (e.g., paid, organic, viral).
insights_reach_by_post_attribution.organic Metric
The number of people who saw your post through organic reach.
insights_reach_by_post_attribution.paid Metric
The number of people who saw your post through paid reach.
insights_reach_by_post_attribution.viral Metric
The number of people who saw your post through viral reach.
insights_reach_engagement_rate Metric
The percentage of users who engaged with a post or page given its reach.
insights_reactions Metric
The total number of reactions on any of your content.
insights_saves Metric
The number of times an Instagram post has been saved by unique users.
insights_video_views Metric
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).
insights_video_views_complete Metric
The number of times a video has been viewed for about 95% of its length.
insights_view_time Dimension
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.
insights_views Metric
The number of times a social media page or profile has been viewed by users.
interactions Metric
The sum of reactions, comments, and shares on a social media post.
interactions_per_1k_fans Metric
The interaction count for every 1000 fans or followers.
likes Metric
The total number of likes received on a post or video.
media_type Dimension
The specific type of media used in a social media post (e.g., video, photo, link).
network Dimension
The social media network or platform where the content was published or the profile is active.
number_of_comments Metric
The total number of comments received on aggregated page posts.
origin Dimension
The source of the content, indicating whether it originated from a user (User-Generated Content) or the brand (Brand's Content).
page.id Dimension
The unique identifier of the social media page.
page.name Dimension
The name of the social media page.
page.url Dimension
The URL of the social media page.
page_posts Metric
The total number of posts published by a page or profile.
page_replies Dimension
The total number of replies made by a Twitter profile.
page_shares Dimension
The total number of times content was retweeted or shared by a page or profile.
post_labels Dimension
Content labels assigned to a post, video, or message for categorization and filtering.
post_labels.{NUM}.id Dimension
The unique identifier of a content label assigned to the post.
post_labels.{NUM}.name Dimension
The name of a content label assigned to the post.
profile Metric
An object containing details about the social media profile, such as its ID, name, and URL.
profile_id Dimension
The unique identifier of the social media profile associated with the content or metric.
profile_insights_enabled Dimension
Indicates whether insights metrics are available for the social media profile.
profile_labels Dimension
A list of labels assigned to the social media profile for categorization or filtering.
profile_name Dimension
The unique name of the profile on the social network.
profile_picture Dimension
The URL of the profile picture on the social network.
profile_timezone Dimension
The timezone configured for this profile within the Emplifi product.
profile_tweets Metric
The total number of original tweets (excluding replies and retweets) posted by a Twitter profile.
published Dimension
Indicates whether the social media post is published.
reactions Metric
The total number of reactions received on a social media post.
sentiment Dimension
The overall sentiment of the social media post, comment, or care case (e.g., positive, neutral, negative).
sentiment_manual_auto Metric
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.
shares Metric
The total number of times a post or ad has been shared on its platform.
subscribers_change Metric
The absolute daily change in the total subscriber count for a YouTube channel.
subscribers_lifetime Metric
The total number of subscribers for a YouTube channel.
url Dimension
A direct URL to the social media post, profile, or associated content.
user_posts Metric
The total number of incoming posts from users directed to a page or profile.
user_posts_average_response_time Dimension
The average time taken to respond to incoming user posts on a page or profile.
user_posts_responded Dimension
The number of incoming user posts (excluding those from administrators) that have received a response from the page or profile.
user_posts_response_rate Metric
The ratio of responded user posts to the total number of incoming user posts.
user_questions Dimension
The total number of incoming page posts identified as questions from users.
user_questions_average_response_time Dimension
The average time taken to respond to incoming user questions on a page or profile.
user_questions_responded Dimension
The number of incoming user questions (excluding those from administrators) that have received a response from the page or profile.
user_questions_response_rate Dimension
The ratio of responded user questions to the total number of incoming user questions.
video_view_time Metric
The total number of seconds a video was watched across its lifetime, including replays and views less than 3 seconds.
video_views Metric
The total number of times a video content has been viewed on a social media platform. The exact definition of a 'view' can vary by platform (e.g., 3+ seconds, playback starts, 2+ seconds).