X (Twitter) Ads
Vendo syncs X Ads performance data, including promoted tweet metrics, campaign hierarchy and ad spend.
Last reviewed September 15, 2026
Source: Vendo imports daily ad performance data from X (formerly Twitter) Ads. The data includes promoted tweet metrics, the campaign and line item hierarchy, and ad spend with currency conversion.
What Vendo Syncs
Ad Performance Data
Vendo imports daily ad-level metrics through the X Ads Async Analytics API:
| Metric | Description |
|---|---|
| Impressions | Total ad impressions |
| Clicks | Ad clicks (URL clicks) |
| Spend | Ad spend converted from micro-units to account currency |
Dimensions
| Dimension | Description |
|---|---|
| Account ID | X Ads advertiser account ID |
| Promoted Tweet ID | Individual ad identifier |
| Campaign ID & Name | Campaign-level grouping |
| Line Item ID & Name | Line item-level grouping |
| Destination URL | Landing page or card URL |
| Report Date | Date of performance data |
Geo (DMA) Performance
The Geo (DMA) Performance stream imports daily promoted tweet performance for each Nielsen Designated Market Area (DMA). Vendo imports this breakdown on a best-effort basis, so it can be incomplete.
| Field | Description |
|---|---|
dma | DMA name |
dma_code | Nielsen DMA code |
impressions | Ad impressions |
clicks | Ad clicks |
cost_source, cost_reporting | Spend in the account currency and in your reporting currency |
UTM Parameters
Vendo extracts UTM parameters from destination URLs:
utm_sourceutm_mediumutm_campaign(if it is not set, Vendo uses the campaign name)utm_termutm_content
Vendo sets utm_source_platform to x.
For more information, see UTM Tracking.
Authentication
X Ads uses OAuth 1.0a. You log in to X and authorize Vendo. Vendo uses its own X developer app to start the connection.
Setup
- In the Vendo app, go to Apps and click Add App.
- Select X Ads from the catalog.
- Log in to X and authorize access to your ad accounts.
- In Ads Account, select the ad account to sync.
- Set your reporting currency and sync schedule.
Platform Details
| Setting | Value |
|---|---|
| Ad Platform | X (Twitter) Ads |
| API | X Ads API v12 (entities), v9 (async analytics) |
| Sync Method | Async analytics jobs with polling |
| Reporting Granularity | Daily, by promoted tweet |
| Entity Hierarchy | Campaign > Line Item > Promoted Tweet |
| Click ID Parameter | None (UTM-based attribution) |
Currency Conversion
X reports ad spend in micro-units (billed_charge_local_micro). Vendo converts it automatically:
- Vendo divides the micro-units by 1,000,000 to get the amount in the source currency.
- Vendo converts the source currency to your reporting currency with daily exchange rates.
Data Freshness & Backfill
Vendo imports daily performance rows on the schedule of the source. If you request a historical window, Vendo processes it during onboarding. X Ads keeps analytics for about 60 days, so Vendo imports only the last 59 days.
Verify Setup
- Make sure that the X Ads source status is active in Vendo.
- Make sure that ad metrics appear in your destination or BigQuery export.
- Make sure that campaign names and line item names have values.