Twitter Ads provides a history of the settings and detailed reports of your Twitter Ad Accounts, Campaigns, Line Items, Tweets, and Media Creatives.

Prerequisites

To connect X Ads to Savant, you'll need:

An X account with access to at least one active X Ads account with ACCOUNT_ADMIN, AD_MANAGER, or CAMPAIGN_ANALYST permissions.
At least one campaign and one promotable user in your X Ads account.
A X app with access to the X Ads API.

Information Required to Connect

Account Id: The Twitter Ads Account Id. This will be the External ID.
- User needs to get to their ads account (not developer app dashboard). Account ID would be in the ads account URL.
- Ads account URL should starts with https://ads.twitter.com/ , which should redirect user to the logged in account.
- Redirect target should have account ID. e.g. in URL https://ads.twitter.com/simpleads/18ce55oog2o/objectivepicker, the account ID would be 18ce55oog2o
Consumer Key and Consumer Secret: The Consumer Key and Secret can be obtained from the Consumer Keys section of the Keys and Tokens tab on the developer app dashboard.
Access Token and Access Token Secret: The Access Token and Secret can be obtained from the Authentication Tokens section of the Keys and Tokens tab on the developer app dashboard.

Set Up X Ads in Savant

In X Ads

Step 1: Apply for a developer account

If you don't already have a developer account, follow these steps:

Go to Twitter's Apply for access page.
Click "Apply for a developer account."
Select "Build customized solutions in-house."
Provide your organization details and explain your intended use of the Twitter data in subsequent application screens.

Step 2: Create Twitter application

If you need to create a Twitter application, follow these steps:

After your developer account is approved, log in to the Developer Portal.
On the Overview page, navigate to the Standalone Apps section.
Click "Create App."
Enter the name of your app and click "Complete."
Make a note of the Consumer key and Consumer secret key. You will need them to configure the system in Savant.
You can also find the keys in the Keys and tokens tab of your app dashboard.

Step 3: Submit Ads API application form

Complete the Twitter Ads API application form and submit it.

Step 4: Set permissions for your app

Go to your Twitter app dashboard.
Select the app that you created.
In the app dashboard, go to the Settings tab.
In the App permissions section, click "Edit."
Set the permissions to "Read" and click "Save."

Step 5: Generate access token and secret

In your app dashboard, go to the "Keys and tokens" tab. Then, in the Authentication Tokens section, generate your access token and secret. Make a note of the Access Token and Access Token Secret. You'll need them to configure the system in Savant.

In Savant

Step 1: Enter your External Account ID.

Step 2: Enter the Consumer key and Consumer secret key (these keys were found in Step 2 above).

Step 3: Enter the Access Token and Access Token Secret (these were created in Step 5 above).

Step 4: Click Authenticate and follow the OAuth Authentication Prompts.

Read Data from X Ads

Learn how to create datasets from Savant’s X Ads connector here.

Available Objects

Name	Description
AdAccounts	Fetches information on advertising-enabled accounts accessible to the authenticated user.
AdActiveEntities	Gathers details on entities whose analytics metrics have undergone changes within a specified timeframe.
AdCampaignAudienceReach	Retrieves analytics on reach and average frequency for designated campaigns.
AdCampaigns	Retrieves detailed information on campaigns associated with the current account.
AdCards	Retrieves detailed information on cards associated with the current account.
AdFundingInstruments	Retrieves funding instruments associated with the specified account.
AdFundingInstrumentsAudienceReach	Gathers analytics on reach and average frequency for specified funding instruments.
AdLineItems	Retrieves funding instruments associated with the specified account.
AdPromotedTweets	Fetches advertising-enabled Tweets accessible to the authenticated user.
AdStats	Queries information on all available metrics for a given entity.
AdTweets	Fetches advertising-enabled Tweets accessible to the authenticated user.