# Twitter Ads

> Social media advertising platform for X (formerly Twitter)

Twitter Ads shows you campaign impressions and engagement metrics, but understanding which promoted tweets drive actual revenue or how social spend compares to other channels requires connecting payment data, analytics tools, and your CRM.

Filament links Twitter Ads performance to your revenue and customer data, turning cross-platform questions about attribution and ROI into plain English queries with instant answers.

## Data we sync

- **Campaigns**: Track campaign structure and settings with campaign_id, name, funding_instrument_id, daily_budget_amount_local_micro, total_budget_amount_local_micro, and start_time. (`campaign_id`, `name`, `funding_instrument_id`, `daily_budget_amount_local_micro`, `total_budget_amount_local_micro`, `start_time`)
- **Ad Groups (Line Items)**: Monitor ad group performance and targeting with line_item_id, campaign_id, name, bid_amount_local_micro, target_cpa_local_micro, and placements. (`line_item_id`, `campaign_id`, `name`, `bid_amount_local_micro`, `target_cpa_local_micro`, `placements`)
- **Promoted Tweets**: Analyze creative performance with promoted_tweet_id, line_item_id, tweet_id, approval_status, and created_at. (`promoted_tweet_id`, `line_item_id`, `tweet_id`, `approval_status`, `created_at`)
- **Campaign Performance Metrics**: Measure campaign results with impressions, clicks, engagements, spend_micro, video_views, and app_clicks by date and campaign. (`impressions`, `clicks`, `engagements`, `spend_micro`, `video_views`, `app_clicks`)
- **Ad Group Performance Metrics**: Track line item efficiency with cost_per_engagement, cost_per_click, engagement_rate, conversion_purchases, and conversion_custom by ad group. (`cost_per_engagement`, `cost_per_click`, `engagement_rate`, `conversion_purchases`, `conversion_custom`)
- **Conversion Tracking**: Monitor conversion events with conversion_event, conversion_time, post_view_conversions, post_engagement_conversions, and attributed_revenue. (`conversion_event`, `conversion_time`, `post_view_conversions`, `post_engagement_conversions`, `attributed_revenue`)
- **Mobile App Conversions**: Measure app performance with mobile_conversion_installs, mobile_conversion_purchases, mobile_conversion_re_engages, and mobile_conversion_lifetime_value_purchases. (`mobile_conversion_installs`, `mobile_conversion_purchases`, `mobile_conversion_re_engages`, `mobile_conversion_lifetime_value_purchases`)
- **Accounts and Funding**: Track account structure and billing with account_id, funding_instrument_id, currency, funded_amount_local_micro, and billing_type. (`account_id`, `funding_instrument_id`, `currency`, `funded_amount_local_micro`, `billing_type`)
- **Media Creative Assets**: Organize creative content with media_key, media_url, media_type, tweet_text, and card_uri for promoted content. (`media_key`, `media_url`, `media_type`, `tweet_text`, `card_uri`)

## How do I connect Twitter Ads?

You need access to an active X Ads account with **Account Admin**, **Ad Manager** or **Campaign Analyst** permissions through multi-user login; delegate access is different. The account must contain at least one campaign and one promotable user.

1. Open [Apps](https://filamentanalytics.com/apps) in Filament and add **Twitter Ads**.
2. Use the standard OAuth connection. Select **Authorize**, sign in to X and select **Authorize app**.
3. Choose **Sync All Accounts**, or **Sync Specific Accounts** and select those to include.
4. Select how many months of reporting history to import.
5. Select **Save & Test**, then return to Filament and complete setup.
