Google Analytics

There are two ways to get LiveDemo events into GA4. You can use both.

Server-side GA4

LiveDemo sends events straight to GA4 with the Measurement Protocol.

1. In GA4, go to Admin → Data streams, open your web stream and copy the Measurement ID (G-…).
2. On the same page, open Measurement Protocol API secrets and click Create. Copy the secret.
3. In LiveDemo, open Settings → Webhooks, Slack & server-side analytics and click Add GA4.
4. Paste the Measurement ID and the Measurement Protocol API secret.
5. Keep all events or remove the ones you don't want, then click Save ("GA4 connected").
6. Click Send test. You'll see "Delivered (HTTP …)". Check Realtime or DebugView in GA4.

Only the workspace Admin on the Growth plan can add it. The secret is stored encrypted.

Each destination shows its last delivery or error. Turn it off with the switch, or Delete it.

Events

Parameters, when known: session_id, demo_id, demo_name, agent_id, agent_name, intent, qualified, demos_opened and country. Names and emails are never sent.

Server-side events use the LiveDemo session as the GA client, so they show up as their own users in GA4, not joined to your website visitor. To join them, use the browser method below.

From your website

With the AI Demo Agent widget

If your page has the widget script, events are forwarded to your own analytics automatically:

• to gtag() if it exists, otherwise to dataLayer (Google Tag Manager)
• and to Segment's analytics.track() if it exists

This includes demos the agent opens. Turn it off with data-analytics="off" on the script tag.

With a plain embed

Embedded demos post every event to your page. Forward them with a few lines:

window.addEventListener('message', (event) => {
    if (event.origin !== 'https://story-api.livedemo.ai') return
    if (event.data?.type !== 'livedemo:event') return
    gtag('event', event.data.name, event.data.properties)
})

For Google Tag Manager, use window.dataLayer.push({ event: event.data.name, ...event.data.properties }) instead.

The AI Demo Agent widget also sends livedemo_agent_open, livedemo_agent_demo_open, livedemo_agent_calendar_open, livedemo_meeting_booked, livedemo_cta_click and livedemo_lead_captured.

In GA4, register parameters such as demo_name and step_number as custom dimensions to report on them.

Next: Segment