Документация

Начало работы

Чтобы начать работу с JS API, подключите библиотеку WidgetApi.js в теле виджета. Библиотека доступна по адресу:

http://img.yandex.net/webwidgets/{version}/WidgetApi.js

Вместо {version} нужно указать необходимую версию JS API.

Совет. 

Рекомендуется подключать библиотеку WidgetApi.js даже в том случае, если не планируется использовать JS API для работы виджета. При подключении библиотеки начинают учитываться как переходы по ссылкам, так и все клики внутри виджета. Подробнее см. раздел Статистика переходов в документе Яндекс.Виджеты. Руководство разработчика.

CTR виджета как один из факторов влияет на ранжирование.

Примечание. 

Статистика переходов и действий пользователей недоступна для просмотра разработчикам виджетов.

Номер версии API, как правило, состоит из двух цифр, например "1.5". Если при подключении указать только первую цифру версии (например, "1"), то подключена будет последняя на данный момент версия "1.x".

Например:

<html> 
  <head> 
    <script type="text/javascript" src="http://img.yandex.net/webwidgets/1/WidgetApi.js"></script> 
      ... 
  </head> 
  <body /> 
</html>

Основным объектом API является сам виджет ( widget). Данный объект создается автоматически во время загрузки виджета. Так как виджеты выполняются внутри отдельных элементов <iframe>, то каждый виджет обладает собственным объектом widget.

Яндекс.Виджеты WidgetApi WidgetApi.js