Key Concepts
Welcome to the key concepts section of Cello's comprehensive referral program guide. Here, you'll get a high-level understanding of the fundamental components of our system. This overview lays the groundwork for further exploration of Cello's features and capabilities in the rest of our guide.
Let's dive in to explore each concept and build a robust referral program that provides a seamless user experience, and, ultimately, drives your growth.
Referral Component
Cello's Referral Component provides an efficient way to integrate a fully functional referral system into your web application. This versatile tool can be quickly customized and deployed, featuring an intuitive interface, a non-disruptive asynchronous loading, and the flexibility to adjust its appearance to match your unique application needs. Include the script in your web page, and with a simple initialization, you'll have a powerful referral program at your fingertips.
Unique campaign code (UCC)
A UCC or Unique campaign code is a unique identifier Cello uses to match a referrer (user sharing the product) and referee (potential new user being invited to the product) so that referrers can be rewarded for new users accordingly. Sometimes, UCC can also be referred to as a referral code.
The UCC is contained in a unique link generated for the referrer and is carried through each step of the referral process. See our docs on how to connect attribution.
Example of a UCC: UPobYBDuu0N
Example of a referral link with UCC: https://moonly.cello.so/UPobYBDuu0N
User Authentication
User authentication is vital for integrating the Cello Referral Component into your product securely. By utilizing JWT (JSON Web Token), Cello ensures the privacy and confidentiality of user-specific data like notifications and payout amounts. This involves generating server-side tokens using a unique user identifier (productUserId). With authentication, Cello creates a safe environment, seamlessly integrating the referral component and ensuring a secure user experience.
New User Discounts
Offering enticing discounts to new users significantly boosts conversion rates in your referral program. By utilizing Stripe's coupons and promotion codes, you can create discounts and attach them to new referred accounts manually or programmatically using the Stripe API, and validating Unique Campaign Codes (UCC) with the Cello API. Cello seamlessly communicates these discounts to new users on your signup pages with Personalized Messages
Attribution
Attribution is the cornerstone of a successful referral program, ensuring that every referrer is duly credited and rewarded for each new user they bring in. Integrating Cello's Attribution Library into your signup pages and transaction process allows you to trace new users back to their referrers, fostering a win-win environment for everyone involved.
Webhook Integrations
Cello's Webhook Integrations leverage your existing payment provider infrastructure to automate tracking, attribution, and reward payouts. By receiving real-time notifications of customer activities like payments and subscription changes, Cello promptly determines referral rewards, informs the referrers. This robust and secure automation ensures efficient running of your referral program. To set it up, you simply add a Stripe Webhook or Chargebee Webhook to your configuration, select the relevant events, and add the secure Signing Secret in the Cello Portal to secure the webhook.