Advanced Matching

Advanced matching allows Whop to match events to users more accurately by sending customer identifiers alongside the event.

Important: Unlike TikTok and Meta, Whop expects customer fields in plain text. HandL sends them unhashed by design. Do not hash emails or phone numbers before passing them.

How It Works

Data Collection: When users fill out forms, HandL automatically captures customer details. Data is stored in localStorage with keys such as em (email) and ph (phone).
Automatic Merging: Every call to HandL.sendWhopEvent() merges any stored customer values into the event payload. Fields you pass directly always override the stored values.
External ID: Uses the first_handlID cookie as external_id. This is automatically generated on first visit.
Full Name: When a first or last name is available, HandL composes name automatically.

Manual Data Collection

You can pass customer fields directly on any event:

HandL.sendWhopEvent('lead', {
    event_id: 'lead_8f21c0',
    email: 'visitor@example.com',
    first_name: 'Jane',
    last_name: 'Doe',
    phone: '+15551234567'
});

Advanced Matching Parameters

Whop supports the following identifiers (all sent as plain text):

Parameter	Description	Source
`email`	User's email address	`localStorage.getItem('em')`
`first_name`	User's first name	`localStorage.getItem('fn')`
`last_name`	User's last name	`localStorage.getItem('ln')`
`name`	Full name	Composed from first and last name
`phone`	User's phone number	`localStorage.getItem('ph')`
`city`	User's city	`localStorage.getItem('ct')`
`state`	User's state	`localStorage.getItem('st')`
`postal_code`	User's postal code	`localStorage.getItem('zp')`
`country`	User's country	`localStorage.getItem('country')`
`external_id`	Unique identifier	`Cookies.get('first_handlID')`

Empty fields are dropped automatically and never sent.

Verification

To verify advanced matching is working:

Open browser DevTools (F12)
Go to the Network tab
Filter for t.whop.tw
Inspect the request payload and confirm your customer fields are present