Google Analytics

LiveAPI Key

Analytics

Overview

Push ClearView company identification data directly into Google Analytics 4 as custom events. When ClearView identifies a company visiting your site, it sends a clearview_company_identified event via the GA4 Measurement Protocol, complete with company parameters like name, industry, employee count, and lead score. This enriches your GA4 reports with B2B context you cannot get from standard analytics alone.

What Gets Synced

Custom GA4 event - A clearview_company_identified event with full company parameters
Company parameters - Name, domain, industry, size, lead score sent as event parameters
Measurement Protocol - Server-side delivery for reliable data collection

Supported Events

Event	Description
`company.identified`	Fires when a new company is identified, sending a custom GA4 event with company parameters

Prerequisites

A Google Analytics 4 property with an active data stream
A Measurement ID (format: G-XXXXXXXXXX)
A Measurement Protocol API secret
ClearView tracking script installed on your site

Setup Guide

Find your Measurement ID

In Google Analytics, go to Admin > Data Streams. Click on your web data stream. Copy the Measurement ID (starts with G-).

Create a Measurement Protocol API secret

On the same data stream page, scroll down and click on "Measurement Protocol API secrets". Click "Create" to generate a new API secret. Give it a name like "ClearView" and copy the secret value.

API secret security

The API secret allows sending events to your GA4 property. Store it securely and never expose it in client-side code.

Configure in ClearView

Go to ClearView Dashboard > Integrations > Google Analytics. Enter your Measurement ID and API secret.

Register custom dimensions (recommended)

In GA4, go to Admin > Custom definitions > Create custom dimensions. Register company_name, company_domain, company_industry, company_employees, and lead_score as custom dimensions/metrics so they appear in your reports.

Test the connection

Click the Test button in ClearView. Then open GA4 Realtime report to verify the clearview_company_identified event appears with correct parameters.

Configuration Fields

Field	Type	Description
`measurementId`	String	Your GA4 Measurement ID (format: G-XXXXXXXXXX). Found under Admin > Data Streams.
`apiSecret`	Secret	Measurement Protocol API secret. Created under Data Streams > Measurement Protocol API secrets.

Data Mapping

ClearView Field	GA4 Parameter	Type
Company Name	`company_name`	string
Domain	`company_domain`	string
Industry	`company_industry`	string
Employee Count	`company_employees`	number
Lead Score	`lead_score`	number
Page URL	`page_url`	string
Visitor Country	`visitor_country`	string

Example Payload

ClearView sends events via the GA4 Measurement Protocol. Here is what the request looks like:

measurement_protocol_request.http

http

POST /mp/collect?measurement_id=G-XXXXXXXXXX&api_secret=xxxxx
Host: www.google-analytics.com
{
  "client_id": "clearview_abc123",
  "events": [
    {
      "name": "clearview_company_identified",
      "params": {
        "company_name": "Acme Corp",
        "company_domain": "acme.com",
        "company_industry": "Technology",
        "company_employees": 250,
        "lead_score": 87,
        "page_url": "https://yoursite.com/pricing",
        "visitor_country": "US",
        "engagement_time_msec": 1000
      }
    }
  ]
}

Using ClearView data in GA4 reports

Register each event parameter as a custom dimension in GA4 to unlock them in Explorations, audience builder, and standard reports. This lets you segment traffic by company industry, size, or lead score.

Troubleshooting

Events not showing in Realtime report

Measurement Protocol events can take up to 24-48 hours to appear in standard reports but should appear in Realtime within a few minutes. Verify your Measurement ID and API secret are correct. Check that the data stream is active.

Custom parameters not visible in reports

Event parameters are not automatically available as dimensions in GA4. You must register them under Admin > Custom definitions. After registration, it may take 24 hours for historical data to populate.

Measurement ID format error

The Measurement ID must start with "G-" followed by alphanumeric characters (e.g., G-ABC123XYZ). If yours starts with "UA-", you have a Universal Analytics property which is not supported. You need a GA4 property.

Need Help?

Our team is here to help you get the Google Analytics integration running smoothly.

Contact Support