# Compatibility notes

## Metrics

- **Windowed search metrics can be attached to pages as well as queries.** The domains of the windowed Search Console metrics (`clicks7Days`, `clicks28Days`, `clicks3Months`, `clicks6Months`, the matching `impressions*`, `ctr*` and `averagePosition*` properties, and their trend properties) were widened from `Query` to `Query ∪ WebPage`. Existing query-level data remains valid; no migration is needed.
- **A 6-month window was added**: `clicks6Months`, `impressions6Months`, `ctr6Months` and `averagePosition6Months`.
- **`averagePositon7Days` is deprecated** because its IRI is misspelled. Use `averagePosition7Days`. The old IRI is kept so existing data stays valid.

## Links

- `hasLinkGroup` from `WebPage` to `LinkGroup`, followed by `hasLink` from `LinkGroup` to `Link`, is the canonical pattern for grouped links. The direct `link` property remains for ungrouped or raw extracted links.
- `isLinkOf` points from `Link` back to `LinkGroup`, as the inverse of `hasLink`. Data that used `isLinkOf` to point from a `Link` directly to a `WebPage` should use `link` for ungrouped links, or add a `LinkGroup` and connect the page with `hasLinkGroup`.
- `linkGroupType` complements `linkGroupName`. The name is free-text display; the type (`header`, `footer`, `body`, `sidebar`, `navigation`) is the value consumers can filter on.
- **Links state their destination (0.1.0).** `linkTargetUrl` holds the href as a string and should be set on every `Link`. `linkTarget` points to the resolved destination node (a `WebPage`, a `URL` node or an entity) once there is one. `linkRel` holds one `rel` token per value.
- `linkText` widened from `xsd:string` to `rdfs:Literal`, so anchors can carry a language tag. Existing values stay valid.
- `linkLocation` and `linkGroupType` share one enumeration: `header`, `footer`, `body`, `sidebar`, `navigation`. Data that used `nav` for `linkLocation` should use `navigation`. When a `LinkGroup` exists, its `linkGroupType` takes precedence over `linkLocation`.
- These terms are deprecated. Their IRIs stay resolvable and existing data stays valid:

| Deprecated | Use instead |
|---|---|
| `anchorResource` | `linkTarget` |
| `linkgroupID` | `linkGroupID`, typed `xsd:string` rather than `xsd:int` |
| `noFollow` | `linkRel` with the value `nofollow` |
| `linkType` | Nothing. Derive internal versus external from `Domain`: compare the source and target pages' `hasDomain`, or the `linkTargetUrl` host with the source page's `domainName`. |
| `AnchorText` (class) | `linkText` on the `Link`. `anchorValue` and `influencedByQuery` are unchanged for now. |

## Other

- `evaluationID` uses `xsd:string`, so identifiers such as `eval_1745567328195` are valid.
- Page-level quality properties such as `seoScore` and `readabilityGradeLevel` are kept. New integrations should link a `WebPage` or `Chunk` to a `QualityScore` instead.
- Query clusters use `hasClusterQuery` / `isClusterQueryOf`. `hasQuery` / `isQueryOf` stay scoped to `WebPage` and `Query`.
- `PageGroup` stays scoped to A/B-testing cohorts. Use `PageType` for functional classifications; nothing infers one from the other.
- Structured-data profile applicability, selection, generation and validated conformance are separate states. A profile being applicable does not authorize generation or guarantee search-engine eligibility.