Twitter Ads
Send advertising events directly to Twitter Ads
Destination Info
Supports Track calls
Supports HIPAA mode
Supports forwarding from the Google Tag Manager Integration
Refer to this destination as Twitter Ads in the Integrations object
Connection Modes:
Web
Mobile
Server
When using Server-Side connection mode you are using a Proxy Integration for Twitter Ads. This destination runs on Freshpaint's servers, but emulates a native installation of the Twitter Ads Tag. That means the integration behaves the same as if you did a native installation of Twitter Ads, but the data first flows through Freshpaint before it's sent to Twitter. See our docs on proxy integrations for more information.
Getting Started
Pixel ID
To configure your Twitter Ads destination, you'll first need to locate or generate a Pixel ID.
In your Twitter Ads account, select Tools > Events Manager. If you don't already have a Pixel ID, the page will guide you through adding a new Event Source.
Once you have a Pixel ID, you can use the copy button to copy the Pixel ID to your clipboard.
Configure Freshpaint destination
Once you have your Pixel ID, you can configure your Twitter Ads destination in Freshpaint.
Once you've saved the Pixel ID, you're ready to start setting up conversion events in Twitter Ads!
Configure Conversion Events
To send a conversion event to Twitter Ads, you need to set up an event in Twitter Ads and map your Freshpaint event to that event ID.
From the Twitter Ads Events Manager, click Add Events.
Give your event a name and click "Next".
Choose "Define event with code" and click "Next".
Save your event and return to the Events Manager. Copy the Event ID (it looks like tw-xxxxx-xxxxx).
Return to the Freshpaint Twitter Destination and configure a transformation to map one of your Freshpaint events to the Twitter Event ID. Click "Configure" next to "Event Transformations".
Click "+ New Transformation".
Select "Standard Event". Choose the event you'd like to send to Twitter Ads. Click "Enable it". Paste the Twitter Event ID in the final text box of this form and click "Save".
Once you've set up a transformation with the Twitter Event ID, you're ready to start sending events to Twitter Ads via Freshpaint!
Check whether it's working
To check whether Twitter Ads is receiving events, you can go to Tools > Events Manager within your Twitter Ads account, which will show you when the last time twitter received an event for each destination.
Track Events
Freshpaint can send Events to your Twitter Ads account, which enables you to perform conversion tracking within your Twitter Ads campaigns.
More information about Twitter Conversion Tracking is available in the twitter docs.
Client-side
You may provide the following additional event properties when sending events to Twitter from the web:
Event property
Type
Required?
Description
quantity
number
Optional
Number of items purchased
revenue
number
Optional
Value of the conversion in USD
Server-side
When using Server-Side connection mode you are using a Proxy Integration for Twitter Ads. This destination runs on Freshpaint's servers, but emulates a native installation of the Twitter Ads Tag. That means the integration behaves the same as if you did a native installation of Twitter Ads, but the data first flows through Freshpaint before it's sent to Twitter. See our docs on proxy integrations for more information.
You may provide the following additional event properties when sending events to Twitter via Freshpaint's servers:
Event property
Type
Required?
Description
$twclid
string
Required
twclid is generated at ad click time and appended to the landing page URL. Freshpaint will automatically capture twclid for events from your website. For events from other sources you would need to provide $twclid.
value or total or revenue
number
Optional
Value of the conversion event
currency
string
Optional
Currency of the conversion value, "USD" by default. Can be any ISO 4217 code (e.g. USD, JPY, EUR).
Considerations
Conversions may take up to 2 hours to appear in your Twitter Ads portal.
Last updated
