Shield · GTM

Google Tag Manager integration

Install Shield via the official tag template or a Custom HTML tag, and act on risk results straight from the dataLayer.

Official tag template

The easiest install — no HTML editing.

Download findip-shield.tpl and import it via GTM → Templates → Tag Templates → New → ⋮ → Import. Site key, auto-track, privacy mode, and dataLayer push are configured fields. Trigger: All Pages.

Custom HTML tag

The plain alternative. Trigger: All Pages.

<script
  src="https://cdn.findip.net/shield/v1.js"
  data-site-key="pub_xxxxxxxxx"
  data-auto-track="true"
  data-privacy-mode="balanced"
  data-push-to-data-layer="true">
</script>

dataLayer events

Create a trigger on event equals findip_risk_result to act on risk scores.

{
  event: 'findip_risk_result',
  findip_session_id: 'sess_xxx',
  findip_visitor_id: 'vis_xxx',
  findip_request_id: 'req_xxx',
  findip_risk_score: 87,
  findip_risk_level: 'high',
  findip_recommendation: 'challenge',
  findip_is_vpn: true,
  findip_is_proxy: false,
  findip_is_tor: false,
  findip_is_relay: false,
  findip_is_hosting: true,
  findip_is_malicious: false,
  findip_country: 'US',
  findip_asn: 12345
}

Passing context via dataLayer

The SDK reads allowlisted fields from existing entries.

dataLayer.push({
  email_domain: 'gmail.com',
  plan: 'enterprise',
  user_id_hash: 'sha256_hash_here',
});

Consent mode & troubleshooting

// On consent granted
FindIP.setConsent(true);

// On consent denied
FindIP.setConsent(false);

Disable dataLayer pushdata-push-to-data-layer="false"

GTM detectionThe SDK auto-detects GTM via google_tag_manager or dataLayer presence.