X Ads Metrics and Breakdowns
This page provides a comprehensive reference of all supported metrics and breakdowns available for X (Twitter) Ads data extraction through Adzviser.
Metrics
Core Performance
| Field Name | Description |
|---|---|
| Impressions | Number of times ads were shown |
| Cost | Total amount spent (billed) |
| CPM | Cost per thousand impressions |
| Clicks | Total number of clicks |
| URL clicks | Clicks on URLs |
| CTR | Click-through rate |
| CPC | Cost per click |
Reach & Frequency
| Field Name | Description |
|---|---|
| Total audience reach | Total unique audience reached |
| Average frequency | Average times each user saw ad |
Engagement
| Field Name | Description |
|---|---|
| Engagements | Total engagement actions |
| Engagements (billed) | Billable engagements |
| Cost per engagement (CPE) | Cost per engagement |
| Engagements rate (%) | Engagement rate percentage |
| Likes (paid) | Paid likes |
| Retweets | Retweet actions |
| Replies | Reply actions |
| Follows | Follow actions |
| Followers | Total followers gained |
| Followers rate (%) | Follower acquisition rate |
| Cost per follower (CPF) | Cost per follower |
| Card engagements | Card engagement actions |
Media Metrics
| Field Name | Description |
|---|---|
| Media views | Total media views |
| Media view rate | Media view rate |
| Media engagements | Media engagement actions |
| Qualified impressions | Qualified ad impressions |
Video Metrics
| Field Name | Description |
|---|---|
| Video views | Total video views |
| Video view rate (%) | Video view rate |
| Cost per video view | Cost per video view |
| Video CTA clicks | Video call-to-action clicks |
| 3s/100% video views | 3-second or 100% views |
| 6s video views | 6-second video views |
| 15s video views | 15-second video views |
| Video starts | Video start events |
| Video views (25% complete) | Views reaching 25% |
| Video views (50% complete) | Views reaching 50% |
| Video views (75% complete) | Views reaching 75% |
| Video views (completed) | Views reaching 100% |
Web Conversions
| Field Name | Description |
|---|---|
| Conversions | Website visit conversions |
| Conversion rate (%) | Website conversion rate |
| Site visits | Website visits |
| Sign-ups | Website sign-ups |
| Downloads | Website downloads |
| Purchases | Website purchases |
| Order quantity | Purchase order quantity |
| Sale amount | Purchase sale amount |
| Custom conversions | Custom conversion events |
| Cost per acquisition | Cost per acquisition |
App Metrics
| Field Name | Description |
|---|---|
| App installs | Mobile app installs |
| App clicks | App click actions |
| App click rate (%) | App click rate |
| App install rate (%) | App install rate |
| Cost per app click (CPAC) | Cost per app click |
| Cost per install (CPI) | Cost per app install |
Lead Generation
| Field Name | Description |
|---|---|
| Leads | Lead card engagements |
| Lead rate (%) | Lead generation rate |
| Cost per lead | Cost per lead |
Mobile Conversion Events
| Field Name | Description |
|---|---|
| Mobile conversion installs | Mobile app installs |
| Mobile conversion achievements unlocked | Achievement unlocks |
| Mobile conversion add to cart | Add to cart events |
| Mobile conversion added payment infos | Payment info additions |
| Mobile conversion add to wishlist | Add to wishlist events |
| Mobile conversion checkout initiated | Checkout initiations |
| Mobile conversion content views | Content view events |
| Mobile conversion invites | Invite events |
| Mobile conversion level achieved | Level achievements |
| Mobile conversion logins | Login events |
| Mobile conversion purchases | Purchase events |
| Mobile conversion re-engages | Re-engagement events |
| Mobile conversion sign ups | Sign-up events |
| Mobile conversion rated | Rating events |
| Mobile conversion reservations | Reservation events |
| Mobile conversion searches | Search events |
| Mobile conversion shares | Share events |
| Mobile conversion spent credits | Credit spend events |
| Mobile conversion tutorial completes | Tutorial completions |
| Mobile conversion updates | Update events |
Promoted Account Metrics
| Field Name | Description |
|---|---|
| Follows (promoted act) | Promoted account follows |
| Follow rate (promoted act) | Promoted account follow rate |
| Impressions (promoted act) | Promoted account impressions |
| Profile visits (promoted act) | Promoted account profile visits |
| Carousel swipes | Carousel card swipes |
| Match rate | Match rate |
| Percentage | Percentage |
| Tweet retweets | Tweet retweets |
| Likes (paid+organic) | Likes (paid+organic) |
| Impressions (profile) (deprecated) | Impressions (profile) (deprecated) |
| Mobile conversion installs post view | Mobile conversion installs post view |
| Mobile conversion installs post engagement | Mobile conversion installs post engagement |
| Mobile conversion achievement unlocked breakdown | Mobile conversion achievement unlocked breakdown |
| Mobile conversion add to cart breakdown | Mobile conversion add to cart breakdown |
| Mobile conversion add to wishlist breakdown | Mobile conversion add to wishlist breakdown |
| Mobile conversion added payment infos breakdown | Mobile conversion added payment infos breakdown |
| Mobile conversion checkout initiated breakdown | Mobile conversion checkout initiated breakdown |
| Mobile conversion content views breakdown | Mobile conversion content views breakdown |
| Mobile conversion installs breakdown | Mobile conversion installs breakdown |
| Mobile conversion invites breakdown | Mobile conversion invites breakdown |
| Mobile conversion level achieved breakdown | Mobile conversion level achieved breakdown |
| Mobile conversion logins breakdown | Mobile conversion logins breakdown |
| Mobile conversion order quantity | Mobile conversion order quantity |
| Mobile conversion purchases breakdown | Mobile conversion purchases breakdown |
| Mobile conversion rated breakdown | Mobile conversion rated breakdown |
| Mobile conversion re-engages breakdown | Mobile conversion re-engages breakdown |
| Mobile conversion reservations breakdown | Mobile conversion reservations breakdown |
| Mobile conversion sale amount | Mobile conversion sale amount |
| Mobile conversion searches breakdown | Mobile conversion searches breakdown |
| Mobile conversion shares breakdown | Mobile conversion shares breakdown |
| Mobile conversion mobile conversion sign ups breakdown | Mobile conversion mobile conversion sign ups breakdown |
| Mobile conversion spent credits breakdown | Mobile conversion spent credits breakdown |
| Mobile conversion tutorial completes breakdown | Mobile conversion tutorial completes breakdown |
| Mobile conversion updates breakdown | Mobile conversion updates breakdown |
| Mobile conversion lifetime value purchases | Mobile conversion lifetime value purchases |
| Mobile conversion lifetime value sign ups | Mobile conversion lifetime value sign ups |
| Mobile conversion lifetime value updates | Mobile conversion lifetime value updates |
| Mobile conversion lifetime value tutorials completed | Mobile conversion lifetime value tutorials completed |
| Mobile conversion lifetime value reservations | Mobile conversion lifetime value reservations |
| Mobile conversion lifetime value add to carts | Mobile conversion lifetime value add to carts |
| Mobile conversion lifetime value add to wishlists | Mobile conversion lifetime value add to wishlists |
| Mobile conversion lifetime value checkouts initiated | Mobile conversion lifetime value checkouts initiated |
| Mobile conversion lifetime value levels achieved | Mobile conversion lifetime value levels achieved |
| Mobile conversion lifetime value achievements unlocked | Mobile conversion lifetime value achievements unlocked |
| Mobile conversion lifetime value shares | Mobile conversion lifetime value shares |
| Mobile conversion lifetime value invites | Mobile conversion lifetime value invites |
| Mobile conversion lifetime value payment info additions | Mobile conversion lifetime value payment info additions |
| Mobile conversion lifetime value spent credits | Mobile conversion lifetime value spent credits |
| Mobile conversion lifetime value rates | Mobile conversion lifetime value rates |
Breakdowns
Account Level
| Field Name | Description |
|---|---|
| Account | Account name |
| Account ID | Unique account identifier |
Campaign Level
| Field Name | Description |
|---|---|
| Campaign | Campaign name |
| Campaign ID | Unique campaign identifier |
| Campaign creation date | Campaign creation date |
| Campaign start date | Campaign start date |
| Campaign end date | Campaign end date |
| Campaign servable | Whether campaign is servable |
| Campaign status | Campaign status |
| Campaign deleted | Whether campaign is deleted |
| Campaign currency | Campaign currency |
| Campaign standard delivery | Standard delivery setting |
| Campaign total budget | Total budget amount |
| Campaign daily budget | Daily budget amount |
| Campaign budget optimization | Budget optimization setting |
| Campaign paused | Whether campaign is paused |
Funding Instrument Level
| Field Name | Description |
|---|---|
| Funding instrument ID | Funding instrument ID |
| Funding instrument description | Description |
| Funding instrument type | Type of funding |
| Funding instrument status | Status |
| Funding instrument currency | Currency |
| Funding instrument start date | Start date |
| Funding instrument end date | End date |
| Funding instrument credit limit | Credit limit |
| Funding instrument funded amount | Funded amount |
| Funding instrument credit remaining | Remaining credit |
Ad Group (Line Item) Level
| Field Name | Description |
|---|---|
| Ad group | Ad group name |
| Ad group ID | Unique ad group identifier |
| Ad group objective | Ad group objective |
| Ad group goal | Ad group goal |
| Ad group product type | Product type |
| Ad group placements | Placement settings |
| Ad group charge by | Charge type |
| Ad group bid type | Bid type |
| Ad group bid amount | Bid amount |
| Ad group total budget | Total budget |
| Ad group creation date | Creation date |
| Ad group start date | Start date |
| Ad group end date | End date |
| Ad group status | Status |
| Advertiser domain | Advertiser domain |
Tweet Level
| Field Name | Description |
|---|---|
| Tweet ID | Unique tweet identifier |
| Tweet ad ID | Promoted tweet ad ID |
| Tweet creation date | Tweet creation date |
| Ad name | Ad/tweet name |
| Tweet name | Tweet name |
| Tweet text | Full tweet text |
| Tweet source | Tweet source |
| Tweet type | Type of tweet |
| Tweet language | Tweet language |
| Tweet hashtags | Hashtags used |
| Tweet mentions | User mentions |
| Link to tweet | URL to tweet |
| Tweet first URL | First URL in tweet |
| Tweet card title | Card title |
| Tweet card type | Card type |
| Tweet card destination URL | Card destination |
| Tweet destination URL | Tweet destination URL |
| Tweet media type | Media type |
UTM Parameters
| Field Name | Description |
|---|---|
| Source (utm) | UTM source parameter |
| Medium (utm) | UTM medium parameter |
| Content (utm) | UTM content parameter |
| Term (utm) | UTM term parameter |
| Campaign (utm) | UTM campaign parameter |
Segmentation Breakdowns
| Field Name | Description |
|---|---|
| Age | Age segment |
| Gender | Gender segment |
| Country | Country location |
| Country code | Country code |
| Region | Region location |
| City | City location |
| Platform | Device platform |
| Language | Language segment |
| Interest | Interest category |
| Keyword | Keyword targeting |
| Audience | Audience segment |
| App store category | App store category |
| Conversion tag | Conversion tag |
| Event | Event type |
| Similar to follower | Similar to followers |
| TV show | TV show targeting |
| Reasons funding instrument was not able to fund | Reasons funding instrument was not able to fund |
| Insertion order header ID | Insertion order header ID |
| Ad group primary web event tag | Ad group primary web event tag |
| Ad group deleted | Ad group deleted |
| Ad group Categories | Ad group Categories |
| Ad group include sentiment | Ad group include sentiment |
| Ad group paused | Ad group paused |
| Ad group automatically select bid | Ad group automatically select bid |
| Ad group optimization | Ad group optimization |
| Ad group tracking tags | Ad group tracking tags |
| Tweet scheduled status | Tweet scheduled status |
| Tweet scheduled at | Tweet scheduled at |
| Tweet symbols | Tweet symbols |
| Tweet card name | Tweet card name |
| Tweet card image URL | Tweet card image URL |
| Tweet card image | Tweet card image |
| Tweet card URI | Tweet card URI |
| Tweet card display URL | Tweet card display URL |
| Tweet card ID | Tweet card ID |
| Media creative ID | Media creative ID |
| Media creative creation date | Media creative creation date |
| Media creative type | Media creative type |
| Media name | Media name |
| Media url | Media url |