Changelog

Notable changes to the telemetry specification and these docs, newest first. The protocol is at v0.1 (preview) - expect breaking changes between preview revisions while it stabilises.

2026-05

• Identity (AIMS) folded into the telemetry spec as section 8 - the manifest format for content owners, agents, and platforms now lives alongside the event model.
• telemetry.conformance_level clarified as emitter-side and informational; content-owner manifests no longer carry it.
• New docs pages: Quickstart, Affiliate and ad networks, Authentication, Glossary, Troubleshooting, Integrations overview, and this changelog.
• Telemetry ingest moved to its own subdomain. Events and sessions now go to telemetry.openattribution.org with flat paths (/events, /sessions/*); reads, identity, delegations, and click tokens stay on api.openattribution.org.
• Telemetry read paths flattened - /api/v1/telemetry/* became /content-owners/* and /agent/*; versioning moved into the event payload. Identity keeps the /api/v1/identity/* prefix.
• Edge emitters now use telemetry:write-scoped content-owner keys; events carry an explicit id.
• Role-aware onboarding: content owners are self-serve; platform and agent access goes through a submit-then-approve flow while the network beds in.
• .well-known guidance aligned with the v0.1 manifest; the manifest unified across roles.
• Click-token lookup documented as two-sided opt-in (share_sessions_via_click_tokens and visible_in_click_token_lookups, both default off).
• Grounding (content_grounded) promoted to a first-class stage; marketplaces guide added; "publisher" replaced with "content owner" throughout.

2026-04

• Telemetry adoption guides published from the spec repo into the docs site.
• Cloudflare integration switched to API-key auth; org_id dropped from the event payload.

2026-03

• Cloudflare integration docs rewritten for edge telemetry - the Worker detects AI crawlers and reports content_retrieved with source_role: edge, no agent cooperation needed.
• Site moved to Cloudflare Pages.

v0.1 - preview specification

First public draft of the OpenAttribution telemetry specification: the session-event-outcome model, the content stages from retrieval to engagement, source roles, the JSON schemas, the manifest format, and protocol bindings. Preview status - the surface is still moving. Read it at openattribution-org/telemetry.