Chrome Extension
The TrueMetriks Ad Overlay drops your real, attribution-corrected numbers straight onto the ad rows in Facebook Ads Manager and Google Ads. No more flipping between tabs to know which ad actually made money. It is read-only and never touches your ad accounts.
Set this up with AI
Copy this prompt into ChatGPT, Claude or whichever AI you use. It carries this whole guide, the pages it depends on, and a link to every video, so it can walk you through it one step at a time.
Video guide
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.
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".
- Open the Chrome Web Store listing and click
Add to Chrome, then approve the permissions. - Pin the extension so the icon stays in your toolbar.
- Click the icon and choose
Connect to TrueMetriks. It signs you in with your existingapp.truemetriks.comlogin, so there is no separate password. Once connected the popup showsConnected as [email protected].
The same popup has two buttons you will use later:
Open dashboardopens your full TrueMetriks dashboard on top of the Ads Manager or Google Ads page you are on, exactly like the bar'sDashboardbutton. On any other page it opens the dashboard in a new tab.Close TrueMetriks bar/Show TrueMetriks barhides the bar and brings it back. See Close the bar.
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. Every control has a small i icon next to it: hover it for a one-line explanation.
How to use (guided tour)
New to the bar? Click How to use at the left end of the bar. A short guided tour highlights each control in turn, from Website to Close, and explains what it does. Use Next and Back to move through it, or the arrow keys. Press Esc or the x to stop it at any time. You can run it again whenever you like.
Website
Shows which of your TrueMetriks websites the numbers come from. TrueMetriks picks it from the ad account you are viewing. If that ad account sends people to more than one of your websites, open the menu and choose the one to show. The extension remembers your choice for that ad account.
Which ad account the extension uses
Wondering where to configure which ad account is connected to the Chrome extension? There is no ad account setting in TrueMetriks or in the extension. The toolbar always follows the ad account that is open in Facebook Ads Manager or Google Ads, so switch accounts the usual way in the ad platform.
On Facebook, TrueMetriks links every ad account the Facebook login you connected can access. If the bar shows Not connected on the account you need, that login cannot see it. Go to Settings > Ad integrations > Facebook, reconnect with a Facebook login that has access to that ad account, and make sure the account is ticked on Meta's screens.
On Google Ads, the bar works for the accounts you imported in Settings > Ad integrations > Google Ads.
After you switch ad accounts, reload the page if the Website name on the bar has not changed.
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 for how the three models differ.
Customers
Filter the numbers by who bought: New + returning counts every buyer, New only counts people buying from you for the first time, and Returning only counts people who had bought from you before.
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 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. At least one column always stays on, so the last ticked one cannot be unticked.
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 status next to it shows where things stand: Live (green) when the numbers are current, Loading (yellow) while it fetches them, and Not loaded (red) if something went wrong. Press Refresh to try again.
If the status stays red and the stats are missing, Refresh will not fix it: the cause is still there. Work through When the toolbar stays red.
A missing or inactive Facebook pixel never turns the status red, because the overlay does not use your pixel.
Hide columns
Hide columns tucks the TrueMetriks columns away so the ad platform's own right-edge columns show again. Click Show columns to bring them back - nothing is lost.
Dashboard
Dashboard opens your full TrueMetriks dashboard right on top of the ads page. You are already signed in, and it opens on the website shown in the bar, starting on today, so you can dig into your buyers, journeys and revenue without opening a new tab. Pick any other dates or move to any other dashboard page inside it. Wide date ranges take longer to calculate; while one loads, the dashboard tells you so.
Close it with the x or the Esc key to get straight back to your ads. It reopens instantly, because it stays loaded in the background. The Open dashboard button in the extension's toolbar popup does the same thing.
Close the bar
Close, at the right end of the bar, hides the whole TrueMetriks bar and its columns. Use it when you want the plain ad platform screen back. While the bar is closed, the extension stops fetching numbers.
The bar stays closed on every Ads Manager and Google Ads tab until you bring it back:
- Click the TrueMetriks icon in your Chrome toolbar. If you do not see it, it is under the puzzle-piece icon. Pin it so it stays in view.
- Press
Show TrueMetriks bar.
The bar and the columns come back right away on every open tab, with your settings as you left them.
Narrow windows
On a smaller screen the bar makes room by shortening the labels in the menus on the left (a long website name or date range ends in "..."). The buttons on the right always stay fully visible.
The TrueMetriks columns also get narrower to fit the space next to your campaign names.
When columns are hidden behind the name column
In Facebook Ads Manager the campaign name column stays put while the rest of the table scrolls, and it is drawn on top. When it is wide, or the window is narrow, it can cover some of the TrueMetriks columns. A yellow note then appears under the bar, saying how many columns are hidden, with an arrow and a blue line on the edge of the name column.
To show them again, do one of these:
- Drag the edge of the name column (the blue line) to the left to make it narrower.
- Turn some columns off in
Columns.
Press Dismiss to hide the note and the arrow. They stay hidden until you move the edge of the name column again and columns are still covered. Google Ads does not need this, because its TrueMetriks columns always sit on top.
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.
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.
When the toolbar stays red (Not loaded)
The Chrome extension's toolbar shows Not loaded in red and the stats are missing or blank on every row. That means the overlay could not read the ad ids on the page, or could not fetch their numbers. Go through these checks in order, and reload the ad platform page after each fix.
- Update the extension. Open
chrome://extensionsand check that TrueMetriks Ad Overlay is version 0.4.3 or later. Older versions could not read the shorter ids that older Facebook ad accounts use, so the bar stayed red on those accounts while newer accounts worked. Chrome updates extensions on its own within a few hours; to update now, turn onDeveloper modeand pressUpdate. - Open a supported tab. The overlay works on Campaigns, Ad sets and Ads in Facebook Ads Manager, and on Campaigns, Ad groups and Ads in Google Ads. Wait for the table to finish loading.
- Check the connection. Click the TrueMetriks icon in your Chrome toolbar. It should say
Connected asand your email. If not, pressConnect to TrueMetriks. - Check the Website name on the bar. If it says
Not connected, the ad account you are viewing is not linked to any of your websites. See Which ad account the extension uses. - On Google Ads, turn on the ID column. See Google Ads: enable the ID columns first.
Refresh does nothing
Refresh only fetches the numbers again. If the toolbar is still red after it, whatever stopped the numbers is still there, so pressing it again will not help. Work through the five checks above instead.
A missing Facebook pixel does not turn the toolbar red
The overlay does not use your Facebook pixel, so a missing or inactive pixel never makes the toolbar red. Its numbers come from TrueMetriks tracking on your website, and its spend from your Facebook connection in TrueMetriks.
You still want the pixel connected so TrueMetriks can send your conversions to Facebook, but the overlay works without it.
Green on one ad account but red on the one you need
If the toolbar is green on one of your ad accounts but red or blank on the correct one, the two accounts differ in one of the checks above. The most common cause is an older ad account on an extension version before 0.4.3 (check 1). The next is an ad account your Facebook connection cannot see (check 4).
Green, but a row shows only dashes
If the toolbar is green but a row shows - in every cell, that row had no spend and no tracked visits or sales in the selected date range.
Still red after all five checks?
Message us on WhatsApp or email [email protected] with your website address and the ad account you are viewing.
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/adsmanagerandbusiness.facebook.com) and Google Ads (ads.google.com). - It follows your ad platform's light or dark theme automatically.
Frequently asked questions
Which platforms and plans is the extension available on?
It works in Facebook Ads Manager and Google Ads, and is available on the Growth and Unlimited plans. On Starter it installs but shows an upgrade prompt instead of the overlay.
Can the extension change anything in my ad accounts?
No. 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.
Which tabs does the overlay show numbers on?
Campaigns, Ad sets and Ads in Facebook Ads Manager, and Campaigns, Ad groups and Ads in Google Ads. Facebook used to fill in the Ads tab only; it now fills all three, because a click tagged with an ad's id also counts toward that ad's ad set and its campaign.
Why is my campaign total bigger than its ad sets added up?
Because ids only ever climb, never descend. A click carrying only a campaign id stays at campaign level and is never pushed down into one of the ad sets underneath, since a campaign has many and picking one to credit would be inventing an answer. So the campaign row includes touches that never named an ad set. This is not a bug, and it applies on both platforms.
Can I open the full TrueMetriks dashboard without leaving Ads Manager?
Yes. Click Dashboard on the TrueMetriks bar, or Open dashboard in the extension's toolbar popup. Your full dashboard opens on top of the ads page, already signed in, on the matched website, starting on today. Close it to get straight back to your ads.
How do I hide the TrueMetriks bar?
Click Close on the right end of the bar. The bar and the TrueMetriks columns disappear on every Ads Manager and Google Ads tab. To bring them back, click the TrueMetriks icon in your Chrome toolbar and press Show TrueMetriks bar.
Why does the bar say Not loaded in red, with blank stats, on Facebook?
The overlay could not read the ad ids on the page or could not fetch their numbers. Check, in this order: the extension is version 0.4.3 or later (older versions could not read the shorter ids of older Facebook ad accounts), you are on Campaigns, Ad sets or Ads, the extension popup says Connected, and the Website name on the bar is not Not connected. Then reload the Ads Manager page.
Does a missing or inactive Facebook pixel turn the bar red?
No. The overlay does not use your Facebook pixel. Its numbers come from TrueMetriks tracking on your website and its spend from your Facebook connection in TrueMetriks, so a missing pixel never makes the bar red.
Where do I choose which Facebook ad account the overlay uses?
There is no setting for it. The bar always follows the ad account open in Ads Manager. TrueMetriks links every ad account the Facebook login you connected can access, so if the account you are looking at says Not connected, reconnect Facebook in Settings > Ad integrations > Facebook with a login that has access to it, then reload Ads Manager.
Why does Google Ads need an extra setup step?
The overlay matches each row using Google's own ID column, which Google hides by default, so without it the overlay shows no numbers. In Modify columns, enable Campaign ID on the Campaigns view, Ad group ID on Ad groups, and Ad ID on Ads. Facebook needs none of this and works right away.