> ## Documentation Index
> Fetch the complete documentation index at: https://docs.cello.so/llms.txt
> Use this file to discover all available pages before exploring further.

# Introduction

> Learn how to implement referral attribution to track signups and purchases back to their original referrers

Referral conversion enables you to track and attribute user signups and purchases back to their original referrers and reward them for conversions.

Cello helps you capture referral codes `ucc` from landing pages and maintains attribution throughout the entire user journey, from initial visit to final purchase.

# How it works

The referral conversion process follows a four-step attribution flow:

<img src="https://mintcdn.com/cello/6Zr08teY9AER0ncF/attribution/referral-conversion-tracking-overview-diagram.png?fit=max&auto=format&n=6Zr08teY9AER0ncF&q=85&s=8d2c7e1350fd617e8bab166e32948994" alt="Cello Referral conversion process four-step attribution flow overview diagram" width="2304" height="1216" data-path="attribution/referral-conversion-tracking-overview-diagram.png" />

1. **Referral Link Sharing** - Referrers share links containing unique codes (`ucc` parameters)
2. **Landing Page Capture** - Your website captures and stores referral codes `ucc` as first-party cookies
3. **Signup Tracking** - New user registrations are linked to their referrer
4. **Purchase Tracking** - Revenue events are attributed back to the original referrers

<Tip>
  Accurate referral conversion tracking depends on properly passing the referral code `ucc` through each step of the referral journey.
</Tip>

<Warning>
  **Attribution based on organization level**

  If the buying persona is the organization and you want to attribute purchases on the organization level always provide the **ID of the organization** in the parameter `payload.newUserId`
</Warning>

# Getting started with referral conversion tracking

Learn how to track conversions with Cello in the following resources:

<CardGroup cols={2}>
  <Card title="Web signup flow" icon="browser" href="/attribution/for-web">
    Capture referral code during web signup flow
  </Card>

  <Card title="Mobile signup flow" icon="mobile" href="/attribution/for-mobile">
    Capture referral code during mobile signup
  </Card>

  <Card title="Track signups" icon="user-plus" href="/sdk/client-side/embedded-script-tag">
    A full guide on tracking signup events
  </Card>

  <Card title="Track purchases" icon="credit-card" href="/sdk/client-side/embedded-script-tag">
    A full guide on tracking purchase events
  </Card>
</CardGroup>

or choose a step-by-step quickstart guide for your integration scenario:

<CardGroup cols={2}>
  <Card title="Stripe Webhook Quickstart" icon="book-open" horizontal={false} href="/attribution/use-cases/stripe" />

  <Card title="Chargebee Webhook Quickstart" icon="book-open" horizontal={false} href="/attribution/use-cases/chargebee" />
</CardGroup>
