Quickstart
From a new site to a running experiment: install the snippet, define a goal, create a variant and start.
Before you start#
You need an account (create one) and the ability to add one script tag to the <head> of the site you want to optimize. The whole setup takes four steps: add the site, install the snippet, define what a conversion is, and start an experiment.
Roles matter for a few of them: an admin adds sites, a member creates goals and experiments, a viewer can read everything but change nothing.
Four steps to a running experiment#
Add your site
In the dashboard, add a site with its name and domain (
example.com, without scheme or path). Subdomains of the domain are accepted automatically; list any other host the site is served from as an extra domain. Events from hosts that are not listed are rejected.Install the snippet
The site's Install page shows a tag with your site key. Paste it as high in the
<head>as you can, on every page:Install taghtml <script src="https://lift.example.com/s/lift_pk_YOUR_SITE_KEY"></script>The tag is synchronous on purpose — that is what lets a variant be in place before the page is first painted. Platform-specific instructions are in Installing the snippet.
Then run the installation check on the same page. It fetches your home page and looks for the tag; the site also turns from pending to active the first time the snippet reports from a real page view.
Define a goal
A goal is the conversion an experiment is judged on. On the site's Goals page, pick the type that matches what you want more of:
- Click on an element, by CSS selector — a call-to-action button.
- Form submit — a lead form.
- Page view of a URL — a thank-you page.
- Custom event or revenue, reported from your own code.
Reporting a custom eventjs // Converts every custom goal whose event name is "signup_completed". lift.track('signup_completed'); // Only the name and a numeric "value" are used. Any other property is ignored: // it is not sent to Avenue Lift and not forwarded to your analytics integrations. lift.track('plan_selected', { value: 49 });Details and attribution rules are in Goals and conversion tracking.
Create an experiment and start it
Create an experiment on the site, choose the page it runs on and its primary goal, then add at least one variant. There are three ways to write one:
- the visual editor, on your live page;
- an idea from the site's Ideas backlog, which becomes a draft experiment with its variant already written;
- AI-written challengers, which wait for your review before they go live.
Open the variant's preview link to see it on the real page, then press Start. A launch checklist runs first. It blocks a start that could not work — no primary goal, no active variant to test — and warns about the rest, such as a snippet that has not been seen on the site yet.
Check that it works#
Open a page the experiment targets with ?lift_debug=1 added to the URL. A small QA panel appears with the snippet's mode, the variant you were assigned and the events it has sent.
https://www.example.com/pricing?lift_debug=1From the browser console, lift.debug() returns the same state as an object. See Preview and QA debug mode.
Nothing shows up?
What happens next#
Visitors are split between the original page and your variants. Results appear on the experiment page as soon as there is traffic; a recommendation to ship or stop follows once there is enough evidence. With bandit allocation, Avenue Lift also moves traffic toward what is converting while the experiment runs.
- Experiments and the bandit — how to read the numbers.
- Autopilot and AI review — let the product write challengers and act on results.
- Anti-flicker and performance — what the snippet does to page load.