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:
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. |
Understanding X Ads’ Limitations
There are no known limitations to Savant’s X Ads connector.