Банковские услуги

Для каких сайтов

Это старая версия документа, которая прекратила свое действие 04.07.2024 г. Действующая версия размещена по адресу: https://yandex.ru/support/webmaster/search-appearance/banks.html

Для банков.

Что добавляет в результаты поиска

Тематические блоки могут содержать информацию о банковских услугах: курсе валют, условиях ипотеки, суммах, условиях, сроках вкладов. Это поможет пользователю сделать выбор, а банку — привлечь внимание выгодными услугами и условиями сделок.

Пример отображения (дизайн может меняться):

Содержит подходящую запросу пользователя информацию о вкладах в разных банках.

Содержит подходящую запросу пользователя информацию о разных вкладах в определенном банке. Может формироваться из данных фида и информации на сайте.

Как настроить

Чтобы ваши предложения попадали в такие ответы, необходимо передавать Яндексу актуальную информацию о них. Для этого нужно подготовить и разместить на своем сайте фид в формате YML. Стандарт YML разработан Яндексом и основан на стандарте XML.

В поисковой выдаче ответ будет формироваться из переданных в фиде данных. Также предложения могут попадать в ответ автоматически на основе обработки данных поискового робота Яндекса.

Чтобы ответы отображались корректно, рекомендуем передавать в фиде все предложения банка в заданной категории. Например, если у банка на сайте указано 12 ипотечных программ, передайте в фиде все эти программы.

Ограничения для фида

Размер YML-файла

50 МБ

Количество элементов offer

10 000

Количество всех YML-файлов (товарные фиды, фиды услуг и предложений, RSS для контентных Турбо-страниц) суммарно для сайта и его поддоменов

1000

Так как предложения отображаются в отдельных тематических блоках, для каждого из них нужно создать свой фид и добавить ссылку на него в заявку на подключение блоков.

Валютный фид

Пример фида

Скачать

Описание полей

Элемент

Тип

Описание

URL

string

Ссылка на страницу, где указаны курсы валют.

Currency

From

string

Символьный код валюты по ISO 4217. Например: USD, RUB, EUR.

To

string

Символьный код валюты по ISO 4217. Например: USD, RUB, EUR.

AmountLowerLimit

float

От какого объема действительна цена.

Nominal

float

За сколько единиц валюты указана цена.

BuyPriсe

float

Цена покупки для заданного Nominal.

SellPrice

float

Цена продажи для заданного Nominal.

UpdateAt

date time

Время обновления цены в формате ISO 8601 с указанием часового пояса.

Price

AmountLowerLimit

float

От какого объема действительна цена.

Nominal

float

За сколько единиц валюты указана цена.

BuyPriсe

float

Цена покупки для заданного Nominal.

SellPrice

float

Цена продажи для заданного Nominal.

UpdateAt

date time

Время обновления цены в формате ISO 8601 с указанием часового пояса.

Offices

Namе

string

Имя банка, не отделения.

Office object

Namе

string

ID (имя) отделения, уникальный для всех отделений в фиде.

City

string

Наименование населенного пункта, где находится отделение.

Adress

string

Адрес в населенном пункте. Можно указать полный адрес: регион, область, район.

Также данные о валюте можно передавать с помощью вашего API. Для этого заполните заявку и оставьте запрос в поле для комментариев.

Ипотечный фид

Пример фида

Скачать

Описание полей

Параметр

Тип

Описание

generation-date*

date time

Время обновления фида. Формат ISO 8601.

offers*

array

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

banks*

array

Список банков. Хранит метаданные о банках.

references*

array

Список рекомендаций. Хранит список регионов.

offer object

bankBic*

string

БИК банка. Форматы представлены на этой странице.

offerId*

integer

Идентификатор предложения. Должен быть уникальным для каждого предложения.

purposeIds

dictionary

Идентификаторы целей.

name*

string

Название программы.

description

string

Описание программы.

specialPrograms

array

Специальные предложения.

isInAllRegions

boolean

Доступен по всей России.

info

object

Дополнительная информация о программе.

regions

array

Хранит справочник регионов. Каждый регион должен встречаться в документе только один раз.

offerUrl

string

Ссылка на страницу с предложением, можно с UTM-метками.

totalLoanCostMin

float

Полная стоимость кредита. От какой суммы.

totalLoanCostMax

float

Полная стоимость кредита. До какой суммы.

rateTables

object

Таблица со ставками и условиями.

boosts

object

Повышающие или понижающие коэффициенты.

specialProgram object (offer)

url

string

Ссылка на специальную программу.

specialProgramId

integer

Идентификатор программы.

specialProgram object (references)

item

object

Цель.

purpose object

item

object

Специальная программа.

item object (purpose / boost )

title

string

Название программы.

value

float

Значение фактора в процентах.

info

item

object

Дополнительная информация о программе.

item object (info)

title

string

Название программы.

text

string

Описание.

region object

id

integer

Идентификатор региона.

name

string

Название региона.

rateTables

rates*

array

Список таблиц со ставками и условиями.

rate object

initialPaymentPercentageMin

integer

Минимальный процент первоначального взноса.

initialPaymentPercentageMax

float

Максимальный процент первоначального взноса.

periodFromDays

integer

Минимальный срок кредита (в днях).

periodToDays

integer

Максимальный срок кредита (в днях).

amountFrom

integer

Минимальная сумма кредита.

amountTo

integer

Максимальная сумма кредита.

rate

float

Процентная ставка.

bank object

bic*

integer

БИК банка.

name*

string

Название кредита для показа в тематическом блоке.

url*

string

Ссылка на страницу, где указаны курсы валют.

favicon*

string

Ссылка на логотип банка. Используйте порты: 80 и 443.

Вклады

Пример фида

Скачать

Описание полей

Параметр

Тип

Описание

generation-date*

date time

Время обновления фида. Формат ISO 8601.

offers*

array

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

banks*

array

Список банков. Хранит метаданные о банках.

references*

array

Список рекомендаций. Хранит список регионов.

offer object*

bankBic*

string

БИК банка. Форматы представлены на этой странице.

offerId*

integer

Идентификатор предложения (вклада). Должен быть уникальным для каждого предложения.

currency*

string

Валюта вклада по ISO 4217.

name*

string

Название вклада для показа в тематическом блоке.

description

string

Описание вклада словами, без цифр.

partialWithdrawal

object

Доступно ли частичное снятие средств.

refill

object

Возможность пополнить вклад.

preferentialTermination

object

Возможность закрыть вклад досрочно.

interestPayment

object

Доступность капитализации.

info

object

Дополнительная информация о предложении.

isOnline

boolean

Возможно ли открыть вклад онлайн.

isInAllRegions

boolean

Вклад доступен по всей России.

regions

array

Хранит справочник регионов. Каждый регион должен встречаться в документе только один раз.

offerUrl*

string

Ссылка на страницу с предложением, можно с UTM-метками.

rateTables

object

Таблица со ставками и условиями.

bonuses

array

Список бонусов.

bank object

bic*

integer

БИК банка.

name*

string

Название вклада для показа в тематическом блоке.

url*

string

Ссылка на сайт банка.

favicon*

string

Ссылка на логотип банка. Используйте порты: 80 и 443.

reference object

regions

array

Хранит справочник регионов. Каждый регион должен встречаться в документе только один раз.

region object

id

integer

Идентификатор региона.

name

string

Название региона.

interestPayment

capitalization*

boolean

Невозможно (0) / Возможно (1).

monthly

boolean

Ежемесячно.

quaterly

boolean

Каждый квартал.

annually

boolean

Ежегодно.

rateTables

rates*

array

Список таблиц со ставками и условиями.

rate object

periodFromDays*

integer

Минимальный срок вклада (в днях).

periodToDays*

integer

Максимальный срок вклада (в днях).

amountFrom*

integer

Минимальная сумма вклада.

amountTo

integer

Максимальная сумма вклада.

rate*

float

Процентная ставка.

bonus object

title*

string

Название бонуса.

description

string

Описание бонуса.

maxAmount

integer

Максимальный размер бонуса.

maxPercent

float

Максимальный процент бонуса.

promocode

string

Промокод.

endDate*

date time

Дата и время завершения акции.

info

item

object

Условия вклада.

partialWithdrawal

has*

boolean

Невозможно (0) / Возможно (1).

description

string

Описание условий частичного снятия.

refill

has*

boolean

Невозможно (0) / Возможно (1).

description

string

Описание условий пополнения вклада.

preferentialTermination

has*

boolean

Невозможно (0) / Возможно (1).

description

string

Описание условий досрочного закрытия вклада.

item object

title

string

Название условия.

text

string

Подробнее об условии.

Оставить заявку

Условия

Сайт несет ответственность за корректность данных, соответствие предложений тематике, а также за распространение незаконной информации. В случае нарушения условий Яндекс имеет право не использовать данные сайта для изменения представления ответа в поисковой выдаче. См. подробные условия.

Ошибки при загрузке фида

В структуре и формате данных

Код ошибки

Сообщение

Описание

1

PE_SAX_UNKNOWN

Неизвестная ошибка XML-парсера #{0}. Пожалуйста, обратитесь в поддержку.

2

PE_SAX_XML_ERR_LTSLASH_REQUIRED

Ожидался закрывающий тег: </.

3

PE_SAX_XML_ERR_EMPTY_DOCUMENT

Пустой фид.

4

PE_SAX_XML_ERR_START_TAG_EXPECTED

Не найден открывающий тег.

5

PE_SAX_XML_ERR_PARSE_ENTITY_REF

Неправильно указано имя сущности.

6

PE_SAX_XML_ERR_PARSE_START_TAG

Недопустимое имя открывающего тега.

7

PE_SAX_XML_ERR_PARSE_ATTRIBUTE_NAME

Неправильно указано имя атрибута.

8

PE_SAX_XML_ERR_UNSUPPORTED_VERSION

Неподдерживаемая xml версия `{0}`.

9

PE_SAX_XML_ERR_ENTITY_REF_SEMICOLON

Ссылка на сущность.

10

PE_SAX_XML_ERR_PREMATURE_END_OF_DATA

Преждевременное завершение данных в теге `{0}`.

11

PE_SAX_XML_ERR_UTF_8

Обнаружено нарушение кодировки UTF-8.

12

PE_SAX_XML_ERR_PCDATA_INVALID_CHAR

Неизвестный символ с кодом `{0}` в блоке PCDATA.

13

PE_SAX_XML_ERR_OPENING_ENDING_TAG_MISMATCH

Не совпадают открывающий и закрывающий теги `{0}` и `{1}`.

14

PE_SAX_XML_ERR_CDATA_SECTION_NOT_FINISHED

Некорректно завершен блок CData.

15

PE_SAX_XML_ERR_EXTRA_CONTENT_AT_THE_END

Неожиданный контент в конце фида.

16

PE_SAX_XML_ERR_ENTITY_NOT_DEFINED

Сущность &{0}; не определена.

17

PE_SAX_XML_ERR_XML_DECLARATION

Объявление ХML допустимо только в начале файла.

18

PE_SAX_XML_ERR_ATTRIBUTE_VALUE_MISSING

У атрибута `{0}` должно быть указано значение.

19

PE_SAX_XML_ERR_ATTRIBUTES_CONSTRUCT

Некорректно сформированы атрибуты.

20

PE_SAX_XML_ERR_GT_EXPECTED

Не найден символ >.

21

PE_SAX_XML_ERR_END_TAG_SYMBOL_EXPECTED

Не найден закрывающий тег для `{0}`.

22

PE_SAX_XML_ERR_INTERNAL_ERROR

Внутренняя ошибка.

23

PE_SAX_XML_ERR_STANDALONE_VALUE

Атрибут standalone может иметь только значения yes или no.

24

PE_SAX_XML_ERR_UNESCAPED_START_TAG_SYMBOL

Символ < в значении атрибута должен быть экранирован.

25

PE_SAX_XML_ERR_ATTRIBUTE_VALUE_FORMAT

Ожидается \ или ' для значения атрибута.

26

PE_SAX_XML_ERR_HEADER

Неправильно объявлен XML заголовок.

27

PE_SAX_XML_ERR_INVALID_SEQUENCE

Недопустимая последовательность ]]>.

98

PE_TOO_MANY_ERRORS

Слишком много ошибок. Будут показаны только самые важные.

99

PE_EXCEPTION

Фатальная ошибка парсера.

100

PE_REFL_UNKNOWN_ATTR

Неизвестный атрибут `{0}` в теге `{1}`. Данные в нём будут проигнорированы.

101

PE_REFL_UNKNOWN_TAG

Неизвестный тег `{0}`. Данные в нём будут проигнорированы.

102

PE_REFL_NO_ONTEXT

В теге `{0}` не должно быть текста. Данный текст будет проигнорирован.

103

PE_REFL_TAG_IS_SINGULAR

Тег `{0}` не может использоваться более одного раза. Данные в повторениях этого тега будут проигнорированы.

104

PE_REFL_ATTR_IS_SINGULAR

Атрибут `{0}` в теге `{1}` не может использоваться более одного раза. Данные в повторениях этого атрибута будут проигнорированы.

105

PE_REFL_REQ_ATTR_IS_NOT_FILLED

Обязательный атрибут `{0}` в теге `{1}` не заполнен.

106

PE_REFL_REQ_TAG_IS_NOT_FILLED

Обязательный тег `{0}` не заполнен.

201

PE_COMMON_DEPTH

Превышена максимальная глубина вложенных полей равная {0}.

202

PE_COMMON_DUPLICATE_OFFER_ID

ID оффера в поле `{0}` уже был использован. Для каждого оффера это поле должно быть уникально. Данный оффер будет проигнорирован. Пример повторяющегося ID: `{1}`.

203

PE_COMMON_NO_OFFER_ID

Отсутствует ID оффера в поле `{0}`. Для каждого оффера это поле должно быть заполнено и уникально. Данный оффер будет проигнорирован.

204

PE_COMMON_MAX_LIMIT_OFFERS

Превышено максимальное количество офферов в фиде в {0} офферов.

301

PE_PARSE_NOT_BOOL

В теге `{0}` ожидалось значение логического типа (true/false), а обнаружено: `{1}`.

302

PE_PARSE_NOT_ENUM

Неизвестное значение `{2}` в теге `{0}`, ожидалось одно из следующих значений: {1}.

303

PE_PARSE_NOT_INTEGER

Ожидалось целое число в теге `{0}`, а получено `{1}`.

304

PE_PARSE_NOT_UINTEGER

Ожидалось целое неотрицательное число в теге `{0}`, а получено `{1}`.

305

PE_PARSE_NOT_DOUBLE

Ожидалось вещественное число в теге `{0}`, а получено `{1}`.

306

PE_PARSE_NOT_POSITIVE_DOUBLE

Ожидалось неотрицательное вещественное число в теге `{0}`, а получено `{1}`.

307

PE_PARSE_INCORRECT_URL

Неверный URL в теге `{0}`: `{1}`.

308

PE_PARSE_INCORRECT_IMAGE_URL

Неверный URL для изображения в теге `{0}`: `{1}` (для корректных URL'ов разрешены только порты 80 и 443).

309

PE_PARSE_INCORRECT_DATETIME

Некорректная дата в теге `{0}`: `{1}`. Дата должна соответствовать стандарту ISO8601.

311

PE_PARSE_EXCESS_TAG

Слишком много значений в теге `{0}`: обнаружено {2} значений , хотя максимально допустимо лишь `{1}`. Все значения сверх этого предела будут проигнорированы.

313

PE_PARSE_TOO_BIG_VALUE

В теге `{0}` число `{2}` превышает допустимый максимум в `{1}`.

314

PE_PARSE_INCORRECT_PAIR

В теге `{0}` ожидалась пара значений, разделённых `{1}`, но обнаружено: `{2}`.

335

PE_PARSE_REQUIRED_FIELD_NOT_CORRECT

Тег `{0}` является обязательным, но в нём либо нет значения, либо оно заполнено неправильно. Без него оффер будет проигнорирован.

351

PE_PARSE_TOO_SMALL_VALUE

В теге `{0}` число `{2}` меньше допустимого минимума в `{1}`.

357

PE_PARSE_VALUE_IS_OUT_OF_RANGE

`{1}` выходит за пределы допустимого диапазона тега `{0}`. Допустимый диапазон `{2}`.

358

PE_PARSE_REQUIRED_FIELD_DOES_NOT_EXIST

Тег `{0}` является обязательным, но он отсутствует, либо в нём нет значения.

359

PE_PARSE_VALUE_IS_NOT_UNIQUE

Тег `{0}` требует уникальности значений. Повторяется значение `{1}`.

В финансовом фиде

Код ошибки

Сообщение

Описание

801

PE_UNISEARCH_FINANCE_NO_REFERENCES_FOUND

В фиде не найдена секция <references>. Убедитесь, что она добавлена и заполнена верно.

802

PE_UNISEARCH_FINANCE_NO_BANKS_FOUND

В фиде не найден список банков.

803

PE_UNISEARCH_FINANCE_MISMATCH_REFERENCE

Тег `{1}` содержит значение `{0}`. Такое значение не найдено в списке `{2}`.

804

PE_UNISEARCH_FINANCE_NO_PROGRAMMS_FOUND

В фиде не обнаружен список программ.

805

PE_UNISEARCH_FINANCE_NO_REGIONS_FOUND

В фиде не обнаружен список регионов.

808

PE_UNISEARCH_FINANCE_INCORRECT_INITIAL_PAYMENT

В теге `{0}` указан неверный диапазон первоначального взноса.

Минимальный — `{1}`.

Максимальный — `{2}`.

809

PE_UNISEARCH_FINANCE_INCORRECT_PERIOD

В теге `{0}` указан неверный диапазон срока займа.

Минимальный — `{1}`.

Максимальный — `{2}`.

810

PE_UNISEARCH_FINANCE_INCORRECT_AMOUNT

В теге `{0}` указан неверный диапазон суммы займа.

Минимальный — `{1}`.

Максимальный — `{2}`.

811

PE_UNISEARCH_FINANCE_ALL_REGIONS_WITH_REGIONS_LIST

Оффер будет доступен во всех регионах, так как уже выставлен флаг IsInAllRegions. У флага приоритет выше, чем у списка регионов.

Дата обновления страницы: 10.06.2024.

Предыдущие версии документа

История изменений
  • В описание параметра boosts добавлены понижающие коэффициенты.