X Ads Fields
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 |
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 |