Twitter Conversion API with GTM Server-Side

X Developer Portal

Create your account with free access to X Developer Portal .

You’ll then need to register or log in to your X account.

Then click on the Sign up for free account link at the bottom of the page.

On the next page, you must explain (minimum 250 characters) why you wish to access the X Developer Portal.

Here’s a sample text you can use:

To accurately track conversions and optimize ad performance on X (formerly Twitter), I need to use the X Ads API with Google Tag Manager Server-Side (GTM SS). Unlike traditional browser-based tracking, which can be blocked by ad blockers or restricted.

You will then be taken to the Developer Portal dashboard.

Request access to the conversion API

To request access to the conversion API, you first need to retrieve your application ID. To do this, go to App settings.

Copy the APP ID that appears.

Then request access to the conversion API (X Ads API) via this form .

Fill in your details, then when you get to page 4, paste the app ID and also the text you used previously for the Developer Portal.

To accurately track conversions and optimize ad performance on X (formerly Twitter), I need to use the X Ads API with Google Tag Manager Server-Side (GTM SS). Unlike traditional browser-based tracking, which can be blocked by ad blockers or restricted.

You can then submit the form.

You’ll know you’ve gained access when ADS API is written to your application (see screenshot below).

Generate access tokens

To send requests to the conversion API, we’ll need the following tokens:

• consumerKey
• consumerSecret
• oauthToken
• oauthTokenSecret

To do this, go to the X Developer Portal dashboard  and click on the key next to your APP.

Then click on the Regenerate button in the red-framed sections below.

A pop-up window then appears with the tokens we need.

consumerKey and consumerSecret	oauthToken and oauthTokenSecret

Event ID and Pixel ID

Go to the X Business Manager , in the menu click on Tools then Events manager.

You then arrive at the next interface where you can already get your Pixel ID.

We’re now going to create 2 events as examples:

1. Page View
2. Purchase

To create a new event, click on Add Events.

Page View

To create a Page View event, select Page view as Event Type and click Next.

Then select Define event with code.

In step 3, if you have nothing to configure, click Save.

Purchase

To create a Purchase event, select Purchase as Event Type and click Next.

Then select Define event with code.

In step 3, if you have nothing to configure, click Save.

Here’s the event manager with these two events and their respective Event IDs.

Addingwell Container UUID

In your Addingwell container, in the Tagging Server section, you can copy the UUID.

Import tag into sGTM

Click here  to download the tag X (formerly Twitter) Ads API then click on the icon to download the file.

Then go to the Templates tab of the server container, and in the Tag templates section, click on New.

Then click on the three small dots in the top right-hand corner, and select Import.

Then select the newly uploaded template.tpl file, and click Save.

Configure tag in sGTM

1. Pixel ID

Enter the pixel ID available in your X Events Manager.

In our example, the Pixel ID is: p1del.

2. Event IDs

In our example, the Event IDs are as follows:

• Page View: tw-p1del-p98xc
• Purchase : tw-p1del-p9905

In your GTM server container, go to Variables and click on New. Then select Lookup Table.

3. Send pixel request

Check this box to send requests to the X pixel.

4. Authentication

Fill in the fields here with the information retrieved from Addingwell and the X Developer Portal.

Now that we’ve finished configuring the tag, let’s move on to its trigger.

Configure trigger

Go to Variables and click on New.

Then select Lookup Table and configure your variable like this, then click Save.

Now you can configure your trigger.

Then add the trigger to your tag, and you’re done!