X Ads (formerly Twitter Ads) Beta

X Ads (formerly Twitter Ads) is an advertising platform that lets you track and monitor ad campaigns, clicks, CTRs, etc. You can also implement efficient ad retargeting for your customers.

Find the open source transformation code for this destination in the GitHub repository.

Connection compatibility

Destination info
Status: Beta Supported sources: Android, iOS , Web, Unity, AMP , Cloud, Warehouse, React Native , Flutter, Cordova, Shopify Refer to it as TWITTER_ADS in the Integrations object.

Connection modes
Source	Cloud mode	Device mode	Hybrid mode
AMP
Android
Cloud
Cordova
Flutter
iOS
React Native
Shopify
Unity
Warehouse
Web

Supported message types
Source	Identify	Page	Track	Screen	Group	Alias
Cloud mode
Supported sources

Get started

Once you have confirmed that the platform supports sending events to X Ads, follow these steps:

1. From your RudderStack dashboard, add a source. Then, from the list of destinations, select X Ads.
2. Assign a name to the destination and click Continue.

Account settings

1. Click the Create Account button.
2. Under Choose an account, click the Connect with X Ads button and give RudderStack the required permissions to access your account. Then, click Save.
3. To verify or change your account, click the Edit Credentials button.

Connection settings

• Pixel ID: Enter the Universal Website Tag (UWT) ID for your X Ads account.
• Map RudderStack event name to X event ID: This setting lets you map a RudderStack Event Name to a specific Twitter Event ID.

For more information on obtaining the Pixel ID and Twitter Event ID, see FAQ.

Track

You can use the track call to capture user events and send them as conversion events for a single Universal Website Tag pixel ID.

The following snippet highlights a sample track call:

rudderanalytics.track("Product Purchased", {
  "quantity": "3",
  "currency": "USD",
  "value": 251,
  "email": "alex@example.com",
  "conversionId": "56342424234"
  "description": "Shoes",
  "contents": [{
      "id": "1",
      "price": "50.00",
      "quantity": 1
    },
    {
      "id": "2",
      "price": "100.55",
      "quantity": 2
    }
  ]
})

Supported mappings

The following table details the mappings between RudderStack and X Ads properties:

Note that each event must contain one of the following fields:

The following table lists the mappings between the properties.contents object fields and X Ads properties:

FAQ

Where can I find the X Ads Pixel ID and Event ID?

1. Sign in to your X Ads account.
2. Go to Tools > Event Manager.
3. Set up your X pixel and add the associated events. For more information, see Conversion tracking for websites.
4. You can find the pixel ID and event ID under your pixel name and created events.

Questions? Contact us by email or on Slack