MediaTailor ad skipping reference guide
This section provides comprehensive reference information about ad skip reasons and links to related documentation for AWS Elemental MediaTailor. Use this reference guide to understand the specific meanings of different skip reasons and find additional troubleshooting resources.
Complete ad skip reasons reference
MediaTailor logs specific reasons why ads are skipped in the FILLED_AVAIL
event log message from the MediaTailor/AdDecisionServerInteractions
log
group.
Skip reason | Description |
---|---|
NEW_CREATIVE |
The ad has not been transcoded yet. This occurs when MediaTailor encounters a new ad creative that requires transcoding before insertion. |
PROFILE_NOT_FOUND |
The MediaConvert transcode profile associated with the session's configuration does not exist, preventing ad preparation. |
TRANSCODE_ERROR |
The ad transcode process encountered an error and failed to complete. |
TRANSCODE_IN_PROGRESS |
The ad transcode is still in progress and not yet ready for insertion. |
INTERNAL_ERROR |
An internal MediaTailor error occurred while handling the ad, preventing insertion. |
AVAIL_DURATION_EXCEEDED |
The ad does not fit within the remaining duration of the ad break. |
LEFTOVER_AVAIL_EXCEEDED_THRESHOLD |
The cumulative duration of all ads that could have been inserted does not meet the personalization threshold configured for the session. |
VAST_PARSING_ERROR |
The VAST response from the ad decision server contains errors or is malformed. |
ADS_TIMEOUT |
The ad decision server did not respond within the configured timeout period. |
MEDIA_FILE_UNAVAILABLE |
The ad media files specified in the VAST response are not accessible. |
SESSION_INITIALIZATION_FAILED |
The MediaTailor session failed to initialize properly, often due to incorrect session variables. |
EARLY_CUE_IN |
The ad break ended earlier than expected due to an early cue-in signal, preventing the ad from being fully inserted. |
NO_VARIANT_MATCH |
The ad creative does not have a variant that matches the content stream's encoding parameters (bitrate, resolution, codec). |
NO_MODEL_CREATIVE_MATCH |
The ad creative does not match the expected model or format requirements for the current playback configuration. |
REJECTED_REPLICA_VAST |
The VAST response was rejected due to replica or duplicate content detection policies. |
INVALID_VAST_WRAPPER_AD |
The VAST wrapper ad contains invalid or malformed wrapper elements that prevent successful ad insertion. |
IMPORT_ERROR |
An error occurred during the ad import process, preventing the ad from being processed for insertion. |
IMPORT_IN_PROGRESS |
The ad import process is currently in progress and has not completed yet. |
Related resources
For more information on troubleshooting ad skipping issues, refer to these related topics:
-
MediaTailor dynamic ad variables for ADS requests - Comprehensive guide to dynamic ad variables in MediaTailor
-
Prefetching ads - How to implement ad prefetching to prevent transcoding-related skipping
-
Monitoring AWS Elemental MediaTailor with Amazon CloudWatch metrics - Monitoring MediaTailor with CloudWatch metrics
-
Viewing AWS Elemental MediaTailor logs - How to view and analyze MediaTailor logs
-
Troubleshooting MediaTailor event flow issues - Understanding the ad insertion event flow