Setup Guide

Set up and configure X Pixel as a destination in RudderStack.

  •   2 minute read  

This guide will help you set up X Pixel as a destination in the RudderStack dashboard. It also lists the configuration settings required to correctly send data from the supported sources to X Pixel.

Connection compatibility

Destination info

Connection modes
SourceCloud modeDevice modeHybrid mode
Webnot supportedsupportednot supported
Supported message types
SourceIdentifyPageTrackScreenGroupAlias
Device mode
Webnot supportedsupportedsupportednot supportednot supportednot supported
info
While using a Content Security Policy (CSP) header on your website, you need to allowlist the ads-twitter.com, ads-api.twitter.com, and analytics.twitter.com domains in the img-src and connect-src directives to to see results with X Pixel.

Setup

In your RudderStack dashboard, add a source. Then, from the list of destinations, select XPixel.

Connection settings

SettingDescription
Destination nameAssign a name to uniquely identify the destination.
Pixel IDEnter your Pixel ID of your X pixel event source.

Configuration settings

The Client-side Event Filtering setting lets you specify which events should be discarded or allowed to flow through to X Pixel.

SettingDescription
Choose if you want to turn on events filteringChoose from either of the No events filtering, Filter via allowlist, and Filter via denylist options to specify if and how you want to filter the events.
Allowlisted/Denylisted eventsIf you have selected either of the Filter via allowlist or Filter via denylist options in the previous setting, use this setting to specify the events you want to allow or discard while flowing to X Pixel.

Event mapping

SettingDescription
External Event mappingsClick Set-up mapping to map the RudderStack events to X Pixel events. RudderStack also provides the JSON mapper to set these mappings.

Next steps

FAQ

How can I verify that X Pixel is correctly placed on my website?

You can leverage the X Pixel Helper to verify the X Pixel placement. It shares the tracking status of the X Pixel and relevant events, and also includes the error codes depending on the issue.

Download the Google Chrome extension for X Pixel Helper here.

Questions? Contact us by email or on Slack