# Protocollo pubblico - Schema.org v2 su Matarese Automobili

Versione: 1.1.0
Stato: protocollo in corso; misurazione non iniziata
Ultimo aggiornamento: 2026-07-15

## Scopo e regola di verita

Questo documento definisce come verra valutato il rollout Schema.org v2 di DealerWebsite. Non certifica che il rollout sia avvenuto e non pubblica risultati. Qualunque campo privo di evidenza resta `null`, `pending` o `not_started`; non viene sostituito con una stima.

L'autorizzazione a pubblicare identita, dominio e protocollo del caso Matarese Automobili e stata concessa da Antonio Matarese con decorrenza 2026-07-01 e registrata nel pacchetto il 2026-07-15. Il record pubblico e in `publication-authorization.json`. Questa autorizzazione non convalida risultati non misurati e non ripristina claim, ranking, endorsement LLM o media attribuiti ritirati nel correction log.

## Ipotesi

L'ipotesi tecnica e che un grafo Schema.org unico, coerente con contenuto visibile, canonical, sitemap e fonte dati della UI riduca errori di contratto e ambiguita di entita. Le variazioni di ranking, click e citazioni AI sono outcome osservazionali: non sono garantite e non vengono attribuite causalmente al markup senza un disegno sperimentale adeguato.

## Disegno temporale

1. Congelamento del manifest URL e del prompt set prima della prima osservazione.
2. Baseline Search Console di 8 settimane (56 giorni).
3. Deploy identificato da commit e deployment ID.
4. Washout di 14 giorni, escluso dal confronto principale.
5. Periodo post di 8 settimane (56 giorni).
6. Pubblicazione di risultati positivi, negativi o nulli con le stesse regole.

L'unita primaria e `URL-day`, non il totale grezzo del sito. Questo limita la distorsione causata dal churn dei veicoli: ogni URL e ogni giorno osservabile costituiscono una riga. Le analisi vengono stratificate per tipo pagina; URL entrati o usciti dal manifest vengono marcati, non imputati come continui.

## KPI tecnici deterministici

I seguenti criteri sono gate pass/fail e non metriche marketing:

- 100% dei contract test previsti superati;
- 100% di coerenza tra sitemap e canonical;
- zero riferimenti a host tecnici nel grafo pubblico;
- zero `@id` stabili confliggenti;
- zero mismatch tra prezzo/disponibilita visibili e sorgente del grafo;
- zero duplicazioni del grafo nel payload di idratazione.

Ogni misurazione registra URL, timestamp, build ID, deployment ID, contratto Schema, hash SHA-256 del grafo normalizzato e prova grezza o riferimento immutabile alla prova.

## Outcome Search osservazionali

Per Search Console vengono raccolti click, impression, CTR e posizione media per pagina e giorno, mantenendo separati tipo di ricerca, paese e dispositivo quando disponibili. La sorgente assegna in genere i dati alla canonical selezionata da Google e puo omettere query anonimizzate; questi limiti devono essere riportati.

Il confronto principale usa le due finestre da 56 giorni e non il washout. Non si promettono rich result: Google dichiara che un markup valido abilita l'idoneita ma non garantisce la visualizzazione della feature.

## Outcome AI osservazionali

Il prompt set candidato e in `prompt-set.json`. Prima della prima esecuzione deve essere congelato con timestamp, hash e commit ID. Ogni run registra provider, prodotto, modello dichiarato, modalita di ricerca/browsing, lingua, area geografica, timestamp e output integrale consentito dai termini applicabili.

La valutazione distingue:

- presenza o assenza di citazione;
- supporto della citazione alla specifica frase valutata;
- accuratezza dei fatti rispetto alla sorgente congelata;
- freshness rispetto allo snapshot dello stock;
- risposta nulla o rifiuto.

Una menzione senza fonte non vale come citazione supportata. Un risultato non disponibile viene registrato come mancante con motivo, mai trasformato in zero senza distinzione.

## Confondenti definiti ex ante

- stagionalita e domanda locale;
- variazioni di stock, prezzi e disponibilita;
- campagne, PR, backlink e modifiche editoriali concorrenti;
- aggiornamenti degli algoritmi Search;
- aggiornamenti, personalizzazione e non-determinismo dei modelli AI;
- differenze per account, posizione, dispositivo e modalita di browsing;
- modifiche di canonical selezionata, crawling e indicizzazione;
- indisponibilita di provider o dati incompleti.

Le modifiche concorrenti vengono annotate per data. Se impediscono un confronto interpretabile, il risultato viene dichiarato inconcludente.

## Governance e correzioni

Il manifest, i contratti, gli hash, il prompt set e il correction log sono file statici versionati su DealerMax. DealerMax non effettua chiamate runtime verso APIMAX per comporre questa pagina. Le prove operative vengono prodotte fuori dal runtime pubblico e pubblicate solo dopo controllo, consenso e redazione di eventuali dati sensibili.

Le correzioni non sovrascrivono silenziosamente la storia: vengono aggiunte a `correction-log.json` con data, ambito, motivo e azione.

## Riferimenti autoritativi

- Google Search Central, Product structured data: https://developers.google.com/search/docs/appearance/structured-data/product-snippet
- Google Search Central, general structured data guidelines: https://developers.google.com/search/docs/appearance/structured-data/sd-policies
- Google Search Console, definizione di impression, posizione e click: https://support.google.com/webmasters/answer/7042828