ads
POST /v1/public/ads-tag/{public_key}/signals
The universal tag's click-shield beacon (public, rate-limited, per-site key).
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}/signalsSigned 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
| Name | Type | Required | What it is |
|---|---|---|---|
public_key (path) | string | Yes | — |
Errors this endpoint can return
400 · 429