For the complete documentation index, see llms.txt. Markdown versions of documentation pages are available by appending .md to page URLs.
Skip to content

▪️Session replay (FullStory, Amplitude)

If you record your site with FullStory or Amplitude Session Replay, the Smartico Gamification widget can be recorded too, in the same session as the rest of your page. Without this setting, the widget plays back as an empty box.

Smartico supports FullStory and Amplitude for now. If you use another session replay tool, please contact your Customer Success Manager: more tools can be added on request.

How it works

The widget runs in an iframe on the domain your Smartico script loads from (libs.smartico.ai, or your own domain), and session replay tools cannot see into iframes from other domains. With session replay turned on, the widget starts your replay tool inside its iframe, in the tool's official iframe mode:

  • the widget is recorded into your page's session, not into a separate one;

  • it records only while your page is recording, so your consent and sampling rules still apply.

Set it up

Add analytics_bridge to your _smartico.init call:

_smartico.init('<label key>', {
    brand_key: '<brand key>',
    analytics_bridge: { vendor: 'fullstory', key: '<org id>' },
    // or: { vendor: 'amplitude', key: '<api key>' }
});

Tool

vendor

key

Extra step on your site

FullStory

fullstory

The org id from your FullStory snippet, e.g. o-ABC123-na1

None. If your FullStory org records only listed domains, add the domain your Smartico script loads from: libs.smartico.ai by default, or your own domain if Smartico serves the script from it.

Amplitude

amplitude

Your Amplitude project API key

Add crossOriginIframes: { enabled: true, coordinateChildren: true } to your Session Replay setup (the plugin or the standalone SDK).

FullStory orgs in any region work: the region is read from the org id (for example -eu1).

Check it

  1. Open your site, start a recorded session, and use the Gamification widget for a minute.

  2. Find the session in your tool:

    • FullStory: run FS('getSession', { format: 'url' }) in the browser console;

    • Amplitude: run amplitude.getSessionId() in the browser console.

  3. Play the session. The widget should play inside your site's recording.

Good to know

  • The widget is recorded like the rest of your page, including the player's username, avatar and balances. Apply your usual privacy rules.

  • Mini-games drawn on a canvas, such as Plinko and Scratch card, may play back as an empty area.

  • To turn session replay off, remove analytics_bridge from the _smartico.init call.

Last updated

Was this helpful?