Browser extension

The PixelFox extension turns event mapping into "click the button that means Add to cart". It runs in your browser, in your own logged-in session, so it can see everything the anonymous crawler cannot: the cart, every checkout step, the order-confirmation page.

Install

1. Download the extension from the dashboard (Settings → Browser extension) and unzip it.

2. Open chrome://extensions, switch on Developer mode, choose Load unpacked and pick the unzipped folder. Chrome 114 or newer; Edge and Brave work the same way.

3. Click the PixelFox icon - it opens as a side panel - and press Connect with PixelFox. A dashboard window asks you to approve the connection and closes itself.

   If the pop-up is blocked, generate a token under Settings → Browser extension and paste it instead. Either way the extension holds a revocable 90-day token, never your dashboard session.

Discover

Pick the site, press Start recording, then walk your storefront: browse, add to cart, go through checkout. Every page is swept for buttons, links and forms - with re-scans after the page settles and on DOM changes, so lazy-loaded grids and modals are caught. Stop & save uploads the pages to Discovered elements, where the dashboard picker and the AI suggester can use them.

Turn on the element picker to capture specific elements by clicking them. Clicks still work - the page adds to cart, navigates, submits - so one pass covers the whole funnel.

Map

The Map tab lists the standard conversions (recommended ones for your business category first), each ad platform's own event names, and the steps of every saved funnel. Press Map, then click the matching element on the page:

• The default selector is the stable one - test ids, a readable id, name, href, aria-label, semantic classes; hashed or utility classes are rejected. It usually matches every equivalent button on the page (all six "Add to cart" cards), which is what you want. The tooltip shows how many it matches before you click.
• Alt+click maps exactly the element under the cursor, for the rare case where two identical-looking buttons mean different things.
• Mapping stays armed across page loads on the same site, so you can map Initiate checkout on the cart page and Add payment info two pages later without re-arming.
• Repeat mappings extend one definition (its selectors accumulate); a mapping made from a platform's own tab routes the event only to that platform until you map it elsewhere.

Purchase and product-view are pages rather than buttons: Map offers the open tab's URL as a pattern instead.

Customer fields

Under a mapped checkout, lead or signup event the panel shows field chips: Value, Email, Phone, First name… Click one, then click the input on your page. The tag reads that input when the event fires and the backend hashes it into the Meta and TikTok match keys - see match quality. Alt+click a chip to clear it.

Funnels

The Funnels tab builds ordered funnels from templates or from scratch, and asks the AI to propose them from what discovery found. Mapping a funnel step writes the step's own event name, so the funnel report is fed exactly what it was defined against.

Security notes

• The content script that runs inside your pages holds no credentials and makes no API calls; only the background worker talks to PixelFox, with the bearer token.
• Recording is locked to the selected site's hostname. Pages elsewhere are ignored, and a mapping picked on another site is refused.
• Tokens are listed and revocable under Settings → Browser extension.