1. Help Center
  2. Data Source Guides

Guide: Using X (Twitter) Ads with Databox


How to connect X (Twitter) Ads to Databox


How to connect X (Twitter) Ads to Databox

twitter ads gif
To connect an X (Twitter) Ads) Account in Databox, go to Data Manager > + New connection. Type X (Twitter) Ads in the search bar and click on the green Connect button. 

This will open the Authorization window, which is where you will be prompted to enter your X (Twitter) Ads login credentials and authorize the Databox app. 

How much historical data is synced when you first connect X (Twitter) Ads to Databox?

When you connect a new X (Twitter) Ads Data Source in Databox, 24 months worth of historical data is initially synced. 

Certain Metrics may have more or less historical data available. For more information about the amount of historical data available for a specific Metric, please contact our Support Team at help@databox.com.

Pro Tip: Once your X (Twitter) Ads Data Source is connected and actively syncing data, we store the data that's collected in our own database. This allows us to accumulate more data over time as more data syncs are made so that you can report on more historical X (Twitter) Ads data in your Databox reports. Learn more here

What time zone does X (Twitter) Ads data sync in? 

X (Twitter) Ads data is synced in UTC. 

How to access pre-built X (Twitter) Ads Templates

  1. Navigate to Databoards > Public Templates
  2. In the Data Source drop-down list, select X (Twitter) Ads
  3. To view a preview of the Template populated with dummy data, click Preview
  4. To pull the Template into your Account and re-populate it with your own X (Twitter) Ads data, click Use Template
  5. Select the appropriate X (Twitter) Ads Data Source from the drop-down list to complete the process. The Databoard will be re-populated with data from the selected X (Twitter) Ads Account and can be found the  Databoards page

Pro Tip: Once the Databoard is available on the Databoards page, it is completely disconnected from the public Template. Therefore, you can further customize this Databoard to meet your specific needs using the Designer.

Popular X (Twitter) Ads Templates

Account Overview Tweet Engagement Summary
This Databoard gives an overview of Impressions, Clicks and Spend across all your  X (Twitter) Ads Campaigns.
This Databoard focuses on Engagement Metrics across your X (Twitter)  Ads Campaigns.

How to build a Databoard using X (Twitter) Ads data


Popular X (Twitter) Ads Metrics

Impressions Clicks by Campaign Link Clicks by Campaign

Spend by Campaign Video Call to Action by Campaign Tweet Engagements

View a full list of X (Twitter) Ads Metrics available in Databox here.

How to build a Databoard

  1. Navigate to  Databoards > + New Databoard > Start Blank
  2. Click on the Metric  Library icon on the lefthand side of the Designer
  3. Select X (Twitter) Ads from the Data Source drop-down list in the Metric Library
  4. View the list of pre-built X (Twitter) Ads Datablocks. Drag and drop your selected Datablock onto your Databoard   
  5. If a pre-built Datablock isn't available for your use case, click on the  Visualization types icon under the Metric Library icon
  6. View the list of Visualizations available in Databox. Drag and drop your selected Visualization onto your Databoard
  7. Click on the Datablock on the Databoard to open the corresponding Property Manager on the righthand side of the Designer
  8. Select the appropriate X (Twitter) AdsData Source and Metric in the righthand Property Manager. This will update the Datablock settings and will populate the Datablock with the appropriate data.
  9. Complete steps 4-8 until your Databoard is complete

Additional Information

  • Due to an API limitation, we can only fetch campaigns from the API where their effective status is active. Otherwise, no data will be displayed on Databoards (e.g. for "Paused" or "Halted" campaign statuses).

  • The 100 most recently updated Campaigns are being synced for all Campaign Metrics.