How to add Manifest Personalization for HLS

This lets you enhance the viewing experience by individualizing Apple HTTP Live Streaming (HLS) video quality to best suit your end user's devices.

You can add Manifest Personalization ("MPer") to your AMD configuration to personalize distribution of your HLS media. When a request is sent to a property hostname that's been set in your AMD configuration and it matches the criteria set for a rule that includes MPer for HLS, a manifest is generated "on-the-fly." This manifest determines the appropriate video quality content for the requesting device.

Manifest Personalization for HLS offers the following benefits:

  • You can implement preferred bit rate and bit rate filtering. These allow you to maintain quality and performance to deliver the most optimal playback experience for each end user.
  • You can offload the master manifest file manipulation. This lets you target unique device profiles and geographic/network characteristics.
  • You can reduce the associated computation and storage overhead on your origin.

What video formats are supported?

Manifest Personalization is supported for use with both live and on-demand HLS media.

How do I get access to Manifest Personalization?

You need to have this added to your contract to access the appropriate behavior in Property Manager. Contact your account representative to add this functionality.

Add Manifest Personalization and set the Match Criteria

Once it's on your contract, you can add Manifest Personalization to your AMD property. It's added as an optional rule to the property.

  1. Create a new AMD configuration, or edit an existing one using the Property Manager in Control Center.
  2. In the Property Configuration Settings options, click the Add Rule button to add a new rule.
  3. In the Available Rules (by Category) field, type Manifest Personalization to filter and select it from the list.
  4. By default, the (match) Criteria is set to various common file names that represent HLS Master Manifest files. You can add or remove filenames as necessary.
    Note: You can use wildcard characters for manifest filenames (for example, "master-*.m3u8"). But, make sure that your master manifest naming convention doesn't overlap with your media playlists and segments.
  5. Set Enable Manifest Personalization to "On."

Once enabled, you need to select the appropriate Mode to configure Manifest Personalization, and you can optionally apply other available settings.