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:

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

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).