Once you’ve authenticated Twitter Ads Twitter Premium, or Twitter Public Data, you’re ready to create your first query. This guide will walk you through how to set up your first query in any of these data sources in Google Sheets, Data Studio, and Excel, as well as data warehouse destinations like Google Cloud Storage, BigQuery, and the Supermetrics API.
Before you begin
Twitter Ads
To connect Supermetrics to Twitter Ads, you need:
- Campaign Analyst access to an ad account. Some dimensions may require Ad Manager access. Learn how to grant ad account access.
Twitter Premium
To connect Supermetrics to Twitter Premium, you need:
- A valid account.
- Twitter Premium is available only with an Enterprise-level license. Contact our sales team if you'd like to talk about connecting it.
Note that Twitter Premium doesn't support multi-account logins or agency access. The API doesn't allow you to fetch data from multiple user accounts with one login — you'll need to add each user account separately.
Tweet historical
Twitter Premium has some rate-limited features. One of these is a cap on pulling data for Tweets that are more than 90 days old.
You can remove this cap with Supermetrics' Tweet historical feature, which offers media view, media engagement, URL clicks and more report types on Tweets older than 90 days. Start a conversation with our sales team if you'd like to add this feature to your license.
Available fields
Visit our documentation site for a full list of the metrics and dimensions Supermetrics can pull from the data source. You can find the full list of data sources on the left side of the page.
- Field label is the name that appears in the sidebar.
- Metrics can be found under type - “met”.
- Dimensions can be found under type - “dim” .
Instructions
- Authenticate the data source in Google Sheets.
- Select Dates. Choose one date range (today, yesterday, last week, etc.). To select a custom date, you can insert the date manually in the Start and End fields in the calendar bar.
- Select Metrics.
- Select Split by Dimensions. You can choose to split your data into rows and/or columns, reflect the number of rows or columns to be fetched, and define how the data is sorted.
- Click Get Data to Table to create your query and pull your data.
Advanced options for Google Sheets
- You can filter your data by selecting the field, operator, and value to filter by. Learn more about filters.
- Under Options, you can add additional features to your query.
- Replace blank metric values with zeros.
- Combine new results with old.
- Format results for Data Studio (to import data from Google Sheets to Data Studio).
- No header row.
- Highlight values with colours (green, red, etc.).
- Advanced settings.
- Authenticate the data source in Data Studio.
- Under Dimension, select Dimensions.
- Under Metric, select Metrics.
- Select how to sort the data.
- Select the Date range from the auto or custom options. If you choose a custom date range, click the arrow on the top-right hand side. Under a specific period, select a Start Date and End Date.
Advanced options for Data Studio
You can filter your data by selecting the field, condition, and value to filter by. Learn more about using filters.
- Authenticate the data source in Excel.
- Select Dates. Choose one date range (today, yesterday, last week, etc.). To select a custom date, you can insert the date manually in the Start and End fields in the calendar bar.
- Select Metrics.
- Select Split by Dimensions. You can choose to split your data into rows and/or columns, reflect the number of rows or columns to be fetched, and define how the data is sorted.
- Click Get data to create your query and pull your data.
Advanced options for Excel
- You can filter your data by selecting the field, operator, and value to filter by. Learn more about filters.
- Under Options, you can add additional features to your query. Learn more about Supermetrics advanced settings in Excel.
Explore our guides to set up data transfers to various destinations.
- Set up BigQuery
- Set up data warehouse and cloud storage products (Amazon S3, Google Cloud Storage, Snowflake, Azure Storage, or Azure Synapse)
- Set up the Supermetrics API
Troubleshooting
- If you see an error about metrics and dimensions not fetching together, or fields being incompatible, follow these steps to fix the issue.
- If you see errors relating to quotas, or “daily query quotas”, read this guide.