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 ID
  • dt: Tag ID
  • mo: Tag mode. Value is always 0 for Pageview Monitoring mode
  • pd: Product key, always acc for BotGuard for Applications

Optional Fields

  • ap: App ID
  • ck: Cookie ID
  • dv: Device ID
  • si: Site ID
  • ui: User ID
  • c1 - c10: Custom fields
  • r1 - 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.