Twitter Ads
8 min
twitter ads (now x ads) is x's advertising platform for promoted content, conversion campaigns, and audience targeting this destination loads the x/twitter universal website tag (uwt) javascript sdk in the browser and forwards conversion events based on a configurable event mapping page and identify events are not forwarded there is no server side component getting started this is a device mode destination the twitter/x uwt sdk is loaded automatically — no manual script installation is required you will need pixel id — your twitter/x pixel id, found in your x ads account under tools > conversion tracking optionally event mapping — maps chord event names to twitter event ids (e g , { "product added" "tw abc12 def34" } ) only events with an explicit entry in this mapping are forwarded all unmapped events are silently skipped identifier — which product field to use as the content id ( product id , sku , or id ) defaults to product id > id > sku fallback chain connecting to the twitter ads cdp destination warning before connecting destinations in the chord cdp, please verify with all destination owners that all non chord cdp configured destinations are disabled running external destinations alongside configured chord cdp destinations can result in duplicate events downstream log into the chord data platform navigate to the cdp click the "add" button next to destinations select twitter ads from the destination catalog enter the destination name and your pixel id configure the event mapping to specify which chord events should fire which twitter event ids optionally configure the identifier field click "create" to connect events page and identify events are not forwarded to twitter ads only track events with an explicit entry in the event mapping configuration are forwarded all unmapped events are silently skipped track events twitter sdk call twq("event", twittereventid, eventpayload) user parameters twitter attribute chord source (priority order) notes email address properties email > context traits email > traits email automatically hashed by the twitter sdk phone number properties phone > context traits phone > traits phone automatically hashed by the twitter sdk order parameters twitter attribute chord source (priority order) notes value properties revenue > properties total > properties value currency properties currency defaults to "usd" conversion id properties cart id / properties order id used for deduplication product contents each product in properties products\[] is mapped to a twitter content item twitter attribute chord source (priority order) notes content id configured identifier field from properties products\[] > product id > id > sku content name properties products\[] name content price properties products\[] price num items properties products\[] quantity content type properties products\[] category content group id properties products\[] variant id all undefined values are filtered out before sending initialization the plugin sets up the twq function queue, then loads https //static ads twitter com/uwt js after the script loads, it calls twq("config", pixelid) to initialize the pixel the plugin manages sdk loading state ( fresh → loading → loaded / failed ) to prevent duplicate script loads if the script fails to load, subsequent events are silently dropped csp requirements if your site uses a content security policy, allow the following domains directive domain script src https //static ads twitter com connect src https //static ads twitter com updated 6 apr 2026