INGEST User Guide
Ingest serves as a centralized location for asset ingestion visibility, detailed ingestion error notifications, parallel asset introspection, as well as S3 native ingestion provisioning. Users can manage ingestion from various sources, including external S3 buckets, MRSS Feeds, direct uploads, and others, and obtain detailed information about the status of assets or feeds.
Dashboard
The Ingest dashboard offers a high-level overview of alerts for feeds, videos, and files, providing a means to diagnose and resolve issues. The top section includes a summary of ingestion alerts, which, at a glance, indicate any necessary actions. Clicking on any item's row on the page will take you to a more detailed view on its respective page, while "View All" will take you to that section, which can also be accessed from the top row.
Ingestion Alerts - An aggregate of all feed, video, and file failures.
Feed Alerts - The statuses of all feeds for video ingestion.
Video Alerts - The statuses of all videos currently being ingested.
File Alerts - The statuses of all file assets related to video items.
Feeds
Feeds represent content pipelines that have been configured within the user's account. For more details on the available ingestion paths, please refer to the Content Delivery Guidelines.
From the Feeds page, users have access to several actions. Feeds can be filtered by status, type, and title. In this view, Feeds provide the following information:
Feed Name - A useful identifying title for the feed, visible only internally.
Brand - The brand to which content from this source will be ingested. Brands can be managed in Account, and assets associated with the brand will appear in the Manage section under the brand.
Status - A green checkmark indicates that the feed is operating normally, while a red exclamation mark indicates that the feed is misconfigured or experiencing access issues.
Videos Completed - The number of successful titles ingested from this feed.
Videos Processing - The number of videos that have been successfully picked up and are queued for processing.
Videos Failed - Videos that have failed to ingest.
Updated - The timestamp indicating the last time this feed indexed new videos for ingestion.
At the far right, there is a Restart button which will reattempt any errored items immediately, and a drop down menu where a user can take the following actions:
View Videos - Takes you to the videos list associated with this feed.
View Files - Takes you to the files list of videos associated with this feed.
View Configuration - Allows you to modify the configuration of the feed.
Disable Feed - Stops the feed from running anymore, immediately. Any items in "Processing" will also be stopped.
Delete Feed - Deletes the feed from the system. Videos that have been ingested from this feed will not be deleted.
Videos
The Videos page is where the status of videos can be viewed. If a video has failed for any reason, it will be displayed at the top by default, allowing the user to click on it for more information. Videos can also be filtered by status, type, feed, title, and globally unique identifier (GUID).
Within each row is the following information:
Title - The title appears in white, with the GUID in grey beneath it. Both can be searched.
Feed Name - Indicates the feed where the video was found.
Encoding - Indicates the status of the job, whether it is currently encoding and has passed validation.
Status - Indicates whether the asset has been processed, is in progress, or has failed.
Asset Validation - This involves validation for the following files during the ingestion process. Refer to the Content Delivery Guidelines for accepted formats.
Video - Checks for minimum resolution, errors with the video file, the file type, and audio tracks.
Subtitle - Checks the format and validity of the captions file.
Artwork - Checks the resolution of the file to ensure it meets the minimum 1280x720 resolution and that the image is not blank.
Metadata - Checks for valid values used for metadata. Please see Metadata Specifications and the Content Delivery samples for more details.
The user actions available in this section are as follows, and they are contextual based on the status of the video:
Delete Video - If a video has failed to ingest and is no longer planned to be ingested, this action removes the video from the processing queue and the videos page.
View Exception - Provides details on why the asset failed to ingest. Please refer to the Error Troubleshooting section below for more details.
Preview Video - If a video is successfully ingested, clicking this action will take you directly to its edit page in Manage.
Reprocess Video - If there are updated assets available for processing, this action will reprocess the video. Will not add captions on a video previously processed without them.
Update Metadata - Triggers an updated pull of metadata that will populate to the video. Does not require the usage of the "metadata_update_date" field that can be used for bulk updates.
Files
The Files section displays the status of individual assets within a video item. Files can be clicked into to display more details on why an asset failed, providing the user with information on how to resolve the issues. Files can be filtered by status, type, feed, file name, and whether or not the file is correctly referenced in the metadata manifest. If a file exists in a bucket but is not used, it is identified as an orphaned file.
Metadata Best Practices
Metadata Updates: Use the metadata_update_date field to append metadata or add supplemental assets (such as adding new licensing windows or artwork).
Make sure the date is more recent than the last the last update date and not in the future.
GUID cannot be updated as this is what value is being checked against for new metadata.
Existing artwork and localizations will not be deleted if new ones are added.
Fields supporting only one value, such as content_format, will be replaced rather than appended.
Artwork Specifications: The Artwork tab allows multiple images per video. Leaving thumbnail_type blank indicates a Default image; however, a video supports only one default that must be 16:9. Other accepted types are Texted and Textless. The system automatically detects aspect ratios, supporting: 16:9, 4:3, 3:4, 5:9, 2:3, 4:1, 2:1, and 1:1.
Localization: Localized metadata displays specific ratings or artwork based on the target language and region. You may use single rows or provide multiple ratings/artworks per language by passing JSON objects. Please reference the examples above for correct JSON formatting.
Licensing: Licensing windows should not conflict with each other, or the metadata will fail to ingest properly. Additional windows can be added via the metadata_update_date.