Microdata
Microdata es un método de marcado con datos renderizados como elementos HTML estándar.
Alerta
Si inserta micro marcado usando un plugin, probablemente necesitará modificarlo. Para hacer esto, contacte al desarrollador del plugin u otro profesional con habilidades de desarrollo.
Principios de marcado
Para revisar su contenido, agregue el atributo itemscope
a cualquier etiqueta que contenga la entidad que se está describiendo. Para indicar de qué tipo de elemento se trata, utilice el atributo itemtype
después del itemscope
y ajústelo a la clase adecuada en el formato itemtype=“http://schema.org/<Nombre de clase>”
. Las entidades también pueden estar anidadas entre sí. Por ejemplo, puede especificar que el contenido de una etiqueta div
describe un artículo de noticias (la clase NewsArticle
), mientras que el de una etiqueta p
describe a una persona (la clase Person
):
<div itemscope itemtype="http://schema.org/NewsArticle">
<h1>Moscú rompe el récord de temperatura de 1922</h1>
<p itemscope itemtype="http://schema.org/Person">
Autor: <span>John Smith</span> — <span>corresponsal especial</span></p>
<p>El miércoles 6 de noviembre, Moscú batió el récord de temperatura
registrado en 1922. La temperatura del aire fue de más 12.1 grados centígrados,
según el centro Fobos.</p>
</div>
Para especificar las propiedades de un elemento, use el atributo itemprop
. Puede encontrar la lista de propiedades disponibles en la descripción de la clase correspondiente en el sitio web del estándar. En el ejemplo a continuación, se utilizan las propiedades de NewsArticle
para revisar elementos que describen el título del artículo, su autor y texto, y las propiedades de Person
se utilizan para revisar elementos como el nombre y la posición del autor:
<div itemscope itemtype="http://schema.org/NewsArticle">
<h1 itemprop="headline">Moscú rompe el récord de temperatura de 1922 </h1>
<p itemprop="author" itemscope itemtype="http://schema.org/Person">
Autor: <span itemprop="name">John Smith</span> —
<span itemprop="jobTitle">corresponsal especial</span> </p>
<p itemprop="articleBody">El miércoles 6 de noviembre, Moscú batió el récord de temperatura
registrada en 1922. La temperatura del aire fue de más 12.1 grados centígrados,
según el centro Fobos.</p>
</div>
Información legible por máquina
Al agregar revisión a sus materiales, puede usar no solo elementos de Schema.org sino también información comprensible por máquina. Esta información no está disponible para los lectores, pero puede ser procesada por navegadores, motores de búsqueda y robots.
La etiqueta meta
-
A veces, la información importante no se puede revisar debido a la forma en que aparece en la página. Por ejemplo, cuando la información se transmite en una imagen o un objeto Flash o cuando no se declara explícitamente en la página. En tales casos, puede usar la etiqueta
meta
con el atributocontent
. En el ejemplo a continuación, se utilizan la etiquetameta
y las propiedades de la claseArticle
para indicar el tema de los materiales:<meta itemprop="about" content="Clima">
Esta técnica debe usarse con moderación. Solo use la etiqueta
meta
con el atributocontent
para información que no se puede revisar de otra manera.Alerta
En elementos con revisión, Yandex. Metrica primero busca el valor en el atributo
content
y luego en el contenido de la etiqueta.
Fecha y hora
-
Puede usar el atributo
datetime
de la etiquetatime
para registrar el tiempo. Las fechas se escriben en el formato ISO 8601. El ejemplo a continuación muestra la fecha de10:30, 6 de noviembre de 2018
, que se pasa como2018-12-11T07:30:00Z
a un robot.<time itemprop="datePublished" datetime="2018-12-11T07:30:00Z"> 10:30, 6 de noviembre de 2018</time>
¿Qué contenido puedo marcar?
Yandex Metrica admite la revisión para el siguiente contenido:
- Artículo, noticia o publicación de blog (
Article
,NewsArticle
, oBlogPosting
) - Descripción de película (
Movie
) - Reseña o comentario (
Review
) Recipe
Pregunta
Otros tipos de contenido no se incluirán en los informes de Yandex Metrica incluso con el marcado correcto.
Cómo marcar materiales
Al revisar materiales, puede usar tanto entidades de Schema.org como datos legibles por máquina descritos anteriormente.
Agregue revisión a su contenido siguiendo las reglas a continuación para asegurarse de que sea procesado correctamente por Yandex Metrica. Para acceder a estadísticas más completas, recomendamos marcar todos los elementos de contenido (aunque solo se requieren tres: identificador, título y texto). Si ya utiliza Schema.org, compruebe si el marcado en su sitio web cumple estos requisitos. Los ejemplos de código en los términos no son la única opción de revisión correcta.
El marcado puede agregarse al sitio automáticamente — por ejemplo, con complementos de WordPress. Antes de usar el complemento seleccionado, asegúrese de que le permita pasar todos los elementos de marcado necesarios al código de la página.
No recomendamos usar sistemas de gestión de etiquetas para marcar su contenido porque Yandex Metrica no podrá procesar correctamente los datos revisados. Sin embargo, dichos sistemas se pueden usar para otros propósitos, como instalar una etiqueta en un sitio.
Alerta
Todos los elementos de Schema.org con marcado deben estar dentro de la etiqueta body
. Si hay varias unidades de contenido en la página, cada una de ellas debe marcarse por separado. Es importante cumplir con estos requisitos para que las estadísticas se recopilen correctamente.
Seleccione el tipo de materiales:
Para marcar artículos, noticias o publicaciones, use cualquiera de las entidades: Article
, NewsArticle
o BlogPosting
. Marque los siguientes elementos de contenido (los elementos obligatorios están marcados con un asterisco):
ID*
-
El ID se especifica usando la propiedad
identifier
. Permite a Yandex Metrica distinguir entre diferentes contenidos. El ID no se muestra en los informes.<meta itemprop="identifier" content="12345">
También puede especificar el ID usando la propiedad
mainEntityOfPage
. Se usa si no se encuentra la propiedadidentifier
. Yandex.Metrica la busca para el valor del atributoitemid
que se usará como ID.<meta itemscope itemprop="mainEntityOfPage" itemType="https://schema.org/WebPage" itemid="/life/weather/12345.html"/>
Si no se encuentran las propiedades anteriores, se utiliza el encabezado de nivel superior de las etiquetas
<h1>...<h6>
o el valor del atributohref
de la referencia canónica como ID.
Si se marcan múltiples IDs, se usará el primer valor encontrado.
Título*
-
Puede especificar el encabezado usando la propiedad
headline
oalternativeHeadline
. El encabezado aparecerá en los informes de Yandex Metrica. Si se configuran ambas propiedades, sus valores se escriben con un espacio. Por ejemplo, si los títulos están marcados de esta manera:<h1 itemprop="headline">Moscú rompe el récord de temperatura de 1922</h1> <h2 itemprop="alternativeHeadline"> La temperatura en noviembre supera los 12 °C</h2>
En el informe, el artículo se llama “Moscú rompe el récord de temperatura de 1922. La temperatura en noviembre supera los 12 °C”.
Si no se encuentra ninguna de las propiedades anteriores, se utiliza el valor de la propiedad
name
como título.
Texto*
-
El texto de un artículo debe estar contenido en la etiqueta con la propiedad
articleBody
.Se determina el número de caracteres en el texto. Esto es necesario para determinar el volumen del material. Solo el contenido de las etiquetas anidadas se considera texto. Los caracteres en las etiquetas reales no se tienen en cuenta. Recomendamos que marque el texto de los materiales para que no incluya lo que es innecesario: banners publicitarios, bloques de comentarios, etc., de lo contrario, el volumen de materiales e indicadores de estadísticas pueden calcularse incorrectamente.
<p itemprop="articleBody"> El miércoles 6 de noviembre, Moscú batió el récord de temperatura
Cómo se calculan las métricas de desplazamiento completo y lectura completa
Los desplazamientos completos se calculan en función de las entidades principales. El cálculo tiene en cuenta todo el contenido de la etiqueta en la que se describen. Por ejemplo, si el texto del artículo está en una etiqueta con la entidad Article
, entonces el cálculo se basará en todo el contenido hasta el cierre de esta etiqueta.
El cálculo de lecturas completas tiene en cuenta el número de caracteres, por lo que esta métrica se puede calcular en función de la propiedad articleBody
.
Ejemplo de marcado
A continuación puede ver un ejemplo del marcado de un artículo.
<!DOCTYPE html>
<html>
<head></head>
<body>
<article>
<h1>Moscú rompe el récord de temperatura de 1922</h1>
<div> La temperatura en noviembre supera los 12 °C</div>
<span><a href="/example-news/authors/john_smith.html">John Smith</a></span>
<time datetime="2018-11-06T09:25:10+04:00">06.11.2018, 09:25</time>
<meta content="2018-11-06T09:25:10+04:00"/>
<div>
El miércoles 6 de noviembre, Moscú batió el récord de temperatura
registrada en 1922. La temperatura del aire fue de más 12.1 grados centígrados,,
según el centro Fobos.
</div>
</article>
</body>
</html>
Ejemplo de marcado de página con múltiples artículos:
<!DOCTYPE html>
<html>
<head>
<link rel="[canonical](*canonical)"
href="https://www.noticias-ejemplo.com/life/weather/2018/11/06/123.html" />
</head>
<body>
<div itemscope itemtype="http://schema.org/NewsArticle">
<meta itemprop="identifier" content="12345">
<meta itemprop="[datePublished](*datePublished)" content="2024-07-25T08:56:49Z" />
<h1 itemprop="[headline](*headline)">Moscú rompe el récord de temperatura de 1922</h1>
<div itemprop="about">Clima</div>
<ol itemscope itemtype="http://schema.org/BreadcrumbList">
<li itemprop="[itemListElement](*itemListElement)" itemscope
itemtype="http://schema.org/ListItem">
<a itemprop="item" href="//noticias-ejemplo.ru/life">
<span itemprop="name">Clima</span></a>
<meta itemprop="position" content="1" />
</li>
<li itemprop="[itemListElement](*itemListElement)" itemscope
itemtype="http://schema.org/ListItem">
<a itemprop="item" href="//noticias-ejemplo.ru/life/weather">
<span itemprop="name">Clima</span></a>
<meta itemprop="position" content="2" />
</li>
</ol>
<p itemprop="articleBody">El miércoles 6 de noviembre, Moscú batió el récord de temperatura
registrada en 1922. La temperatura del aire fue de más 12.1 grados centígrados,
según el centro Fobos
</p>
<div itemprop="[author](*author)" itemscope itemtype="http://schema.org/Person">
<span itemprop="name">John Smith</span>
</div>
<a itemprop="url" href="https://test_one.ru"> Primer artículo</a>
</div>
<div itemscope itemtype="http://schema.org/NewsArticle">
<meta itemprop="identifier" content="54321">
<meta itemprop="[datePublished](*datePublished)" content="2024-07-25T08:56:49Z" />
<ol itemscope itemtype="http://schema.org/BreadcrumbList">
<li itemprop="[itemListElement](*itemListElement)" itemscope
itemtype="http://schema.org/ListItem">
<a itemprop="item" href="//example-news.ru/life">
<span itemprop="name">Clima</span></a>
<meta itemprop="position" content="1" />
</li>
<li itemprop="[itemListElement](*itemListElement)" itemscope
itemtype="http://schema.org/ListItem">
<a itemprop="item" href="//example-news.ru/life/weather">
<span itemprop="name">Clima</span></a>
<meta itemprop="position" content="2" />
</li>
</ol>
<div itemprop="about">Segundo artículo</div>
<h1 itemprop="[headline](*headline)">Moscú rompe el récord de temperatura de 1923</h1>
<p itemprop="articleBody">El miércoles 6 de noviembre, Moscú batió el récord de temperatura
registrada en 1923. La temperatura del aire fue de más 13.1 grados centígrados,
según el centro Fobos.
</p>
<div itemprop="[author](*author)" itemscope itemtype="http://schema.org/Person">
<meta itemprop="name">Van Vanov
</div>
<a itemprop="url" href="https://test_two.ru"> Segundo artículo</a>
</div>
</body>
</html>
<!DOCTYPE html>
<html>
<head>
<link rel="[canonical](*canonical)"
href="https://www.ejemplo-noticias.com/life/weather/2018/11/06/123.html" />
</head>
<body>
<ol itemscope itemtype="http://schema.org/BreadcrumbList">
<a href="/"></a>
<li><a href="/politics/">Politics</a></li>
<li><a href="/business/">Negocios</a></li>
<li><a href="/social/">Social</a></li>
<li itemprop="[itemListElement](*itemListElement)" itemscope itemtype="http://schema.org/ListItem">
<a itemprop="item" href="/life/">
<span itemprop="name">Vida</span></a>
<meta itemprop="position" content="1" />
</li>
<li itemprop="[itemListElement](*itemListElement)" itemscope itemtype="http://schema.org/ListItem">
<a itemprop="item" href="/life/weather">
<span itemprop="name">Clima</span></a>
<meta itemprop="position" content="2" />
</li>
<li><a href="/life/psychology/">Psicología</a></li>
<li><a href="/life/cooking/">Cocina</a></li>
</ol>
<article itemscope itemtype="http://schema.org/NewsArticle">
<meta itemprop="about" content="Heat"/>
<meta itemprop="about" content="Anomalías climáticas"/>
<h1 itemprop="[headline](*headline)">Moscú rompe el récord de temperatura de 1922</h1>
<div itemprop="[alternativeHeadline](*alternativeHeadline)"> La temperatura en noviembre supera los 12 °C</div>
<span itemprop="[author](*author)" itemscope itemtype="http://schema.org/Person">
<span itemprop="name">John Smith</span>
</span>
<time itemprop="[datePublished](*datePublished)" datetime="2018-11-06T09:25:10+04:00">06.11.2018, 09:25</time>
<meta itemprop="dateModified" content="2018-11-06T09:26:10+04:00" />
<meta itemscope itemprop="mainEntityOfPage" itemType="https://schema.org/WebPage"
itemid="/weather/november-heat.html"/>
<div itemprop="articleBody">
El miércoles 6 de noviembre, Moscú batió el récord de temperatura
registrado en 1922. La temperatura del aire fue de más 12.1 grados centígrados,
según el centro Fobos.
</div>
</article>
</body>
</html>
Ejemplo de marcado de página con múltiples artículos:
<!DOCTYPE html>
<html>
<head>
<link rel="[canonical](*canonical)"
href="https://www.noticias-ejemplo.com/life/weather/2018/11/06/123.html" />
</head>
<body>
<div itemscope itemtype="http://schema.org/NewsArticle">
<meta itemprop="identifier" content="12345">
<meta itemprop="[datePublished](*datePublished)" content="2024-07-25T08:56:49Z" />
<h1 itemprop="[headline](*headline)">Moscú rompe el récord de temperatura de 1923</h1>
<div itemprop="about">Clima</div>
<ol itemscope itemtype="http://schema.org/BreadcrumbList">
<li itemprop="[itemListElement](*itemListElement)" itemscope
itemtype="http://schema.org/ListItem">
<a itemprop="item" href="//noticias-ejemplo.ru/life">
<span itemprop="name">Clima</span></a>
<meta itemprop="position" content="1" />
</li>
<li itemprop="[itemListElement](*itemListElement)" itemscope
itemtype="http://schema.org/ListItem">
<a itemprop="item" href="//noticias-ejemplo.ru/life/weather">
<span itemprop="name">Clima</span></a>
<meta itemprop="position" content="2" />
</li>
</ol>
<p itemprop="articleBody">El miércoles 6 de noviembre, Moscú batió el récord de temperatura
registrado en 1922. La temperatura del aire fue de más 12.1 grados centígrados,
según el centro Fobos
</p>
<div itemprop="[author](*author)" itemscope itemtype="http://schema.org/Person">
<span itemprop="name">John Smith</span>
</div>
<a itemprop="url" href="https://test_one.ru"> Primer artículo</a>
</div>
<div itemscope itemtype="http://schema.org/NewsArticle">
<meta itemprop="identifier" content="54321">
<meta itemprop="[datePublished](*datePublished)" content="2024-07-25T08:56:49Z" />
<ol itemscope itemtype="http://schema.org/BreadcrumbList">
<li itemprop="[itemListElement](*itemListElement)" itemscope
itemtype="http://schema.org/ListItem">
<a itemprop="item" href="//example-news.ru/life">
<span itemprop="name">Clima</span></a>
<meta itemprop="position" content="1" />
</li>
<li itemprop="[itemListElement](*itemListElement)" itemscope
itemtype="http://schema.org/ListItem">
<a itemprop="item" href="//example-news.ru/life/weather">
<span itemprop="name">Clima</span></a>
<meta itemprop="position" content="2" />
</li>
</ol>
<div itemprop="about">Segundo artículo</div>
<h1 itemprop="[headline](*headline)">Moscú rompe el récord de temperatura de 1923</h1>
<p itemprop="articleBody">El miércoles 6 de noviembre, Moscú batió el récord de temperatura
registrada en 1923. La temperatura del aire fue de más 13.1 grados centígrados,
según el centro Fobos.
</p>
<div itemprop="[author](*author)" itemscope itemtype="http://schema.org/Person">
<meta itemprop="name">Van Vanov
</div>
<a itemprop="url" href="https://test_two.ru"> Segundo artículo</a>
</div>
</body>
</html>
Especificidades de la carga de contenido de la página
Si los materiales contienen múltiples imágenes o escritura compleja que se ejecutan, a menudo se utiliza la “carga diferida”, es decir, los datos se cargan de forma asincrónica en la página. Recomendamos transmitir los datos con marcado mientras se abre contenido. Esto asegurará que todos los valores se reciban y procesen correctamente.
Más información
Enlaces útiles |
Capacitación en línea |
Descripción de la propiedad
ID
El ID permite a Yandex Metrica distinguir entre diferentes contenidos. El ID no se muestra en los informes.
<meta itemprop="identifier" content="12345">
Descripción de la propiedad
Título
Puede especificar el encabezado usando la propiedad headline
o alternativeHeadline
. El encabezado aparecerá en los informes de Yandex Metrica. Si se configuran ambas propiedades, sus valores se escriben con un espacio. Por ejemplo, si los títulos están marcados de esta manera:
<h1 itemprop="headline">Moscú rompe el récord de temperatura de 1922</h1>
<h2 itemprop="alternativeHeadline">La temperatura en noviembre supera los 12 °C</h2>
En el informe, el artículo se llama “Moscú rompe el récord de temperatura de 1922. La temperatura en noviembre supera los 12 °C”.
Si no se encuentra ninguna de las propiedades anteriores, se utiliza el valor de la propiedad name
como título.
Descripción de la propiedad
Título
Puede especificar el encabezado usando la propiedad headline
o alternativeHeadline
. El encabezado aparecerá en los informes de Yandex Metrica. Si se configuran ambas propiedades, sus valores se escriben con un espacio. Por ejemplo, si los títulos están marcados de esta manera:
<h1 itemprop="headline">Moscú rompe el récord de temperatura de 1922</h1>
<h2 itemprop="alternativeHeadline">La temperatura en noviembre supera los 12 °C</h2>
En el informe, el artículo se llama “Moscú rompe el récord de temperatura de 1922. La temperatura en noviembre supera los 12 °C”.
Si no se encuentra ninguna de las propiedades anteriores, se utiliza el valor de la propiedad name
como título.
Descripción de la propiedad
Fecha de publicación
Las fechas de publicación datePublished
y revisión dateModified
están escritas en formato ISO 8601.
html <meta itemprop="datePublished” content="2018-12-11T08:56:49Z” />
o en el atributo datetime
de la etiqueta time
<time itemprop="dateModified" datetime="2018-12-11T07:30:00Z">07:30, 11 de diciembre de 2018</time>
Descripción de la propiedad
Fecha de cambio
Las fechas de publicación datePublished
y revisión dateModified
están escritas en formato ISO 8601.
html <meta itemprop="datePublished” content="2018-12-11T08:56:49Z” />
o en el atributo datetime
de la etiqueta time
<time itemprop="dateModified" datetime="2018-12-11T07:30:00Z">07:30, 11 de diciembre de 2018</time>
Descripción de la propiedad
Categoría
Un encabezado es una sección de un sitio web dedicada a un tema específico. Para marcar una categoría, use la clase BreadcrumbList
. Describe una cadena de páginas web enlazadas (“migas de pan”), que generalmente termina con el contenido actual. Dentro de la BreadcrumbList
, defina múltiples elementos del tipo ListItem
, que se marcan con la propiedad itemListElement
y describen los encabezados actuales y más amplios.
La anidación de categorías se establece utilizando la propiedad position
de la clase ListItem
. Por ejemplo, la categoría “Vida” puede contener categorías anidadas como “Clima” e “Incidentes”. Si position = '1'
, los materiales están en el nivel superior (“Vida”), si position = '2'
: están en el segundo nivel (“Clima”).
El encabezado de los materiales será el valor de la propiedad name
de la entidad ListItem
con el valor de position
más grande.
Nota
En este momento, las estadísticas muestran dos niveles de anidamiento de categorías.
<ol itemscope itemtype="http://schema.org/BreadcrumbList">
<li itemprop="itemListElement" itemscope
itemtype="http://schema.org/ListItem">
<a itemprop="item" href="//example-news.ru/life">
<span itemprop="name">Vida</span></a>
<meta itemprop="position" content="1" />
</li>
<li itemprop="itemListElement" itemscope
itemtype="http://schema.org/ListItem">
<a itemprop="item" href="//example-news.ru/life/weather">
<span itemprop="name">Clima</span></a>
<meta itemprop="position" content="2" />
</li>
</ol>
Descripción de la propiedad
Autor
Para especificar el autor, nosotros usamos la propiedad author
. Si hay varios autores, debe especificarlos en diferentes etiquetas.
html <div itemprop="author">John Smith</div>
El valor también puede tomarse de:
-
La propiedad
nombre
de la clasePersona
.<div itemprop="author" itemscope itemtype="http://schema.org/Person"> <span itemprop="name">Juan Luna</span> </div>
-
El atributo del enlace
href
.<link itemprop='author' href="/example/authors/juan_luna.html"/>
Con estos datos, puede ver las estadísticas de los autores individuales en Yandex Metrica.
Descripción de la propiedad
Tema
Puede marcar palabras clave o hashtags como temas. Para hacerlo, defina la propiedad información
para cada tema. Puede utilizar el valor de la propiedad name
de cualquier clase:
<div itemprop="about">Calor</div>
<div itemprop="about" itemscope itemtype="https://schema.org/Thing">
<span itemprop="name">Moscú</span>
</div>
Descripción de la propiedad
Referencia canónica
La URL del contenido se especifica usando la propiedad url
.
<a itemprop="url" href="https://www.noticias-ejemplo.com/vida/clima/moscu">noticias-ejemplo.com</a>
Si no se encuentra la propiedad url
, el sistema busca un enlace canónico. Este enlace se utiliza para indicar el contenido principal si la página actual duplica una página del sitio. Los enlaces canónicos están marcados con un atributo especial rel="canonical"
. Por ejemplo, si el contenido es un duplicado de la página http://www.ejemplo-noticias.com/pagina
, contiene <link rel="canonical" href="http://www.ejemplo-noticias.com/pagina"/>
. El valor del atributo href
del enlace canónico se utiliza como la URL del material.
El valor encontrado puede usarse cuando se genera la ID de contenido.
Descripción de la propiedad
ID
Esta propiedad se usa si no se encuentra la propiedad identifier
. Yandex.Metrica la busca para el valor del atributo itemid
que se usará como ID.
<meta itemscope itemprop="mainEntityOfPage"
itemType="https://schema.org/WebPage" itemid="/life/weather/12345.html"/>
Descripción de la propiedad
Texto del artículo
Se determina el número de caracteres en el texto. Esto es necesario para determinar el volumen del material. Solo el contenido de las etiquetas anidadas se considera texto. Los caracteres en las etiquetas reales no se tienen en cuenta. Recomendamos que marque el texto de los materiales para que no incluya lo que es innecesario: banners publicitarios, bloques de comentarios, etc., de lo contrario, el volumen de materiales e indicadores de estadísticas pueden calcularse incorrectamente.
<p itemprop="articleBody">
El miércoles 6 de noviembre, Moscú batió el récord de temperatura registrado en 1922. La temperatura del aire fue de más 12.1 grados centígrados, según el centro Fobos.
</p>
Si no se encuentra la propiedad articleBody
, se utilizan los valores de la propiedad description
o text
como el texto.
Si no se encuentra ninguna de las propiedades, se utiliza el contenido de la etiqueta marcada Article
o NewsArticle
, sin los caracteres de la etiqueta, como el texto.
Nota
Puede obtener estadísticas completas para contenido con texto de más de 500 caracteres.