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 Albumprofile 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 Releaseprofile 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 .
Album.xml : This is a standard audio album containing 4 tracks with standard AVOD and SVOD rights.
This message also includes the <ReleaseVisibility>
composite for the album specifying when metadata, cover art and track listing can be displayed.
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.
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.
- Monetize if match > 75 sec
- Monetize if match >= 60 sec
- Monetize if match > 90%
- Block if match > 80%
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. |
