> ## Documentation Index
> Fetch the complete documentation index at: https://docs.adriel.com/llms.txt
> Use this file to discover all available pages before exploring further.

# How to connect

> How to connect the X (Twitter) Ads data source to Adriel: authorize an X account, select an ad account, and import campaigns and conversions.

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

<Steps>
  <Step title="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.
  </Step>

  <Step title="Select the ad account">
    On the data source settings, choose the **Ad Accounts** to connect.
  </Step>

  <Step title="Submit">
    Click **Submit** to complete the connection. Initial data availability can take up to one business day.
  </Step>
</Steps>

## 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](/data-sources/o-z/x-twitter-ads/data-reference).

## Troubleshooting

<AccordionGroup>
  <Accordion title="Not all ad sets are appearing">
    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.
  </Accordion>

  <Accordion title="Some conversion metrics show zero">
    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.
  </Accordion>

  <Accordion title="Ad names appear as full tweet text">
    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.
  </Accordion>

  <Accordion title="Token expired or revoked">
    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.
  </Accordion>
</AccordionGroup>

## Related

<CardGroup cols={2}>
  <Card title="X (Twitter) Ads data reference" href="/data-sources/o-z/x-twitter-ads/data-reference">
    Metrics, breakdowns, conversion sub-types, and limits for X (Twitter) Ads.
  </Card>

  <Card title="X (Twitter) Ads FAQs" href="/data-sources/o-z/x-twitter-ads/faqs">
    Common questions and expected behaviors for the X (Twitter) Ads data source.
  </Card>

  <Card title="How to connect X (Twitter) Organic" href="/data-sources/o-z/x-twitter-organic/how-to-connect">
    Connect owned X account analytics.
  </Card>
</CardGroup>