# DURUM.ai Chrome Extension

The DURUM.ai Chrome extension shows your real CRM data directly inside the Meta Ads Manager table, without switching tabs or exporting reports.

---

## What it does

Next to every campaign, adset and ad in Meta Ads Manager, you see your DURUM.ai columns, computed from your CRM events rather than Meta's estimated conversions:

| Family | Available columns |
|--------|-------------------|
| Spend and traffic | `Spend`, `Impressions`, `Clicks`, `CTR`, `CPC` |
| Leads | `Leads`, `Applications`, `CPL` (cost per lead), `Cost per application` |
| Appointments | `Bookings`, `Cost per booking`, `Meetings`, `No-shows`, `Cancellations`, `No-show rate`, `Show rate`, `Cancellation rate` |
| Sales | `Sales`, `Revenue`, `Average ticket`, `ROAS`, `CPA`, `Close rate`, `Lead to sale`, `Booking to sale` |
| Calls and quality | `Calls`, `ICP score` |

Every row also gets a **health score** (0 to 100) and, when an Insight DURUM recommendation targets that entity, a **recommendation badge** (creative fatigue, scaling, pause).

**Drill-down by contact**: click any number (leads, bookings, sales) to open the side panel with the list of contacts behind it. Click a contact to see their identity, event timeline, Meta attribution (`ad_id`, campaign, UTMs), analyzed calls and detected objections.

The extension's top bar adds:

- The **attribution model** selector: DURUM Hybrid (default), Linear, First Touch, Last Touch, Position (40-20-40)
- The **active client** selector (agencies managing several accounts)
- The **comparison period**: none, or the previous 7, 14, 30 or 90 days
- The **Refresh** button to force a resync
- The **column picker**: choose which DURUM.ai metrics appear in the table

---

## Installation

The extension is provided by your account manager, either through the Chrome Web Store (DURUM.ai listing) when the version is available there, or as a ZIP file you load yourself.

**From the Chrome Web Store**

1. Open the DURUM.ai listing sent by your account manager.
2. Click **Add to Chrome**.
3. Confirm the requested permissions (see [Permissions](#permissions)).
4. The DURUM.ai icon appears in the Chrome extensions bar.

**From a ZIP file**

1. Unzip the file you received.
2. Open `chrome://extensions/` and enable **Developer mode** (top right).
3. Click **Load unpacked** and pick the unzipped folder.

---

## First use

### 1. Sign in

Click the DURUM.ai icon in the Chrome bar. The popup opens on a sign-in screen.

- Enter the **email** and **password** of your DURUM.ai account (the same as for [app.durum.ai](https://app.durum.ai))
- Or click **Sign in with Google** if your DURUM.ai account is linked to Google

### 2. Pick the active client (agencies only)

If you manage several accounts, an **Active client** menu appears after sign-in. Choose the client whose data you want to see.

You can also switch client without opening the popup: the **Client** menu sits in the top bar, directly on Meta Ads Manager.

### 3. Open Meta Ads Manager

Go to [business.facebook.com/adsmanager](https://business.facebook.com/adsmanager). The DURUM.ai columns appear automatically to the right of Meta's native columns.

---

## Customize the columns

In the extension's top bar:

1. Click **Columns**.
2. Turn the metrics you want on or off.
3. Your choices are saved per client.

Five vertical presets are included as a starting point, then you adjust column by column:

| Preset | For whom |
|--------|----------|
| `lead_gen` | Lead acquisition |
| `ecommerce` | Online store |
| `agency_close` | Agency closing on the phone |
| `real_estate` | Real estate |
| `p_vertical` | Professional vertical |

---

## Permissions {#permissions}

The extension requests the following permissions:

| Permission | Justification |
|------------|---------------|
| `storage` | Metrics cache (5 minutes) and preferences (active client, columns, attribution model) |
| `alarms` | Automatic session token refresh every 55 minutes |
| `identity` | Sign in with Google (optional) |
| `scripting` | Inject the script into Meta tabs already open after an update |
| `tabs` | Detect whether the active tab is on Meta Ads Manager |
| `https://*.facebook.com/*` | Read the Meta Ads Manager table to identify the entities to enrich |
| `https://*.supabase.co/*` | Call the DURUM.ai services that return your CRM metrics |

The extension is **read-only on Meta**: no ad edits, no code injection, no budget changes.

---

## Security and privacy

- **Authentication** through the same system as the DURUM.ai app
- **Isolation**: you only see your own account's data
- **No Meta data** is shared with any third party
- **No tracking**: no analytics, no advertising, no pixel
- The token is stored locally in `chrome.storage.local` and refreshed every 55 minutes
- The metrics cache (5 minutes) is cleared on sign-out or client switch

Full policy: [Privacy Policy](https://docs.durum.ai/en/extension/privacy).

---

## Multi-account (agencies)

The client selector in the top bar lets you switch account without leaving Meta Ads Manager:

1. Open Meta Ads Manager for any account.
2. In the DURUM.ai bar, pick the client in the **Client** menu.
3. The data refreshes automatically.

> **Warning**
>
> Make sure the client selected in the bar matches the Meta account on screen. Otherwise the metrics shown will not match the visible ads.

---

## Troubleshooting

### "Service worker unavailable"

Chrome suspended the extension's service worker:

1. Go to `chrome://extensions/`.
2. Find the DURUM.ai card.
3. Click the reload icon.
4. Reopen the popup.

### Zeros everywhere in the columns

Possible causes:

- **Not signed in**: open the popup and sign in
- **Wrong active client**: check the Client menu in the top bar
- **Period without data**: the period selected in Meta has no CRM events for this client
- **Meta account not linked**: check with your account manager that this ad account is connected to DURUM.ai

### The side panel does not appear

- Make sure you are on [business.facebook.com/adsmanager](https://business.facebook.com/adsmanager) and not on another Meta page
- Reload the page (`Ctrl + Shift + R`, or `Cmd + Shift + R` on Mac)
- If nothing changes, reload the extension in `chrome://extensions/`

### The numbers do not match the app

The extension queries the same services as the DURUM.ai app. If the numbers differ:

1. Check that the **period** is the same (Meta date picker versus app filters).
2. Check that the **attribution model** is the same (extension bar versus app settings).
3. Check that the **active client** matches the Meta account on screen.
4. If the gap persists, contact support with a screenshot.

---

## Support

- Email: [info@durum.ai](mailto:info@durum.ai)
- Documentation: [docs.durum.ai](https://docs.durum.ai)
- DURUM.ai app: [app.durum.ai](https://app.durum.ai)

---

## Versions

An extension installed from the Chrome Web Store is updated automatically by Chrome. To find your version:

1. Open the DURUM.ai popup.
2. The version is shown at the bottom of the screen once signed in (for example `v0.6.4`).

To force an update, go to `chrome://extensions/` and click **Update** at the top right.

---

Source: https://docs.durum.ai/en/extension/