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

# Affiliate campaigns

> Create and configure affiliate campaigns — define your commission structure, link products, connect funnels, and set up multi-tier commission tiers for your affiliate program.

An affiliate campaign is the foundation of your affiliate program. Each campaign defines where affiliate traffic comes from, which products earn commissions, and how those commissions are calculated. You can run multiple campaigns simultaneously — each with different products, commission structures, and groups of affiliates.

Navigate to **Marketing > Affiliate Manager > Campaigns** to create and manage your campaigns.

***

## What a campaign controls

| Setting              | What it does                                                                    |
| -------------------- | ------------------------------------------------------------------------------- |
| Source               | The funnel, website, form, survey, or calendar that affiliates drive traffic to |
| Products             | The specific products or services that generate commissionable sales            |
| Commission type      | Percentage of sale or flat dollar amount per sale                               |
| Commission length    | How long after the initial referral the affiliate earns commissions             |
| Variable commissions | Tiered rates that increase based on cumulative sales performance                |
| Multi-tier           | Two-tier structure rewarding affiliates who recruit sub-affiliates              |
| Cookie duration      | How long a referral click stays attributed to the affiliate                     |

***

## Creating a new campaign

<Steps>
  <Step title="Add a new campaign">
    In the Affiliate Manager, click **+ Add** in the upper-right corner. This opens the campaign creation form.
  </Step>

  <Step title="Name the campaign">
    Enter a clear, descriptive campaign name. If you run multiple campaigns, use names that make it immediately clear which products or audience the campaign targets — for example, "Summer Coaching Program" or "Partner Referral Program."
  </Step>

  <Step title="Choose the traffic source">
    Select where affiliate links will send referred visitors:

    * **Funnel** — a specific funnel page (must be connected to a domain)
    * **Website** — a page on your connected website (must be connected to a domain)
    * **Form** — a standalone form
    * **Survey** — a standalone survey
    * **Calendar** — a booking page

    The source determines which page the affiliate's unique tracking link points to. All purchases completed through that funnel or form will be tracked back to the referring affiliate.
  </Step>

  <Step title="Add products">
    Select one or more products from your product catalog that this campaign covers. Commissions are only generated when one of these products is purchased. If no products are added, the campaign cannot be activated.
  </Step>

  <Step title="Set the commission structure">
    Choose the commission model:

    **Percentage commission:** The affiliate earns a fixed percentage of each sale amount. For example, a 30% commission on a $500 sale pays $150 to the affiliate.

    **Flat amount commission:** The affiliate earns a fixed dollar amount per sale, regardless of the sale price. For example, \$50 per sale.

    To set different commission rates for individual products within the same campaign, click the **per-product commissions** toggle (two arrows icon) and set a rate for each product separately.
  </Step>

  <Step title="Set the commission length">
    Commission length defines how long after the initial referral the affiliate continues to earn commissions on repeat purchases by the same customer. For example, a 12-month commission length means that if a referred customer purchases again within 12 months, the original affiliate still earns a commission on that repeat sale.
  </Step>

  <Step title="Configure variable commissions (optional)">
    Variable commissions let you increase commission rates as affiliates hit cumulative sales milestones — useful for incentivizing top performers. Define multiple tiers, each with a minimum sales threshold and an increased commission rate.

    For example:

    * 0–10 sales: 20% commission
    * 11–25 sales: 25% commission
    * 26+ sales: 30% commission
  </Step>

  <Step title="Save the campaign">
    Click **Save**. The campaign is saved in an inactive state. You can return later to add affiliates and activate it. A campaign can only be activated once it has at least one product and at least one affiliate assigned.
  </Step>
</Steps>

***

## Multi-tier commissions

Multi-tier commissions reward affiliates for recruiting other affiliates. When a sub-affiliate makes a sale, both the sub-affiliate and the recruiter earn commissions.

To configure multi-tier commissions:

1. In the campaign settings, open the **Multi-Tier Commission** section
2. Set the **Tier 1 commission** — the rate paid to the affiliate on their own direct sales
3. Set the **Tier 2 commission** — the rate paid to the recruiter when one of their recruited sub-affiliates makes a sale
4. Enable **Sub-Affiliate Sign Ups** if you want affiliates to be able to recruit others using a self-service sign-up link

<Note>
  Multi-tier commissions are limited to two tiers (the direct affiliate and one level of recruiter above them). Sub-affiliates earn commissions only on their own sales, not on any further affiliates they recruit.
</Note>

***

## Pay-per-lead campaigns

If your business model involves paying affiliates for qualified leads rather than completed sales, configure pay-per-lead:

1. In the campaign commission settings, enable **Pay-Per-Lead**
2. Set the flat fee paid per qualified lead submitted through the affiliate's tracking link

Pay-per-lead commissions are triggered when a contact is created through the affiliate's source (funnel, form, etc.) regardless of whether a purchase occurs.

***

## Running multiple campaigns simultaneously

You can have any number of campaigns active at the same time. Common scenarios include:

* **Separate campaigns per product line** — so each product has its own commission structure and affiliate group
* **Client-specific campaigns** — for businesses managing multiple products or programs through the Affiliate Manager
* **Time-limited campaigns** — promotional campaigns with elevated commission rates for a fixed period, run alongside an always-on base campaign
* **Tier-based campaigns** — a standard campaign for general affiliates and a premium campaign with higher rates for top performers

Affiliates can be enrolled in multiple campaigns. Their stats are tracked separately per campaign, so you can see exactly which campaign is driving results from each affiliate.

<Tip>
  Give each campaign a distinct, recognizable name and include it in your affiliate communications so affiliates always know which campaign and tracking link they should be using for each product.
</Tip>

***

## Frequently asked questions

<AccordionGroup>
  <Accordion title="Can I change the commission rate on an active campaign?">
    Yes. Commission rate changes take effect for future sales from the moment the change is saved. Sales already recorded before the change retain the commission rate that was in effect at the time of the sale.
  </Accordion>

  <Accordion title="What happens if I add a new product to an active campaign?">
    Adding a product to an active campaign makes it immediately eligible for commissions. Affiliates do not need to be notified or re-enrolled — their existing tracking links will now generate commissions when the new product is purchased.
  </Accordion>

  <Accordion title="Can I limit which affiliates belong to a specific campaign?">
    Yes. Each affiliate must be explicitly enrolled in a campaign. Enrollment does not happen automatically when a campaign is created — you add affiliates to campaigns individually or in bulk from the Affiliates section.
  </Accordion>

  <Accordion title="What is the difference between commission length and cookie duration?">
    Cookie duration is how long a click on an affiliate's link is attributed to that affiliate for conversion tracking — if someone clicks a link today and buys 45 days later, a 60-day cookie would still credit the affiliate. Commission length is how long after the first purchase an affiliate keeps earning on that same customer's repeat purchases — a 12-month length means they earn on any repeat buys within the next year.
  </Accordion>

  <Accordion title="Can a campaign link to an external website not built in the HoopAI platform?">
    Yes. The Affiliate Manager supports external website campaigns. You can set an external URL as the campaign source and use a universal tracking snippet to monitor conversions across your entire external domain with a single integration.
  </Accordion>
</AccordionGroup>

***

## Multi-tier commissions setup (detailed)

Multi-tier commissions create a two-level reward system: affiliates earn on their own sales (Tier 1) and on sales made by affiliates they recruit (Tier 2).

### Configuration

<Steps>
  <Step title="Open campaign settings">
    Edit your campaign and scroll to the **Multi-Tier Commission** section.
  </Step>

  <Step title="Set Tier 1 rate">
    This is the commission the affiliate earns on their own direct sales. Example: 25%.
  </Step>

  <Step title="Set Tier 2 rate">
    This is the commission the recruiting affiliate earns when their sub-affiliate makes a sale. Example: 5%. The sub-affiliate still earns their full Tier 1 rate.
  </Step>

  <Step title="Enable sub-affiliate signups">
    Toggle on **Sub-Affiliate Sign Ups** so affiliates can share a recruitment link from their portal.
  </Step>
</Steps>

**Example:** Affiliate A recruits Affiliate B. A sale of \$1,000 occurs through Affiliate B's link:

* Affiliate B earns \$250 (25% Tier 1)
* Affiliate A earns \$50 (5% Tier 2)
* Total commission paid: \$300

***

## Commission length and variable commissions (detailed)

### Commission length

Commission length defines how long an affiliate continues earning on repeat purchases from a customer they referred:

| Setting       | Meaning                                                             |
| ------------- | ------------------------------------------------------------------- |
| **One-time**  | Commission on the initial sale only                                 |
| **3 months**  | Commission on any purchases within 3 months of the initial referral |
| **6 months**  | Commission for 6 months                                             |
| **12 months** | Commission for 12 months (common for SaaS with monthly billing)     |
| **Lifetime**  | Commission on all future purchases by that customer, indefinitely   |

### Variable commissions

Variable commissions reward top performers with escalating rates:

1. Open the campaign settings and click **Variable Commissions**
2. Define tiers:
   | Sales milestone | Commission rate |
   | --------------- | --------------- |
   | 0-10 sales      | 20%             |
   | 11-25 sales     | 25%             |
   | 26-50 sales     | 30%             |
   | 51+ sales       | 35%             |
3. The affiliate's rate automatically increases when they reach each milestone
4. Milestones are calculated on cumulative sales within this campaign

***

## External website support

Run affiliate campaigns on websites not built in the HoopAI platform:

1. Set the campaign source to **External Website**
2. Enter the external URL as the campaign destination
3. Copy the **Universal Tracking Snippet** — a JavaScript code block
4. Add the snippet to your external website's header or footer
5. The snippet tracks affiliate link clicks and conversions across your entire external domain

<Note>
  The universal tracking snippet must be installed on all pages of your external site where conversions can occur. Without it, sales will not be attributed to affiliates.
</Note>

***

## Referral link click tracking

Track how affiliate links perform before conversions happen:

* **Click counts** — see how many unique and total clicks each affiliate's link receives
* **Click-to-lead rate** — percentage of clicks that result in a lead (form submission or contact creation)
* **Click-to-customer rate** — percentage of clicks that result in a paying customer
* **Click timeline** — view click activity over time to identify trends and promotional effectiveness

Access click data in the **Affiliates** section by clicking on an individual affiliate's profile, or in the campaign overview for aggregate click statistics.
