On this page

Implement Session Replay with Google Tag Manager

Instrumenting Amplitude Session Replay with Google Tag Manager requires a different procedure than the standard Browser SDK Plugin.

This article applies to client-side GTM instrumentations only.

Enable Session Replay

To instrument Session Replay with Google Tag Manager:

  1. Add the Google Tag Manager Web Template for Amplitude Analytics Browser SDK if you haven't enabled it.

Update the Amplitude tag template

The latest version of the Amplitude Analytics Browser SDK template includes a Session Replay toggle.

  1. In Google Tag Manager, create a new tag using the Amplitude template, or edit an existing tag based on the template.
  2. In the tag's Initialization section, select Enable Session Replay Plugin.
  3. In Amplitude, navigate to Organization Settings > Session Replay Settings. Update any masking, sample rate, or other settings.

Troubleshooting

Multiple instantiation of the Amplitude SDKs is a common problem with GTM and other code injection frameworks. Make sure the initialization logic runs only once in your app. Multiple instantiation can happen if:

  • More than one "Init Tag" or another custom tag runs Amplitude.
  • Another code injection framework (for example, SquareSpace or Bubble) also runs Amplitude.

This template uses the Amplitude Browser SDK Plugin. For troubleshooting help, refer to Troubleshooting | Session Replay Plugin.

Was this helpful?