New User Discounts

Offering discounts or rewards to referees is a powerful strategy for improving signup conversion

Why discounts matter

The most effective referral programs offer value to both sides:

• Referrer rewards: Cash for successful referrals
• Referee discounts: Immediate value like percentage discounts or free months

This symmetric approach maximizes participation because referrers feel good about sharing something valuable, while referees receive immediate benefit for trying your product. According to referral program best practices, dual rewards can increase referral conversion rates by 30-50% compared to single-sided programs.

How to add discounts in Cello

Applying discounts is orchestrated in your subscription platforms. Please refer to our integration docs for guidance specific to your platform.

Before implementing the technical integration, you need to configure discount information in your Cello campaign. This allows the discount details to be displayed in the Referral Component offer and terms, and Landing page for new users, even though the actual discount application happens in your subscription platform.

Adding discount information to your campaign

1. Navigate to Campaign Settings: Go to Campaign settings in Cello Portal
2. Configure Discount Details: Add discount information by specifying:
   • Discount percentage: The percentage off the regular price (e.g., 50%)
   • Duration in months: How long the discount applies (e.g., 6 months)

3. Save Configuration: The discount information is now stored in your campaign configuration and can be retrieved via the getCampaignConfig() method from AttirbutionJS to display on your landing page.

Important: This configuration is for display purposes only. The actual discount application must be implemented in your subscription platform (Stripe, Chargebee, etc.) as described in the integration sections below.

Displaying discounts to new users

Once you’ve configured discounts in Cello, you can display this information to referred users through two main approaches: the automated New User Banner or custom landing page personalization.

Option 1: New User Banner (No-code solution)

Recommended for quick setup

The New User Banner is an automated banner that appears only to visitors who arrive through referral links. It requires minimal technical setup and handles personalization automatically.

How it works

The banner automatically displays:

• Referrer’s name (e.g., “Bob has invited you…”)
• Discount information from your campaign config
• Personalized call-to-action buttons
• Special messaging for referred users only

Setup steps

1. Add Attribution JavaScript

   Add the Cello Attribution script to your landing page:

   <script src="https://assets.cello.so/attribution/latest/cello-attribution.js"></script>
   

2. Enable banner in Cello Portal

   1. Go to New User Experience setup → Personalization tab
   2. Turn on the “New User Banner” option
   3. Customize the banner message and styling if needed

   

3. Configure personalization

   Ensure personalization is enabled in your user experience configuration and you are sending the name of the referrer in the productUserDetails when booting the widget, so referrer name appear in the banner.

Option 2: Custom Landing Page Personalization

Recommended for full control

For complete control over the user experience, implement custom personalization using Attribution JS methods.

Setup steps

1. Add Attribution Script Queue

   First, add this code before any Attribution calls to handle asynchronous loading:

   // Queue function to handle script loading
   window.CelloAttribution=window.CelloAttribution||function(t,...o){if("getReferral"===t)throw new Error("getReferral is not supported in this context. Use getUcc instead.");let e,n;const i=new Promise((t,o)=>{e=t,n=o});return window.CelloAttributionCmd=window.CelloAttributionCmd||[],window.CelloAttributionCmd.push({command:t,args:o,resolve:e,reject:n}),i}
   

2. Retrieve referral and discount information

   Use Attribution JS methods to retrieve referral and campaign configuration data:

   • window.CelloAttribution("getUcc")
   • window.CelloAttribution("getReferrerName")
   • window.CelloAttribution("getCampaignConfig")
3. Display discount on the landing page

   Display the discount inline on your landing page (e.g., a banner or callout). The values come from the campaign configuration retrieved in the previous step. The getCampaignConfig() method returns discount data in this format:

   // Example campaign config response
   {
       newUserDiscountPercentage: 0.25,  // 25% discount (decimal format)
       newUserDiscountMonth: 3           // For 3 months
   }
   

FAQ

Can I add different discounts for different campaigns?

Cello supports multiple campaigns with different discount structures, allowing you to offer varied incentives based on the referral source or campaign type.