How to enable the display of existing subscriptions

Movie and TV series cards in search results can display the streaming services that the user is subscribed to. Such services are shown above other streaming services so that the user can easily find the platform they watch movies on. If the user has multiple subscriptions, the streaming services they're subscribed to are displayed in random order.

For subscriptions to be displayed in movie and TV series cards, provide information about your subscriptions and subscribers to Yandex. The information should be provided in a JSON file.

Note

Before providing the information, create and upload a feed with movie and TV series data in JSON format.

Step 1. Prepare the data

  1. Create a JSON file. It should contain the following parameters:

    Name

    Required

    Description

    Note

    sub_name

    Yes

    The subscription name.

    Must have the same value as requirespayment.name from the main feed. If you have more than one subscription type, include different names.

    date_from

    No

    The subscription start date.

    For example, 28.07.2023.

    date_to

    No

    The subscription end date.

    For example, 28.09.2023.

    email_hash

    Yes

    The user's email address.

    Use hashing before sending data.

    This information is required for identifying subscribers.

    phone_hash

    Yes

    The user's phone number.

  2. Place the file on the site of your streaming service and set up the file to be updated at least once a day. Make sure that the link is accessible to the Yandex indexing bot by checking the server response in Yandex Webmaster.

Step 2. Pass the data to Yandex

Alert

If you're passing user data, make sure that this doesn't violate the law and that you have legitimate reasons for processing personal information for the relevant purposes. That's a prerequisite to filling out the application form. A feed containing user data must be encrypted with a GPG key.

Fill out the application form. Enter:

  1. Your streaming service's URL. For example, https://example.com.

  2. Add a link to the JSON file you created in Step 1.

  3. Add your streaming service's logo. It will be displayed in movie or TV series cards.

    Logo requirements

    Size: 120 × 120, 32 × 32, or 16 × 16 pixels.

    Format: SVG (recommended), ICO, GIF, JPEG, PNG, and BMP. Animation is not supported.

Fill out application

Hashing user information

When you prepare the data, use the MD5 algorithm for hashing. Each record must be hashed separately.

Before hashing, normalize the data:

Field

Description

phone_hash

The user's phone number.

A numeric string containing a phone number with a country code. Spaces and additional characters are not allowed.

79995551111

7 (999) 555-11-11

emails_hash

The user's email address.

A string of Latin characters with the @ sign and a domain name. Uppercase letters are not allowed.

mail@yandex.ru

Mail@yandex.ru

An example of records with hash values:

phone_hash,emails_hash
a31259d185ad013e0a663437c605d056,78ee6d68f49d2c90397d9ff77fc3814d1
702e8494aeb560dff987eh623e71ccf8,f5ge43thaeb67df89875777e71bccf88i



You can also go to

Previous
Movies and TV series
Next
Feed statistics