X (Twitter) Ads
Retarget referred visitors and track referral events in X (Twitter) Ads to optimize your ad campaigns.
How It Works
The X (Twitter) Ads integration lets you retarget website visitors who arrive through referral links and track their conversions. Once connected, X Ads will track these referred visitors and conversions when they submit their email addresses on your website.
Under the hood, GrowSurf loads the X Ads library for event tracking. If X Ads is already installed, GrowSurf intelligently avoids loading it twice.
How to Set Up
Step 1: In Campaign Editor > 4. Options > Integrations, open the X (Twitter) Ads integration card and enter your X Ads pixel ID. You can get your pixel ID from logging into your X Ads Manager account, and navigating to Tools > Events manager.

Step 2: Once connected, GrowSurf will have all events enabled by default. Disable any events that you do not want to track.
Step 3: In your X Ads account, you will need to add the following two conversion events (You can skip this step if you have both "Track conversion event" checkboxes toggled off). Follow the instructions in How to Add Conversion Events In X Ads.
growsurf_referral_signup
- This conversion event represents when a referred visitor submits their email address on the form on your website that has referral tracking on it.growsurf_referral_trigger
- This conversion event represents when a participant completes a qualifying action, like making a purchase (Note: this only applies when you are usinggrowsurf.triggerReferral()
from the front-end).
How to Add Conversion Events In X Ads
Troubleshooting Tips
Here are common scenarios and how to troubleshoot them.
If X Ads events are NOT occurring, but you were expecting them:
Make sure you do not have any ad-blockers or browser extensions blocking requests to X Ads.
If you are testing conversions being tracked, make sure that you've allowed up to 24-48 hours for X Ads to process the events.
You can install the X Pixel Helper to troubleshoot issues. Make sure to visit the webpage through a participant's referral link first in order for X ads to load.
To troubleshoot if the X ads script is loading on your website, you'll want to make sure you that you visit a participant's referral link first.
If X Ad events are occurring, but you were NOT expecting them:
If you want to prevent X Ads from being loaded completely, you must disconnect the integration completely. Simply toggling off all checkboxes is insufficient.
If you see X Ads network requests being made on your website and you have the integration completely disabled, GrowSurf may not be emitting these events. Check other parts of your code to find where these events might be happening.
Last updated
Was this helpful?