Skip to content

Date structurate: Article, FAQPage, BreadcrumbList

Datele structurate sunt marcajul din pagină prin care Google înțelege ce fel de conținut are în față și decide dacă îl afișează cu dată, imagine sau traseu de navigare în loc de o adresă brută. Pe hyperice.md marcajul e complet pe produse și colecții, dar lipsește pe blog, pe pagina de întrebări frecvente și pe majoritatea paginilor statice. Blogul e singura parte a site-ului care poate aduce vizitatori pe întrebări, nu pe numele produsului, și tocmai el nu are niciun marcaj de articol.

Ce am găsit

Articolele de blog nu au marcaj Article

HTML-ul servit pentru https://hyperice.md/blogs/hyperhub/foam-rolling-for-sciatica (și variantele /en, /ru) conține exact un singur bloc <script type="application/ld+json">, de tip BreadcrumbList. Același rezultat în DOM-ul randat.

Cauza, backend/src/services/page-meta.ts:271-276, ramura de articol:

        jsonLd: [
          breadcrumbJsonLd([
            { name: pageStrings(strings, 'hyperhub').title, url: absolute('/blogs/hyperhub') },
            { name: title, url: absolute(canonicalPath) },
          ]),
        ],

backend/src/services/structured-data.ts are 109 linii și exportă doar organizationJsonLd (linia 27), productJsonLd (linia 65) și breadcrumbJsonLd (linia 98) — nicio funcție pentru Article. Sitemap-ul conține 216 adrese de articol (72 de articole × 3 limbi).

Pagina de întrebări frecvente nu are marcaj FAQPage

curl pe /support/faq, /en/support/faq și /ru/support/faq: zero apariții de application/ld+json în toate trei.

Conținutul există și e real: frontend/src/pages/support/Faq.tsx:22 (blocul RO), :155 (RU), :287 (EN); blocul RO conține 8 perechi întrebare/răspuns, despre plasarea comenzii, modalitățile de plată, TVA, primirea produsului, retur, garanție și statutul de dispozitiv medical.

Pe fișa de produs, DOM-ul randat al https://hyperice.md/products/hypervolt-3-pro conține h2 „Întrebări frecvente" cu întrebări și răspunsuri vizibile, dar JSON-LD-ul emis e doar Product + BreadcrumbList. În frontend/src/data/productDetails.ts există 42 de blocuri faq:.

Condiția Google (marcajul trebuie să reflecte ce se vede în pagină) e deja îndeplinită — lipsește doar marcajul. Câștigul practic e însă mic: din 2023 Google afișează rezultate îmbogățite de tip FAQ doar pentru site-uri guvernamentale și de sănătate, nu pentru magazine.

27 din 42 de pagini nu au niciun JSON-LD

Verificat prin curl, numărul de blocuri application/ld+json este 0 pe /about, /blogs/hyperhub, /gift-cards, /legal/privacy, /legal/terms, /recovery-rooms, /support/contact, /support/faq și /therapy/recovery — fiecare în cele trei limbi.

Cauza, backend/src/services/page-meta.ts:134:

  const staticPage = (key: string, canonicalPath: string, extra: JsonLdNode[] = []): PageMeta => {

Parametrul extra e folosit într-un singur apel, linia 164 — staticPage('home', '/', [organizationJsonLd(origin)]). Apelurile de la liniile 170, 174, 178 și 288 nu trimit nimic, deci toate paginile statice ies fără date structurate. Mecanismul există deja: breadcrumbJsonLd din structured-data.ts:98 e folosit pe colecții (page-meta.ts:235) și pe produse, unde traseul e corect — pozițiile 1..n contigue, cu name și item prezente.

De făcut

  • Se adaugă o funcție articleJsonLd în backend/src/services/structured-data.ts și se emite în page-meta.ts lângă breadcrumb: @type Article, headline din titlu, description din excerpt, image cu heroImage absolut, datePublished din article.dateISO, publisher Organization cu numele și logoul din backend/src/lib/company.ts, mainEntityOfPage canonicalul. Fără author inventat — se pune publisher, care e adevărat.
  • În page-meta.ts, staticPage construiește singur traseul din rootCrumb plus pagina curentă, și pentru /therapy/*, /legal/*, /support/* treapta intermediară dacă are pagină proprie — la fel cum face ramura de colecție de la linia 235. Odată cu asta dispare și parametrul extra, folosit într-un singur loc.
  • Se adaugă o funcție faqPageJsonLd(qa) în structured-data.ts (@type FAQPage, mainEntity cu Question/acceptedAnswer), apelată în page-meta.ts pentru ruta /support/faq — întrebările se mută din Faq.tsx într-un modul comun sau se citesc din aceeași sursă — și pentru rutele de produs care au bloc faq în frontend/src/data/productDetails.ts.

Criteriu de acceptare

  • curl pe 3 articole × 3 limbi arată două blocuri JSON-LD, Article și BreadcrumbList, ambele parsabile, cu headline, image, datePublished și publisher completate; datePublished coincide cu data afișată pe pagină.
  • curl pe /about, /therapy/recovery, /support/faq, /legal/terms, /recovery-rooms și /gift-cards în cele 3 limbi arată câte un BreadcrumbList parsabil, cu pozițiile 1..n contigue și item-uri care conțin prefixul de limbă corect.
  • curl pe /support/faq în cele 3 limbi arată un bloc FAQPage parsabil cu 8 Question, fiecare cu acceptedAnswer nevid, iar textul din marcaj coincide cuvânt cu cuvânt cu ce se vede pe pagină; la fel pe cel puțin 3 fișe de produs cu FAQ.
Edited by Vitalie