Ghost

Run a newsletter referral program in Ghost.org with Referral Rocket

Welcome to the help guide for the integration between Ghost.org and Referral Rocket. This powerful connection allows you to launch and manage a complete referral program for your newsletter, rewarding your subscribers for sharing your content and helping you grow your audience.

With this integration, you can:

• Automatically Sync Subscribers: New Ghost members are seamlessly added to your Referral Rocket program.

• Track Referral Links: Monitor exactly who is sharing your newsletter and how effective their efforts are.

• Incentivize Sharing: Offer rewards, discounts, or exclusive content to your top referrers.

• Grow Your Audience: Leverage word-of-mouth marketing to acquire high-quality, trusted new subscribers.

Use the guides below to get your referral program up and running in minutes.

Step 1 - Tracking Referrals

Create a new referral page in ghost where referred users will land. Add the sign up widget that allows to add labels on this page. Design this page as per your liking to increase the chances of conversion (ie user subscribing to your newsletter)

On this referral landing page, add the following javascript in the header. (This script is important to track the referral link) Note - Replace this with your campaign ID

//Add script to head tag
<script type="text/javascript" campaign-id="YOUR-CAMPAIGN-ID"  defer src="https://app.referralrocket.io/widget/widgetIndex.js"></script>

Next, add the following script in the HTML page.

Note that this script depends on having the input field with the tag "data-members-label="referral" to copy the referral code dynamically into it.

<script>
  
function getCookie(name) {
    let nameEQ = name + "=";
    let ca = document.cookie.split(';');
    for(let i=0; i < ca.length; i++) {
        let c = ca[i];
        while (c.charAt(0) === ' ') c = c.substring(1, c.length);
        if (c.indexOf(nameEQ) === 0) {
          
          console.log(' found ' + c.substring(nameEQ.length, c.length));
          return c.substring(nameEQ.length, c.length);
      }
    }
      console.log('not found');
    return null;
}

// Wait for DOM to be ready
function setFieldFromCookie() {
    const cookieValue = getCookie('rr_referral_code');
    if (cookieValue) {
        // Try multiple possible selectors
        const labelInput = document.querySelector('input[data-members-label="referral"]') 
            || document.querySelector('input[name="labels"]')
            || document.querySelector('input[data-members-label]');
        
        if (labelInput) {
            labelInput.value = cookieValue;
            console.log('Referral code set:', cookieValue);
        } else {
            console.warn('Input field not found');
        }
    }
}

// Run when DOM is ready
if (document.readyState === 'loading') {
    document.addEventListener('DOMContentLoaded', setFieldFromCookie);
} else {
    setFieldFromCookie();
}
</script>

Step 2 - Configuring your campaign

Copy the referral page link, add use that in the campaign configuration. This is the link referred users will land.

Step 3 - Setting up webhooks and integration

Follow the steps to integrate Referral Rocket with Ghost.org to automatically track referrals/sign ups.

1. Go to your integration settings in campaign and click on Ghost

   

2. Click Connect

   
3. Copy the Webhook link and head to Ghost.org

4. Create a webhook in Ghost.org

   1. Add the link

   2. Select "Member Added" event

   3. Create a secret key

5. Copy the secret key and paste it into Referral Rocket.

6. Save

You are done connecting Referral Rocket with Ghost.org.

If you want referrer to earn a reward when the new user sign up, check the "Qualify referrer for reward on referred user signup" check box. If you want the referrer to earn a reward on payment leave it unchecked, instead connect your payment integration (eg stripe) to track payments.