Ottimizzare la visibilità delle tue recensioni per la SEO e le IA generative

Grazie all'integrazione del nostro widget prodotto, Avis Vérifiés ti permette di inserire in modo nativo i dati strutturati necessari alla visualizzazione dei Rich Snippet (risultati avanzati) nei risultati di ricerca organica.

Tuttavia, potresti aver temporaneamente notato una diminuzione del numero di frammenti di recensione validi nella tua Search Console, oppure un calo —o addirittura la scomparsa— del volume di visualizzazione delle stelle sotto i link delle tue pagine prodotto nei risultati di ricerca (SERP).

Il nostro widget si basa su uno script JavaScript. Google tratta questa tecnologia in modo specifico: deve essere eseguita da un motore di rendering per poterne leggere il contenuto.

Può accadere che Google non esegua sistematicamente il JavaScript del nostro widget prodotto e quindi non veda i dati strutturati che contiene, il che può impedire la visualizzazione dei Rich Snippet (stelle, numero di recensioni, frammenti di recensione).

Questo comportamento è casuale e non è stato oggetto di alcuna comunicazione ufficiale da parte di Google.

Pertanto, per garantire una visibilità permanente dei dati strutturati, ti consigliamo di implementare manualmente dati strutturati in formato JSON-LD, direttamente nel codice HTML delle tue pagine prodotto.

Questa integrazione si basa sulla nostra API Published e questa guida ti accompagna passo dopo passo nell'arricchimento delle tue pagine prodotto con dati strutturati JSON-LD, conformi ai requisiti di Google.

Prerequisiti

• Un client_id / client_secret OAuth2 valido (da generare nel tuo account Avis Vérifiés)
• Un ID di variazione prodotto (product_variation_id) per ogni prodotto del tuo sito. (Il riferimento del prodotto per cui ricevi recensioni.)

La documentazione completa dell'API

Disattivare i Rich Snippet del widget prodotto

1. Dal menu laterale a sinistra, clicca su Visualizzazione delle recensioni, poi su Integra i miei widget.
2. Clicca sulla piccola matita associata al widget prodotto che preferisci.
3. Dalle impostazioni avanzate, deseleziona l'attivazione dei Rich Snippet.

Guida all'integrazione passo dopo passo

Recuperare il JSON-LD già pacchettizzato

Un nuovo endpoint dedicato dell'API Published (scopri di più sull'API Published) restituisce direttamente il markup JSON-LD già pacchettizzato (voto medio, numero di recensioni e, se del caso, le singole recensioni), conforme ai requisiti di Google.

Non devi quindi più formattare nulla da solo: è sufficiente recuperare la risposta dell'API e inserirla lato server nell'HTML della tua pagina prodotto, tra i tag <script type="application/ld+json"> … </script>. È il metodo più semplice e meno soggetto a errori.

URL

https://api.skeepers.io/verified-reviews/v1/published/products/structured-datas

Esempio di risposta ottenuta (formato JSON):

{
  "ratings": {
    "@context": "https://schema.org",
    "aggregateRating": {
      "@type": "AggregateRating",
      "ratingValue": 4.3,
      "reviewCount": 12,
      "bestRating": 5,
      "worstRating": 1,
      "itemReviewed": {
        "@id": "https://www.example.com/p/blue-widget"
      }
    }
  },
  "reviews": {
    "@context": "https://schema.org",
    "review": [
      {
        "@type": "Review",
        "reviewBody": "Great product, exactly as described!",
        "datePublished": "2024-06-24T15:12:31Z",
        "reviewRating": {
          "@type": "Rating",
          "ratingValue": 5,
          "bestRating": 5,
          "worstRating": 1
        },
        "author": {
          "@type": "Person",
          "name": "John D."
        },
        "itemReviewed": {
          "@id": "https://www.example.com/p/blue-widget"
        }
      }
    ]
  },
  "reviewSummary": {
    "@context": "https://schema.org",
    "review": {
      "@type": "Review",
      "reviewBody": "Customers love the build quality and value, with occasional notes on delivery times.",
      "datePublished": "2024-06-24T15:12:31Z",
      "author": {
        "@type": "Organization",
        "name": "Skeepers"
      },
      "itemReviewed": {
        "@id": "https://www.example.com/p/blue-widget"
      }
    }
  }
}

Inserisci questo blocco così com'è nel <head> o subito prima del tag di chiusura </body> della tua pagina prodotto. Ricordati di mantenere una cache aggiornata quotidianamente (vedi Buone pratiche) invece di chiamare l'API a ogni caricamento della pagina.

Testare la validazione dei dati

Utilizza lo strumento Google Rich Results Test per verificare che i dati strutturati siano corretti e ben rilevati.