Optimizar la visibilidad de tus opiniones para el SEO y las IA generativas

Gracias a la integración de nuestro widget de producto, Avis Vérifiés te permite insertar de forma nativa los datos estructurados necesarios para mostrar los Rich Snippets (resultados enriquecidos) en los resultados de búsqueda orgánica.

Sin embargo, es posible que hayas constatado temporalmente una disminución del número de fragmentos de opiniones válidos en tu Search Console, o incluso una bajada —o la desaparición— del volumen de visualización de las estrellas bajo los enlaces de tus páginas de producto en los resultados de búsqueda (SERP).

Nuestro widget se basa en un script JavaScript. Google trata esta tecnología de forma específica: necesita ser ejecutada por un motor de renderizado para poder leer su contenido.

Puede ocurrir que Google no ejecute sistemáticamente el JavaScript de nuestro widget de producto y, por tanto, no vea los datos estructurados que contiene, lo que puede impedir que se muestren los Rich Snippets (estrellas, número de opiniones, fragmentos de opiniones).

Este comportamiento es aleatorio y no ha sido objeto de ninguna comunicación oficial por parte de Google.

Así, para garantizar una visibilidad permanente de los datos estructurados, te recomendamos implementar manualmente datos estructurados en formato JSON-LD, directamente en el código HTML de tus páginas de producto.

Esta integración se apoya en nuestra API Published y esta guía te acompaña paso a paso para enriquecer tus páginas de producto con datos estructurados JSON-LD, conformes con los requisitos de Google.

Requisitos previos

• Un client_id / client_secret OAuth2 válido (que debes generar en tu cuenta de Avis Vérifiés)
• Un ID de variación de producto (product_variation_id) para cada producto de tu sitio. (La referencia del producto del que recibes opiniones.)

La documentación completa de la API

Desactivar los Rich Snippets del widget de producto

1. Desde el menú lateral izquierdo, haz clic en Visualización de opiniones y luego en Integrar mis widgets.
2. Haz clic en el lápiz pequeño asociado al widget de producto que elijas.
3. En los ajustes avanzados, desmarca la activación de los Rich Snippets.

Guía de integración paso a paso

Recuperar el JSON-LD ya empaquetado

Un nuevo endpoint dedicado de la API Published (más información sobre la API Published) devuelve directamente el marcado JSON-LD ya empaquetado (nota media, número de opiniones y, en su caso, las opiniones individuales), conforme con los requisitos de Google.

Por tanto, ya no tienes que formatear nada tú mismo: basta con recuperar la respuesta de la API e insertarla del lado del servidor en el HTML de tu página de producto, entre las etiquetas <script type="application/ld+json"> … </script>. Es el método más sencillo y menos propenso a errores.

URL

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

Ejemplo de respuesta obtenida (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"
      }
    }
  }
}

Inserta este bloque tal cual en el <head> o justo antes de la etiqueta de cierre </body> de tu página de producto. Recuerda mantener una caché actualizada a diario (consulta Buenas prácticas) en lugar de llamar a la API en cada carga de página.

Probar la validación de los datos

Utiliza la herramienta Google Rich Results Test para comprobar que los datos estructurados son correctos y se detectan correctamente.