Google Tag Manager

Difficulty: Intermediate
Developer Required: Depends on your signup flow Use Google Tag Manager (GTM) to add the FirstPromoter scripts to your website without editing its code. You’ll add two tags: the main tracking script records visits from referral links, and the referral tracking tag records signups.

This guide assumes the GTM container is already installed on your website.

Main tracking script

Copy the main tracking script

In FirstPromoter, go to Settings > Integrations, open the website integration setup, choose the JS option under Custom integration, and copy the Main tracking script. It looks like this, with your account ID filled in:

<script>(function(w){w.fpr=w.fpr||function(){w.fpr.q = w.fpr.q||[];w.fpr.q[arguments[0]=='set'?'unshift':'push'](arguments);};})(window);
fpr("init", {cid:"<your-account-id-here>"});
fpr("click");
</script>
<script src="https://cdn.firstpromoter.com/fpr.js" async></script>

Create a Custom HTML tag

In your GTM workspace, go to Tags and click New. Click Tag Configuration and choose Custom HTML.

Paste the script

Paste the main tracking script into the HTML field.

Set the trigger

Click Triggering and select Initialization - All Pages. This loads FirstPromoter before your other tags, so the referral tag can use it.

Save and publish

Name the tag FirstPromoter - Main tracking script and click Save. Then click Submit and Publish to make the change live.

Referral tracking

When a visitor signs up or submits an opt-in form, send their email to FirstPromoter with fpr("referral"). Pick the option that matches how your signup works.

Thank-you page
Form submission
Data layer event

Use this when your form redirects to a thank-you page that has the email in its URL, for example https://yoursite.com/thank-you?email=jane@example.com.

Create a new Custom HTML tag and paste the script below.
Click Triggering, click + to create a new trigger, and choose Page View.
Select Some Page Views and add a condition matching your thank-you page, for example Page Path contains /thank-you.
Name the tag FirstPromoter - Referral tracking, save it, then submit and publish your container.

<script>
  (function () {
    var email = new URLSearchParams(window.location.search).get("email");
    if (email && window.fpr) {
      fpr("referral", { email: email });
    }
  })();
</script>

If the URL parameter is not called email, change get("email") to match it.

Use this when your signup or opt-in form is on your site and has an email field.

Go to Variables, click Configure under Built-In Variables, and enable Form Element and Form ID.
Create a new Custom HTML tag and paste the script below.
Click Triggering, click + to create a new trigger, and choose Form Submission.
Enable Wait for Tags (keep the 2000 ms default) so the referral is sent before the page changes.
If your form submits without reloading the page (an AJAX or JavaScript form), turn off Check Validation.
Select Some Forms and add a condition matching your form, for example Form ID equals signup-form.
Name the tag FirstPromoter - Referral tracking, save it, then submit and publish your container.

<script>
  (function () {
    var form = {{Form Element}};
    var emailInput = form && form.querySelector('input[type="email"], input[name="email"]');
    if (emailInput && emailInput.value && window.fpr) {
      fpr("referral", { email: emailInput.value.trim() });
    }
  })();
</script>

The script reads the first email field in the submitted form. If your email field has a different name, update the selector to match it.

Use this when signups happen in your app and a developer can push an event to the GTM data layer. This is the most reliable option, and it lets you send the user ID as well as the email.

Ask your developer to run the code below right after a successful signup, using the new user’s details.

window.dataLayer = window.dataLayer || [];
window.dataLayer.push({
  event: "fp_signup",
  fp_email: user.email,
  fp_uid: user.id,
});

In GTM, go to Variables and create two Data Layer Variable variables: one with the name fp_email (save it as DLV - fp_email) and one with the name fp_uid (save it as DLV - fp_uid).
Create a new Custom HTML tag and paste the script below.
Click Triggering, click + to create a new trigger, choose Custom Event, and set Event name to fp_signup.
Name the tag FirstPromoter - Referral tracking, save it, then submit and publish your container.

<script>
  if (window.fpr) {
    fpr("referral", { email: {{DLV - fp_email}}, uid: {{DLV - fp_uid}} });
  }
</script>

If your signup creates the account on your server, you can track the referral with the API instead. Keep the main tracking script in GTM so clicks are still recorded.

Testing your setup

In GTM, click Preview, enter your website URL with a referral link from one of your affiliates (for example https://yoursite.com/?fpr=joe13), and click Connect.
In Tag Assistant, check that FirstPromoter - Main tracking script fired. In your browser’s developer tools, the _fprom_tid and _fprom_ref cookies should now be set.
Sign up or submit your form, and check that FirstPromoter - Referral tracking fired.
Open the affiliate in your FirstPromoter dashboard and confirm the new referral appears.

Common issues

Tag not firing: check that the trigger conditions match your page or form, and that you published the container. Preview mode does not change your live site.
Referral tag fired but nothing appears in FirstPromoter: the visitor must have arrived through a referral link first, in the same browser. Ad blockers can also block tracking requests. To avoid that, set up a proxy.
Consent banner: if your consent tool blocks tags until the visitor accepts, configure the FirstPromoter tags to follow the same consent settings as your other analytics tags.

Sales tracking

Sales are tracked through your billing integration (Stripe, Chargebee, Paddle and others), not through GTM. Make sure the email (or user ID) sent with the referral is the same one your billing provider sends, so FirstPromoter can match the sale to the referral.

Overview

How to guides

Advanced

Scripts

Integration Options

Webhooks

MCP Server (Experimental)

Main tracking script

Referral tracking

Testing your setup

Common issues

Sales tracking

​Main tracking script

​Referral tracking

​Testing your setup

​Common issues

​Sales tracking

Main tracking script

Referral tracking

Testing your setup

Common issues

Sales tracking