Skip to main content

Install the pixel

The pixel is how Bryn sees your website traffic. Without it, Bryn cannot identify anyone. Install it site-wide: identification improves with coverage, and a single-page install misses most of the visitors Bryn could have named for you.

One snippet does two jobs: it reports visits to Bryn, and it receives the payload that lets your site personalize for identified visitors.

One snippet, two directions: the pixel reports visits and receives the personalization payload in under 500 ms.One snippet, two directions: the pixel reports visits and receives the personalization payload in under 500 ms.

Before you start​

  • Your pixel ref: shown on the Pixel step of onboarding, and in your Bryn dashboard.
  • Edit access to your site's <head> template or your tag manager. No access? Skip to hand it off.

Install it​

Pick your platform:

No code changes on your site. Bryn ships an official GTM tag template.

  1. 1
    Import the template

    In GTM, go to Templates, then Search Gallery, and search for Bryn Pixel (published from the civicteam/bryn-google-tag-manager repository).

  2. 2
    Create the tag

    Add a new tag using the template and paste your pixel ref into the Pixel ref field. Use the copy button in the Bryn dashboard so no stray characters come along.

  3. 3
    Trigger on all pages

    Set the trigger to All Pages, then publish the container.

Hand it off​

Not the person who edits the website? Send your developer this page link and your pixel ref, with one line: "Please add this script tag to our site-wide head template so it loads on every page." The verification step below tells them (and you) that it worked.

Verify it's working​

Open your site in a normal browser tab, click around, then check Activity in the Bryn dashboard. Your visit arrives within moments of the pixel going live.

note

You may not see yourself identified, and that is normal. The pixel reports every visit, but Bryn only resolves identities for business traffic it can match. Seeing the visit in Activity means the pixel works, even while your own visit stays anonymous.

For your IT and security team​

What the pixel does, in one screen:

  • Sends: page URL, referrer, and timestamp on each page view. Nothing else is collected.
  • Never touches: form fields, keystrokes, cookies from other tools.
  • Origin allowlist: Bryn only accepts events from domains on your workspace's allowlist, and rejects everything else.
  • Personalization writes are inert by default: the return leg only sets text content and the standard hidden attribute on elements you mark, which keeps it XSS-safe. If you never add markers, it changes nothing.
  • Erasure: deletion requests propagate through Bryn's stores. See How Bryn works for the identification model.

Going further​