JSON-LD

JSON-LD es un método de revisión que representa datos utilizando los objetos de Datos Enlazados (LD).

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

Los datos en el formato JSON-LD se describen con una serie de pares de valores de claves separados por comas. El formato incluye clases reservadas para definir el contexto de descripción o vincular los objetos de distintas maneras. Por ejemplo, @context define el vocabulario del objeto (en este caso — Schema.org), mientras que @type define el tipo de la entidad descrita. Para acceder a la lista completa de listas reservadas, consulte la documentación de JSON-LD.
La entidad se describe entre llaves { } dentro de la etiqueta <script> con el atributo type="application/ld+json" o type="ld+json". Indique que se utiliza el vocabulario de Schema.org para el marcado — "@context":"http://schema.org". Use la clave @type para especificar la clase de Schema.org que define la entidad descrita. Marque las propiedades de la entidad: use las propiedades de la clase Schema.org especificada como claves.
Para marcar múltiples entidades en una página, puede usar:

Grafo (@graph)

Para cada nodo del grafo, especifique @id — un enlace a la sección de la página que contiene la entidad descrita.

El ejemplo a continuación describe dos artículos de noticias "@type":"Artículo de noticias". El identificador del artículo ( @id clave), fecha de publicación (datePublished clave), y los autores del artículo (author clave) se especifican como un arreglo de dos elementos. Para describir autores, usamos entidades anidadas de la clase Person.

<script type="application/ld+json">

Más información sobre JSON-LD.

¿Qué contenido puedo marcar?

Yandex Metrica admite la revisión para el siguiente contenido:

Artículo, artículo de noticias o publicación de blog (Article, NewsArticle o BlogPosting)
Descripción de película (Movie)
Reseña o comentario (Review)
Recipe
Preguntas y respuestas (Question o QAPage)

Otros tipos de contenido no se incluirán en los informes de Yandex Metrica incluso con el marcado correcto.

Cómo marcar materiales

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 JSON-LD, 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.

Alerta

Si hay varias unidades de contenido en una sola página, marque cada una por separado para que las estadísticas se recopilen correctamente.

Marque los siguientes elementos de contenido (los elementos obligatorios están marcados con un asterisco):

ID*

El identificador se especifica usando la clave reservada @id. Permite a Yandex Metrica distinguir entre diferentes contenidos. El ID no se muestra en los informes. Algunos ejemplos de identificadores son un enlace de contenido o un valor único arbitrario.

"@id": "https://www.noticias-ejemplo.com/life/weather/moscow#сao"

Si no se encuentra la clave @id, el sistema intenta encontrarla en las entidades anidadas dentro de las claves mainEntity o mainEntityOfPage.

<script type="application/ld+json">
  {  
    "@context": "http://schema.org",  
    "@type": "NewsArticle",  
    "mainEntityOfPage": {
           "@type": "WebPage",
           "@id": "https://www.noticias-ejemplo.com/life/weather/moscow#сao"
        }
  }
  </script>

@id se puede usar para calcular desplazamientos completos y lecturas completas. Si se usa como un ID:

Se especifica la URL del artículo, Yandex.Metrica detecta el fragmento después del # (#fragment). Luego Yandex.Metrica busca el elemento HTML en el artículo que contiene este fragmento (id="fragment" attribute). Si se encuentra el fragmento, se calculan los indicadores. La URL del artículo también se procesa.
Si se elige un valor aleatorio y head contiene un código JSON-LD, entonces los indicadores se calculan de acuerdo con el contenido del body. Si el código body está ubicado dentro de otro elemento HTML, entonces se usa el elemento primario para la revisión en los cálculos. Por eso, los datos en el informe pueden no ser completamente precisos. Los cálculos también se realizan de esta manera si la URL del artículo termina con un # y no le siguen fragmentos.

Título*

El titular se muestra en los informes de Yandex Metrica. Se puede especificar en las claves headline o alternativeHeadline. Si se encuentran ambas claves, sus valores se separan con un espacio. Por ejemplo, si los títulos están marcados de esta manera:

"headline": "Moscú rompe el récord de temperatura de 1922",
"alternativeHeadline":  "La temperatura en noviembre supera los 12 °C"

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 encuentran las claves anteriores, se utiliza el valor de la clave name o itemReviewed como el titular (para la clase Review).

Texto*

El texto debe estar contenido en la clave text. El texto define la cantidad de caracteres. Esto es necesario para determinar el volumen de materiales y calcular las métricas de profundidad de desplazamiento y profundidad de lectura.

"text": "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".
```

Si no se encuentra la clave `text`, se toma el siguiente contenido como texto:
- Contenidos del elemento anclado del valor de la clave `url` o `@id`.
    
    ```json
    "@context": "https://schema.org",
    "@type": "Article",
    "url": "https://www.example-news.com/life/weather/moscow#cao"
    ```
    
- Contenido del nodo que incrusta la entidad descrita (si es algo distinto de `<head>`).
    
- Contenido de la página `<body>` en todos los demás casos.

Al calcular el tamaño del texto, se ignoran los caracteres de la etiqueta.

{% note info %}

Puede obtener estadísticas completas para contenido con texto de más de 500 caracteres.

{% endnote %}

Autor

El autor se especifica usando la clave author. Si hay varios autores, enumérelos en la matriz.

 "author": [
{"@type": "Person", "name": "John Smith"}, 
{"@type": "Person", "name": "Dylan Brown"}
  ]

Si no se encontró la clave, el sistema intentará encontrarla en las entidades anidadas en de las claves mainEntity o mainEntityOfPage.

<script type="application/ld+json">
{  
  "@context": "http://schema.org",  
  "@type": "NewsArticle", 
  "@id": "12345", 
  "mainEntityOfPage": {
         "@type": "WebPage",
         "author": {"@type": "Person", "name": "John Smith"} 
      }
}
</script>

Con estos datos, puede ver las estadísticas de los autores individuales.

Tema

Puede marcar palabras clave o hashtags como temas. Especifique los temas en la clave about:

"about": [
    {"@type": "Event", "name": "Calor"},
    {"@type": "Event", "name": "Moscú"}
]

El tipo (@type) es opcional o especifique cualquier tipo que sea compatible con el estándar.

Si no se encuentra la clave name, el sistema intentará encontrar los valores en la clave alternateName.

Fechas de publicación y revisión

Las fechas de publicación y modificación se indican en las claves datePublished y dateModified. Las fechas se escriben en el formato ISO 8601.

"datePublished": "2018-12-11T08:56:49Z",
"dateModified": "2018-11-06T09:26:10+04:00"

Categoría

Un encabezado es una sección de un sitio web dedicada a un tema específico. Para revisar una categoría, use la clave BreadcrumbList. Describe una cadena de páginas web enlazadas (“migas de pan”), que generalmente termina con el contenido actual. Dentro de BreadcrumbList, en la clave itemListElement, se deben definir varias entidades de tipo ListItem que describen la categoría actual y las más amplias.

La anidación de categorías se puede definir mediante la clave position. Por ejemplo, la categoría “Vida” puede contener categorías anidadas como “Clima” e “Incidentes”. Si "position":"1", el contenido está en el nivel superior (“Vida”), si “position":"2", está en el segundo nivel (“Clima”).

La categoría de contenido es el valor de la clave name con el valor de position más alto.

Nota

En este momento, las estadísticas muestran dos niveles de anidamiento de categorías.

{
  "@context": "http://schema.org",
  "@type": "BreadcrumbList",
  "itemListElement": [
    {
      "@type": "ListItem",
      "position": 1,
      "item":{
          "@id": "//example-news.ru/life",
          "name": "Life"}
    },{
      "@type": "ListItem",
      "position": 2,
      "item":{
          "@id": "//example-news.ru/life/weather",
          "name": "Weather"}
    }]
}

URL del contenido

La URL del contenido debe incluirse en la clave url. Recomendamos insertar un fragmento de URL después de un #. Los indicadores se calcularán en función del contenido al que apunta el fragmento de URL. Más información

"url": "https://www.noticias-ejemplo.com/life/weather/moscow#сao"

Si la revisión es correcta y la etiqueta está habilitada correctamente, pronto comenzarán a recopilarse estadísticas sobre el contenido en Yandex Metrica.

Ejemplo de marcado

A continuación, puede ver un ejemplo de revisión de noticias.

<script type="application/ld+json">
{
   "@context": "http://schema.org",
   "@graph": [
       {
         "@type":"BreadcrumbList",
         "itemListElement": [
             {
               "@type": "ListItem",
               "position": 1,
               "item": {
                 "@id": "//example-news.ru/life",
                 "name": "Life"
                }
              },
              {
                 "@type": "ListItem",
                 "position": 2,
                 "item": {
                     "@id": "//example-news.ru/life/weather",
                     "name": "Weather"
                 }
               }
            ]
        },
        {
          "@type": "NewsArticle",
          "@[id](*identifier)": "https://www.example-news.com/life/weather/moscow#cao",
          "[headline](*headline)": "Moscú rompe el récord de temperatura de 1922",
          "[alternativeHeadline](*alternativeHeadline)": "La temperatura en noviembre supera los 12 °C",
          "[datePublished](*datePublished)": "2018-12-11T08:56:49Z",
          "dateModified": "2018-11-06T09:26:10+04:00",
          "[text](*itemListElement)": "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.",
          "[author](*author)": [
              {"@type": "Person", "name": "John Smith"}, 
              {"@type": "Person", "name": "Dylan Brown"}
           ],
          "about": {
              "@type": "Event",
              "name": "Moscow"
          },
          "[url](*canonical)": "https://www.example-news.com/life/weather/moscow#cao"
        }
    ]
}
</script>

Más información

Informes de contenido

Chatee con nosotros

Escriba un correo electrónico

Tome en cuenta: Nuestro equipo de soporte nunca iniciará llamadas hacia usted. No siga las instrucciones de personas que le llamen y se presenten como el equipo de soporte de Yandex Metrica.

Enlaces útiles

Capacitación en línea

Obtener un certificado de Yandex Metrica

itemprop

Descripción de la propiedad

Las clases Article y NewsArticle

identificador del tipo ValorDePropiedad o Texto o URL

El ID permite a Yandex Metrica distinguir entre diferentes contenidos. El ID no se muestra en los informes.

<meta itemprop="identifier" content="12345">

mainEntityOfPage de la URL tipo,

CreativeWork

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"/>

titulo

tipo: Texto

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.

títuloAlternativo

tipo: Texto

Título

<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.

cuerpoArticulo

tipo: Texto

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.

autor

tipo: Texto,

o Persona,

u Organización

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 clase Persona.

<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.

acerca de

tipo: Cosa

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>

fechaDePublicación

tipo: Fecha

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>

fechaModificada del tipo Fecha

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>

Clase ListaDeMigasDePan

elementoDeLista

tipo: ElementoDeLista,

o Texto,

o Cosa

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>

Otro

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

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

<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

<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

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 clase Persona.

<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>

El valor encontrado puede usarse cuando se genera la ID de contenido.

¿Ha sido útil el artículo?

Microdata

Open Graph