The message samples demonstrate how to communicate new releases and takedowns for streaming with ads, YouTube Premium and Content ID. All samples are based on DDEX ERN version 3.8.
Sound Recordings - Album deliveries
These sample files follow the Audio Album profile and should be used for delivering on a per-release basis. Learn how to choose a release profile.
| New Release Sample | Takedown Sample | |
|---|---|---|
| YouTube Premium | 721620118165_yt_premium.xml | 721620118165_yt_premium_takedown.xml |
| Content ID | 721620118165_content_id.xml | 721620118165_content_id_takedown.xml |
| Combined Feed (YouTube Premium & Content ID) |
721620118165_combined.xml | 721620118165_combined_takedown.xml |
| Creator Music | Album_creatormusic_only_takedown.xml | |
| YouTube Premium, Content ID, & Creator Music Combined Feed | Album_contentid_creatormusic_combined.xml | Album_contentid_creatormusic_combined_takedown.xml |
Sound Recordings - Track deliveries
These sample files follow the Single Resource Release profile and should be used for delivering on a per-track basis. Learn how to choose a release profile.
| New Release Sample | Takedown Sample | |
|---|---|---|
| Content ID | USGCV1172318_content_id.xml | USGCV1172318_content_id_takedown.xml |
| Creator Music | SRR_CreatorMusic_only.xml | SRR_CreatorMusic_only_takedown.xml |
| Content ID & Creator Music Combined Feed | SRR_CID_CreatorMusic_Combined.xml | SRR_CID_CreatorMusic_Combined_takedown.xml |
Music Videos
These sample files follow the Video Single profile and should be used to deliver on a per-video basis.
| New Release Sample | Update Sample | |
|---|---|---|
| Music Video Upload | music_video_only.xml | music_video_only_update.xml |
| Content ID | QZ6RS1700001_music_video_content_id_only.xml | QZ6RS1700001_music_video_content_id_only_update.xml |
| Combined Feed (Music Video Upload & Content ID) |
QZ6RS1700001_music_video_content_id_combined.xml | QZ6RS1700001_music_video_content_id_combined_update.xml |
Web Videos
These sample files follow the Video Single profile and should be used to deliver on a per-video basis.
| New Release Sample | Update Sample | |
|---|---|---|
| Web Video Upload | web_video_only.xml | web_video_only_update.xml |
| Content ID | web_video_content_id_only.xml | web_video_content_id_only_update.xml |
| Combined Feed (Web Video Upload & Content ID) |
web_video_content_id_combined.xml | web_video_content_id_combined_update.xml |
<ReleaseId> element.The below table indicates when the respective <ProprietaryId> elements should be communicated.
| Video ID | Channel ID | Asset ID | |
|---|---|---|---|
| Delivering new video | Not allowed | Required | Optional |
| Claiming existing video | Required | Optional | Optional |
| Creating fingerprint from existing video | Required | Optional | Optional |
| Reference/Fingerprint only upload | Not allowed | Not allowed | Optional |
| Asset-only update | Not allowed | Not allowed | Optional |
Status reports for DDEX deliveries
Starting 2018, YouTube will transition to using the DDEX standard FtpAcknowledgementMessage for all DDEX status reports. See the ERN Choreography Standard documentation for more information on this message.
| Successful Package Report | Failed Package Report | |
|---|---|---|
| YouTube Premium | ACK_721620118178.xml | ACK_721620118178_failed.xml |
Sound Recordings – Album deliveries
These sample files follow the Audio Album profile and should be used for delivering on a per-release basis. Learn how to choose a release profile.
| YouTube Premium / Art Tracks | |
| New Release samples | Update / Takedown samples |
|---|---|
|
Album.xml: This is a standard audio album containing 4 tracks with standard AVOD and SVOD rights. This message also includes the Single.xml: This is a product with release type set to “Single” and contains 1 track, this message includes deal terms for standard AVOD and SVOD rights. EP.xml: This is a product with release type set to “EP” and contains 4 tracks, this message also includes deal terms for standard AVOD and SVOD rights. MultidiscAlbum.xml: This is an audio album containing 7 tracks on 2 “discs”, the first disc contains 4 tracks and the 2nd disc contains 3 tracks, the message includes deal terms for standard AVOD and SVOD rights. Multi-artist contributor album.xml: This is an audio album with 4 tracks and 5 different parties, track 1 has 1 party with 2 different contributor roles, track 3 has 3 different contributors with 3 distinct contributor roles, and an album release with both main and featured artists. The album release (R0) in this message has a<DisplayArtistName> that is different from the union of the separate <DisplayArtist> components. |
Album update metadata no binaries.xml: This is a metadata only update message to update the titles for tracks 1 and 2, no binary files are included in this update. Album Takedown Immediate.xml: This is an update message with no deal composites for immediate takedown. Album Takedown w endate.xml: This is an update message with deal composites with end dates for takedown on future date. |
| Content ID | |
| Album with rights for Art Tracks and Content ID policies with different start dates | Album with rights and policies with different start dates.xml: a sample message that contains both Art Tracks and Content ID with different start dates for policies. |
|---|---|
| Album with policy in message and referencing a saved policy | Album with policy in message and reference to saved policy.xml: a sample message for an album that contains a monetize policy in message and also references a saved policy in CMS. |
| Add asset label | Album add asset label.xml: a sample message adding an asset label to track 1. |
| Add custom ID | Album add custom ID.xml: a sample message adding a custom ID to track 1. |
| Update ownership territories | Album update ownership territories.xml: a sample message updating ownership territories to US, CA and MX. |
| Clear asset labels and update metadata | Album clear asset label and update metadata.xml: a sample message demonstrating how to clear all existing asset labels and also update existing artist name on track 1. |
| Add new Sound Recording share to existing asset | Album add new SR share with ISRC to existing asset.xml: sample message adding a new SR share with new ISRC to an existing asset. |
| Album with claim conditions based on time duration and percentage match |
Album AT with time and percent claim conditions.xml: a sample message containing an audio album with 4 tracks with AVOD and SVOD rights and sound recording ownership, with 4 different Content ID deals for each track.
|
| Content ID-Full takedown | Album remove all ownership / takedown.xml: a sample message removing all ownership and resulting in a takedown for Content ID. |
Sound Recordings – Track deliveries
These sample files follow the Single Resource Release profile and should be used for delivering on a per-track basis. Learn how to choose a release profile.
| New Release samples | Update / Takedown samples | |
| Content ID |
Single resource release for CID.xml: a sample message for a single resource release for Content ID with rights controller referencing a saved policy. Single resource release for CID with related release.xml: a sample message for a single resource release for Content ID with rights controller and related release composite to communicate album metadata. |
Single resource release takedown.xml: a sample message to takedown a single resource release, removing ownership information and omitting deal composite. |
|---|
Videos
These are sample messages with a Video Single profile used for the delivery of videos.
| Videos | |
|---|---|
| VideoSingle.xml | This message is for a video with both AVOD and SVOD rights. |
| VideoSingle update no binary.xml | This message demonstrates how to update metadata for a video without the binary file. |
| VideoSingleWRelatedResource.xml | This message is for a video with both AVOD and SVOD rights with relationship info for the sound recording with ISRC US1111111111. |
| Video CID related release.xml | This message is for a video that references a saved policy and relates to a product with a specific UPC/EAN. |
| VideoSingle AVOD SVOD CID.xml | This message is for a video with AVOD, SVOD rights and claim policy with duration and percentage conditions. |