What is Hood Web SDK?

A JavaScript SDK that provides auto‑configuration, event tracking, modals, and web push — via a single <script>.

Who it’s for

Frontend engineers integrating tracking, modals, and push into web apps (SPA and MPA).

▶Get started

This is the first stop when integrating the SDK. Learn how to safely load the script, initialize it, and validate that basic tracking works — in a few minutes.

• Installation & loading: Installation and loading — where and how to load ht.js, supported data-* attributes, CSP and performance notes.
• Quick start: Getting started — minimal snippet, SPA pageviews, consent basics, and sanity checks.
• Initialization & auto‑conf: Initialization and auto-conf — how the SDK resolves configuration, load order, and precedence.

📄Reference

Use these when you need precise behavior or you’re troubleshooting. They describe every knob you can turn and how components interact.

• Configuration & precedence: Configuration reference — all keys, defaults, and which layer overrides which.
• Public API (Hood): API reference — complete list of callable methods with signatures and examples.
• Events & triggers: Events and triggers — what the SDK emits and how to react to it.
• Filtering (rules, operators, macros): Filtering — target specific audiences with conditions and table lookups.

⚙Features

Deep‑dives into the main building blocks you’ll use in production.

• Modals (A/B, languages, limits): Modals — render, A/B test, and cap experiences with accessibility built‑in.
• Web push (VAPID, SW, AMP): Push notifications — request permission responsibly and deliver messages.
• Tags (custom actions): Tag Manager — register and execute custom tags with triggers and filters.
• Data model & storage (UTM, BW_INFO, session/local): Data and storage — what the SDK stores and how you can reference it.
• Errors & Crashlytics: Error and crashlytics — capture client errors alongside your analytics.

✓Examples & help

Copy‑pasteable recipes for common tasks and answers to frequent questions.

• Real-world examples: Examples and best practices — Integration patterns, use cases, advanced scenarios, troubleshooting.
• Frequently asked questions: FAQ & Troubleshooting — quick fixes for typical integration pitfalls.