Ad Click DefenseIntegration options

Deploy the detection tag

This guide explains how to deploy the Ad Click Defense JavaScript detection tag. It assumes you have reviewed the integration options guide.

Prerequisites

Before you begin, ensure your environment meets the following requirements:

  • Access to the HUMAN console.
  • Ability to modify JavaScript-supported website, page templates, ad delivery configurations, or creative tags.
  • You must be able to deploy the HUMAN detection tag alongside the ad creative.

Deploy the JavaScript detection tag

This is the recommended deployment path for JavaScript-enabled web and mobile web environments. The detection tag uses a lightweight asynchronous script to collect click-related technical and behavioral signals for Click IVT analysis and reporting within the HUMAN dashboard. HUMAN analyzes the pre-click signals and populates aggregate-level reporting in your dashboard within one hour from the time the click took place.

If your environment does not support JavaScript, such as mobile apps or restricted web environments, contact a HUMAN representative for guidance on alternative deployment options.

1

Obtain the detection tag

HUMAN will provide you with the HTML markup of the tag(s) and assist with validation. The tag requires the async attribute and contains a data-kvqs attribute that you must configure.

Example of a HUMAN JavaScript detection tag
<script src="https://example.human.tag.url/c123456/payload.js?dt=123456789" async="true" data-kvqs="..."></script>

The tag consists of the following attributes:

  • src: A URL to one of several HUMAN owned domains that serve the payload. Also, note that the payload name—payload.js—will vary as well as the value of the dt parameter.
  • async: The tag should be loaded asynchronously and not block page loading.
  • data-kvqs: A list of parameters with dynamic values.
2

Configure the data-kvqs attribute

You must dynamically populate the data-kvqs attribute with a single string containing your required parameters. To build this string, follow these formatting rules:

  1. Format individual parameters as parameter=value.
  2. Separate multiple key-value pairs with an ampersand (&).
  3. Remove all spaces from the string.
  4. Apply standard URL encoding to all values.

Example of a HUMAN detection tag with populated values in the data-kvqs attribute:

```html wordWrap showLineNumbers= Example with populated data-kvqs attribute

### Inject dynamic values using macros
Use your ad platform's macro syntax (for example, `${...}`, `%%...%%`, or `{{...}}`) to dynamically inject values at serving time. You must map your platform's macros to the corresponding HUMAN parameters.
```html wordWrap showLineNumbers={false} Example of the HUMAN detection tag with macros
<script src="https://example.human.tag.url/c123456/payload.js&dt=123456789" async="true" data-kvqs="ck={{IMPRESSION-ID}}&di={{DOMAIN-INTENDED}}&sr={{SUPPLIER-ID}}&pp={{PUBLISHER-ID}}"></script>

Parameter mapping:

  • ck: Your unique impression identifier
  • di: The intended domain for the click destination
  • sr: Your supplier ID (provided by HUMAN)
  • pp: Your publisher ID (provided by HUMAN)

The example above is for illustration purposes only. It does not include all the available parameters and should not be used in production. See Detection tag parameters for detailed parameter descriptions.

3

Insert the tag

Place the fully configured tag at the top-most level of the creative iframe to ensure it executes correctly when the ad renders.

Next steps

After deploying the detection tag, proceed to the next step based on your chosen integration option:

  • Observer-Path: No additional steps required. Your data will be available on the HUMAN Dashboard within one hour from the time the click took place.
  • Observer-Path with real-time Click IVT Response: Deploy the real-time API to get IVT decision responses in real time.

Contact a HUMAN representative for validation and support during the deployment process.