X Ads (formerly Twitter Ads)
This page describes how to use Census with X Ads.
Last updated
Was this helpful?
This page describes how to use Census with X Ads.
Last updated
Was this helpful?
This guide shows you how to use Census to connect your X Ads account to your data warehouse and create your first sync.
Before you begin, you'll need the following:
Census account: If you don't have this already, .
X Ads account
Credentials for your data warehouse: For details, see the guide for your .
Log into Census and navigate to .
Click New Destination.
Select X Ads from the menu.
Follow the X Ads authentication flow.
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
To proceed, you will need to rename the audience you're trying to create to use a name that has not been previously used.
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, Census 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.
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.
Learn more about all of our sync behaviors in our documentation.
if you want Census to support more X Ads objects and/or behaviors.
X Ads does not allow reuse of audience names that have been deleted, described in their . If you attempt to reuse an audience name that has been used in the past, the Census sync will fail with a BadRequestError: the server responded with status 400
error. Looking at the API Inspector, you will see that Census is failing to create a new audience with X returning an error saying Entity already exists CustomAudience
.
You can send our at support@getcensus.com or start a conversation from the in-app chat.