Embeddable Widgets

Ovyxa lets you embed live analytics views into any webpage — your marketing site, internal dashboard, blog, or investor updates. You can also create shared dashboard links for stakeholders who do not have an Ovyxa account.

---

Shared Dashboard Links

The simplest way to share analytics is a read-only dashboard link.

1. Go to Settings → Visibility → Shared Links.
2. Click Create Shared Link.
3. Optionally set a password for access control.
4. Copy the generated URL:

https://app.ovyxa.com/share/example.com?auth=sh_abc123def456

Anyone with the link (and password, if set) can view the full dashboard in read-only mode. They cannot modify settings, goals, or filters. Shared links do not expire unless you revoke them.

---

Embedding with an iframe

Use the shared link as an iframe source to embed the full dashboard:

<iframe
  src="https://app.ovyxa.com/share/example.com?auth=sh_abc123def456&embed=true"
  width="100%"
  height="800"
  frameborder="0"
  loading="lazy"
  style="border: 1px solid #e5e7eb; border-radius: 8px;"
></iframe>

The embed=true parameter removes the Ovyxa navigation header and footer, giving you a clean embedded view.

---

Query Parameters for Customization

Append these parameters to the shared link URL to control what the embedded view shows:

Parameter	Example	Description
embed	true	Removes navigation chrome
theme	light or dark	Force a color theme
period	30d, 7d, month, 12mo	Default date range
filters	source==Google;country==US	Pre-apply filters
tab	sources, pages, countries	Default active tab
hide	datepicker,filters	Hide specific UI elements
accent	#6366f1	Custom accent color (hex)
revenue	true	Show revenue columns by default
background	transparent	Transparent background for seamless embedding

Example: embed sources widget with custom accent

<iframe
  src="https://app.ovyxa.com/share/example.com?auth=sh_abc123&embed=true&tab=sources&period=30d&accent=%236366f1&background=transparent"
  width="100%"
  height="500"
  frameborder="0"
></iframe>

---

Embedding Specific Widgets

Instead of the full dashboard, you can embed individual components:

Visitor counter

A small badge showing current active visitors:

<iframe
  src="https://app.ovyxa.com/share/example.com?auth=sh_abc123&widget=realtime-counter"
  width="200"
  height="60"
  frameborder="0"
></iframe>

Chart only

Just the main timeseries chart:

<iframe
  src="https://app.ovyxa.com/share/example.com?auth=sh_abc123&widget=chart&period=30d&metric=visitors"
  width="100%"
  height="300"
  frameborder="0"
></iframe>

Available metric values: visitors, pageviews, bounce_rate, visit_duration, revenue.

Top sources table

<iframe
  src="https://app.ovyxa.com/share/example.com?auth=sh_abc123&widget=sources&period=30d&limit=10"
  width="400"
  height="500"
  frameborder="0"
></iframe>

Available widget values: chart, sources, pages, countries, devices, realtime-counter, overview-stats.

---

API-Powered Custom Embeds

For full control over presentation, use the Stats API and build your own widgets:

const response = await fetch(
  'https://api.ovyxa.com/api/v1/stats/overview?site_id=example.com&period=30d',
  { headers: { 'Authorization': 'Bearer YOUR_API_KEY' } }
);

const data = await response.json();
// Render data.visitors, data.pageviews, data.revenue in your own UI

This approach lets you match your brand's design system exactly and combine Ovyxa data with other metrics.

---

Security Notes

• Shared links are scoped to a single site and are read-only.
• Password-protected links require the password on first access (stored in a session cookie).
• You can revoke a shared link at any time from Settings → Visibility.
• Embedded iframes respect the X-Frame-Options header. Ovyxa allows framing for shared links by default.
• API keys used for custom embeds should use the read:stats scope only.