Skip to main content
Web Tracking is a single script tag you add to your site. Once it is live, it records page views and can receive custom events from your own code. This article covers the allGood side: issuing your tracking key, choosing what the tag sends, copying the tag, and rotating or revoking the key. Without Web Tracking, you can still send campaigns and build forms. You just will not see who visited which pages, or how a submission ties back to a specific visitor.

Prerequisites

  • You can open the Web Tracking settings for your account and have the Admin or Power user role. With the Standard role, you cannot issue, rotate, or revoke a key.
  • You have a connected subdomain. The tag loads from it, so without one there is no address to load from.
  • The origin of each site you want to track is on your allowed origins list. A page on an unlisted origin has its events skipped with no warning.

Issue your key and copy your tag

1

Open Web Tracking

Open Web Tracking in your account settings.
The Web Tracking settings page, showing the generated tag, the account's tracking key, and the two switches that control what the tag sends

The Web Tracking settings page, showing the generated tag, the account's tracking key, and the two switches that control what the tag sends.

2

Issue a tracking key

If the page shows Issue key instead of a key, select it. This creates your account’s key, which begins agsk_. The tag snippet then appears with your domain and key filled in. There is one key per account, not one per website.
3

Turn on Send events to allGood

In What the tag does, switch Send events to allGood on. It starts off on a new account, and while it is off the tag sends nothing at all. The status chip reads Publishing…, then Live at the edge. Until it turns green, the previous setting still applies.
4

Copy your tag

In Your tag, select Copy. Send the tag to whoever owns your website. They add it to the <head> of each page you want tracked. See Install the tag. If they use Google Tag Manager, select Install with Google Tag Manager instead and follow Install with Google Tag Manager.
Your tag is ready. It starts sending on the next page load after your website owner installs it, once the origin is allowed, Send events to allGood is on, and your visitor’s consent allows it.

What the two switches do

Both are in What the tag does. Send events to allGood is the master switch. Off, the tag records nothing: no page views, and no custom events from your own code. Automatic page views controls only the page views the tag records by itself. It records one when a page loads, and again on every route change in a single-page app. Off, it stops those, but custom events and form submissions still go through. Turn it off if your site changes its URL for reasons that are not really navigation, and you would rather record page views yourself. Consent applies to tracking, not to form submissions. Page views and custom events send only once your visitor’s consent, set under Consent Provider, allows it. A form submission is something the visitor chose to do, so it follows a separate rule. It also never uses the tracking key.
Settings changes take a moment to reach all of allGood’s servers. See Saved vs live at the edge.

Your tracking key

The key sits in the source of every page that carries your tag, so anyone who views the source can read it. It is not a secret, and it does not need protecting. It says which allGood account is sending. It does not authorize the sender. What controls who can send is your allowed origins list, plus bot protection for anything that is not a browser. Someone holding your key can only post from a website you have already allowed, and can only make traffic look like yours. Rotate the key if you think someone else is using it, not because it was visible. Next to the key, allGood shows a short keyId. Quote it to support when you need to say which key is live, instead of pasting the key itself.

Rotate the key

Rotate issues a new key. The old key keeps working until the new one reaches allGood’s edge, so a rotation never leaves a gap with no valid key.
1

Select Rotate

On Web Tracking, select Rotate. The new key appears immediately.
2

Replace the tag everywhere

Copy the new tag. Replace it on every page that carries the old key, and in any Google Tag Manager container that uses the generated template. Pages still on the old key stop being recorded once it stops working.
3

Check that events still arrive

Load a page and look for a successful tracking request. If it is refused, see Troubleshooting.

Revoke the key

Revoke clears the key. Every tracked event is refused until you issue a new one, and the screen shows a revoked badge. Use it when you want tracking to stop now, not when you want a different key.
Revoking does not stop form capture. Forms use their own public ID and your allowed origins list, not the tracking key. To stop a form accepting submissions, unregister the form. Rotating has a grace period. Revoking does not, so confirm your live tag already uses a different key before you revoke.

Check that it works

Select Open test page on Web Tracking. It opens a page that allGood hosts on a separate domain, running your real tag against your real settings. It checks the whole path without touching your own site. Your developer can also check the browser console and network tab. See Test your setup.

Track custom events

identify() and track() calls let your own code send events beyond page views. They need JavaScript on your site, so they are a task for a developer. Share Identify and track with them.