# Conversion Events & Labels

Conversion events represent the key actions in your referral journey.&#x20;

## How Many Conversion Events Do You Want to Track?

In ReferralHero, you can track up to three conversion events and assign clear labels to each one. Each conversion event progresses through the following linear stages.

<figure><img src="https://363135598-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LsuqexOLPOWiUrWg_Ko%2Fuploads%2FOD1R38TnUzCzmKVzm936%2Fimage.png?alt=media&#x26;token=e51577dc-ee58-4ca1-9519-3cb1f29fe2f8" alt=""><figcaption></figcaption></figure>

#### **One Event**

Track a single key action, such as:

* Signing up for your newsletter
* Joining a waitlist
* Creating an account

**Best for:** Simple campaigns focused on one primary conversion.

#### **Two Events**

Track a two-step journey, such as:

* Signing up → Making a purchase
* Registering → Attending a webinar

**Best for:** Campaigns where a meaningful action follows the initial signup.

#### **Three Events**

Track a full customer journey, such as:

* Signing up → Attending a demo → Purchasing a plan
* Registering → Completing onboarding → Subscribing

**Best for:** More complex funnels, especially in SaaS or B2B with multiple engagement points.

## **Label Each Conversion Event**

Once you’ve selected how many events to track, assign a short and descriptive label to each one. These labels appear in your dashboard and are used throughout your campaign setup.

**Examples:**

* “Signed Up”
* “Attended Webinar”
* “Purchased Plan”
* “Upgraded to Pro”

Labels are used in:

* **Analytics** – Track how users move through your funnel

<figure><img src="https://363135598-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LsuqexOLPOWiUrWg_Ko%2Fuploads%2Fna0dxo9TYDCJW8KKgVQM%2Fimage.png?alt=media&#x26;token=261c0df0-3429-475e-b324-8fb1b4a24736" alt=""><figcaption></figcaption></figure>

* **Automations** – Trigger emails, webhooks, or SMS when a specific event is completed

<figure><img src="https://363135598-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LsuqexOLPOWiUrWg_Ko%2Fuploads%2FeNKzMSvmqqVyMWoiFYPY%2Fimage.png?alt=media&#x26;token=591cc89f-dfe7-4576-b118-89b368959e2f" alt=""><figcaption></figcaption></figure>

* **Reward Tracking** – Issue rewards only when subscribers hit specific milestones

<figure><img src="https://363135598-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LsuqexOLPOWiUrWg_Ko%2Fuploads%2Fb58wVBR1KZfXXqj6vIKx%2Fimage.png?alt=media&#x26;token=acef4a90-a1cd-464a-a409-fe9acc6b933e" alt=""><figcaption></figcaption></figure>

{% hint style="success" %}
**Tip:** If you're using integrations like API, Zapier, or webhooks, match your event labels to your actual event names or property values.
{% endhint %}

## **Unqualified Status**

Referrals can be marked as **Unqualified**, a non-linear status that sits outside the standard conversion flow and does not follow the usual Pending → Unconfirmed → Confirmed progression.

This status is used to identify referrals that should be excluded from progression through the standard funnel stages (for example: invalid, spam, or disqualified leads).

Referrals can be moved to **Unqualified** from any stage and restored to their original stage.

The label for this status can be customized (e.g. “Disqualified”, “Invalid Lead”).

<figure><img src="https://363135598-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LsuqexOLPOWiUrWg_Ko%2Fuploads%2FKo4jaAlo63GhEdnhLFId%2Fimage.png?alt=media&#x26;token=a12ab486-4be6-4122-90db-bf1367f2b4eb" alt="" width="563"><figcaption></figcaption></figure>

{% hint style="info" %}
**NOTES:**

* Marking a referral as **Unqualified** does not affect analytics calculations:
  * Referral counts remain unchanged
  * Original conversion events are preserved
* Unqualified referrals remain part of the referral system and may still be included in reward evaluation logic, depending on campaign configuration.
  {% endhint %}

### **Managing Unqualified Referrals**

#### **Moving Referrals to Unqualified**

Referrals can be marked as **Unqualified** through:

* Manual updates in the admin dashboard
* Bulk updates via CSV import
* REST API
* HubSpot integration
* GoHighLevel integration
* Zapier integration

#### **Restoring Referrals**

Referrals marked as **Unqualified** can be restored to their previous progression stage. When restored, the referral resumes its original stage.

Restoration is available via:

* Admin dashboard
* REST API
* Zapier integration

<figure><img src="https://363135598-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LsuqexOLPOWiUrWg_Ko%2Fuploads%2FnOHgjICCNDNgBq3ZmPj8%2Fimage.png?alt=media&#x26;token=97312661-3069-4528-bedb-1448aabdf1f1" alt=""><figcaption></figcaption></figure>

## **Referral Status**

Each subscriber’s progress is automatically reflected in their **Referral Status**, which updates as they complete each event. This status determines when rewards are issued to the advocate.&#x20;

✅ Learn more in the [Referral Status](https://support.referralhero.com/campaign-management/subscribers/subscriber-profile#referral-status) section.
