TrueMetriks documentation: Chrome Extension https://docs.truemetriks.com/features/chrome-extension/ Generated from the TrueMetriks documentation. Paste the whole of this file into ChatGPT, Claude, Gemini, Cursor or any other AI. I use TrueMetriks, a server-side tracking and conversion attribution platform. It tracks my website visitors, ties every sale back to the ad that produced it, and sends those conversions back to my ad platforms. Help me with this specific task: Chrome Extension. Install the TrueMetriks Ad Overlay to see attribution-corrected ROAS, Profit, CPL, and CPS on every row inside Facebook Ads Manager and Google Ads. HOW TO GUIDE ME - This file has three parts: THE GUIDE is today's task, BACKGROUND is a prerequisite to confirm with me before you start THE GUIDE, not optional reading, and LINK MAP is the only place a real link comes from. - Ask me ONE thing at a time and wait for my answer before moving on. - At the start of every step, ask me: "do you want the written steps, or the video?" If I pick the video, give me the exact link from the LINK MAP at the bottom and wait until I tell you I have watched it. If I pick the written steps, give them to me from this file. - Only ever give me links that appear in the LINK MAP below. Never invent a URL, never guess an anchor, and if I ask for something that has no link here, say so and point me at https://docs.truemetriks.com/ instead. - Never ask me for my password, my API key, my MCP key, or any card details. You are reading me the steps; I am the one clicking in my own account. - Confirm each step worked before starting the next one. - Keep it short. I am doing this while looking at my screen, not reading an essay. - Everything you need is in this file. You do not need to browse the web. =============================================================================== THE GUIDE: Chrome Extension https://docs.truemetriks.com/features/chrome-extension/ ===============================================================================
Add to Chrome → Free to install. Available on the Growth and Unlimited plans.
**Video guide** VIDEO: How the TrueMetriks Ad Overlay Chrome extension works -> https://docs.truemetriks.com/features/chrome-extension/#video-walkthrough ## What it does The TrueMetriks Ad Overlay puts your real numbers right next to Facebook's and Google's, on the screen you already work in. It adds a dark TrueMetriks toolbar above your ad table and eight extra cells to every ad, ad set, ad group, or campaign row.
The TrueMetriks Ad Overlay running inside a real Facebook Ads Manager account
The overlay running in a real Facebook Ads Manager account.
Spend is read from the ad platform; every other number comes from TrueMetriks. Each one is calculated for the date range and attribution model you pick in the toolbar, so the ROAS you see is real, not a platform estimate. ## Install it The extension is published on the Chrome Web Store as "TrueMetriks Ad Overlay". 1. Open the [Chrome Web Store listing](https://chromewebstore.google.com/detail/truemetriks-ad-overlay/hfkmfhbidmgfpfnignikimdniaebppdc) and click `Add to Chrome`, then approve the permissions. 2. Pin the extension so the icon stays in your toolbar. 3. Click the icon and choose `Connect to TrueMetriks`. It signs you in with your existing `app.truemetriks.com` login, so there is no separate password. Once connected the popup shows `Connected as you@yourcompany.com`. After that, open **Campaigns**, **Ad sets** or **Ads** to see your numbers. Both platforms work the same way: Blank overlay? You are usually on a page the extension does not cover, or the table has not finished rendering. Refresh and give it a moment. Facebook used to fill in the Ads tab only. It now fills Campaigns and Ad sets too, because a click tagged with an ad's id also counts toward that ad's ad set and its campaign. ## Why a campaign can be bigger than its ad sets added up Add up every ad set inside a campaign and the total can come out smaller than the campaign row itself. That is not a bug. Ids only ever climb. A click tagged with an ad's id counts toward that ad, its ad set and its campaign. A click carrying only a campaign id stays at campaign level forever: it is never pushed down into one of the ad sets underneath, because a campaign has many and picking one to credit would be inventing an answer. So the campaign row holds everything attributed to that campaign, including touches that never named an ad set, while the ad set rows hold only what named them. The gap between the two is real traffic, sitting at the level it was actually identified at. This is how attribution works rather than a platform quirk, so it applies to Facebook campaigns versus ad sets and Google campaigns versus ad groups alike. ## The eight cells The overlay always adds the same eight cells, in this fixed order, regardless of the order you turn them on. | Cell | What it shows | |---------|---------------------------------------------------------------------| | Leads | Leads TrueMetriks attributes to this row for the selected view | | CPL | Cost per lead, which is the platform spend divided by Leads | | Sales | Purchases TrueMetriks attributes to this row | | CPS | Cost per sale, which is the platform spend divided by Sales | | ROAS | Return on ad spend, which is Revenue divided by Spend | | Spend | Spend read directly from the ad platform | | Revenue | Revenue TrueMetriks attributes to this row | | Profit | Revenue minus Spend | ROAS and Profit are colour-coded so good and bad rows jump out: green when a row is winning, red when ROAS drops below break-even or Profit goes negative. ## The toolbar controls Everything is driven from the dark TrueMetriks bar at the top of the page. ### Attribution Switch how credit is assigned between First touch, Last touch, and Any touch. Every cell instantly recalculates for the model you pick. - First touch credits the ad that first introduced the customer. - Last touch credits the ad they clicked right before buying. - Any touch credits every ad that was part of the journey. This is the same attribution choice you have on the TrueMetriks dashboard. See [Buyer journeys and attribution](https://docs.truemetriks.com/features/buyer-journeys-attribution/) for how the three models differ. ### Audience Filter the numbers by who converted: everyone, only first-time buyers, or only repeat buyers. Set it to `New only` to optimise your prospecting campaigns on fresh customers instead of repeat purchases that would have happened anyway. See [New vs returning customers](https://docs.truemetriks.com/features/new-vs-returning/) for the full picture. ### Columns Turn any of the eight cells on or off. The count in the toolbar (`Columns: 8`) shows how many are visible. ### Date The overlay reads the date range from the ad platform's own date picker (shown as `Date: maximum`), so change the date in Facebook or Google as usual and the cells follow. Nothing to set here. ### Refresh and the status dot `Refresh` pulls the latest numbers (the overlay also caches for a minute so it stays fast). The dot on the right shows the connection: green for connected, amber while syncing, red if something is wrong. ### Hide cells `Hide cells` collapses the eight TrueMetriks cells so the ad platform's own right-edge columns show again. Click `Show cells` to bring them back - nothing is lost. ## Google Ads: enable the ID columns first (required) Facebook works the moment you open it. Google does not: the overlay matches each Google row by Google's own ID column, which Google hides by default, so until you turn it on there is nothing to match and no numbers show. > **This step is required.** Enable the ID column on all three views - Campaigns, Ad groups, and Ads. Each has its own ID, and skipping one leaves the overlay blank on that view.
The TrueMetriks Ad Overlay running inside a real Google Ads account
The overlay running in a real Google Ads account, with the ID column enabled.
You do this once per view, and Google remembers it. The three views sit in the Google Ads left menu: ### Step 1 - open Modify columns On the view you are setting up, find the toolbar above the ad table and click **Columns**, then **Modify columns**. ### Step 2 - search the ID and add it In the **Modify columns** panel, type the ID for the view you are on into the search box, tick it so it moves into **Your columns** on the right, then click **Apply** at the bottom. ### Step 3 - repeat on all three views Each view needs its own ID. Do the same on the other two tabs: | Google Ads view | Search for | Enable this column | |-----------------|--------------|--------------------| | Campaigns | `campaign id` | `Campaign ID` | | Ad groups | `ad group id` | `Ad group ID` | | Ads | `ad id` | `Ad ID` | Once a view has its ID column on, refresh the page and the overlay's eight cells appear on every row. If you ever see Google rows with no TrueMetriks numbers, the overlay tells you which column is missing with a message like "Enable the Campaign ID column to see TrueMetriks data" - go back to Modify columns for that view and switch it on. ## Why these numbers beat the platform's own The whole reason the overlay exists is that the numbers Facebook and Google show you are usually too low and credited to the wrong ad. - More sales counted. iOS, ad blockers, and cookie limits drop a big share of pixel events; TrueMetriks catches them server-side. - A longer window. TrueMetriks keeps the full journey, so a sale weeks after the click still gets credited to the ad that drove it, instead of expiring on the platform's short window. - Your choice of attribution. First, last, or any touch, recalculated live, instead of the one model the platform picks for you. - One scoreboard. Facebook and Google each only see their own conversions and over-claim; the overlay scores every row the same way, so their ROAS is finally comparable. The result is a per-ad ROAS and Profit you can actually trust enough to scale or cut on. ## Plan availability The Chrome extension is available on the Growth and Unlimited plans. On Starter it installs but the popup shows an upgrade prompt instead of the overlay. Upgrade from `app.truemetriks.com` and it turns on right away. ## Good to know - It is read-only. The overlay only reads your ad screens and pulls the matching TrueMetriks numbers through your own login. It never edits, pauses, or spends anything in your ad accounts. - It works in Facebook Ads Manager (`facebook.com/adsmanager` and `business.facebook.com`) and Google Ads (`ads.google.com`). - It follows your ad platform's light or dark theme automatically. =============================================================================== LINK MAP Use these exact URLs. Anything ending in a # anchor opens on that section or that video. Nothing else is a valid link. Never invent a URL and never guess an anchor. Chrome Extension The guide ................................... https://docs.truemetriks.com/features/chrome-extension/ What it does ................................ https://docs.truemetriks.com/features/chrome-extension/#what-it-does Install it .................................. https://docs.truemetriks.com/features/chrome-extension/#install-it Why a campaign can be bigger than its ad sets added up https://docs.truemetriks.com/features/chrome-extension/#why-a-campaign-can-be-bigger-than-its-ad-sets-added-up The eight cells ............................. https://docs.truemetriks.com/features/chrome-extension/#the-eight-cells The toolbar controls ........................ https://docs.truemetriks.com/features/chrome-extension/#the-toolbar-controls Attribution ................................. https://docs.truemetriks.com/features/chrome-extension/#attribution Audience .................................... https://docs.truemetriks.com/features/chrome-extension/#audience Columns ..................................... https://docs.truemetriks.com/features/chrome-extension/#columns Date ........................................ https://docs.truemetriks.com/features/chrome-extension/#date Refresh and the status dot .................. https://docs.truemetriks.com/features/chrome-extension/#refresh-and-the-status-dot Hide cells .................................. https://docs.truemetriks.com/features/chrome-extension/#hide-cells Google Ads: enable the ID columns first (required) https://docs.truemetriks.com/features/chrome-extension/#google-ads-enable-the-id-columns-first-required Step 1 - open Modify columns ................ https://docs.truemetriks.com/features/chrome-extension/#step-1-open-modify-columns Step 2 - search the ID and add it ........... https://docs.truemetriks.com/features/chrome-extension/#step-2-search-the-id-and-add-it Step 3 - repeat on all three views .......... https://docs.truemetriks.com/features/chrome-extension/#step-3-repeat-on-all-three-views Why these numbers beat the platform's own ... https://docs.truemetriks.com/features/chrome-extension/#why-these-numbers-beat-the-platforms-own Plan availability ........................... https://docs.truemetriks.com/features/chrome-extension/#plan-availability Good to know ................................ https://docs.truemetriks.com/features/chrome-extension/#good-to-know VIDEO, How the TrueMetriks Ad Overlay Chrome extension works https://docs.truemetriks.com/features/chrome-extension/#video-walkthrough