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

  1. Для каких сайтов
  2. Что добавляет в результаты поиска
  3. Как настроить
  4. Условия
  5. Ошибки при загрузке фида

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

Для банков.

Примечание. Отображение тематических блоков находится в режиме тестирования.

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

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

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

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

Чтобы ваши предложения попадали в такие ответы, необходимо передавать Яндексу актуальную информацию о них. Для этого нужно подготовить и разместить на своем сайте фид в формате 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. У флага приоритет выше, чем у списка регионов.

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

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

История изменений
  • Отредактирована структура валютного и ипотечного фида, фида для вкладов. Добавлен список ошибок при загрузке фида.