CreatorIQ: Most-used fields#
The table below gives information about most-used fields that you can import from CreatorIQ. 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 |
|---|---|---|---|
AverageViewDuration |
AverageViewDuration |
The average length of time (in seconds) that viewers watched a video or streamed content. This is a common video performance metric. |
dimension |
AvgStreamConcurrentViews |
AvgStreamConcurrentViews |
The average number of concurrent viewers during a live stream. |
dimension |
BaseMetricValue |
BaseMetricValue |
The value of the primary metric used for campaign performance measurement, such as followers or views. |
dimension |
CampaignId |
CampaignId |
Unique identifier for a marketing campaign. |
dimension |
CampaignName |
CampaignName |
The name given to an influencer marketing campaign. |
dimension |
CampaignStatus |
CampaignStatus |
The current operational status of the marketing campaign. |
dimension |
Clicks |
Clicks |
The total number of clicks on content, links, or calls to action. |
metric |
Comments |
Comments |
The total number of comments received on a social media post. |
metric |
ConversionMetrics |
ConversionMetrics |
Key performance indicators that measure the effectiveness of a campaign in achieving specific goals, such as sales, sign-ups, or leads. |
dimension |
ConversionMetricsByMonth |
ConversionMetricsByMonth |
Conversion metrics aggregated on a monthly basis, providing insights into conversion performance over time. |
dimension |
ConversionMetricsByPostType |
ConversionMetricsByPostType |
Conversion metrics categorized by the type of content post (e.g., image, video, story), allowing analysis of which content formats drive the most conversions. |
dimension |
ConversionMetricsList |
ConversionMetricsList |
A collection of various conversion-related metrics associated with campaign activities or individual posts. |
dimension |
Dislikes |
Dislikes |
The total number of dislikes received on a piece of content. |
metric |
EarnedMedia |
EarnedMedia |
The value of media generated through organic influencer activity, not directly paid for. |
dimension |
EndDate |
EndDate |
The end date of the influencer marketing campaign or a post’s activity period. |
dimension |
Engagement |
Engagement |
A measure of audience interaction with content (e.g., likes, comments, shares). |
dimension |
EngagementRate |
EngagementRate |
A metric indicating the level of interaction users have with content, calculated based on various engagement metrics like likes, comments, and shares relative to reach or impressions. |
dimension |
EstimatedImpressions |
EstimatedImpressions |
An estimated number of times a post was displayed. This is often an approximation used in campaign planning or reporting. |
metric |
EstimatedImpressionsFlag |
EstimatedImpressionsFlag |
Indicates if the impression count is an estimated value rather than an exact measurement. |
metric |
EstimatedReach |
EstimatedReach |
An estimated number of unique users who saw the post. This is often an approximation used in campaign planning or reporting. |
metric |
EstimatedReachFlag |
EstimatedReachFlag |
Indicates if the reach count is an estimated value rather than an exact measurement. |
metric |
Exits |
Exits |
The number of times users exited a stream or content. |
dimension |
ExtendedReach |
ExtendedReach |
The total audience reached, including secondary exposure beyond the initial audience. |
dimension |
FacebookComments |
FacebookComments |
The total number of comments received on a Facebook post. |
dimension |
FacebookLikes |
FacebookLikes |
The total number of likes received on a Facebook post. |
dimension |
FacebookShares |
FacebookShares |
The total number of shares a Facebook post received. |
dimension |
Follows |
Follows |
The number of new followers gained directly from a post or interaction. |
dimension |
IGBaseMetricValue |
IGBaseMetricValue |
The value of the base metric specific to Instagram. |
dimension |
IGCombinedBaseMetricValue |
IGCombinedBaseMetricValue |
The combined base metric value for Instagram, encompassing both organic and paid activity. |
dimension |
IGCombinedEngagement |
IGCombinedEngagement |
The total engagement from Instagram content, combining organic and paid interactions. |
dimension |
IGEngagement |
IGEngagement |
The total engagement for an Instagram post, including interactions like likes and comments. |
dimension |
IGPaidBaseMetricValue |
IGPaidBaseMetricValue |
The base metric value for Instagram content specifically attributed to paid campaigns. |
dimension |
IGPaidEngagement |
IGPaidEngagement |
The engagement generated on Instagram posts through paid promotional efforts. |
dimension |
Id |
Id |
The unique identifier for a specific entity, such as a post within a campaign. |
dimension |
InstagramShares |
InstagramShares |
The number of times an Instagram post was shared, for example, through direct messages. |
dimension |
Likes |
Likes |
The total number of ‘likes’ or positive reactions received on a social media post. |
metric |
LinkClicks |
LinkClicks |
The total number of times a link within the post was clicked by users. |
metric |
LinkClicksByLabel |
LinkClicksByLabel |
The number of clicks on trackable links, categorized or filtered by specific labels associated with those links. |
dimension |
LinkClicksByMonth |
LinkClicksByMonth |
The total number of clicks on tracked links, aggregated by month, providing insight into monthly user engagement with campaign links. |
dimension |
LinkClicksByPostType |
LinkClicksByPostType |
The total number of clicks on tracked links, categorized by the type of content post, helping to identify which content types generate the most link engagement. |
dimension |
LinkClicksNumberOfDestinations |
LinkClicksNumberOfDestinations |
The count of unique URLs or destinations that were clicked through tracking links, indicating the diversity of traffic driven by a campaign. |
metric |
MinutesWatched |
MinutesWatched |
The total duration, in minutes, that users spent watching video content. |
dimension |
NetworkImpressions |
NetworkImpressions |
The total number of impressions across the entire social network for a post. Note: This field is marked for deprecation in the CreatorIQ API. |
dimension |
NetworkViews_next |
NetworkViews_next |
The total number of views across the entire social network, using the updated ‘views_next’ metric. This field replaces older ‘Views’ metrics. |
dimension |
OneTimeFollowers |
OneTimeFollowers |
The number of new followers gained during the campaign period. |
dimension |
OneTimeReach |
OneTimeReach |
The number of unique users reached during the campaign for the first time. |
metric |
PaidMediaStats |
PaidMediaStats |
A collection of metrics related to the performance of paid media campaigns. |
dimension |
PeakStreamConcurrentViews |
PeakStreamConcurrentViews |
The highest number of concurrent viewers observed at any point during a live stream. |
dimension |
PinterestShares |
PinterestShares |
The total number of times a Pinterest post (Pin) was shared or re-pinned. |
dimension |
Post |
Post |
The actual content of the social media post being tracked in a campaign. |
dimension |
PostId |
PostId |
The unique identifier assigned to a specific post on the social network. |
dimension |
PostLink |
PostLink |
The direct URL or permalink to the social media post. |
dimension |
PostType |
PostType |
The category or format of the social media post (e.g., image, video, story, tweet). |
dimension |
Posts |
Posts |
The individual pieces of content published by an influencer as part of a campaign. This includes various post types such as photos, videos, or reels, and is a core component of campaign activity data. |
metric |
ProfileVisits |
ProfileVisits |
The number of times users clicked to view the associated profile from the post. |
dimension |
PublisherId |
PublisherId |
The unique identifier for the publisher (influencer or content creator) associated with the campaign activity. |
dimension |
PublisherName |
PublisherName |
The name of the publisher (influencer or content creator) who created the post. |
dimension |
Reach |
Reach |
The number of unique users who saw the post or content. |
metric |
Replies |
Replies |
The total number of replies to content or comments. |
dimension |
Retweets |
Retweets |
The total number of times a Twitter post was retweeted. |
dimension |
Saves |
Saves |
The number of times a post was saved or bookmarked by users, common on platforms like Instagram and Pinterest. |
dimension |
SocialMediaValue |
SocialMediaValue |
The monetary value attributed to social media activity and engagement. |
dimension |
SocialNetwork |
SocialNetwork |
The social media platform where the post was published (e.g., Instagram, Facebook, YouTube). |
dimension |
StartDate |
StartDate |
The start date of the influencer marketing campaign or a post’s activity period. |
dimension |
Status |
Status |
The current status of a campaign post, such as ‘Published’. |
dimension |
SwipeUps |
SwipeUps |
The number of times users swiped up on a call-to-action link in content, typically in Instagram Stories. |
dimension |
TotalReach |
TotalReach |
The total number of unique users who saw the content across all platforms or a specific campaign. |
metric |
TotalShares |
TotalShares |
The total number of times a piece of content (post) has been shared across social media platforms within a campaign. This is a per-post performance metric. |
dimension |
TotalViewTime |
TotalViewTime |
The cumulative duration, in seconds, that users spent watching video content. |
dimension |
TwitterShares |
TwitterShares |
The total number of times a Twitter post (Tweet) was shared or retweeted. |
dimension |
UserName |
UserName |
The username of the content creator on the respective social media network. |
dimension |
Views |
Views |
The number of times content was viewed. This field is a metric. |
dimension |
Views_next |
Views_next |
The updated and current total number of views for a post or video content. This field replaces older ‘Views’ metrics. |
metric |
Votes |
Votes |
The number of votes received on a post, often related to interactive content or polls. |
dimension |