X Ads (Formerly Twitter Ads)
This page describes how to use Activations with X Ads.
Getting started
This guide shows you how to use Activations to connect your X Ads account to your data warehouse and create your first sync.
Prerequisites
Before you begin, you'll need the following:
- Fivetran account: If you don't have this already, start with a free trial.
- X Ads account
- Credentials for your data warehouse: For details, see the guide for your specific data source technology.
To sync audiences, X requires a manual approval step. Details can be found in X docs.
For access to the Audience endpoint, you will need to be added to an allowlist. Please fill this form and accept the new Twitter Ads Products and Services Agreement if initially accepted prior to 2018-08-01.
Connect X Ads Account
- Log into Activations and navigate to Destinations.
- Click New Destination.
- Select X Ads from the menu.
- Follow the X Ads authentication flow.
Supported Objects and Sync Behaviors
Learn more about all of our sync behaviors in our Syncs documentation.
| Object Name | Supported? | Sync Keys | Behaviors |
|---|---|---|---|
| Audience | ✅ | Hashed or Unhashed Email, Hashed or Unhashed Handle, Hashed or Unhashed Device ID | Mirror |
| Mobile Conversion Event | ✅ | App ID, Conversion Time, Conversion Type, Hashed Device ID, OS Type | Send |
| Web Conversion Event | ✅ | Click ID, Hashed or Unhashed Email, Hashed or Unhashed Phone Number | Send |
Contact Support if you want Activations to support more X Ads objects and/or behaviors.
Audiences
X Ads does not allow reuse of audience names that have been deleted, described in their documentation here. If you attempt to reuse an audience name that has been used in the past, the Activations sync will fail with a BadRequestError: the server responded with status 400 error. Looking at the API Inspector, you will see that Activations is failing to create a new audience with X returning an error saying Entity already exists CustomAudience.
To proceed, you will need to rename the audience you're trying to create to use a name that has not been previously used.
Conversion Events
When syncing data to conversion events, the Use timestamp column to identify new data setting can help limit the number of API calls. With this setting, Activations will check if the record has changed since the last sync occurred and skip syncing for the record if there have been no changes.
To use this setting, you'll also need to include a column in your database/data source that tracks the latest sync for each record.
Sync speed & limits
Rate limits affect how many records you can sync in a specific period of time. X Ads API has a rate limit of 1,500 calls per minute. Calls to sync audience data and conversion event data share the same rate limit.
Need help connecting to X Ads?
You can reach out to our support team.