Skip to content

Custom events

Record any action, such as a signup or a purchase, with one call. Custom events never count toward your plan's pageviews.

nocrumbs('Signup', { props: { plan: 'Starter' } });

The first argument is the event name. The optional props add details you can break down and filter by in the dashboard on Starter and up. On the Free plan they are still collected, and you can use them after an upgrade.

Revenue

Add the amount and its currency to an event, such as a purchase, and the goal for that event shows the revenue next to its conversions, also per source, channel, campaign, and page:

nocrumbs('Purchase', { revenue: { amount: 49.99, currency: 'USD' } });

The currency is a three-letter code (USD, EUR, GBP). Amounts are kept to the cent and added up per currency, with no conversion between currencies. Pageviews never carry revenue.

Calling it before the script loads

The script loads with defer, so it may not be ready when your code runs. Add this line before any call, and early events wait until the script is ready:

<script>window.nocrumbs = window.nocrumbs || function () { (window.nocrumbs.q = window.nocrumbs.q || []).push(arguments); };</script>

Limits

  • Event names can be up to 64 characters. pageview and engagement are reserved.
  • Up to 30 properties per event. Property names use letters, numbers, and underscores, up to 64 characters.
  • Property values are text, numbers, or true and false, up to 300 characters. Longer values are left out.
  • A revenue amount is a number from 0 up to one billion. An amount or currency that does not fit is left out, and the event still counts.

Keep personal details out

Never put names, email addresses, or other personal details in events or properties. NOCRUMBS™ is built to hold nothing that identifies a person, and your events should keep it that way.