Implement Session Replay with Google Tag Manager

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

Note

This article pertains to client-side GTM instrumentations only.

Enable Session Replay

To instrument Session Replay with Google Tag Manager:

Add the Google Tag Manager Web Template for Amplitude Analytics Browser SDK if it's not yet enabled.

Update the Amplitude tag template

A Session Replay toggle is available in the latest version of the Amplitude Analytics Browser SDK template.

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

Troubleshooting

Multiple instantiation of the Amplitude SDKs. This is a common problem seen with GTM and other code injection frameworks. Ensure that the initialization logic is only run once on your app. This could happen if:

There is more than 1 "Init Tag" or another custom tag that’s running Amplitude.
You have another Code Injection Framework (for example, SquareSpace or Bubble) that also runs Amplitude.

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