X Analytics (formerly Twitter Analytics) is a powerful data source that provides valuable insights into your X account's performance, audience engagement, and tweet activity. This guide will walk you through the process of setting up X Analytics as a data source in Power My Analytics, creating reports, and understanding key metrics and limitations.

Prerequisites

• An X Ads account is required to connect your X Analytics account to Power My Analytics
• Your account with X Ads must have an active X Premium subscription (blue checkmark)

To create an X Ads account:

1. Go to ads.x.com and click Sign in.
   
2. Log in to your X account.
   

Individual tweet data will only be accessible starting from the date your ad account was created.

Adding X Analytics as a Data Source

1. Make sure you are logged in to the X account you want to connect as a data source.
2. Navigate to your Hub and select Sources from the menu.
3. Click + Add new source and choose X Analytics from the gallery.
4. Sign in to your X account to authenticate and authorize Power My Analytics to access your account.
   • If the X authorization popup shows an X account other than the one you want to connect, log out of that account and log into the X account you're trying to connect.

Creating a Data Studio Report

Follow these steps to create a Data Studio report using your X Analytics data:

1. After adding X Analytics as a data source in the PMA hub, navigate to Reports > Data Studio
2. Select X Analytics under Create Data Studio Report (this will open the official Data Studio application in a new window)
3. Google Data Studio Configuration:
   • Step 1:
     • Name your data source (e.g., "X Analytics - Organization Name")
     • Choose your Power My Analytics hub from the dropdown
     • Optional: Leave "Use report template for new reports" checked to use the PMA demo template
     • Click Next
   • Step 2:
     • User Account: Select your X Analytics account (real data) or "Sample Account" (sample data)
     • Click Next
   • Step 3:
     • Click Connect (top right) to complete the data source configuration
   • Step 4:
     • Click Create Report (top right)
     • Include "today" in your report's date range to begin historical data storage

For a quick start, use our pre-built X Analytics demo template.

Key Reports and Fields

Here are some popular X Analytics metrics you can use in your reports:

• Key Performance Metrics: Tweets, Likes, Retweets, Followers, Tweet Like Count, Tweet Retweet count
• Tweet Metrics: Tweet Like Count, Tweet Retweet count, Reply Count, Quote Count

For a complete list of available X Analytics fields in Power My Analytics, refer to the Schema Explorer.

Limitations and Important Considerations

• Cached Data Requests with Unique Metrics and Date Dimension: When a unique metric is paired with the date dimension, this will result in a request for cached data instead of a request for live data. For more information, please see Understanding Cached and Live Data Requests.
• Backfilling: An initial backfill of 24 months of data will be performed when you first connect your X Analytics account as a data source.
• Lifetime metrics: The fields Followers, Following, Likes, Tweets, and Lists are lifetime values and cannot be backfilled.
• Ad account creation date: Individual tweet data is only available starting from the date your X Ads account was created.
• Organic metrics: Organic metrics are only accurate if they are less than 30 days old. After 30 days, no new data will be collected for these fields.

Unavailable Data

• Impressions
• Clicks
• Realtime data
• Custom fields

Troubleshooting

See our article Basic Troubleshooting for information on issues that may affect the X Analytics connector.