Send a test to your experimentation platform
Create a Spar test as a draft in GrowthBook, Intelligems, or Convert, keep it in sync, and recover if the push fails.
If your team already runs experiments in GrowthBook, Intelligems, or Convert, you can design a test in Spar and send it there. Spar creates a draft experiment on the platform; you start it there, and its status and results sync back to the test in Spar.
If you don't use one of these platforms, leave tests on Spar. Spar serves the variation and does the stats itself.
1. Connect the platform
Go to Settings > Integrations, open the Experimentation tab, and click Connect on your platform:
- GrowthBook: an API key, plus the API base URL if you self-host.
- Intelligems: an API key.
- Convert: an API key and secret.
Setup details for each one are in Integrations.
2. Choose the platform on the Launch tab
Design the test as usual (see Run an A/B test end to end), then:
- Open the test's Launch tab.
- In the Experiment platform card, set Run this test on to your platform. An integration marked (read only) can't receive new drafts.
- Click Save changes. The launch bar counts unsaved settings as a blocker, so save before you push.
Once a platform is picked, the scheduling settings at the top of the tab are replaced by Scheduling runs in your platform: end date, sample size, and early stopping are all set on the platform. Changed your mind? Click Run on Spar instead.
3. Push it
The launch bar now reads Ready to create in your platform. Click Create in GrowthBook (or Intelligems, or Convert).
Before it lets you push, Spar checks a shorter list than for Spar-run tests: settings saved, a target page selected, at least one finished variation, a valid traffic split, and a primary objective. Click Review blockers to see what's missing.
While Spar creates the draft, the bar shows Creating draft in your platform. When it's done you'll see Synced with your platform.
4. Start it on the platform
Click Open in your platform and start the experiment there. Starting, stopping, and scheduling all happen on the platform. You can't drag a test that runs on another platform into Running on the Board.
5. Keep it in sync
The Experiment platform card on the Launch tab shows the linked experiment's External status, when it was Last synced, and its date range. Spar syncs on its own; click Sync now if you want the latest status right away. Results from the platform also show in that card.
To unlink a test from its platform experiment, click Disconnect. The experiment stays on the platform but is no longer attached to the test.
If the push fails
The bar reads Couldn't create the draft in your platform, with the error the platform returned. The same error appears in the Experiment platform card as Failed to create the draft in your platform.
- Read the error. If it points at your connection (credentials or permissions), fix it on the platform or under Settings > Integrations.
- Click Retry push.
If you'd rather not wait, click Switch to Spar in the Experiment platform card to run the test on Spar instead.
If the bar reads Draft created in your platform, but linking failed, the draft exists but Spar couldn't attach it to the test. Click Sync now to link it, or Open in your platform to check the draft.
Make a platform the default
If most of your tests go to the same platform, set it once:
- Go to Settings > Sync.
- Under Defaults, set Default experiment platform.
Defaults only apply going forward. Existing tests keep their platform.
To skip the manual push, turn on Sync to experiment platform under Test sync. Spar then creates the draft on your default platform automatically whenever you drag a test into the Draft lane on the Board. With it off, you push from the test yourself as described above.
Bring in experiments you started on the platform
Experiments created directly in your platform can be tracked in Spar too.
- From an opportunity: on the opportunity's full page, open the ... menu on Ideas and tests, choose Link external experiment, pick the experiment in the Import experiment dialog, and click Import experiment. Spar adds it as a test attached to that opportunity. Spar may also suggest matching experiments on the card; click Link to this opportunity to accept one.
- From a test: if a test is set to run on a platform but isn't linked yet, the Experiment platform card on its Launch tab has Link to your platform experiment. Pick the experiment and click Link.
Last updated on