Connect Vturb and read your VSL metrics
Connect your Vturb account with its Analytics API key and Clickmax starts listing your videos in the page editor and showing each VSL's metrics — play rate, engagement, retention and A/B test comparisons — without you opening the Vturb dashboard.
Before you start
- Workspace role: Owner, Administrator, Editor or Collaborator. The Finance, Guest and Agent roles have no access to Integrations.
- A Vturb account with the Analytics API enabled.
- Each workspace can have one connected Vturb account.
Step by step
- In Clickmax, open Integrations > Explore integrations and, under Video and VSL, pick the Vturb card.
- In another tab, sign in to Vturb and copy the key from Settings > Analytics API.
- Back in Clickmax, paste it into the API key field.
- (Optional) Paste the embed code of any video in your account. See below for what it is used for.
- Click Connect account.
Clickmax validates the key against Vturb before saving: if it is wrong or inactive, the connection is not created and you get the error right away.
Once connected, Vturb shows up under Integrations with status Active and the date it was last validated.
What the embed code is for
The API key grants access to the metrics, but Vturb's API does not tell us which account it belongs to — and that identifier is required to build the player address when you pick a video from the editor.
The embed code solves it: Clickmax extracts only the account identifier from it. That is why the field is optional when connecting:
- embed pasted: videos already show up with thumbnails in the editor and can be applied to pages;
- no embed: the connection works and the metrics are available, and the editor asks for the embed the first time you open a Vturb block.
To copy the embed, open any video in the Vturb dashboard and use the </> button. Paste the whole snippet — Clickmax discards the rest.
Connecting from the editor
While building a page you do not have to leave it: add or select a Vturb block and use the Connect API tab in the right sidebar.
It is the same connection either way — connecting in one place counts for the other, because there is only one Vturb account per workspace.
One video per page
The same Vturb video cannot be applied twice on the same page. The player uses the video identifier as the element identifier on the page, so a second block with the same video would not work on the published page.
In practice: when you pick a video already used on that page, the card is disabled and Clickmax warns you. Pick another video or remove the previous block.
How to read the metrics
Rates are shown as percentages in the interface. When interpreting them:
Period metrics refresh every few minutes, so they do not reflect the current minute.
A/B tests
When a video is part of a Vturb A/B test, Clickmax compares the variants side by side and shows the per-second retention curve.
Two traps when calling a winner:
- decide by revenue per visitor, not conversion rate — a variant can convert less and still earn more per visitor;
- if the test is still running, the numbers are a trend, not a verdict: traffic is still being split.
See the metrics inside the funnel
On the funnel canvas, a page card that has a Vturb video gets a Vturb row, right below the products. Click it to open that video's metrics without leaving the funnel.
The block only shows up when both are true: Vturb is connected in the workspace and Clickmax detected a player on that page. Pages without a VSL are unchanged.
The date range is the same one from the funnel's Analytics panel. Changing the range there changes it here too, so the video's numbers and the funnel's numbers always describe the same window of time.
External pages need a scan
On a page built in Clickmax's editor, detection is automatic: it happens when you save the page.
On an external page (your own site, outside Clickmax) Clickmax cannot read the content on its own. Open the card's menu and use Scan triggers: the page opens in a new tab, is read right there, and when you come back the card already shows the Vturb row.
A page saved in the editor before this update doesn't have its video detected yet. Open it in the editor and save once for the row to appear.
One block per video
If the page has more than one Vturb video, all of them show up in the same panel, one metrics block per video.
When a video applied to the page has been deleted in Vturb, its name can no longer be resolved and Clickmax shows the video identifier instead — enough to find it in the Vturb dashboard.
When the scan doesn't find the VSL
Not every external page hands the video over to the scan: sites that mount the VSL a few seconds late, non-standard embed formats, or pages behind a login. For those, you can link it by hand.
On the page card, open the menu (⋮) and choose Link a Vturb video. Clickmax lists the videos in your account — pick one or more and save. Videos already detected automatically show up marked and don't need to be selected.
If the video isn't in the list, paste the Vturb embed code into the field at the bottom of the panel.
To remove a link, open the same panel: manually linked videos show at the top, each with a trash button. Removing all of them returns the page to the same state as never having linked anything — automatic detection still applies.
A manual link is never erased by a new scan or by saving the page in the editor. If automatic detection later finds the same video, it still shows up only once.
The menu item only appears when Vturb is connected.
"Invalid credential" status
It means the connection exists but Vturb rejected the key — usually because it was revoked or expired in the Vturb dashboard.
To fix it, open the integration under Integrations and paste a new key. You do not need to disconnect first.
Disconnecting
Under Integrations, open Vturb and click Disconnect.
The key is deleted — Clickmax does not keep a credential you have already revoked. Videos already applied to published pages keep working, because the player is in the page HTML; what stops working is the video list in the editor and the metrics panels.