Referred Users and Referral Tracking

How Toppal tracks referred users and how to view transaction details.

Written By Tyler

Last updated 8 minutes ago

How Referral Tracking Works

  1. Affiliate shares their link: https://{marketplace}/signup?referrerID={code}

  2. User clicks and signs up on your Sharetribe marketplace

  3. The referrerID is captured during signup

  4. Sharetribe stores it as private user data

  5. Toppal reads the attribution during event sync

  6. The user appears as a referred user

Viewing Referred Users

On the affiliate detail page, the Referred Users table shows:

Name

Referred user's name

Email

Email address

Signup Date

When they signed up

Listings

Number of listings created

Purchases/Sales

Counts and values

GMV

Total gross merchandise value

Payout Value

Total payout value generated

Transaction Drill-Down

Click a referred user to see each transaction: ID, role (buyer/seller), state, eligibility, GMV, revenue, payout value, and transition history.

Eligibility Reasons

When ineligible: "Affiliate not active", "Transaction below minimum value", "Transaction limit reached"

Retroactive Attribution

If a referrer code is added after signup, Toppal attributes the user on the next sync cycle.