Как подключить отображение наличия подписки

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

Пример отображения

Дизайн может меняться.

Чтобы подписки начали отображаться в карточках фильмов и сериалов, нужно передавать Яндексу информацию о ваших подписках и подписчиках. Информация передается в JSON-файле.

Примечание. Перед тем как передавать информацию, сформируйте и загрузите фид с данными о фильмах и сериалах в JSON-формате.
  1. Шаг 1. Подготовьте данные
  2. Шаг 2. Передайте данные в Яндекс
  3. Хеширование данных о пользователях

Шаг 1. Подготовьте данные

  1. Сформируйте JSON-файл. Он должен содержать следующие параметры:
    Название Обязательно Описание Примечание
    sub_name Да Название подписки. Должно совпадать с requirespayment.name из основного фида. Если у вас доступно более одного типа подписки — нужно передавать разные названия.
    date_from Нет Дата начала подписки. Например, 28.07.2023.
    date_to Нет Дата окончания подписки. Например, 28.09.2023.
    email_hash Да Адрес электронной почты пользователя.

    Перед отправкой данных используйте хеширование.

    Информация нужна для определения пользователей с подпиской.

    phone_hash Да Номер телефона пользователя.
  2. Разместите файл на сайте вашего онлайн-кинотеатра и настройте обновление файла не реже раза в сутки. Убедитесь, что ссылка доступна для робота Яндекса, с помощью инструмента Вебмастера Проверка ответа сервера.

Шаг 2. Передайте данные в Яндекс

Внимание. Если вы передаете данные о пользователях, при заполнении заявки убедитесь, что передача данных соответствует законодательству и у вас есть законные основания для обработки персональных данных для соответствующих целей. Фид с пользовательскими данными необходимо зашифровать GPG-ключом.

Заполните заявку. Укажите:

  1. Адрес вашего онлайн-кинотеатра, например https://example.com.
  2. Добавьте ссылку на сформированный в Шаге 1 JSON-файл.
  3. Добавьте логотип вашего онлайн-кинотеатра. Он будет отображаться в карточке фильма или сериала.
    Требования к логотипу

    Размер: 120 × 120, 32 × 32 или 16 × 16 пикселей.

    Формат: SVG (рекомендуемый), ICO, GIF, JPEG, PNG, BMP. Анимация не поддерживается.

Хеширование данных о пользователях

При подготовке данных используйте хеширование по алгоритму md5. При этом каждая запись должна быть захеширована отдельно.

Перед хешированием нужно нормализовать данные:

Поле Описание
phone_hash

Номер телефона пользователя.

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

79995551111

7 (999) 555-11-11

emails_hash

Адрес электронной почты пользователя.

Строка латиницей, включающая символ @ и имя домена. Нельзя использовать прописные буквы.

[email protected]

[email protected]

Пример записей с захешированными значениями:

phone_hash,emails_hash
a31259d185ad013e0a663437c605d056,78ee6d68f49d2c90397d9ff77fc3814d1
702e8494aeb560dff987eh623e71ccf8,f5ge43thaeb67df89875777e71bccf88i