Twitter Ads Metrics and Dimensions

Field group
Field
Type
Data type
Description
PerformanceAmount spent
METRIC
MICRO_CURRENCYThe estimated total amount of money you've spent on your campaign, ad set or ad
PerformanceClicks
METRIC
INTEGERThe number of clicks
PerformanceLikes
METRIC
INTEGERThe number of people who liked your ad by clicking the heart button
PerformanceImpressions
METRIC
INTEGERThe amount of impressions for an ad
PerformanceCTR
METRIC
RATIOThe number of clicks your ad receives (Clicks) divided by the number of times your ad is shown (Impressions)
PerformanceTweets posted
METRIC
INTEGERTotal number of tweets posted, including quote tweets and tweets created with conversational cards
PerformanceRetweets
METRIC
INTEGERThe number of people that retweeted your ad by clicking the retweet button
PerformanceFollows
METRIC
INTEGERTotal number of followers generated from your tweet
PerformanceUnfollows
METRIC
INTEGERThe number of unfollows
PerformanceCPC
METRIC
CURRENCYThe average amount of money you have spent on a click
PerformanceCPM
METRIC
CURRENCYThe average amount of money you have spent per 1,000 impressions
PerformanceCost per app clicks
METRIC
CURRENCYTotal spend divided by the number of app clicks, including earned
Clicks (more)App clicks
METRIC
INTEGERTotal number of clicks to install or open your app. This includes earned clicks that you're not billed for
Clicks (more)App clicks rate
METRIC
RATIOTotal number of app clicks divided by impressions
Clicks (more)URL clicks
METRIC
INTEGERThis is the number of ad expansions divided by the number of times your ad is shown
EngagementsEngagements
METRIC
INTEGERTotal interactions with your Tweet, including Retweets, replies, likes, poll votes, hashtag clicks, and swipes. This includes earned interactions that you're not billed for
EngagementsEngagement rate
METRIC
RATIOTweet engagements divided by impressions. This helps you understand the rate of engagements with your ad
EngagementsCard engagements
METRIC
FLOATTotal number of card engagements
TimeYear
DIMENSION
YEARGroup results by year
TimeYear month
DIMENSION
YEARMONTHGroup results by Year and month, e.g., 2023-Jan
TimeYear month number
DIMENSION
YEAR_MONTH_NUMBERGroup results by Year and month number, e.g., 2023-01
TimeMonth
DIMENSION
MONTH_NAMEGroup results by Month of the year, e.g., January
TimeMonth number
DIMENSION
MONTHGroup results by Month as represented by the date of the first day of a month. Formatted as yyyy-MM-dd
TimeWeek number(sun - sat)
DIMENSION
WEEK_NUMBERGroup results by Week as defined as Monday through Sunday, and represented by the date of Monday. Formatted as yyyy-MM-dd
TimeWeek start date(sun - sat)
DIMENSION
WEEK_START_DATEStart date of the week. Formatted as yyyy-MM-dd. Week starts on Monday
TimeWeek number(mon - sun)
DIMENSION
WEEK_ISO_NUMBERGroup results by Week as defined as Monday through Sunday, and represented by the date of Monday. Formatted as yyyy-MM-dd
TimeWeek start date(mon - sun)
DIMENSION
WEEK_ISO_START_DATEStart date of the week. Formatted as yyyy-MM-dd. Week starts on Monday
TimeDate
DIMENSION
DATEGroup results by Date
AccountAccount name
DIMENSION
STRINGThe ad account name
AccountAccount ID
DIMENSION
STRINGThe unique ID for the ad account
AccountAccount timezone
DIMENSION
STRINGThe timezone of the ad account
CampaignCampaign name
DIMENSION
STRINGThe name of the campaign
CampaignCampaign ID
DIMENSION
STRINGThe unique ID for each campaign
CampaignCampaign status
DIMENSION
STRINGThe campaign status, with possible values ACTIVE, DRAFT, or PAUSED
CampaignCampaign created date
DIMENSION
DATETIMEThe date at which the campaign was created
CampaignCampaign updated date
DIMENSION
DATEThe date at which the campaign was updated
CampaignCampaign currency
DIMENSION
STRINGThe currency used for all spend-related metrics and billing
CampaignCampaign standard delivery
DIMENSION
BOOLEANGroup results by campaign created date
CampaignCampaign total budget
DIMENSION
MICRO_CURRENCYThe maximum amount you're willing to spend on each campaign for the duration of the campaign
CampaignCampaign daily budget
DIMENSION
MICRO_CURRENCYThe maximum amount you're willing to spend on each campaign on average per day
CampaignCampaign budget optimization
DIMENSION
STRINGType of the campaign budget optimization. Possible values - CAMPAIGN and LINE_ITEM
Ad GroupAd group name
DIMENSION
STRINGThe name of the Ad group
Ad GroupAd group ID
DIMENSION
STRINGThe ID of the Ad group
Ad GroupAd group status
DIMENSION
STRINGThe ad group status, with possible values ACTIVE, DRAFT, or PAUSED
Ad GroupAd group start date
DIMENSION
DATEThe date at which the ad group started
Ad GroupAd group end date
DIMENSION
DATEThe date at which the ad group ended
Ad GroupAd group created date
DIMENSION
DATETIMEThe date at which the ad group created
Ad GroupAd group updated date
DIMENSION
DATETIMEThe date at which the ad group updated
Ad GroupAd group objective
DIMENSION
STRINGThe objective of the Ad group
Ad GroupAd group goal
DIMENSION
STRINGThe optimization setting used for this ad group
Ad GroupAd group product type
DIMENSION
STRINGThe product type of the ad group
Ad GroupAd group bid amount
DIMENSION
MICRO_CURRENCYThe product type of the ad group
Ad GroupAd group total budget
DIMENSION
MICRO_CURRENCYThe maximum amount you are willing to spend on the ad group, for the duration of the ad group flight length. Formerly called line item total budget
Ad GroupAd group advertiser domain
DIMENSION
STRINGThe domain of the advertiser
Ad GroupPrimary web event tag
DIMENSION
STRINGThe domain of the advertiser
AdAd ID
DIMENSION
STRINGThe ID of the Ad
AdTweet ID
DIMENSION
STRINGThe ID of the tweet
AdAd status
DIMENSION
STRINGThe status of the ad
AdAd created date
DIMENSION
DATETIMEThe ad created date