{"id":"product/public-discovery-measurement","relativePath":"product/public-discovery-measurement.md","title":"Public discovery measurement (PD0)","markdown":"# Public discovery measurement (PD0)\n\nStatus: instrumented; production observation and five moderated sessions remain open.\n\nThe public baseline uses consent-gated GA4 events and never attaches a user ID,\nemail address, organization ID, or professional-workspace route. Browser-local\nmarkers distinguish a first artwork completion from a visit at least 24 hours\nlater; clearing browser storage resets those markers.\n\n| Event | Outcome | Trigger |\n|---|---|---|\n| `first_time_artwork_completion` | First-time completion | First consented artwork route reached in a browser. |\n| `artwork_to_artwork_continuation` | Artwork continuation | Visitor follows previous, next, related, or curated-connection artwork link. |\n| `return_visit` | Return visit | A consented public visit occurs at least 24 hours after the prior stored visit. |\n| `public_domain_download` | Rights-safe download | Visitor selects the image download control, which is rendered only for an exact item-level public-domain or CC0 image statement. |\n| `share` | Share | Native share completes, or the clipboard fallback successfully copies the canonical artwork URL. Cancellation and errors are not counted. |\n\nThe initial report must include event counts, eligible consented sessions, the\nmeasurement window in UTC, and known gaps. Do not calculate conversion rates\nwhen the denominator is unavailable, and do not treat GA4 page views as any of\nthe five outcome events.\n\nImport real evidence with:\n\n```powershell\npnpm pd0:evidence -- --input=path/to/pd0-evidence.json --check\n```\n\nThe input object requires `measurementWindow` (`startedAt`, `endedAt`,\n`eligibleConsentedSessions`, and `source`), integer counts for all five event\nnames, `usabilitySessions`, and an optional `productOwnerReview`. Each session\nuses only an opaque `participantCode`, UTC completion time, `nonSpecialist: true`,\n`consented: true`, the four comprehension/completion results (`yes`,\n`with-help`, or `no`), and a friction note. Quotes are optional and limited to\n20 words. Direct identifier fields, duplicate codes, negative counts, invalid\nwindows, and synthetic completion are rejected. `--check` exits unsuccessfully\nuntil five sessions and an approved, attributable product-owner review exist.\n\nCross-origin image hosts may cause the browser to open the original image before\nthe visitor saves it. The download event therefore measures selection of a\nrights-qualified download action, not confirmation that a file reached disk.\n\n## Non-specialist usability protocol\n\nRecruit five adults who do not work professionally with museum metadata,\ncollections systems, Linked Art, or cultural-heritage APIs. Record only a\nparticipant code and coarse experience note—no names or contact details.\n\nAsk each person to:\n\n1. Explain what the homepage offers after five seconds.\n2. Find an artwork that interests them and say where it came from.\n3. Explain whether its image can be reused.\n4. Continue to a second artwork.\n5. Follow the Flowers connection and describe what is claimed and not claimed.\n\nFor each session, record completion (`yes`, `with-help`, or `no`), notable\nfriction, rights/source comprehension, connection-boundary comprehension, and\none verbatim phrase of at most 20 words with permission. A product owner must\nsign the five-session summary before PD3 expands beyond the first journey.\n","sections":[{"level":2,"heading":"Non-specialist usability protocol","anchor":"non-specialist-usability-protocol"}],"html":"<h1 id=\"public-discovery-measurement-pd0\">Public discovery measurement (PD0)</h1>\n<p>Status: instrumented; production observation and five moderated sessions remain open.</p>\n<p>The public baseline uses consent-gated GA4 events and never attaches a user ID,</p>\n<p>email address, organization ID, or professional-workspace route. Browser-local</p>\n<p>markers distinguish a first artwork completion from a visit at least 24 hours</p>\n<p>later; clearing browser storage resets those markers.</p>\n<p>| Event | Outcome | Trigger |</p>\n<p>|---|---|---|</p>\n<p>| `first_time_artwork_completion` | First-time completion | First consented artwork route reached in a browser. |</p>\n<p>| `artwork_to_artwork_continuation` | Artwork continuation | Visitor follows previous, next, related, or curated-connection artwork link. |</p>\n<p>| `return_visit` | Return visit | A consented public visit occurs at least 24 hours after the prior stored visit. |</p>\n<p>| `public_domain_download` | Rights-safe download | Visitor selects the image download control, which is rendered only for an exact item-level public-domain or CC0 image statement. |</p>\n<p>| `share` | Share | Native share completes, or the clipboard fallback successfully copies the canonical artwork URL. Cancellation and errors are not counted. |</p>\n<p>The initial report must include event counts, eligible consented sessions, the</p>\n<p>measurement window in UTC, and known gaps. Do not calculate conversion rates</p>\n<p>when the denominator is unavailable, and do not treat GA4 page views as any of</p>\n<p>the five outcome events.</p>\n<p>Import real evidence with:</p>\n<pre><code>\npnpm pd0:evidence -- --input=path/to/pd0-evidence.json --check\n</code></pre>\n<p>The input object requires `measurementWindow` (`startedAt`, `endedAt`,</p>\n<p>`eligibleConsentedSessions`, and `source`), integer counts for all five event</p>\n<p>names, `usabilitySessions`, and an optional `productOwnerReview`. Each session</p>\n<p>uses only an opaque `participantCode`, UTC completion time, `nonSpecialist: true`,</p>\n<p>`consented: true`, the four comprehension/completion results (`yes`,</p>\n<p>`with-help`, or `no`), and a friction note. Quotes are optional and limited to</p>\n<p>20 words. Direct identifier fields, duplicate codes, negative counts, invalid</p>\n<p>windows, and synthetic completion are rejected. `--check` exits unsuccessfully</p>\n<p>until five sessions and an approved, attributable product-owner review exist.</p>\n<p>Cross-origin image hosts may cause the browser to open the original image before</p>\n<p>the visitor saves it. The download event therefore measures selection of a</p>\n<p>rights-qualified download action, not confirmation that a file reached disk.</p>\n<h2 id=\"non-specialist-usability-protocol\">Non-specialist usability protocol</h2>\n<p>Recruit five adults who do not work professionally with museum metadata,</p>\n<p>collections systems, Linked Art, or cultural-heritage APIs. Record only a</p>\n<p>participant code and coarse experience note—no names or contact details.</p>\n<p>Ask each person to:</p>\n<ol><li>Explain what the homepage offers after five seconds.</li></ol>\n<ol><li>Find an artwork that interests them and say where it came from.</li></ol>\n<ol><li>Explain whether its image can be reused.</li></ol>\n<ol><li>Continue to a second artwork.</li></ol>\n<ol><li>Follow the Flowers connection and describe what is claimed and not claimed.</li></ol>\n<p>For each session, record completion (`yes`, `with-help`, or `no`), notable</p>\n<p>friction, rights/source comprehension, connection-boundary comprehension, and</p>\n<p>one verbatim phrase of at most 20 words with permission. A product owner must</p>\n<p>sign the five-session summary before PD3 expands beyond the first journey.</p>","updatedAt":"2018-10-20T01:46:40.000Z","checksum":"18a00fc135ffe4a7983493ce73a5cb5d135934dd6b9145de46605dfd50648a9c","checksumPrefix":"18a00fc135ff","anchorCount":1,"lineCount":61,"rawUrl":"/api/docs/content?path=product%2Fpublic-discovery-measurement.md","htmlUrl":"/docs?doc=product%2Fpublic-discovery-measurement.md","apiUrl":"/api/docs/content?path=product%2Fpublic-discovery-measurement.md"}