X Ads (formerly Twitter Ads)

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 Information
Status: Generally Available Supported sources: Android (Java) , Android (Kotlin) , iOS (Obj-C) , iOS (Swift) , Web, Unity, AMP , Cloud, Warehouse, React Native , Flutter, Cordova, Shopify Refer to it as X Ads (formerly Twitter Ads) in the Integrations object.

Connection Modes
Source	Cloud mode	Device mode	Hybrid mode
AMP
Android (Java)
Android (Kotlin)
Cloud
Cordova
Flutter
iOS (Obj-C)
iOS (Swift)
React Native
Shopify
Unity
Warehouse
Web

Supported Message Types
Source	Identify	Page	Track	Screen	Group	Alias	Record	AudienceList
Cloud mode
Supported sources

Get started

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

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 at least one of the following identifier fields:

Note that:

• If you want to send the ip_address field in your events, you must also include at least one of the other identifier fields (email, phone, twclid, or user_agent).
• If you want to send the user_agent field in your events, you must also include at least one of the other identifier fields (email, phone, twclid, or ip_address).

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.