X (Twitter) Ads

Source — Vendo imports daily ad performance data from X (formerly Twitter) Ads, including promoted tweet metrics, campaign and line item hierarchy, and ad spend with currency conversion.

What Vendo Syncs

Ad Performance Data

Vendo imports daily ad-level metrics via 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 dollars

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

UTM Parameters

Vendo automatically extracts UTM parameters from destination URLs:

utm_source
utm_medium
utm_campaign (falls back to campaign name if not set)
utm_term
utm_content

The utm_source_platform is automatically set to x.

See UTM Tracking for details.

Authentication

X Ads uses OAuth 1.0a with permanent tokens. You need to generate credentials from the X Developer Portal :

Credential	Description
Consumer Key	API Key from your X Developer App
Consumer Secret	API Secret from your X Developer App
Access Token	OAuth 1.0a access token
Access Token Secret	OAuth 1.0a access token secret
Ad Account ID	Your X Ads advertiser account ID

Setup

In the Vendo app, navigate to Apps and click Add App
Select X (Twitter) from the integration catalog
Enter your OAuth 1.0a credentials:
- Consumer Key and Consumer Secret from your X Developer App
- Access Token and Access Token Secret generated for your app
- Ad Account ID from X Ads Manager
Vendo validates the credentials against the X Ads API
Configure 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

Ad spend is reported in micro-units (billed_charge_local_micro) and automatically converted:

Micro-units divided by 1,000,000 to get the source currency amount
Source currency converted to your reporting currency using daily exchange rates

Data Freshness & Backfill

Ad performance data syncs daily. Historical backfill is included during onboarding.

Verify Setup

Confirm the X Ads integration status is active in Vendo
Check that ad metrics appear in your destination or BigQuery export
Verify campaign names and line item names are populated

UTM Tracking