CreatorIQ: Most-used fields

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

ActualImpressions

ActualImpressions

The actual number of times a post was displayed. Note: This field is marked for deprecation in the CreatorIQ API.

metric

ActualReach

ActualReach

The actual number of unique users who saw the post. Similar to ‘Reach’ which indicates unique accounts that saw the post.

metric

Age

Age

Demographic data representing the age of the audience or publisher. This is typically retrieved from publisher or audience data.

metric

AverageViewDuration

AverageViewDuration

The average length of time (in seconds) that viewers watched a video or streamed content. This is a common video performance metric.

metric

AverageViewPercentage

AverageViewPercentage

metric

AvgStreamConcurrentViews

AvgStreamConcurrentViews

metric

CampaignId

CampaignId

Unique identifier for a marketing campaign.

metric

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 a post, which may include clicks on links, profiles, or other elements.

metric

Comments

Comments

The total number of comments received on a social media post.

metric

Country

Country

Demographic data representing the country of the audience or publisher. This is typically retrieved from publisher or audience data.

dimension

Dislikes

Dislikes

The total number of dislikes received on a piece of content, typically for video platforms like YouTube.

metric

EarnedMedia

EarnedMedia

metric

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).

metric

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.

metric

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

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

metric

Exits

Exits

metric

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

FollowersAtTimeOfPost

FollowersAtTimeOfPost

The count of followers a social account had at the specific time a post was published.

metric

Follows

Follows

The number of new followers gained directly from a post or interaction.

dimension

IGCombinedEngagement

IGCombinedEngagement

The combined engagement metrics for an Instagram post, which may include various interactions like likes, comments, and shares.

metric

IGEngagement

IGEngagement

The total engagement for an Instagram post, including interactions like likes and comments.

metric

IGPaidEngagement

IGPaidEngagement

The engagement generated on Instagram posts through paid promotional efforts.

dimension

Id

Id

A generic unique identifier for an entity, which could be a post, publisher, or campaign depending on the context.

dimension

InstagramShares

InstagramShares

The number of times an Instagram post was shared, for example, through direct messages.

metric

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.

dimension

MinutesWatched

MinutesWatched

The total duration, in minutes, that users spent watching video content.

metric

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.

metric

NetworkPublisherId

NetworkPublisherId

metric

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.

metric

OneTimeFollowers

OneTimeFollowers

metric

OneTimeReach

OneTimeReach

metric

PartnerId

PartnerId

metric

PeakStreamConcurrentViews

PeakStreamConcurrentViews

metric

PinterestShares

PinterestShares

The total number of times a Pinterest post (Pin) was shared or re-pinned.

dimension

Post

Post

A general reference to a social media post, which can include various details and metrics.

dimension

PostId

PostId

A unique identifier for a specific social media post.

dimension

PostKey

PostKey

dimension

PostLink

PostLink

The URL of the social media post.

dimension

PostTitle

PostTitle

The title or caption associated with the social media post.

dimension

PostType

PostType

The type of social media post, e.g., video, image, story.

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.

metric

PublisherId

PublisherId

A unique identifier for the publisher (content creator/influencer).

metric

PublisherName

PublisherName

The name of the publisher (content creator/influencer).

dimension

Reach

Reach

The number of unique users who saw the post or content.

metric

Replies

Replies

The total number of replies or responses to a post, commonly used for conversational platforms like Twitter.

metric

Retweets

Retweets

The total number of times a Twitter post was retweeted.

metric

Saves

Saves

The number of times a post was saved or bookmarked by users, common on platforms like Instagram and Pinterest.

metric

SocialId

SocialId

metric

SocialNetwork

SocialNetwork

The social media platform where the post was published (e.g., Instagram, TikTok, YouTube).

dimension

SocialNetworkId

SocialNetworkId

The identifier for the social network where the post was published, e.g., ‘instagram’, ‘facebook’.

dimension

StartDate

StartDate

The start date of the influencer marketing campaign or a post’s activity period.

dimension

Status

Status

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.

metric

TotalViewTime

TotalViewTime

The cumulative duration, in seconds, that users spent watching video content.

metric

TwitterShares

TwitterShares

The total number of times a Twitter post (Tweet) was shared or retweeted.

dimension

UserName

UserName

The username of the social media account that published the post.

dimension

Views

Views

The number of times content was viewed. This field is a metric.

metric

ViewsUnique

ViewsUnique

The number of unique viewers for a video or content. Note: This field is marked for deprecation in the CreatorIQ API.

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

dimension