Skip to main content
X (Twitter) Ads is X’s paid advertising platform, used to promote tweets, accounts, trends, and app-install campaigns across the X timeline, search, and profile placements. Connecting it brings ad accounts, campaigns, ad sets, and ads into Adriel dashboards alongside impressions, clicks, billed engagements, spend, video metrics, and X Pixel conversion events for both web and mobile (MMP) tracking.

​
Before you connect

The following are required:
  • An X account with admin access to the X Ads account being connected.
  • An active, approved X Ads account in X Ads Manager.
  • A live X Pixel, if conversion data should flow into dashboards.

​
Connect X (Twitter) Ads

1

Authorize an X account

On the Data Sources page, search for X (Twitter) Ads and select it. Click Authorize app to grant Adriel access to the X account, using an account with admin access to the target ad accounts.
2

Select the ad account

On the data source settings, choose the Ad Accounts to connect.
3

Submit

Click Submit to complete the connection. Initial data availability can take up to one business day.

​
What gets imported

The connector imports the full campaign hierarchy (ad account → campaign → ad set → ad), standard performance metrics, engagement metrics (likes, retweets, replies, follows, unfollows, media engagements, poll card votes), video metrics, and conversion data from the X Pixel covering both web and mobile (MMP) events. For the complete metric list including nested conversion sub-types, breakdown coverage, and known limitations, see the X (Twitter) Ads data reference.

​
Troubleshooting

When an X Ads account has more ad sets than fit in one API page, the connector currently raises a pagination error. This is rare but should be reported when seen.
X exposes conversion metrics nested by attribution sub-type (post view, post engagement, order quantity, sale amount, and a general metric value). The general metric value is intentionally skipped for every conversion event except purchases, so any non-purchase event with that sub-type selected will be empty.
When an ad lacks an explicit name, the fallback chain uses the tweet card name, then the tweet name (if not “Untitled”), and finally the full tweet text. Tweet-style ads can therefore surface with the full tweet text as the ad name.
OAuth 1.0a tokens do not auto-expire but can be revoked. Reconnect via Connections → X (Twitter) Ads → Reconnect and authorize again with the same X account.

X (Twitter) Ads data reference

Metrics, breakdowns, conversion sub-types, and limits for X (Twitter) Ads.

X (Twitter) Ads FAQs

Common questions and expected behaviors for the X (Twitter) Ads data source.

How to connect X (Twitter) Organic

Connect owned X account analytics.