Meta (Facebook) Ads

Retarget referred visitors and track referral events in Meta (Facebook) Ads to optimize your ad campaigns.

How It Works

The Meta Ads integration lets you retarget website visitors who arrive through referral links and track their conversions. Once connected, Meta Ads will track these referred visitors and conversions when they submit their email addresses on your website.

Under the hood, GrowSurf loads the Meta Ads library (Facebook script) for event tracking. If Meta Ads is already installed, GrowSurf intelligently avoids loading it twice.

---

How to Set Up

Step 1: In Campaign Editor > 4. Options > Integrations, open the Meta Ads integration card and enter your Meta Ads pixel ID.

Note: If you are 100% certain that you already have Meta Ads (as a Facebook pixel) installed on your website, you do not need to enter in the Meta 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 Meta Ads installed.

Step 2: Once connected, GrowSurf will have all events enabled by default. Disable any events that you do not want to track.

Important Note: Make sure that your campaign Share URL (found in the Campaign Editor > 5. Installation step) is a part of your Meta Ads account. If you are using multiple domains, within Meta Ads manager, you may need to enable Automatic Advanced Matching and set up Domain Verification to avoid issues with shared traffic between domains.

Step 3: In your Meta Ads account, you will need to add the following two custom conversions (You can skip this step if you have both "Track conversion event" checkboxes toggled off). Follow the instructions in How to Add Custom Conversions In Meta 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 Custom Conversions In Meta Ads

Open instructions

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

1. Log into your Meta Ads Manager account.

2. From the left-side menu, navigate to All tools > Advertise > Events Manager (see image below).

   
3. Choose the pixel ID that you entered for the Meta Ads integration within GrowSurf (see image below).

   
4. You should now be seeing a page called "Data Sources". Click the top-right Create button and choose "Create custom conversion" from the dropdown (see image below).

   
5. You should be seeing a popup window with the title "Create a custom conversion". For the Name field, enter enter the following conversion name depending on which conversion event you're adding:

   1. growsurf_referral_signup

   2. growsurf_referral_trigger

6. For the Data source field, make sure to keep the same pixel ID you chose from step 1 selected.

7. For the Action Source field, keep "Website" selected.

8. For the Event field, choose one of the following:

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

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

9. In the first Rules dropdown, select "Event Parameters". Then in the second Rules field, type in source. For the third Rules field, select "equals". Then in the fourth Rules field, enter growsurf. Your screen should now look like the image below:

   
10. For the other fields like Description and Conversion value, you can adjust to your preferences.

11. Click the Create button.

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

---

Troubleshooting Tips

Here are common scenarios and how to troubleshoot them.

If Meta 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 Meta Ads.

• Make sure your campaign Share URL (and the page where the referral submits their email address, if you are tracking conversions) is a part of your Meta Ads account. You can find the campaign Share URL in the Campaign Editor > 5. Installation step. In your Meta Ads account, you may need to enable Automatic Advanced Matching and set up Domain Verification to avoid issues with shared traffic between domains.

• If you are testing conversions being tracked, make sure that you've allowed up to 30 minutes for Meta Ads to process the events.

• To troubleshoot if the Meta (Facebook) ads script is loading on your website, you'll want to make sure you that you visit a participant's referral link first.

If Meta Ad events are occurring, but you were NOT expecting them:

• If you want to prevent Meta Ads from being loaded completely, you must disconnect the integration completely. Simply toggling off all checkboxes is insufficient.

• If you see Meta 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.