AWS mediatailor documentation change
Summary
Updated slate documentation to include detailed explanation of personalization threshold behavior, added HTTPS certificate requirements for slate sources, expanded error handling scenarios, and restructured VPAID ad requirements.
Security assessment
The change adds security documentation by specifying that HTTPS slate sources require certificates from well-known CAs (not self-signed), preventing potential MITM attacks and ensuring secure content retrieval. However, there's no evidence of a specific security vulnerability being patched. The severity is low as it enforces standard security best practices.
Diff
diff --git a/mediatailor/latest/ug/slate-management.md b/mediatailor/latest/ug/slate-management.md index ad5340827..875a8b69b 100644 --- a//mediatailor/latest/ug/slate-management.md +++ b//mediatailor/latest/ug/slate-management.md @@ -5 +5 @@ -Configuring the slateSlate configuration and VPAID +Configuring the slateHow personalization threshold worksSlate configuration and VPAID @@ -7 +7 @@ Configuring the slateSlate configuration and VPAID -# Inserting slate +# MediaTailor slate ad insertion @@ -11 +11 @@ Configuring the slateSlate configuration and VPAID -Slate is only available for live workflows. +Slate is only available for live and live-to-VOD workflows. @@ -15 +15 @@ With AWS Elemental MediaTailor, you can designate a _slate ad_ for ad breaks. A -AWS Elemental MediaTailor shows a slate in the following situations: +AWS Elemental MediaTailor shows slate during ad breaks in the following specific situations: @@ -17 +17 @@ AWS Elemental MediaTailor shows a slate in the following situations: - * To fill in time that's not fully used by an ad replacement + * To fill in time remaining in a break that has not been replaced by personalized ads @@ -19 +19 @@ AWS Elemental MediaTailor shows a slate in the following situations: - * If the ad decision server (ADS) responds with a empty VAST or VMAP response + * If the Ad Decision Server (ADS) responds with an empty VAST or VMAP response @@ -21 +21 @@ AWS Elemental MediaTailor shows a slate in the following situations: - * For error conditions, such as ADS timeout + * For error conditions, such as ADS timeout or HTTP 500 error from the ADS @@ -23,3 +23 @@ AWS Elemental MediaTailor shows a slate in the following situations: - * If the duration of ads is longer than the ad break - - * If an ad isn't available + * If an ad isn't available for insertion by MediaTailor (such as when it hasn't finished transcoding) @@ -34 +32,80 @@ If you don't configure a slate, MediaTailor defaults to the underlying content s -You designate the slate in the ****additional configuration****pane in the[ MediaTailor console](https://console.aws.amazon.com/console/home?nc2=h_ct&src=header-signin). MediaTailor downloads the slate from the URL that you specify, and transcodes it to the same renditions as your content. You can control the maximum amount of time that a slate will be shown through the optional **personalization threshold** configuration in the MediaTailor console. For more information, see [Optional configuration settings](./configurations-create.html#configurations-create-addl). +You designate the slate in the **additional configuration** pane in the [ MediaTailor console](https://console.aws.amazon.com/console/home?nc2=h_ct&src=header-signin). MediaTailor downloads the slate from the URL that you specify, and transcodes it to the same renditions as your content. You can control the maximum amount of time that a slate will be shown through the optional **personalization threshold** configuration in the MediaTailor console. For more information, see How personalization threshold works. + +The slate must be a high-quality MP4 asset that contains both audio and video. Configuring the slate is optional for non-VPAID configurations but mandatory for VPAID workflows. + +###### Note + +If the server that hosts your slate uses HTTPS, its certificate must be from a well-known certificate authority. It can't be a self-signed certificate. If you use a self-signed certificate, then AWS Elemental MediaTailor can't retrieve and stitch the slate into the manifests from the content origin. + +## How personalization threshold works + +The personalization threshold defines the maximum duration of underfilled ad time (in seconds) allowed in an ad break. This feature applies specifically to ad replacement in Live and VOD streams, rather than ad insertion, because it relies on an underlying content stream. + +The behavior varies based on three scenarios: + + 1. **When personalization is disabled:** + + 1. Slate will be inserted for the full duration of unfilled time + + 2. Start/End bumpers will be inserted when configured (for more information, see [MediaTailor bumper ad insertion](./bumpers.html)) + + 3. Ads will be inserted as normal + + 2. **When personalization is enabled and threshold less than break duration:** + + 1. If the unfilled time exceeds the personalization threshold: + + 1. MediaTailor abandons personalization of the ad break + + 2. The underlying content is shown + + 3. No ads, slate, or bumpers are inserted + + 2. If the unfilled time is less than the personalization threshold: + + 1. Ads and slate are inserted + + 2. Bumpers are inserted if configured + + 3. **When personalization is enabled and threshold greater than break duration:** + + 1. Ads will be inserted + + 2. Slate will be inserted for any remaining time in the ad break + + 3. Bumpers will be inserted if configured + + + + +The following table provides detailed behaviors for specific scenarios across both HLS and DASH protocols: + +Detailed behavior matrix Scenario | Personalization disabled | Personalization enabled less than break duration | Personalization enabled greater than break duration +---|---|---|--- +Empty VAST or VMAP | Slate inserted | No slates inserted | Slate inserted +ADS timeout | Slate inserted | No slates inserted | Slate inserted +Ad isn't available (Vast 404) | Slate inserted | No slates inserted | Slate inserted +Duration of ads is longer than ad break | Ads inserted | No ads inserted | Ads inserted +Fill in time that's not fully used by an ad replacement | Slate inserted | If personalization threshold greater than unfilled time: No ads/slates inserted, else: Ads and slates inserted | Slate inserted +Preroll with empty VAST | Slate inserted, no preroll inserted | No slates inserted, no preroll inserted | Slate inserted, no preroll inserted +Preroll with ADS timeout | Slate inserted, no preroll inserted | No slates inserted, no preroll inserted | Slate inserted, no preroll inserted +Preroll when ad isn't available (Vast 404) | Slate inserted, no preroll inserted | No slates inserted, no preroll inserted | Slate inserted, no preroll inserted +Bumpers with empty VAST | Slate inserted, bumper inserted | No slates inserted, no bumpers inserted | Slate inserted, bumper inserted +Bumpers with ADS timeout | Slate inserted, bumper inserted | No slates inserted, no bumpers inserted | Slate inserted, bumper inserted +Bumpers when ad isn't available (Vast 404) | Slate inserted, bumper inserted | No slates inserted, no bumpers inserted | Slate inserted, bumper inserted +Bumpers to fill in time that's not fully used by ad replacement | Slate inserted, bumper inserted, ad inserted | If personalization threshold greater than unfilled time: No bumpers/ads/slates inserted, else: No bumpers/ads/slates inserted | Slate inserted, bumper inserted, ad inserted + +###### Important considerations + +Remember the following when you're working with slate and personalization threshold. + + * This behavior is consistent across both HLS and DASH protocols + + * The personalization threshold feature only applies when slate is configured + + * When slate is configured and personalization threshold is not configured, slate will play for either the full origin avail duration or whatever time remains after filling in the ads + + * For VPAID ads, MediaTailor inserts slate for the duration of the VPAID ad to hold space for ads that the video player will insert + + + @@ -38 +115,5 @@ You designate the slate in the ****additional configuration****pane in the[ Medi -You must configure a slate if you're using VPAID ads. To hold space for VPAID ads that the video player inserts, MediaTailor inserts the slate for the duration of the VPAID ad. This duration might be slightly longer than the duration of the VPAID ad as reported by VAST to accommodate user interactivity, as described in [VPAID requirements](./vast.html#vpaid). The video player then handles the VPAID ad based on the client-side reporting metadata that MediaTailor returns. For information about client-side reporting, see [Client-side ad tracking](./ad-reporting-client-side.html). +###### Important + +Slate configuration is mandatory when using VPAID ads. MediaTailor inserts slate to hold space for VPAID ads that the video player will insert. The slate duration might be slightly longer than the VPAID ad duration to accommodate user interactivity. + +The video player then handles the VPAID ad based on the client-side reporting metadata that MediaTailor returns, as described in [VPAID requirements](./vast.html#vpaid). For information about client-side reporting, see [Client-side ad tracking](./ad-reporting-client-side.html). @@ -46 +127 @@ To use the Amazon Web Services Documentation, Javascript must be enabled. Please -Inserting pre-roll ads +Pre-roll ad insertion