ads

POST /v1/public/ads-tag/{public_key}/signals

The universal tag's click-shield beacon (public, rate-limited, per-site key).

All ads endpoints

All developer docs →

Zinn®, our Viking, hammering at his anvil beside an API endpoint sending events to several listeners.

Authentication

This endpoint is public. It takes no credential and no organisation — it is what our own marketing site and AI answer engines read.

This endpoint takes no organisation id. Your key already identifies the organisation it belongs to, and the response is scoped to it.

Try it

Replace anything in angle brackets with your own values, and the key placeholder with a key from your dashboard.

curl -X POST https://api.zinndigital.com/v1/public/ads-tag/{public_key}/signals

Signed in? The API console in your dashboard fills in your real organisation id and your own key, and runs the request against the live API so you can see the actual response. Open this endpoint in the API console

Details

Public (SHIELDTAG, docs/1006.d/features/za-316-shieldtag.md): the universal script sends it with navigator.sendBeacon as text/plain JSON (no CORS preflight), so the click-fraud shield works on ANY website, not only sites Zinn® hosts. k is landing (a paid-click visit; q holds ONLY the recognised click ids — gclid, msclkid, fbclid, ttclid, li_fat_id, twclid, epik), engaged (the visitor scrolled, tapped or typed), page (a later page view, only after ad consent) or conversion (zinnAds.conversion ran). The visitor address and user agent are the REQUEST's (our ingress's trusted client address), never the body's; the host is the tag's own site; the time is the engine's. The Origin must be the tag's site or a subdomain of it. A follow-up is kept only when the same address landed from a paid click inside the 10-minute dwell window. Landings are scored by the same shield as hosted sites every 5 minutes once the dwell window closed (same weights, verdicts, IP exclusions and claim packs), only while the organisation has the shield and is in good standing; a site already scored as a hosted site or by the Zinn® Ads WordPress plugin is not scored twice. Beacons are deleted after 3 days. Always 204 for a well-formed beacon, stored or not (no oracle).

Parameters

NameTypeRequiredWhat it is
public_key (path)stringYes—

Errors this endpoint can return

400 · 429