Skip to main content

Prerequisites and Installation

Prerequisites and Installation

Prerequisites

Before you begin, make sure you have:

  1. A working Google Tag Manager Server-Side container receiving traffic
  2. A running Probr instance (self-hosted via Docker) with at least one site configured
  3. Editor access (or higher) to the server-side GTM container

Step 1: Create Your Site in Probr

Use the Probr API to create a client and site:

# 1. Create a client
curl -X POST https://your-probr-instance/api/clients \
  -H "Content-Type: application/json" \
  -d '{"name": "My Company", "email": "ops@mycompany.com"}'

# 2. Create a site (use the client_id from the response above)
curl -X POST https://your-probr-instance/api/sites \
  -H "Content-Type: application/json" \
  -d '{"client_id": "<client-uuid>", "name": "mysite.com - Production", "url": "https://mysite.com", "sgtm_url": "https://sgtm.mysite.com"}'

The response will include an auto-generated Ingest Key (ingest_key field) — you'll need it in the next step.

See Clients & Sites for the full API reference.

Step 2: Install the Probr Listener Tag

Option A: From the GTM Community Template Gallery (recommended)

  1. In your server-side GTM container, go to Templates > Tag Templates
  2. Click Search Gallery
  3. Search for "Probr"
  4. Click Probr — Server-Side Listener then Add to workspace
  5. Confirm the addition

Option B: Manual import

  1. Download the template.tpl file from the GitHub repo
  2. In server-side GTM, go to Templates > Tag Templates > New
  3. Click the three dots (more options) in the top right > Import
  4. Select the downloaded template.tpl file
  5. Click Save

Step 3: Create the Tag

  1. Go to Tags > New
  2. Tag Configuration: select Probr — Server-Side Listener
  3. Fill in the fields:
Field Value
Probr Ingest Endpoint https://your-probr-instance/api/ingest
Probr Ingest Key The ingest_key from Step 1
Track user data quality Checked (recommended)
Send mode Per event (recommended)
  1. Triggering: select the All Events trigger (or create a custom trigger)
  2. Name the tag: Probr - Listener
  3. Click Save

Step 4: Exclude the Probr Tag from Monitoring

To avoid a feedback loop (the Probr tag monitoring itself):

  1. Note the ID of the Probr Listener tag (visible in the URL when editing the tag, or in the tag list)
  2. Edit the Probr Listener tag
  3. In the Tag IDs to Exclude field, enter the noted ID
  4. Save

Step 5: Add Tag Metadata (recommended)

So that Probr displays tag names (not just their IDs):

  1. For each important tag in your container, open its settings
  2. Expand Advanced Settings > Additional Tag Metadata
  3. Check Include tag name (name = true)
  4. Save

This allows Probr to identify each tag by name in the dashboard.

Step 6: Publish

  1. Click Submit in GTM
  2. Add a version note (e.g., "Add Probr monitoring")
  3. Click Publish

Data will start appearing in your Probr dashboard within seconds.

Verification

To verify everything is working:

  1. Open Preview mode in your sGTM container
  2. Send a test event from your site
  3. Verify that the Probr - Listener tag fires with the status Succeeded
  4. In your Probr dashboard, verify that the event appears in the real-time feed

Next Step

See the detailed GTM Listener documentation for advanced options.

Back to top