How to install Attriboo on Ruby on Rails

Before you start

This guide covers Rails HTML pages using an ERB layout. If the project uses Haml or Slim, ask its developer for the equivalent template syntax. If controllers use a different layout, include tracking in that document too. An API-only Rails app needs tracking in its frontend.

Add the published domain in Attriboo. Keep one tracking installation and preserve your site’s consent choices. Your website ID is public; private API keys do not belong in the page script.

Copy the script for this website

1. 1
   Choose your website in Attriboo.

   Check the address in the website selector. Add the website first if it is not listed.

2. 2
   Open Setup and choose Ruby on Rails.

   Under Add the tracking script to your website, find Where is your site built? Choose this platform, then use Copy beside Your code. This gives you the right code format with your website ID filled in.

Add Attriboo to Ruby on Rails

1. 1
   Open app/views/layouts/application.html.erb, or the layout your public controllers actually use.
2. 2
   Paste the HTML script from Setup before </head>.

   Preserve csrf_meta_tags, csp_meta_tag, asset helpers and yield.

3. 3
   Deploy.

   Check a direct page load, a Turbo Drive link if used, and Back. Turbo Frame updates within an unchanged URL are not new pages.

<script defer data-site-id="site_YOUR_WEBSITE_ID" src="https://www.attriboo.com/t.js"></script>

Check this platform’s behavior

Do not add a second manual pageview on turbo:load for this installation. If you use a nonce-based Content Security Policy, have the developer add the approved nonce rather than relaxing the policy. Test custom Turbo history behavior separately.

Check that page visits reach Attriboo

1. 1
   Open the published website in another tab.

   Use the address your customers visit. Make your normal tracking choice if a consent banner appears.

2. 2
   Return to the same website in Attriboo → Setup.

   Select Test Connection. Look for a successful result such as Verified Live or activity on the correct address.

3. 3
   Follow an internal link, then use your browser’s Back button.

   Check those paths in the Pages view for the current reporting dates. Allow the reports to refresh. An active connection alone does not confirm every page change.

• Check your first visit
• Troubleshoot missing visits

Connect visits to recorded revenue

Installing the script records website activity. To bring sales into Attriboo, connect the service you use to collect payments in Setup as well. Then compare the recorded sources and customer journeys behind your sales.

A payment imported from before tracking was installed may have no matching visit. Installing today does not recreate old website activity.

• Connect your payment provider
• See supported integrations

Ruby on Rails references

These placement instructions were reviewed against the platform’s documentation and Attriboo’s current tracker. Check the published site after deployment, theme changes or navigation changes.

• Rails layouts and rendering
• Turbo Drive navigation