Developer docs

Install in minutes, expand when ready

Start with one script tag, then connect project settings, event batching, and backend verification for protected access.

Install snippet

<script
  async
  src="https://cdn.adproof.example/gate.js"
  data-project-key="adp_pub_demo123">
</script>

Event payload

Every event should carry enough context to build project-level analytics.

{
  "eventType": "overlay",
  "projectId": "prj_123",
  "publicKey": "adp_pub_demo123",
  "domain": "client.com",
  "path": "/premium/article",
  "pageUrl": "https://client.com/premium/article",
  "sessionId": "sess_456",
  "visitorId": "anon_789",
  "reason": "ad_container_hidden"
}

Server verify

Use this only from the customer backend. Never expose the secret key in browser code.

POST https://api.adproof.example/v1/verify
Authorization: Bearer adp_sk_live_xxx

Launch checklist

  1. Create customer and project.
  2. Add allowed domains.
  3. Configure the strict protected-access flow.
  4. Install the snippet on a test page.
  5. Check events, overlay rate, and integration health.
  6. Enable alerts before production rollout.