Getting Started

Integrate Malvertising Defense for Platforms

If you’re an advertising platform, you can learn how to integrate and deploy the HUMAN Malvertising Defense script with this article.

Legacy Edge and Internet Explorer are not supported.

1

Integration

HUMAN will generate your tag and enable Platform to pass additional data through custom fields. Additional fields outside of creative ID will help HUMAN provide more insights into the specific threats. We recommend and accept the following fields:

  • Seat ID
  • DSP ID
  • Site ID
  • Creative ID
  • Publisher ID
  • Referrer Domain

During integration, keep the following in mind:

  • Platform should replace "%creative-id%" and other macros with values at serve time.
  • If macros are not applicable or available for Seat ID (i.e. Member or Buyer), DSP ID, Site ID, Pub ID or Referrer Domain, delete the line.
  • For maximum effectiveness, the script should be delivered within the creative synchronously above all other ad code, impression/reporting pixels, etc. If it isn’t, this could result in missed threats.
Example script
1<script src="https://HUMAN.domain/{YOUR-UNIQUE-ID}/script.js" 
2    data-creative-id="%Creative ID of ad being served%"
3    data-seat-id="%Seat/Buyer ID on the DSP%"
4    data-dsp-id="%DSP ID on the platform%"
5    data-site-id="%Site ID on the platform%"
6    data-pub-id="%ID of the Publisher%"
7    data-referrer-domain="%publisher domain where the ad is being served%"
8    data-client-key="%{YOUR-UNIQUE-CLIENT-KEY}%"
9    data-api-integration-mode="header">
10</script>
11
12//creative code here
2

Deployment

The deployment process has three phases:

  1. Integration Testing: Before injecting the HUMAN script on live traffic, we recommend performing a number of tests. The HUMAN team will work directly with the Platform team to ensure effectiveness. We will need a test page to perform a full QA pass.
  2. Phased Rollout: Once validated, HUMAN recommends scaling the integration in phases. This can be achieved by deploying on a specific number of websites or a small percentage of traffic in desired geographies. Once live on traffic, HUMAN will verify results to ensure incremental threats are detected and the integration is functioning as expected.
  3. Full Rollout: After gaining confidence through phased rollout, the script should be deployed to target percentage: 10% of traffic. HUMAN will continue to monitor. Incremental threats captured via the direct integration will be visible in the HUMAN Platform Feed dashboard.