{"id":12545,"date":"2026-11-03T12:11:13","date_gmt":"2026-11-03T11:11:13","guid":{"rendered":"https:\/\/help.cirrus-shield.com\/?post_type=docs&#038;p=12545"},"modified":"2026-11-03T12:25:48","modified_gmt":"2026-11-03T11:25:48","slug":"abm-tracker","status":"publish","type":"docs","link":"https:\/\/help.cirrus-shield.com\/en\/docs\/admin-guide\/abm-tracker\/","title":{"rendered":"ABM Tracker \u2013 Admin Guide"},"content":{"rendered":"\n<p class=\"wp-block-paragraph\">ABM Tracker records how people use your websites and delivers the results to Cirrus Shield, so your sales and marketing teams can see who visited, where they came from and what they looked at, next to the rest of your CRM data.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">This guide is for the Cirrus Shield administrator who installs and configures ABM Tracker.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\"><strong>Contents<\/strong><\/p>\n\n\n\n<ol class=\"wp-block-list\">\n<li><a href=\"#sec_1\">How it works<\/a><\/li>\n\n\n<li><a href=\"#sec_2\">Before you start<\/a><\/li>\n\n\n<li><a href=\"#sec_3\">Access ABM Tracker<\/a><\/li>\n\n\n<li><a href=\"#sec_8\">Connect and accept the terms<\/a><\/li>\n\n\n<li><a href=\"#sec_11\">Add a website<\/a><\/li>\n\n\n<li><a href=\"#sec_12\">Visitor consent<\/a><\/li>\n\n\n<li><a href=\"#sec_14\">Website settings<\/a><\/li>\n\n\n<li><a href=\"#sec_19\">What is collected<\/a><\/li>\n\n\n<li><a href=\"#sec_20\">Monitoring delivery<\/a><\/li>\n\n\n<li><a href=\"#sec_21\">Viewing the data in Cirrus Shield<\/a><\/li>\n\n\n<li><a href=\"#sec_22\">Terms, withdrawing and changes<\/a><\/li>\n\n\n<li><a href=\"#sec_23\">Troubleshooting<\/a><\/li>\n\n\n<li><a href=\"#sec_29\">Frequently asked questions<\/a><\/li>\n\n\n<li><a href=\"#sec_30\">Glossary<\/a><\/li>\n<\/ol>\n\n\n\n<h2 class=\"wp-block-heading has-luminous-vivid-amber-color has-text-color has-link-color wp-elements-1\" id=\"sec_1\">1. How it works<\/h2>\n\n\n\n<ol class=\"wp-block-list\">\n<li>A small script on each of your web pages observes the visit, but only after the visitor has agreed to tracking.<\/li>\n\n\n<li>The script sends what it observed to the ABM Tracker collector.<\/li>\n\n\n<li>The collector cleans the data, adds an approximate location and the organization behind the visitor&#8217;s IP address, and writes the records into your Cirrus Shield organization.<\/li>\n<\/ol>\n\n\n\n<p class=\"wp-block-paragraph\">You see the results in four Cirrus Shield objects:<\/p>\n\n\n\n<figure class=\"wp-block-table\"><table class=\"has-fixed-layout\"><thead><tr><th><strong>Object<\/strong><\/th><th><strong>One record per<\/strong><\/th><th><strong>Holds<\/strong><\/th><\/tr><\/thead><tbody><tr><td><strong>Visitor<\/strong><\/td><td>browser<\/td><td>device, language, time zone, first visit date, number of visits, consent evidence<\/td><\/tr><tr><td><strong>Visit<\/strong><\/td><td>browser session<\/td><td>start and end, duration, campaign source, landing page, IP address, location, organization<\/td><\/tr><tr><td><strong>Visited_Page<\/strong><\/td><td>page view<\/td><td>page address, time spent, how far the visitor scrolled, loading speed, page category and language<\/td><\/tr><tr><td><strong>Visit_Event<\/strong><\/td><td>action on a page<\/td><td>file download, outbound link, email or phone link, form viewed \/ started \/ submitted, video progress, your own events<\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n<p class=\"wp-block-paragraph\">ABM Tracker does <strong>not<\/strong> create Contacts or Prospects (Leads) and does not read what a visitor types into a form.<\/p>\n\n\n\n<h2 class=\"wp-block-heading has-luminous-vivid-amber-color has-text-color has-link-color wp-elements-2\" id=\"sec_2\">2. Before you start<\/h2>\n\n\n\n<p class=\"wp-block-paragraph\">You need:<\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li>Administrator access to your Cirrus Shield organization.<\/li>\n\n\n<li>Permission to edit the header or footer of every page you want to track (for WordPress, a theme or header\/footer plugin).<\/li>\n\n\n<li>ABM Tracker installed in your organization by the Cirrus Shield team.<\/li>\n<\/ul>\n\n\n\n<h2 class=\"wp-block-heading has-luminous-vivid-amber-color has-text-color has-link-color wp-elements-3\" id=\"sec_3\">3. Access ABM Tracker<\/h2>\n\n\n\n<p class=\"wp-block-paragraph\"><strong>Prerequisite<\/strong>: you must be an administrator of your Cirrus Shield organization to access the <strong>Setup<\/strong> page.<\/p>\n\n\n\n<ol class=\"wp-block-list\">\n<li>Check that the three objects <strong>Visitor<\/strong>, <strong>Visit<\/strong> and <strong>Visited_Page<\/strong> are present in your organization. If they are missing, contact Cirrus Shield support.<\/li>\n\n\n<li>In your organization, open <strong>Setup<\/strong> (profile menu, top right).<\/li>\n\n\n<li>In the setup menu, click <strong>Extensions<\/strong>.<\/li>\n\n\n<li>In the list of extensions, find <strong>ABM Tracker<\/strong> and click <strong>D\u00e9tails<\/strong>. If you cannot find it, install it without changing any of its settings.<\/li>\n<\/ol>\n\n\n\n<p class=\"wp-block-paragraph\">The ABM Tracker configuration page opens. On first use, it asks you to connect (see section 4).<\/p>\n\n\n\n<h2 class=\"wp-block-heading has-luminous-vivid-amber-color has-text-color has-link-color wp-elements-4\" id=\"sec_8\">4. Connect and accept the terms<\/h2>\n\n\n\n<h3 class=\"wp-block-heading\">Connect<\/h3>\n\n\n\n<p class=\"wp-block-paragraph\">Open <strong>ABM Tracker<\/strong> from <strong>Setup<\/strong> &gt; <strong>Extensions<\/strong> (see section 3). On first use, enter the <strong>Client ID<\/strong> and <strong>Client secret<\/strong> of the connected application <strong>ABM Tracker Confidentiel<\/strong> (in <strong>Setup<\/strong>, then <strong>Applications connect\u00e9es<\/strong>), then select <strong>Connect<\/strong>. The page checks them against Cirrus Shield and confirms that they belong to your organization.<\/p>\n\n\n\n<figure class=\"wp-block-image size-full\"><img loading=\"lazy\" decoding=\"async\" width=\"1000\" height=\"760\" src=\"https:\/\/help.cirrus-shield.com\/wp-content\/uploads\/2026\/11\/abm-tracker-en-01.png\" alt=\"The first screen: organization name, Cirrus Shield URL, Client ID and Client secret\" class=\"wp-image-12494\" srcset=\"https:\/\/help.cirrus-shield.com\/wp-content\/uploads\/2026\/11\/abm-tracker-en-01.png 1000w, https:\/\/help.cirrus-shield.com\/wp-content\/uploads\/2026\/11\/abm-tracker-en-01-300x228.png 300w, https:\/\/help.cirrus-shield.com\/wp-content\/uploads\/2026\/11\/abm-tracker-en-01-768x584.png 768w\" sizes=\"(max-width: 1000px) 100vw, 1000px\" \/><figcaption class=\"wp-element-caption\">The first screen: organization name, Cirrus Shield URL, Client ID and Client secret<\/figcaption><\/figure>\n\n\n\n<h3 class=\"wp-block-heading\">Accept the terms of use<\/h3>\n\n\n\n<p class=\"wp-block-paragraph\">The page lists everything the tracker collects. Tick both boxes, type your full name and work email, and select <strong>I accept and continue<\/strong>. Your name, email, the date and time, and your IP address are kept as a record of the acceptance.<\/p>\n\n\n\n<figure class=\"wp-block-image size-full\"><img loading=\"lazy\" decoding=\"async\" width=\"907\" height=\"2560\" src=\"https:\/\/help.cirrus-shield.com\/wp-content\/uploads\/2026\/11\/abm-tracker-en-02-scaled.png\" alt=\"The terms of use and the acceptance form\" class=\"wp-image-12496\" srcset=\"https:\/\/help.cirrus-shield.com\/wp-content\/uploads\/2026\/11\/abm-tracker-en-02-scaled.png 907w, https:\/\/help.cirrus-shield.com\/wp-content\/uploads\/2026\/11\/abm-tracker-en-02-106x300.png 106w, https:\/\/help.cirrus-shield.com\/wp-content\/uploads\/2026\/11\/abm-tracker-en-02-363x1024.png 363w, https:\/\/help.cirrus-shield.com\/wp-content\/uploads\/2026\/11\/abm-tracker-en-02-768x2169.png 768w, https:\/\/help.cirrus-shield.com\/wp-content\/uploads\/2026\/11\/abm-tracker-en-02-544x1536.png 544w\" sizes=\"(max-width: 907px) 100vw, 907px\" \/><figcaption class=\"wp-element-caption\">The terms of use and the acceptance form<\/figcaption><\/figure>\n\n\n\n<blockquote class=\"wp-block-quote is-layout-flow wp-block-quote-is-layout-flow\">\n<p class=\"wp-block-paragraph\"><strong>Until the terms are accepted, nothing runs.<\/strong> You cannot add websites, the collector refuses data from your websites, and nothing is delivered to Cirrus Shield.<\/p>\n<\/blockquote>\n\n\n\n<p class=\"wp-block-paragraph\">Once accepted, the configuration page shows who accepted and when, and is ready for your first website.<\/p>\n\n\n\n<figure class=\"wp-block-image size-full\"><img loading=\"lazy\" decoding=\"async\" width=\"1000\" height=\"1671\" src=\"https:\/\/help.cirrus-shield.com\/wp-content\/uploads\/2026\/11\/abm-tracker-en-03.png\" alt=\"The configuration page before any website is added\" class=\"wp-image-12498\" srcset=\"https:\/\/help.cirrus-shield.com\/wp-content\/uploads\/2026\/11\/abm-tracker-en-03.png 1000w, https:\/\/help.cirrus-shield.com\/wp-content\/uploads\/2026\/11\/abm-tracker-en-03-180x300.png 180w, https:\/\/help.cirrus-shield.com\/wp-content\/uploads\/2026\/11\/abm-tracker-en-03-613x1024.png 613w, https:\/\/help.cirrus-shield.com\/wp-content\/uploads\/2026\/11\/abm-tracker-en-03-768x1283.png 768w, https:\/\/help.cirrus-shield.com\/wp-content\/uploads\/2026\/11\/abm-tracker-en-03-919x1536.png 919w\" sizes=\"(max-width: 1000px) 100vw, 1000px\" \/><figcaption class=\"wp-element-caption\">The configuration page before any website is added<\/figcaption><\/figure>\n\n\n\n<h2 class=\"wp-block-heading has-luminous-vivid-amber-color has-text-color has-link-color wp-elements-5\" id=\"sec_11\">5. Add a website<\/h2>\n\n\n\n<p class=\"wp-block-paragraph\">Under <strong>Add a website<\/strong>:<\/p>\n\n\n\n<ol class=\"wp-block-list\">\n<li><strong>Name<\/strong>: a label for your own use.<\/li>\n\n\n<li><strong>Website addresses<\/strong>: one per line, <strong>exactly as they appear in the browser<\/strong>, for example https:\/\/www.example.com. If both https:\/\/www.example.com and https:\/\/example.com exist, add both. Only https addresses are accepted.<\/li>\n\n\n<li>Choose how visitor consent is handled (see section 6). Optionally add the link to your privacy policy and the name to show in the banner.<\/li>\n\n\n<li>Select <strong>Add<\/strong>.<\/li>\n<\/ol>\n\n\n\n<figure class=\"wp-block-image size-full\"><img loading=\"lazy\" decoding=\"async\" width=\"860\" height=\"1083\" src=\"https:\/\/help.cirrus-shield.com\/wp-content\/uploads\/2026\/11\/abm-tracker-en-04.png\" alt=\"The Add a website form\" class=\"wp-image-12500\" srcset=\"https:\/\/help.cirrus-shield.com\/wp-content\/uploads\/2026\/11\/abm-tracker-en-04.png 860w, https:\/\/help.cirrus-shield.com\/wp-content\/uploads\/2026\/11\/abm-tracker-en-04-238x300.png 238w, https:\/\/help.cirrus-shield.com\/wp-content\/uploads\/2026\/11\/abm-tracker-en-04-813x1024.png 813w, https:\/\/help.cirrus-shield.com\/wp-content\/uploads\/2026\/11\/abm-tracker-en-04-768x967.png 768w\" sizes=\"(max-width: 860px) 100vw, 860px\" \/><figcaption class=\"wp-element-caption\">The Add a website form<\/figcaption><\/figure>\n\n\n\n<p class=\"wp-block-paragraph\">The page then shows <strong>three lines<\/strong> for that website. Paste them, in the order shown, into the header or footer of <strong>every page<\/strong> of the site. The consent line must come before the tracker line.<\/p>\n\n\n\n<figure class=\"wp-block-image size-full\"><img loading=\"lazy\" decoding=\"async\" width=\"860\" height=\"257\" src=\"https:\/\/help.cirrus-shield.com\/wp-content\/uploads\/2026\/11\/abm-tracker-en-05.png\" alt=\"The three script lines of a website\" class=\"wp-image-12502\" srcset=\"https:\/\/help.cirrus-shield.com\/wp-content\/uploads\/2026\/11\/abm-tracker-en-05.png 860w, https:\/\/help.cirrus-shield.com\/wp-content\/uploads\/2026\/11\/abm-tracker-en-05-300x90.png 300w, https:\/\/help.cirrus-shield.com\/wp-content\/uploads\/2026\/11\/abm-tracker-en-05-768x230.png 768w\" sizes=\"(max-width: 860px) 100vw, 860px\" \/><figcaption class=\"wp-element-caption\">The three script lines of a website<\/figcaption><\/figure>\n\n\n\n<pre class=\"wp-block-code\"><code>&lt;script src=\"https:\/\/cdnjs.cloudflare.com\/ajax\/libs\/UAParser.js\/1.0.0\/ua-parser.min.js\"&gt;&lt;\/script&gt;\n&lt;script src=\"https:\/\/abm.example.com\/abm-consent.js\" data-site=\"site_AbC123xYz789\"&gt;&lt;\/script&gt;\n&lt;script src=\"https:\/\/abm.example.com\/abm-tracker.js\" data-site=\"site_AbC123xYz789\"&gt;&lt;\/script&gt;<\/code><\/pre>\n\n\n\n<blockquote class=\"wp-block-quote is-layout-flow wp-block-quote-is-layout-flow\">\n<p class=\"wp-block-paragraph\">The address and the site key above are examples. <strong>Copy the lines from your own configuration page<\/strong>: they carry your own collector address and site key.<\/p>\n<\/blockquote>\n\n\n\n<p class=\"wp-block-paragraph\">An organization can have several websites. Each has its own three lines, and all of them write to the same objects. The <strong>Site_web<\/strong> field on Visitor tells them apart.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">You can <strong>disable<\/strong> a website to pause tracking on it, or <strong>delete<\/strong> it, after which its script stops sending data.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\"><strong>WordPress.<\/strong> To avoid counting your own team, skip the tags for logged-in users:<\/p>\n\n\n\n<pre class=\"wp-block-code\"><code>add_action('wp_head', function () {\n    if (is_user_logged_in()) return; \/\/ do not count the team browsing the site\n    \/\/ ... paste the three &lt;script&gt; lines here ...\n}, 1);<\/code><\/pre>\n\n\n\n<h2 class=\"wp-block-heading has-luminous-vivid-amber-color has-text-color has-link-color wp-elements-6\" id=\"sec_12\">6. Visitor consent<\/h2>\n\n\n\n<p class=\"wp-block-paragraph\">The tracker does nothing until the visitor has agreed. For each website, choose one of three modes.<\/p>\n\n\n\n<figure class=\"wp-block-table\"><table class=\"has-fixed-layout\"><thead><tr><th><strong>Mode<\/strong><\/th><th><strong>What happens<\/strong><\/th><\/tr><\/thead><tbody><tr><td><strong>Show the consent banner<\/strong> (default, recommended)<\/td><td>A banner appears. <strong>Accept<\/strong> and <strong>Decline<\/strong> look the same. The choice is remembered in the visitor&#8217;s browser (one year for Accept, six months for Decline) and a <strong>Privacy choices<\/strong> button lets the visitor change it. Nothing is sent and no cookie is set before the visitor accepts.<\/td><\/tr><tr><td><strong>I use my own consent tool<\/strong><\/td><td>No banner. Your own consent tool calls ABMConsent.grant() when the visitor accepts and ABMConsent.deny() when the visitor refuses.<\/td><\/tr><tr><td><strong>No banner: I collect consent in another way<\/strong><\/td><td>The tracker runs on every visit. You can only choose this after ticking a confirmation that you collect consent another way, before the page loads.<\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n<p class=\"wp-block-paragraph\">In every mode, a browser that sends <strong>Global Privacy Control<\/strong> or <strong>Do Not Track<\/strong> is treated as having refused.<\/p>\n\n\n\n<h3 class=\"wp-block-heading\">What the visitor sees<\/h3>\n\n\n\n<p class=\"wp-block-paragraph\">The banner names your organization, links to your privacy policy and lets the visitor accept or decline.<\/p>\n\n\n\n<figure class=\"wp-block-image size-full\"><img loading=\"lazy\" decoding=\"async\" width=\"1000\" height=\"640\" src=\"https:\/\/help.cirrus-shield.com\/wp-content\/uploads\/2026\/11\/abm-tracker-en-06.png\" alt=\"The consent banner\" class=\"wp-image-12504\" srcset=\"https:\/\/help.cirrus-shield.com\/wp-content\/uploads\/2026\/11\/abm-tracker-en-06.png 1000w, https:\/\/help.cirrus-shield.com\/wp-content\/uploads\/2026\/11\/abm-tracker-en-06-300x192.png 300w, https:\/\/help.cirrus-shield.com\/wp-content\/uploads\/2026\/11\/abm-tracker-en-06-768x492.png 768w\" sizes=\"(max-width: 1000px) 100vw, 1000px\" \/><figcaption class=\"wp-element-caption\">The consent banner<\/figcaption><\/figure>\n\n\n\n<p class=\"wp-block-paragraph\"><strong>See what is collected<\/strong> opens a list of exactly what you accepted in the terms.<\/p>\n\n\n\n<figure class=\"wp-block-image size-full\"><img loading=\"lazy\" decoding=\"async\" width=\"1000\" height=\"640\" src=\"https:\/\/help.cirrus-shield.com\/wp-content\/uploads\/2026\/11\/abm-tracker-en-07.png\" alt=\"The &quot;what is collected&quot; panel of the banner\" class=\"wp-image-12506\" srcset=\"https:\/\/help.cirrus-shield.com\/wp-content\/uploads\/2026\/11\/abm-tracker-en-07.png 1000w, https:\/\/help.cirrus-shield.com\/wp-content\/uploads\/2026\/11\/abm-tracker-en-07-300x192.png 300w, https:\/\/help.cirrus-shield.com\/wp-content\/uploads\/2026\/11\/abm-tracker-en-07-768x492.png 768w\" sizes=\"(max-width: 1000px) 100vw, 1000px\" \/><figcaption class=\"wp-element-caption\">The &#8220;what is collected&#8221; panel of the banner<\/figcaption><\/figure>\n\n\n\n<p class=\"wp-block-paragraph\">After the visitor chooses, a small <strong>Privacy choices<\/strong> button stays in the corner so they can change their mind.<\/p>\n\n\n\n<figure class=\"wp-block-image size-full\"><img loading=\"lazy\" decoding=\"async\" width=\"1000\" height=\"640\" src=\"https:\/\/help.cirrus-shield.com\/wp-content\/uploads\/2026\/11\/abm-tracker-en-08.png\" alt=\"The Privacy choices button\" class=\"wp-image-12508\" srcset=\"https:\/\/help.cirrus-shield.com\/wp-content\/uploads\/2026\/11\/abm-tracker-en-08.png 1000w, https:\/\/help.cirrus-shield.com\/wp-content\/uploads\/2026\/11\/abm-tracker-en-08-300x192.png 300w, https:\/\/help.cirrus-shield.com\/wp-content\/uploads\/2026\/11\/abm-tracker-en-08-768x492.png 768w\" sizes=\"(max-width: 1000px) 100vw, 1000px\" \/><figcaption class=\"wp-element-caption\">The Privacy choices button<\/figcaption><\/figure>\n\n\n\n<p class=\"wp-block-paragraph\"><strong>Reopening the banner from your own page.<\/strong> For example from a link on your privacy page, call ABMConsent.show().<\/p>\n\n\n\n<p class=\"wp-block-paragraph\"><strong>Consent evidence.<\/strong> Each Visitor record stores Consent_source (banner, external or none), Consent_date and Consent_version. You can use them to prove consent later and to filter visitors in the CRM.<\/p>\n\n\n\n<blockquote class=\"wp-block-quote is-layout-flow wp-block-quote-is-layout-flow\">\n<p class=\"wp-block-paragraph\">The banner is provided as a convenience and is <strong>not legal advice<\/strong>. You remain responsible for making sure it is adequate for your visitors and your country. Have its wording reviewed by a lawyer.<\/p>\n<\/blockquote>\n\n\n\n<h2 class=\"wp-block-heading has-luminous-vivid-amber-color has-text-color has-link-color wp-elements-7\" id=\"sec_14\">7. Website settings<\/h2>\n\n\n\n<p class=\"wp-block-paragraph\">Open <strong>Visitor consent<\/strong> under a website to change its settings, then select <strong>Save<\/strong>.<\/p>\n\n\n\n<figure class=\"wp-block-image size-full\"><img loading=\"lazy\" decoding=\"async\" width=\"860\" height=\"1082\" src=\"https:\/\/help.cirrus-shield.com\/wp-content\/uploads\/2026\/11\/abm-tracker-en-09.png\" alt=\"The settings of a website\" class=\"wp-image-12510\" srcset=\"https:\/\/help.cirrus-shield.com\/wp-content\/uploads\/2026\/11\/abm-tracker-en-09.png 860w, https:\/\/help.cirrus-shield.com\/wp-content\/uploads\/2026\/11\/abm-tracker-en-09-238x300.png 238w, https:\/\/help.cirrus-shield.com\/wp-content\/uploads\/2026\/11\/abm-tracker-en-09-814x1024.png 814w, https:\/\/help.cirrus-shield.com\/wp-content\/uploads\/2026\/11\/abm-tracker-en-09-768x966.png 768w\" sizes=\"(max-width: 860px) 100vw, 860px\" \/><figcaption class=\"wp-element-caption\">The settings of a website<\/figcaption><\/figure>\n\n\n\n<h3 class=\"wp-block-heading\">Link to your privacy policy and name shown in the banner<\/h3>\n\n\n\n<p class=\"wp-block-paragraph\">Both are optional. The name defaults to the website name.<\/p>\n\n\n\n<h3 class=\"wp-block-heading\">Ignore your own visits<\/h3>\n\n\n\n<p class=\"wp-block-paragraph\">List your office or team IP addresses, one per line. Ranges work, for example 203.0.113.0\/24. Visits from these addresses are accepted and dropped, so they never reach Cirrus Shield. Known crawlers and bots are always ignored.<\/p>\n\n\n\n<h3 class=\"wp-block-heading\">Page categories<\/h3>\n\n\n\n<p class=\"wp-block-paragraph\">Group pages into categories such as Pricing or Blog. Write one rule per line: a path, an equals sign, then the category.<\/p>\n\n\n\n<pre class=\"wp-block-code\"><code>\/pricing* = Pricing\n\/blog\/* = Blog\n\/ = Home<\/code><\/pre>\n\n\n\n<ul class=\"wp-block-list\">\n<li>A * matches anything.<\/li>\n\n\n<li>The <strong>first<\/strong> rule that matches wins.<\/li>\n\n\n<li>A category is 1 to 60 characters, and you can have up to 50 rules.<\/li>\n<\/ul>\n\n\n\n<p class=\"wp-block-paragraph\">A page can also declare its own category, which takes priority over the rules:<\/p>\n\n\n\n<pre class=\"wp-block-code\"><code>&lt;meta name=\"abm-page-category\" content=\"Pricing\"&gt;<\/code><\/pre>\n\n\n\n<h3 class=\"wp-block-heading\">Your own events<\/h3>\n\n\n\n<p class=\"wp-block-paragraph\">Track any action you care about, with no code, by marking an element:<\/p>\n\n\n\n<pre class=\"wp-block-code\"><code>&lt;button data-abm-event=\"demo_requested\" data-abm-label=\"Pricing page\" data-abm-value=\"1200\"&gt;Book a demo&lt;\/button&gt;<\/code><\/pre>\n\n\n\n<p class=\"wp-block-paragraph\">Or from your own code, for example after a form succeeds:<\/p>\n\n\n\n<pre class=\"wp-block-code\"><code>ABMTracker.event('demo_requested', { label: 'Pricing page', value: 1200 });<\/code><\/pre>\n\n\n\n<p class=\"wp-block-paragraph\">Events are discarded until the visitor has consented, and a page sends at most 50.<\/p>\n\n\n\n<blockquote class=\"wp-block-quote is-layout-flow wp-block-quote-is-layout-flow\">\n<p class=\"wp-block-paragraph\"><strong>Do not put personal information in event names, labels, values or in the utm_ parameters of your links.<\/strong><\/p>\n<\/blockquote>\n\n\n\n<h2 class=\"wp-block-heading has-luminous-vivid-amber-color has-text-color has-link-color wp-elements-8\" id=\"sec_19\">8. What is collected<\/h2>\n\n\n\n<p class=\"wp-block-paragraph\">The exact list is shown in the terms you accept and in the banner&#8217;s <strong>See what is collected<\/strong> panel. In summary:<\/p>\n\n\n\n<figure class=\"wp-block-table\"><table class=\"has-fixed-layout\"><thead><tr><th><strong>Area<\/strong><\/th><th><strong>What is recorded<\/strong><\/th><\/tr><\/thead><tbody><tr><td><strong>The visitor&#8217;s device<\/strong><\/td><td>a random identifier stored in a cookie (kept for 1 year), operating system, browser and version, screen resolution, device type, language, time zone, light or dark theme, media formats, the &#8220;Do Not Track&#8221; setting, push-notification permission status, the website visited, consent evidence, date of first visit and number of visits<\/td><\/tr><tr><td><strong>Each visit<\/strong><\/td><td>a random visit identifier, start and end time, duration, last page visited, network type, IP address, the organization that owns the IP address, and the approximate location (country, region, city, coordinates)<\/td><\/tr><tr><td><strong>Campaign source<\/strong><\/td><td>the utm_source, utm_medium, utm_campaign, utm_term and utm_content of the link, the type of source (search, social, email, paid, referral or direct), the referring website&#8217;s domain, the first page of the visit and the visit number<\/td><\/tr><tr><td><strong>Each page<\/strong><\/td><td>the address, time actually spent active on the page, furthest scroll, window size, loading speed (LCP, FCP, TTFB), layout stability (CLS), responsiveness (INP), a page category and the page language<\/td><\/tr><tr><td><strong>Actions<\/strong><\/td><td>file downloads, links to other websites, mailto: and tel: links, a form being viewed, started and submitted, video progress at 25 \/ 50 \/ 75 \/ 100 %, and your own events<\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n<p class=\"wp-block-paragraph\"><strong>What is never collected:<\/strong> what a visitor types into a form (only that a form was started or submitted, never a field name or a value), passwords, and street-level addresses.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">A few things to know:<\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li><strong>Location is approximate.<\/strong> It comes from the IP address, which is accurate to the city at best, and is wrong for VPNs, mobile networks and company networks routed through another city. The Geolocation field only ever holds a position the visitor agreed to share in the browser.<\/li>\n\n\n<li><strong>The organization behind an IP address<\/strong> is found in public internet registries. For a company&#8217;s own network this is the company. For a home or mobile visitor it is their internet provider.<\/li>\n\n\n<li><strong>Crawlers, headless and automated browsers<\/strong> are not recorded.<\/li>\n\n\n<li><strong>Campaign values that look like an email address<\/strong> are dropped.<\/li>\n<\/ul>\n\n\n\n<p class=\"wp-block-paragraph\">The location data is provided by DB-IP.com under licence CC BY 4.0. If you show these fields on a web page of your own, add the credit &#8220;IP Geolocation by DB-IP&#8221;.<\/p>\n\n\n\n<h2 class=\"wp-block-heading has-luminous-vivid-amber-color has-text-color has-link-color wp-elements-9\" id=\"sec_20\">9. Monitoring delivery<\/h2>\n\n\n\n<p class=\"wp-block-paragraph\">The configuration page shows how many records are <strong>Sent<\/strong>, <strong>Waiting<\/strong> and <strong>Failed<\/strong> for your organization.<\/p>\n\n\n\n<figure class=\"wp-block-image size-full\"><img loading=\"lazy\" decoding=\"async\" width=\"860\" height=\"76\" src=\"https:\/\/help.cirrus-shield.com\/wp-content\/uploads\/2026\/11\/abm-tracker-en-10.png\" alt=\"The delivery counters\" class=\"wp-image-12512\" srcset=\"https:\/\/help.cirrus-shield.com\/wp-content\/uploads\/2026\/11\/abm-tracker-en-10.png 860w, https:\/\/help.cirrus-shield.com\/wp-content\/uploads\/2026\/11\/abm-tracker-en-10-300x27.png 300w, https:\/\/help.cirrus-shield.com\/wp-content\/uploads\/2026\/11\/abm-tracker-en-10-768x68.png 768w\" sizes=\"(max-width: 860px) 100vw, 860px\" \/><figcaption class=\"wp-element-caption\">The delivery counters<\/figcaption><\/figure>\n\n\n\n<ul class=\"wp-block-list\">\n<li><strong>Waiting<\/strong> records are delivered in the background. If Cirrus Shield is unavailable they are retried automatically.<\/li>\n\n\n<li><strong>Failed<\/strong> records were rejected and are not retried, for example because a field is missing in your Cirrus Shield objects. See section 12.<\/li>\n<\/ul>\n\n\n\n<h2 class=\"wp-block-heading has-luminous-vivid-amber-color has-text-color has-link-color wp-elements-10\" id=\"sec_21\">10. Viewing the data in Cirrus Shield<\/h2>\n\n\n\n<p class=\"wp-block-paragraph\">Once visitors accept tracking, records appear in three tabs. The screenshots below use the French interface of Cirrus Shield.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\"><strong>Visiteurs<\/strong> (Visitor): one record per browser, named by its random identifier.<\/p>\n\n\n\n<figure class=\"wp-block-image size-full\"><img loading=\"lazy\" decoding=\"async\" width=\"1200\" height=\"420\" src=\"https:\/\/help.cirrus-shield.com\/wp-content\/uploads\/2026\/11\/abm-tracker-en-11.png\" alt=\"The Visitor tab in Cirrus Shield\" class=\"wp-image-12514\" srcset=\"https:\/\/help.cirrus-shield.com\/wp-content\/uploads\/2026\/11\/abm-tracker-en-11.png 1200w, https:\/\/help.cirrus-shield.com\/wp-content\/uploads\/2026\/11\/abm-tracker-en-11-300x105.png 300w, https:\/\/help.cirrus-shield.com\/wp-content\/uploads\/2026\/11\/abm-tracker-en-11-1024x358.png 1024w, https:\/\/help.cirrus-shield.com\/wp-content\/uploads\/2026\/11\/abm-tracker-en-11-768x269.png 768w, https:\/\/help.cirrus-shield.com\/wp-content\/uploads\/2026\/11\/abm-tracker-en-11-1080x378.png 1080w\" sizes=\"(max-width: 1200px) 100vw, 1200px\" \/><figcaption class=\"wp-element-caption\">The Visitor tab in Cirrus Shield<\/figcaption><\/figure>\n\n\n\n<p class=\"wp-block-paragraph\"><strong>Visites<\/strong> (Visit): one record per browser session.<\/p>\n\n\n\n<figure class=\"wp-block-image size-full\"><img loading=\"lazy\" decoding=\"async\" width=\"1200\" height=\"420\" src=\"https:\/\/help.cirrus-shield.com\/wp-content\/uploads\/2026\/11\/abm-tracker-en-12.png\" alt=\"The Visit tab in Cirrus Shield\" class=\"wp-image-12516\" srcset=\"https:\/\/help.cirrus-shield.com\/wp-content\/uploads\/2026\/11\/abm-tracker-en-12.png 1200w, https:\/\/help.cirrus-shield.com\/wp-content\/uploads\/2026\/11\/abm-tracker-en-12-300x105.png 300w, https:\/\/help.cirrus-shield.com\/wp-content\/uploads\/2026\/11\/abm-tracker-en-12-1024x358.png 1024w, https:\/\/help.cirrus-shield.com\/wp-content\/uploads\/2026\/11\/abm-tracker-en-12-768x269.png 768w, https:\/\/help.cirrus-shield.com\/wp-content\/uploads\/2026\/11\/abm-tracker-en-12-1080x378.png 1080w\" sizes=\"(max-width: 1200px) 100vw, 1200px\" \/><figcaption class=\"wp-element-caption\">The Visit tab in Cirrus Shield<\/figcaption><\/figure>\n\n\n\n<p class=\"wp-block-paragraph\"><strong>Pages visit\u00e9es<\/strong> (Visited_Page): one record per page view, named by the page title.<\/p>\n\n\n\n<figure class=\"wp-block-image size-full\"><img loading=\"lazy\" decoding=\"async\" width=\"1200\" height=\"420\" src=\"https:\/\/help.cirrus-shield.com\/wp-content\/uploads\/2026\/11\/abm-tracker-en-13.png\" alt=\"The Visited_Page tab in Cirrus Shield\" class=\"wp-image-12518\" srcset=\"https:\/\/help.cirrus-shield.com\/wp-content\/uploads\/2026\/11\/abm-tracker-en-13.png 1200w, https:\/\/help.cirrus-shield.com\/wp-content\/uploads\/2026\/11\/abm-tracker-en-13-300x105.png 300w, https:\/\/help.cirrus-shield.com\/wp-content\/uploads\/2026\/11\/abm-tracker-en-13-1024x358.png 1024w, https:\/\/help.cirrus-shield.com\/wp-content\/uploads\/2026\/11\/abm-tracker-en-13-768x269.png 768w, https:\/\/help.cirrus-shield.com\/wp-content\/uploads\/2026\/11\/abm-tracker-en-13-1080x378.png 1080w\" sizes=\"(max-width: 1200px) 100vw, 1200px\" \/><figcaption class=\"wp-element-caption\">The Visited_Page tab in Cirrus Shield<\/figcaption><\/figure>\n\n\n\n<p class=\"wp-block-paragraph\">Open a Visitor to see its visits and pages in the related lists.<\/p>\n\n\n\n<h2 class=\"wp-block-heading has-luminous-vivid-amber-color has-text-color has-link-color wp-elements-11\" id=\"sec_22\">11. Terms, withdrawing and changes<\/h2>\n\n\n\n<ul class=\"wp-block-list\">\n<li><strong>Withdraw.<\/strong> Select <strong>Withdraw acceptance<\/strong> on the configuration page. The tracker stops at once.<\/li>\n\n\n<li><strong>When the terms change.<\/strong> If the list of collected data changes in a new version, your organization must accept the terms again before tracking resumes, and visitors are asked for their choice again.<\/li>\n\n\n<li><strong>Lock.<\/strong> Select <strong>Lock<\/strong> to close your session on the configuration page.<\/li>\n<\/ul>\n\n\n\n<h2 class=\"wp-block-heading has-luminous-vivid-amber-color has-text-color has-link-color wp-elements-12\" id=\"sec_23\">12. Troubleshooting<\/h2>\n\n\n\n<h3 class=\"wp-block-heading\">The page refuses my Client ID and secret<\/h3>\n\n\n\n<figure class=\"wp-block-table\"><table class=\"has-fixed-layout\"><thead><tr><th><strong>Message<\/strong><\/th><th><strong>What to check<\/strong><\/th><\/tr><\/thead><tbody><tr><td><em>Cirrus Shield does not recognise this Client ID and secret<\/em><\/td><td>Copy the Client ID and secret of <strong>ABM Tracker Confidentiel<\/strong> again, without spaces. Make sure the application is enabled, its secret has not been regenerated since, and the Cirrus Shield URL is your organization&#8217;s.<\/td><\/tr><tr><td><em>The connected application is not allowed the api:write scope<\/em><\/td><td>Add api:write to the application&#8217;s allowed scopes in Cirrus Shield.<\/td><\/tr><tr><td><em>Cirrus Shield refused this connected application<\/em><\/td><td>The application may not be enabled for client credentials, or this server&#8217;s IP address is not in its allowed list.<\/td><\/tr><tr><td><em>Cirrus Shield could not be reached from this server<\/em><\/td><td>Check the Cirrus Shield URL and the server&#8217;s internet access.<\/td><\/tr><tr><td><em>These credentials belong to a different Cirrus Shield organization<\/em><\/td><td>You opened the plugin from one organization but entered the credentials of another.<\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n<h3 class=\"wp-block-heading\">No data appears in Cirrus Shield<\/h3>\n\n\n\n<ol class=\"wp-block-list\">\n<li>Check that the terms are accepted and the website is <strong>Active<\/strong>.<\/li>\n\n\n<li>Check that the <strong>three script lines are present, in order<\/strong>, on the page (view the page source).<\/li>\n\n\n<li>Check that the page address is listed in the website&#8217;s addresses, <strong>exactly<\/strong> as it appears in the browser. www and non-www are different addresses.<\/li>\n\n\n<li>Accept the banner in the browser you are testing with. Nothing is sent before the visitor accepts. If your browser sends Global Privacy Control or Do Not Track, tracking stays off.<\/li>\n\n\n<li>Visits from your own IP addresses may be on the <strong>ignore<\/strong> list.<\/li>\n\n\n<li>Wait a little and refresh. Delivery happens in the background, so records can arrive after the visit.<\/li>\n<\/ol>\n\n\n\n<h3 class=\"wp-block-heading\">The count of Failed records grows<\/h3>\n\n\n\n<p class=\"wp-block-paragraph\">A record carrying a field that your Cirrus Shield object does not have is rejected. This usually means your objects are not up to date. Contact Cirrus Shield support so they can update them.<\/p>\n\n\n\n<h3 class=\"wp-block-heading\">A field called Latitude_IP or Longitude_IP is missing on Visit<\/h3>\n\n\n\n<p class=\"wp-block-paragraph\">Early versions of the objects could be installed without these two fields. Contact Cirrus Shield support so they can add them.<\/p>\n\n\n\n<h3 class=\"wp-block-heading\">The banner does not appear<\/h3>\n\n\n\n<ul class=\"wp-block-list\">\n<li>Check that the consent script line is present and comes <strong>before<\/strong> the tracker line.<\/li>\n\n\n<li>Check that the website&#8217;s consent mode is <strong>Show the consent banner<\/strong>.<\/li>\n\n\n<li>A visitor who already chose will not see the banner again until the choice expires. They can use the <strong>Privacy choices<\/strong> button.<\/li>\n\n\n<li>The tracker does not start at all if abm-consent.js is blocked or missing.<\/li>\n<\/ul>\n\n\n\n<h2 class=\"wp-block-heading has-luminous-vivid-amber-color has-text-color has-link-color wp-elements-13\" id=\"sec_29\">13. Frequently asked questions<\/h2>\n\n\n\n<p class=\"wp-block-paragraph\"><strong>Does ABM Tracker create Contacts or Prospects?<\/strong> No. It records visits, pages and actions on Visitor, Visit, Visited_Page and Visit_Event records only. It does not create Contacts or Prospects and does not link a visitor to a named person.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\"><strong>Does it record what visitors type into forms?<\/strong> No. It records that a form was viewed, started or submitted, and never a field name or a typed value.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\"><strong>Can I run it on several websites?<\/strong> Yes. Add each website separately and paste its own three script lines on its pages.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\"><strong>Does it set cookies before consent?<\/strong> No. With the consent banner, nothing is sent and no cookie is set before the visitor accepts.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\"><strong>Is the interface available in French?<\/strong> Yes. The configuration page and the banner are available in English and French.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\"><strong>Who is responsible for legal compliance?<\/strong> Your organization. You accept this in the terms of use. The banner wording is a convenience and should be reviewed by a lawyer.<\/p>\n\n\n\n<h2 class=\"wp-block-heading has-luminous-vivid-amber-color has-text-color has-link-color wp-elements-14\" id=\"sec_30\">14. Glossary<\/h2>\n\n\n\n<figure class=\"wp-block-table\"><table class=\"has-fixed-layout\"><thead><tr><th><strong>Term<\/strong><\/th><th><strong>Meaning<\/strong><\/th><\/tr><\/thead><tbody><tr><td><strong>Collector<\/strong><\/td><td>the ABM Tracker server that receives data from your websites and writes it to Cirrus Shield<\/td><\/tr><tr><td><strong>Connected application<\/strong><\/td><td>the Cirrus Shield credentials that let the collector write records into your organization<\/td><\/tr><tr><td><strong>Visitor<\/strong><\/td><td>one browser, identified by a random cookie<\/td><\/tr><tr><td><strong>Visit<\/strong><\/td><td>one browser session<\/td><\/tr><tr><td><strong>Consent source<\/strong><\/td><td>how consent was given: banner, your own tool, or none<\/td><\/tr><tr><td><strong>UTM parameters<\/strong><\/td><td>the utm_&#8230; values added to links to identify a campaign<\/td><\/tr><\/tbody><\/table><\/figure>\n","protected":false},"author":20,"featured_media":0,"parent":132,"menu_order":15,"comment_status":"open","ping_status":"closed","template":"","meta":{"_et_pb_use_builder":"","_et_pb_old_content":"","_et_gb_content_width":"","_is_vendor_doc":"0","footnotes":""},"doc_tag":[],"class_list":["post-12545","docs","type-docs","status-publish","hentry"],"comment_count":0,"_links":{"self":[{"href":"https:\/\/help.cirrus-shield.com\/en\/wp-json\/wp\/v2\/docs\/12545","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/help.cirrus-shield.com\/en\/wp-json\/wp\/v2\/docs"}],"about":[{"href":"https:\/\/help.cirrus-shield.com\/en\/wp-json\/wp\/v2\/types\/docs"}],"author":[{"embeddable":true,"href":"https:\/\/help.cirrus-shield.com\/en\/wp-json\/wp\/v2\/users\/20"}],"replies":[{"embeddable":true,"href":"https:\/\/help.cirrus-shield.com\/en\/wp-json\/wp\/v2\/comments?post=12545"}],"version-history":[{"count":5,"href":"https:\/\/help.cirrus-shield.com\/en\/wp-json\/wp\/v2\/docs\/12545\/revisions"}],"predecessor-version":[{"id":12555,"href":"https:\/\/help.cirrus-shield.com\/en\/wp-json\/wp\/v2\/docs\/12545\/revisions\/12555"}],"up":[{"embeddable":true,"href":"https:\/\/help.cirrus-shield.com\/en\/wp-json\/wp\/v2\/docs\/132"}],"prev":[{"title":"Ecommerce Website Builder","link":"https:\/\/help.cirrus-shield.com\/en\/docs\/admin-guide\/ecommerce-website-builder\/","href":"https:\/\/help.cirrus-shield.com\/en\/wp-json\/wp\/v2\/docs\/12376"}],"wp:attachment":[{"href":"https:\/\/help.cirrus-shield.com\/en\/wp-json\/wp\/v2\/media?parent=12545"}],"wp:term":[{"taxonomy":"doc_tag","embeddable":true,"href":"https:\/\/help.cirrus-shield.com\/en\/wp-json\/wp\/v2\/doc_tag?post=12545"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}