Open Graph

Open Graph is a vocabulary used for the semantic markup of web data. It lets you control the preview that is generated when publishing links on social networks and transmit information to other internet services. For more details, see the official website.

Note. Data with markup is public and any service can extract and use it.
Attention. If you embed micro markup using a plugin, you'll probably need to modify it. To do this, contact the plugin developer or another professional with development skills.
  1. Markup principles
  2. Types of content that can have markup
  3. How to mark up content
  4. Markup example

Markup principles

Data about an object in Open Graph is described by sets of property-value pairs in meta tags. The property must be specified in property and its value in content. For example, you can specify that the type of object being described is an article:

<meta property="og:type" content="article">

The standard requires that Open Graph data be located in the head tag. However, to collect content statistics, we recommend placing meta tags on the node where the content is embedded, especially when there are multiple content items on the page. This is necessary for accurately calculating full scroll and full read metrics.

Types of content that can have markup

Yandex Metrica only supports Article markup. Other types of content will not be included in Yandex Metrica reports even with the correct markup.

How to mark up content

Mark up the following content elements (required elements are marked with an asterisk):

Headline*
The headline is shown in Yandex Metrica reports. It is specified in the og:title property.
<meta property="og:title" content="В Москве побит температурный рекорд 1922 года">
Text*

The text is the content of the node that contains the described material. If the markup is in the head tag, the text will be the entire contents of the body tag. Tag symbols are not taken into account. The text defines the number of characters. This is necessary for determining the volume of material and calculate scroll depth and read depth metrics.

Note. You can get complete statistics for content with text longer than 500 characters.
Author

The author is specified using the article:author property. If there are multiple authors, list them in different meta tags.

<meta property="article:author" content="Иван Иванов">
<meta property="article:author" content="Петр Петров">

With this data, you can view statistics for individual authors.

Topic

You can mark up keywords and hashtags as topics. Specify the topics in the article:tag property. If there are multiple topics, list them in different meta tags.

<meta property="article:tag" content="Жара">
<meta property="article:tag" content="Москва">
Dates of publication and revisions

Publication dates and changes are specified in the article:published_time and article:modified_time properties. Dates are written in ISO 8601 format.

<meta property="article:modified_time" content="2018-12-11T08:56:49Z">
<meta property="article:published_time" content="2018-11-06T09:26:10+04:00">
Rubric

A category is a section of a website dedicated to a specific topic. To specify a material category, use the property article:section.

<meta property="article:section" content="Погода">
Content URL

The content URL must be contained in the property og:url.

<meta property="og:url" content="https://www.example-news.com/life/weather/moscow"/>

Otherwise, the value will be taken from the canonical link:

<link rel="canonical" href="https://www.example-news.com/life/weather/moscow">

If the markup is correct and the tag is properly enabled, statistics on the content will soon start to be collected in Yandex Metrica.

Markup example

<html prefix="og:http://ogp.me/ns# article:http://ogp.me/ns/article#">
  <head>
    <title>В Москве побит температурный рекорд 1922 года</title>
    <meta property="og:type" content="article"/>
    <meta property="og:title" content="В Москве побит температурный рекорд 1922 года"/>
    <meta property="og:url" content="https://www.example-news.com/life/weather/moscow#cao"/>
    <meta property="article:section" content="Погода">
    <meta property="article:modified_time" content="2018-12-11T08:56:49Z">
    <meta property="article:published_time" content="2018-11-06T09:26:10+04:00">   
    <meta property="article:author" content="Иван Иванов">
    <meta property="article:author" content="Петр Петров">
    <meta property="article:tag" content="Жара">
    <meta property="article:tag" content="Москва">
    ...
  </head>  
 <body>
   <div>
     В среду, 6 ноября, в Москве был побит температурный рекорд, 
      зафиксированный в 1922 году. Температура воздуха составила плюс 12,1 градуса 
      по Цельсию, как сообщает центр «Фобос».
   </div>
   ...
 </body>
</html>