Skip to main content
All CollectionsSystem Setup Guides
X Ads (Twitter) Connector Setup
X Ads (Twitter) Connector Setup
Updated over a week ago

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.

  • 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:

  1. Click "Apply for a developer account."

  2. Select "Build customized solutions in-house."

  3. 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:

  1. After your developer account is approved, log in to the Developer Portal.

  2. On the Overview page, navigate to the Standalone Apps section.

  3. Click "Create App."

  4. Enter the name of your app and click "Complete."

  5. 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

  1. Go to your Twitter app dashboard.

  2. Select the app that you created.

  3. In the app dashboard, go to the Settings tab.

  4. In the App permissions section, click "Edit."

  5. 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.

Did this answer your question?