Invite & Promo Tracking

The Invite & Promotion Tracking System in OneeChan allows server administrators to track invites, manage promotional campaigns, and analyze user growth through invite codes.

This system automatically tracks invites, logs who invited whom, and calculates promotional costs per user or verified member. Administrators can create, remove, and monitor promotional campaigns linked to invites.

Features

  • Invite Tracking – Detects which invite was used when a new member joins.

  • Invite Leaderboard – Displays top inviters for different time periods.

  • Promo Management – Assigns promotional campaigns to invite codes for tracking.

  • Cost Analysis – Tracks cost per join and cost per verified user for promotions.

  • Source Management – Allows tracking of invite sources (ads, campaigns, etc.).

  • Vanity URL Support – Logs vanity invite usage if enabled.

Invite System Slash Commands

/invites list – View Top Inviters

Required Permission: Administrator Description: Lists the top inviters in a selected time period.

Argument
Type
Required
Description

period

enum

✅ Yes

View invites for 24h, 7d, 14d, or 30d.

Example Usage

/invites list period:7d

Example Output:

/invites source – Manage Invite Sources

Required Permission: Administrator Description: Assigns, removes, or lists invite sources for tracking.

Argument
Type
Required
Description

action

enum

✅ Yes

Choose add, remove, or list.

invite_code

string

❌ No

Invite code to update (required for add).

source_name

string

❌ No

Source name to assign (required for add).

Example Usage

/invites source action:add invite_code:"abcd123" source_name:"Ad Campaign"

Example Output:

Invite 'abcd123' has been assigned to source 'Ad Campaign'.

Removing an Invite Source

/invites source action:remove invite_code:"abcd123"

Example Output:

Invite 'abcd123' has been removed from the source tracking.

Listing Invite Sources

/invites source action:list

Example Output:

Current Tracked Invite Sources:
- Invite: abcd123 | Source: "Ad Campaign"
- Invite: efgh567 | Source: "Partnership Event"

/invites lookup – Find Users Invited by a Specific User or Invite Code

Required Permission: Administrator Description: Finds users invited by a specific user or invite code.

Argument
Type
Required
Description

user

@user

❌ No

Look up users invited by a specific user.

invite_code

string

❌ No

Look up users who joined via a specific invite.

Example Usage

/invites lookup user:@UserA
/invites lookup invite_code:"abcd123"

Example Output:

Users invited by @UserA:
✅ - @NewMember1 (Joined 3 days ago)
❌ - @LeftMember (Joined 5 days ago, left 2 days ago)

Promo System Slash Commands

/promo add – Create a New Promo Campaign

Required Permission: Administrator Description: Creates a new promotional campaign linked to an invite.

Argument
Type
Required
Description

invite_code

string

✅ Yes

The invite code to link the promo to.

promo_name

string

✅ Yes

The name of the promo.

start_date

date

✅ Yes

The start date of the promo.

duration_days

int

✅ Yes

How long the promo lasts.

price

decimal

✅ Yes

The price of the promo campaign.

type

enum

✅ Yes

Type of promo (one-time, time-limited).

Example Usage

/promo add invite_code:"abcd123" promo_name:"Spring Sale" start_date:"01-04-2024" duration_days:30 price:100 type:time-limited

Example Output:

Promo 'Spring Sale' added for invite 'abcd123'.

/promo list – View Active Promotions

Required Permission: Administrator Description: Lists all active promotions currently running.

Example Usage

/promo list

Example Output:

Active Promotions:
1. 'Spring Sale' - Invite Code: abcd123 | Price: $100 | 30 days
2. 'Summer Boost' - Invite Code: efgh567 | Price: $200 | 14 days

/promo remove – Remove a Promo from an Invite Code

Required Permission: Administrator Description: Deletes a promo campaign linked to an invite.

Argument
Type
Required
Description

invite_code

string

✅ Yes

The invite code to remove.

Example Usage

/promo remove invite_code:"abcd123"

Example Output:

Promo 'Spring Sale' linked to 'abcd123' has been removed.

Last updated