Brilliant Directories

Brilliant Directories is a platform for building membership directory websites, with paid member plans handled through Stripe. Connecting it to Referly means someone who arrives on an affiliate link and then upgrades to a paid membership is credited to the affiliate who sent them, along with their renewals. Brilliant Directories lets you add your own code in two places — the site head, and a conversion-tracking widget — which is exactly what this integration needs. You add the Referly tracking script to the head, drop a sale-tracking snippet into the conversion widget, and connect Stripe. Plan about 20 minutes.

What this integration can and can’t track

What you want to track	Does it work?	Notes
Link clicks and visits	Yes	From the tracking script in Design Settings
Free member sign-ups	Yes	Fired from the conversion-tracking widget
Paid membership upgrades	Yes, with the amount	Recorded as a sale with commission
Recurring renewals	Yes	Each renewal payment comes through Stripe
Refunds	Yes	Referly recognises a refund and adjusts the commission
Cancelled memberships	Yes	Referly knows when a subscription ends

The sale side runs through Stripe, so it covers the whole life of a member: the first upgrade, every renewal, refunds, and cancellations.

Before you start

You’ll need:

A live Referly program with at least one affiliate to test with. See setting up your program if you haven’t got that far.
Admin access to your Brilliant Directories site.
A Stripe account your directory charges memberships through.

Open the guide inside Referly first, because it has your program’s own tracking script filled in. In your dashboard, open Settings from the left sidebar, select Integrations, find the Brilliant Directories card, and select Instructions.

Step 1: Add the Referly tracking script

Copy the script from Step 1 of the instructions window. Your program’s own identifier is already filled in where YOUR_PROGRAM_ID appears here:

<script
  src="https://referly.so/affiliate-tracker.js"
  data-affiliate
  data-program-id="YOUR_PROGRAM_ID"
  async>
</script>

Now put it into Brilliant Directories:

Open your site's admin panel

Go to your Brilliant Directories admin panel and select your website.

Go to Design Settings

Open Design Settings → Custom CSS/HEAD. This is where Brilliant Directories lets you add code to every page’s <head>.

Paste the script and save

Paste the tracking script in and save. Using the head means tracking starts as early as possible in the page load.

If affiliates send traffic to a marketing site first and people click through to your directory, put the tracking script on both. A visitor who is never recognised can’t be credited.

Step 2: Connect Stripe

Brilliant Directories charges memberships through Stripe, and Stripe is where Referly reads your revenue from. Without this step you’ll see clicks and sign-ups but no sales. In the instructions window, go to Step 2: Connect Stripe and select Connect Stripe. You’ll be sent to Stripe to authorise the connection, then returned to Referly.

Use the same Stripe account your directory charges through, and make sure your program’s test-or-live mode matches the payments you expect.

Step 3: Add the conversion-tracking snippet

Brilliant Directories fires a conversion-tracking widget when a member signs up or upgrades. That’s where Referly’s sale snippet goes, so it can record the sign-up and the payment with the member’s real details.

Open your site's admin panel

Go to your Brilliant Directories admin panel and select your website.

Open the Widget Manager

Go to Toolbox → Widget Manager.

Find the conversion tracking widget

Search for the widget Bootstrap Theme - Conversion Tracking Codes.

Customize it

Click Actions → Customize.

Find the tracking placeholder

In the HTML section, find the line that reads Enter Conversion Tracking Codes To Track Sign Ups & Upgraded Members Below ******* —>.

Paste the snippet below and save

Paste the code below beneath that line and save.

<script>
  window.createPushLapSale({
    userId: '<?php echo $conversion_tracking['user_id']; ?>',
    amount: <?php echo $conversion_tracking['amount']; ?>,
    name: '<?php echo $conversion_tracking['full_name']; ?>',
    email: '<?php echo $conversion_tracking['email']; ?>'
  });
</script>

The PHP placeholders are filled in by Brilliant Directories at the moment a member converts, so Referly receives the real user, amount, name, and email. The payment is then matched to the referred visitor and credited to the affiliate.

Test it end to end

Run a real sign-up and upgrade through before telling affiliates the integration is live.

Grab a real affiliate link

Open Affiliates in the left sidebar of Referly, pick an affiliate, and copy their referral link.

Open it in a private window

Use a private or incognito window so no old tracking interferes. Land on your directory and let the page finish loading.

Register a new member with a fresh email address, then upgrade to a paid plan. Use a low-priced plan or a full-discount coupon rather than a live card charge if you can.

Check Referly

Open Customers in the left sidebar. The member should appear within a minute, credited to the affiliate whose link you used, with the amount they paid and its commission.

When the test upgrade appears under Customers against the right affiliate with the right amount, you’re done.

Refund the test payment in Stripe and remove the test referral in Referly so your reports start clean.

Troubleshooting

Clicks are counted but no sales ever appear

Almost always the Stripe connection. Check that Referly is connected to the same Stripe account your directory charges through, and that your program’s test-or-live mode matches the payments you’re expecting.

Nothing is tracked at all, not even clicks

The Step 1 script isn’t running. Confirm it’s saved in Design Settings → Custom CSS/HEAD, then load a page with an affiliate link on the end and check a click shows up in Referly.

Sign-ups or upgrades aren't being recorded

The Step 3 snippet needs to be in the Bootstrap Theme - Conversion Tracking Codes widget, beneath the placeholder line. Confirm you saved the widget after pasting it.

The wrong affiliate got the credit

The member most likely visited on another affiliate’s link earlier. The first affiliate to refer someone keeps the credit for the length of your cookie window. You can move a referral from the customer’s page, described in managing referred customers.

Still stuck? Book an integration call and we’ll go through your setup with you.

Stripe

Connect the Stripe account your directory charges through.

Universal forms integration

The general form-capture pattern this integration builds on.

Commissions overview

Set recurring commission for membership revenue.

All integrations

See every platform Referly connects to.

Getting started

Managing your program

Engaging affiliates

Gamification

Growth

Program settings

Integrations

Billing and plans

For agencies

For affiliates

Brilliant Directories

What this integration can and can’t track

Before you start

Step 1: Add the Referly tracking script

Step 2: Connect Stripe

Step 3: Add the conversion-tracking snippet

Test it end to end

Troubleshooting

Stripe

Universal forms integration

Commissions overview

All integrations

​What this integration can and can’t track

​Before you start

​Step 1: Add the Referly tracking script

​Step 2: Connect Stripe

​Step 3: Add the conversion-tracking snippet

​Test it end to end

​Troubleshooting

​Related

Stripe

Universal forms integration

Commissions overview

All integrations

What this integration can and can’t track

Before you start

Step 1: Add the Referly tracking script

Step 2: Connect Stripe

Step 3: Add the conversion-tracking snippet

Test it end to end

Troubleshooting

Related