Detection Tag - Passive, Non-Interactive

The Passive, Non-Interactive mode helps you to understand the bot traffic that is loading pages on your web properties. This integration type focuses exclusively on page loads and ignores subsequent events, like logging in, liking posts, playing songs, etc.

Setup

Tag Fields

Required Fields

  • ci: Customer ID
  • dt: Tag ID
  • mo: Tag mode. Value is always 0 for Passive, Non-Interactive
  • 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

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, followed by the main payload that is ~40KB. Postbacks are made one to a few times, and are generally a few hundred Bytes.

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.