Document history for AWS Elemental MediaTailor

The following table describes important changes to this documentation.

Change	Description	Date
Added log types	Added new section that lists the log types that MediaTailor emits.	January 15, 2025
Added log filtering information	Added new section about filtering logs that MediaTailor emits.	January 15, 2025
Added supported query parameter formatting	Added sections for manifest query parameter and ADS query parameter formatting.	January 2, 2025
Integration information for Google Ad Manager	Added a section about integrating MediaTailor with Google Ad Manager from server side and client side.	November 25, 2024
Updated variable	Changed breakabilityStartTime to availabilityStartTime.	May 6, 2024
Added personalization detail	Added the Insertion Mode personalization detail.	May 6, 2024
Program Rules	Added new content on program rules.	April 25, 2024
Updated content on creating channels	Added information about program rules when creating channels.	April 20, 2024
Updated content on adding programs	Added information about program rules when adding programs.	April 20, 2024
AlternateMedia and the As Run Log	Added a note on how AlternateMedia affects the As Run Log.	February 28, 2024
Time-shifted viewing	MediaTailor channels support time-shifted viewing for content that's up to 6 hours old.	December 27, 2023
Updated manifest settings	Added information about passthrough tags, depending on the chosen Ad markup type.	November 28, 2023
SCTE-35 messages for ad breaks	Added information about inserted SCTE-35 tags for Daterange versus Scte35 Enhanced Ad markup types.	November 28, 2023
Key-value pairs for the Enhanced Scte35 Ad markup type	Added information about how MediaTailor handles submitted key-value pairs for the Enhanced Scte35 Ad markup type.	November 28, 2023
VOD source ad opportunities	MediaTailor can now automatically detect ad opportunities on VOD sources.	October 6, 2023
New Autodetect SigV4 authentication type	MediaTailor now supports the AUTODETECT_SIGV4 access type.	August 18, 2023
Updated client-side tracking content	Updated the client-side tracking content to include additional information.	August 12, 2023
Setting up MediaTailor and MediaPackage workflows to use live sources	Added information on setup, general requirements, and behavior when MediaTailor and AWS Elemental MediaPackage workflows use live sources.	May 24, 2023
Manifest query parameters documentation	Added a section that describes manifest query parameters.	April 26, 2023
Overlay ads documentation	Added a section that describes overlay ads.	April 24, 2023
Ad ID decoration in manifests documentation	Added a section that describes ad ID decoration in manifests.	April 24, 2023
Added AFTER_LIVE_EDGE suppression mode	AFTER_LIVE_EDGE ad suppression mode is now available in addition to BEFORE_LIVE_EDGE mode.	February 21, 2023
New As Run log	New topic on the As Run log.	January 19, 2023
IAM best-practices updates	Updated guide to align with the IAM best practices. For more information, see Security best practices in IAM.	December 27, 2022
IAM best-practices updates	Updated guide to align with the IAM best practices. For more information, see Security best practices in IAM.	December 27, 2022
Updated quotas content	Updated and reorganized quotas information.	September 13, 2022
Added and corrected channel assembly quotas	Added quotas for live sources, segment delivery configurations, manifest requests, and channel transactions in the MediaTailor channel assembly service.	September 13, 2022
Added and corrected channel assembly quotas	Added quotas for logging, channel, live sources, programs, source locations, and channel policies in the MediaTailor channel assembly service.	September 11, 2022
New channel assembly alerts table	You can now see a table that explains channel assembly alerts.	September 1, 2022
New Amazon CloudWatch metrics	Added new CloudWatch metrics.	June 26, 2022
Ad calls topic	Added link to prefetch support for VAST responses.	May 25, 2022
New ADS request variables	MediaTailor now supports these additional SCTE-35 variables in ADS requests: scte.segmentation_type_id, scte.avails_expected, scte.delivery_not_restricted_flag, scte.segment_num, scte.sub_segment_num, scte.segments_expected, scte.sub_segments_expected, scte.device_restrictions, scte.no_regional_blackout_flag, scte.archive_allowed_flag and scte.segmentation_event_id.	April 27, 2022
New IAM managed policy policy topic	Added two new managed policies for MediaTailor.	November 24, 2021
New AWSElementalMediaTailorReadOnly managed policy	Added a new AWS managed policy that grants permissions that allows read-only access to MediaTailor resources.	November 10, 2021
New AWSElementalMediaTailorFullAccess managed policy	Added a new AWS managed policy that allows full access to MediaTailor resources.	November 10, 2021
New confused deputy topic	Added a topic that explains how to prevent the confused deputy problem.	November 4, 2021
Prefetching ads topic	MediaTailor can now prefetch ads for ad breaks before they occur.	October 12, 2021
Added logging configuration settings for playback configurations	Use logging configuration settings to control settings related to playback configuration logs.	September 28, 2021
SCTE-35 messages for ad breaks	Added information about using segmentation_descriptor messages together with time_signal messages.	September 1, 2021
New linear playback mode	Added a new linear playback mode.	September 1, 2021
New absolute transition type	Added support for absolute transition types, which you can use to set a wall clock start time for your program on linear channels.	September 1, 2021
New channel assembly alerts topic	You can now monitor your channel assembly resources using MediaTailor alerts. When an issue or a potential issue occurs with your channel assembly resources, MediaTailor generates alerts.	July 14, 2021
Corrected channel assembly quotas for channels egress requests	Corrected quotas for channels egress requests in the MediaTailor channel assembly service.	June 29, 2021
New source location authentication type	MediaTailor now supports Secrets Manager access token authentication.	June 16, 2021
New Tier information	Added information about the modes and source types that each Tier supports.	June 13, 2021
New Source type information	For Standard channels, added information about the type of source that the program plays.	June 13, 2021
New MediaTailor live sources documentation	A live source represents a single live stream that you add to your source location. After you create your channel, you can add live sources to your source location and associate each live source with a program.	June 13, 2021
Support for additional UPID types	MediaTailor now supports ADS Information (0xE) and User Defined (0x1) segmentation UPID types.	April 15, 2021
New segmentation UPID dynamic variables	There are three new dynamic variables: scte.segmentation_upid.assetId, scte.segmentation_upid.cueData.key, and scte.segmentation_upid.cueData.value. These variables are used in conjunction with the MPU segmentation UPID type (0xC) for podbuster workflows.	April 15, 2021
New channel assembly service description	Added information about the new channel assembly service.	March 11, 2021
New MediaTailor channel assembly service documentation	Channel assembly is a new manifest-only service that allows you to create linear streaming channels using your existing video on demand (VOD) content.	March 11, 2021
Added channel assembly quotas	Added quotas for the new MediaTailor channel assembly service.	March 11, 2021
New channel assembly terms	Added terms that correspond to the new channel assembly service.	March 10, 2021
Channel assembly tagging support	Added support for tagging of channel assembly resources in AWS Elemental MediaTailor. Channels, SourceLocations, and VodSources support tagging.	March 9, 2021
New dynamic variables topic	MediaTailor now supports dynamic domain variables.	February 25, 2021
Added optional configuration alias settings	Use configuration aliases alongside domain variables to dynamically configure domains during session initialization.	February 25, 2021
New scte.segmentation_upid dynamic ad variable	Added support for the scte.segmentation_upid session data dynamic ad variable.	December 5, 2020
New ad marker passthrough topic	Ad marker passthrough is now available for HLS manifests.	October 29, 2020
Updated configuration advanced settings	Ad marker passthrough is a new playback configuration advanced setting.	October 14, 2020
New debug log mode	New topic on the DEBUG log mode.	August 14, 2020
Clarification around EXT-X-CUE-OUT duration attribute for bumpers	Updated the bumpers requirements so that for HLS the duration attribute is required for each EXT-X-CUE-OUT tag.	August 5, 2020
New bumpers topic	Added a new bumpers topic	July 27, 2020
Ad Suppression is available for DASH	Ad suppression is now available for DASH. Removed the "HLS-only" restriction from the ad suppression topic.	June 3, 2020
Update console-specific names	Updated console-specific names to reflect a newer version of the console UI.	May 1, 2020
New avail.index dynamic ad variable	Added support for the new avail.index session data dynamic ad variable.	March 13, 2020
New AdVerifications and Extensions elements	For client-side reporting, the AdVerifications and Extensions elements are supported.	March 10, 2020
Personalization threshold configuration	Added support for the personalization threshold optional configuration.	February 14, 2020
DASH VOD manifests	Added support for video on demand (VOD) DASH manifests from the origin server, with multi-period manifest output.	December 23, 2019
Console support for transcode profile name	Added description for transcode profile name in the configuration.	December 23, 2019
Updated limits tables	Updated limits for ADS redirects and ADS timeouts.	December 18, 2019
CDN best practices	Added a section about content distribution network (CDN) best practices for personalized manifests.	December 13, 2019
Document live pre-roll behaviors	Added Pre-Roll Ad Insertion section to describe how live pre-roll ads work with AWS Elemental MediaTailor.	November 26, 2019
Support for live pre-roll ads	Added support for inserting pre-roll ads at the beginning of a live stream.	September 11, 2019
Analyzing ADS logs in Amazon CloudWatch Logs insights	Added information for using the AWS Elemental MediaTailor ADS logs and CloudWatch Logs Insights to analyze your MediaTailor sessions.	August 13, 2019
New security chapter	Added a security chapter to enhance and standardize coverage.	May 23, 2019
DASH single-period manifests	Added support for single-period DASH manifests from the origin server, with multi-period manifest output.	April 4, 2019
Support for SCTE-35 UPIDs in the ADS URL	Added support for including a unique program ID (UPID) in the ad decision server (ADS) URL. This allows the ADS to provide program-level ad targeting within a live linear stream.	March 28, 2019
Client-side reporting supports companion ads	For client-side reporting, the AWS Elemental MediaTailor tracking URL response now includes companion ad metadata.	March 28, 2019
HLS ad marker documentation	Added a section that describes supported HLS ad markers.	March 1, 2019
Tagging support	Added support for tagging of configuration resources in AWS Elemental MediaTailor. Tagging allows you to identify and organize your AWS resources and control access to them and to track your AWS costs.	February 14, 2019
Added AWS CloudTrail logging information	Added topic about using CloudTrail to log actions in the AWS Elemental MediaTailor API.	February 11, 2019
Added section on playback errors	Added information about the errors that might be returned by MediaTailor during playback, in response to requests from a player or a content delivery network (CDN).	February 4, 2019
DASH base64-encoded binary	Added support for providing splicing information in manifests in base64-encoded binary, inside <scte35:Signal> <scte35:Binary> markers.	January 4, 2019
DASH time signal	Added support for providing splicing information in manifests inside <scte35:TimeSignal> markers.	December 5, 2018
DASH location support	Added support for the MPEG-DASH <Location> tag.	December 4, 2018
DASH support	Added support for MPEG-DASH manifests.	November 14, 2018
Updated limits tables	Updated limits for configurations and manifest size.	October 13, 2018
New and updated metrics	Added metrics for ad decision server (ADS) and origin timeouts, and updated the ADS and origin error definitions to include timed-out responses.	October 13, 2018
Better documentation coverage for server-side and client-side ad insertion use cases	Expanded description and examples to cover the use of dynamic ad variables for server-side ad insertion and for client-side ad insertion.	October 1, 2018
New regions	Added support for the PDX and FRA Regions.	July 18, 2018
VAST/VPAID	Added information about VAST and VPAID.	March 16, 2018
CloudWatch	Added information about available CloudWatch metrics, namespaces, and dimensions.	March 16, 2018
New regions	Added support for the Asia Pacific (Singapore), Asia Pacific (Sydney), and Asia Pacific (Tokyo) Regions.	February 8, 2018
Default Amazon CloudFront distribution paths	Added the list of paths for the Amazon CloudFront distribution where AWS Elemental MediaTailor stores ads.	February 6, 2018
IAM policy information	Added IAM policy information specific to AWS Elemental MediaTailor. Added instructions for creating non-admin roles with limited permissions.	January 3, 2018
First release	First release of this documentation.	November 27, 2017

Note

• The AWS Media Services are not designed or intended for use with applications or in situations requiring fail‐safe performance, such as life safety operations, navigation or communication systems, air traffic control, or life support machines in which the unavailability, interruption or failure of the services could lead to death, personal injury, property damage or environmental damage.