Install RightMessage with Google Tag Manager

Add RightMessage through Google Tag Manager so you can ask visitors questions and personalize your website without editing its code directly. You'll install the project snippet, then publish your questions, offers, or campaigns separately in RightMessage.

Add the snippet to your container

You'll need a Google Tag Manager web container installed on your site, permission to edit and publish it, and access to your RightMessage project. Check your theme, plugins, and container for an existing RightMessage installation. Use only one copy per page.

If you're changing visible page content, direct installation in your site's head can reduce loading delay. With Tag Manager, its container must load and fire the tag first. Neither method guarantees that the original content will never flash.

1. In RightMessage, select your project and open Settings > JavaScript Snippet under Project.
2. Keep Live website selected and copy the full Snippet Code.

Enlarge

RightMessage live-website Snippet Code panel with the Copy to clipboard icon highlighted in orangeOriginalOriginal

3. In Google Tag Manager, open your site's web container and choose Tags > New.
4. Name it RightMessage. Open Tag Configuration and choose Custom HTML.
5. Paste the full snippet into the HTML field, including its script tags.
6. Open Triggering, select All Pages, and save the tag.

Keep required consent controls in place. If your installation should cover only selected pages, use a trigger limited to those pages instead. The snippet runs only when its trigger and consent requirements allow it. You don't need Support document.write. Google's Custom HTML guide (opens in a new tab) covers the tag editor.

For a separate test environment, read the live and development snippet reference before choosing Staging / development. That code requests an authorized draft debugger session and disables analytics.

Publish the tag

1. Choose Preview in Tag Manager and check that the RightMessage tag fires once on a page where it should run.
2. Check another included page and any excluded page.
3. Choose Submit > Publish and Create Version.
4. Review Workspace Changes, including any changes unrelated to RightMessage.
5. Enter a Version Name and Version Description, confirm the intended environment, and choose Publish.

Saving or previewing the tag doesn't release it. If you can't publish, send the change to the container owner. Google's publishing guide (opens in a new tab) explains its approval controls.

Check that it's working

1. Visit your public website outside Tag Manager preview.
2. In RightMessage, open Settings > JavaScript Snippet and look for a recent timestamp in Snippet Health.

Enlarge

Snippet Health showing the last data receipt timestamp for the local example projectOriginalOriginal

A recent timestamp means RightMessage is receiving data. Use the debugger to see what it's showing on the page.

If no data arrives, check the tag's firing, consent state, project snippet, and published container version. Installation troubleshooting also helps when the snippet loads but nothing appears.

Next, build a resource recommendation in the app. RightMessage's Publish action is separate from publishing your Tag Manager container.