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.

Note: If you are 100% certain that you already have X Ads installed on your website, you do not need to enter in the X Ads pixel ID. Simply press Connect and the integration will be enabled. However, we recommend that you still enter it to account for URLs that do not have X Ads installed.

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 using growsurf.triggerReferral()from the front-end).

---

How to Add Conversion Events In X Ads

Open instructions

You'll need to complete steps 1-12 below for each event growsurf_referral_signup and growsurf_referral_trigger.

1. Log into your X Ads Manager account and select the campaign with the pixel ID that you entered for the X Ads integration within GrowSurf.

2. In the top menu, navigate to Tools > Events manager.

3. Choose an existing pixel to use (or create a new one if you do not have any). In the Events section, click the "Add Events" button (see image below).

   
4. For the Name, enter the following conversion name depending on which conversion event you're adding:

   1. growsurf_referral_signup

   2. growsurf_referral_trigger

5. For the event type, choose one of the following:

   1. For growsurf_referral_signup, we recommend using "Lead (formerly sign up)" (or choose a different category that best represents a referred visitor signing up).

   2. For growsurf_referral_trigger, we recommend using "Purchase" (or choose a different category that best represents when a referred participant completes a qualifying action, which triggers a referral).

6. For the other fields like attribution window, you can adjust to your preferences.

7. Click the bottom Next button (see image below).

   
8. In the next screen, keep "Define event with code" selected, then click the Next button (see image below).

   
9. Click the "Conversion ID" and "Email address" checkboxes.

10. Scroll to the bottom of the page and copy the event ID to use for the next step (see image below). The event ID starts with a tw-.

    
11. In your GrowSurf campaign editor, enter the event ID for the appropriate input field (see image below).

    
12. Return to X Ads manager and Click Save.

13. Make sure that you repeat steps 1-12 above for growsurf_referral_trigger as well.

---

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.