Detection Tag - Pageview Monitoring mode
The Pageview Monitoring
mode (previously named Passive, Non-Interactive mode
) helps provide visibility of bot
traffic that is loading pages on your web properties without requiring any server-to-server API calls. This integration
type focuses exclusively on page loads, and does not monitor or mitigate events such as account creation,
authentication, commenting or liking, checking out, etc.
Setup
Tag Fields
Required Fields
ci
: Customer IDdt
: Tag IDmo
: Tag mode. Value is always0
for Pageview Monitoring modepd
: Product key, alwaysacc
for BotGuard for Applications
Optional Fields
ap
: App IDck
: Cookie IDdv
: Device IDsi
: Site IDui
: User IDc1 - c10
: Custom fieldsr1 - r10
: Reporting fields
Field Index
For detailed information on the full set of Detection Tag fields, refer to the Detection Tag Field Index.
Tag Example
Below is an example JavaScript Detection tag with populated values:
<script src="https://s.update.example.com/ag/123456/clear.js?
ci=123456
&dt=1234567890123456789012
&mo=0
&pd=acc
&ap=com.example.Example <!-- in app only -->
&ck=ddeedb6f4adf80dd2d8b0eb81c69da13
&dv=c3f927f4-3ef9-4b53-8887-d794c4daea82 <!-- in app only -->
&si=xyz1234
&ui=04a1ad8a40e296df0d385e46c3796cd3
&c1=v123
&c2=x987
&r1=y314"></script>
Tag Context
Tag Placement
The tag should be placed in the <head>
section of the HTML and should be loaded synchronously. The async
attribute
should not be used. Loading the tag as early as possible will improve the efficacy of the Detection that the tag
provides.
Tag Size
The initial JavaScript payload is 2KB ~ 4KB
in size followed by the main payload that is ~40KB
. Postbacks are made
one to a few times, and are generally a few hundred bytes each.
JavaScript Required
For the majority of use cases, JavaScript is required for effective detection. Our solution assumes that visitors to your online properties have JavaScript enabled.