Documentation

Zyro is a full-stack optimization platform. Unlike standard tools that just "test," Zyro uses Forensics to find broken UX and Bandit Algorithms to automatically generate revenue from winning variations.

Pro Tip: You don't need a developer to launch your first test. Our AI Editor generates high-converting headlines for you instantly.

Client-Side Installation

To enable Forensics, Heatmaps, and Traffic Analytics, install the Zyro snippet in the <head> of your website.

The Snippet

Replace YOUR_SITE_KEY with the ID found in Settings > Sites.

<script>
(function (w, d, s, v, z, n) {
    w.zyro = w.zyro || function () { (w.zyro.q = w.zyro.q || []).push(arguments) };
    w._zyroSettings = { siteKey: 'YOUR_SITE_KEY', version: 1 };
    z = d.createElement('script'); z.async = 1; z.src = s + w._zyroSettings.version + v;
    n = d.getElementsByTagName('head')[0]; n.appendChild(z);
})(window, document, 'https://www.zyro.world/scripts_tracker/zyro-tracker-', '.js');
zyro('track', 'pageview');
</script>

Verification

Once installed, go to Onboarding and click "Verify". The system will scan your live URL to confirm the tracker is firing.

Server-Side Testing (Zero Latency)

For developers who want absolute performance and no flicker, use our Server-Side API. This allows you to determine the variant before the HTML renders.

API Endpoint

POST https://www.zyro.world/api/zyro/v1/decide

Node.js Example

const axios = require('axios');

async function getVariant(userId) {
  const res = await axios.post('https://www.zyro.world/api/zyro/v1/decide', {
    SiteKey: 'YOUR_SITE_KEY',
    FlagKey: 'homepage_hero_test', // The Experiment Name
    UserId: userId
  });
  return res.data.VariationKey; // Returns 'control', 'B', 'C' etc.
}

Variant Editor & AI

Zyro provides a precise editor to rewrite headlines, swap images, or inject code without touching your codebase.

AI Copywriter

Inside the editor, click the "AI Rewrite" button. Our engine will analyze your control text and instantly generate 3 persuasive variations (e.g., adding urgency or simplifying language).

Supported Edit Types

Text: Simple string replacement for Headlines, CTAs, and Descriptions.
Image: Upload new assets directly to our CDN. We automatically swap the src attribute.
HTML: Full control to restructure lists, grids, or layouts.
JavaScript: Inject custom scripts (e.g., alert('Sale ending!');) that only fire for specific variation groups.

Anti-Flicker: Zyro automatically hides the target element for a few milliseconds while your changes apply, ensuring visitors never see the original content flash before the new version loads.

Auto-Pilot (Bandit Algorithms)

Standard A/B tests waste money by sending 50% of traffic to a losing page for weeks. Zyro offers a smarter way.

Thompson Sampling

When you select "Auto-Pilot" in the Experiment Setup, Zyro uses a Multi-Armed Bandit algorithm.

Real-Time Allocation: Every hour, the system recalculates the win probability of each variant.
Profit Maximization: If Variant B is winning, traffic shifts to 80/20 in favor of B automatically.
Use Case: Ideal for limited-time offers, sales, or headlines where you cannot afford to lose conversions while "testing."

Rage & Dead Clicks

Zyro doesn't just count conversions; it detects frustration.

Rage Clicks

Triggered when a user clicks an element 3+ times rapidly. This usually indicates:

A button is broken or slow to load.
An element looks clickable but isn't.
A confusing UI state (e.g., an error message didn't appear).

The Forensic Layer

Go to UX Insights to open the Forensic Overlay. We project a heat map onto your live site showing exactly where Rage Clicks are happening so you can fix the code.

User Journey DNA

Understand the "Golden Path" your most valuable customers take.

Sankey Diagrams

Located in Conversion Analytics, this visualizes traffic flow. It answers: "After landing on the Blog, do they go to Pricing or Features next?"

Actuarial Analysis

We assign a "Value per Visit" to every traffic source. This helps you realize that while TikTok brings more volume, LinkedIn visitors might have a 4x higher probability of conversion.

Integrations

Google Analytics 4 (GA4)

In the Experiment Settings, toggle "Push to GA4". Zyro will dispatch an event named experiment_impression with parameters for experiment_id and variant_name.

Segment.com

Toggle "Segment Integration" to push an Experiment Viewed track event. This allows you to analyze experiment data in Mixpanel, Amplitude, or your data warehouse.