Deal list

These features are only available to partners using YouTube's Content Manager to manage their copyrighted content.

The <DealList> defines the key commercial information for each release, such as in which territories the release can be made available, usage rights and the start/end date for each release. Each <ReleaseDeal> element defines the deals for a release from the <ReleaseList>, which is referenced by its <ReleaseReference>.

Specify deals for YouTube Premium only

On YouTube, streaming operates on a per-track basis. We can only process deals for individual tracks where the <ReleaseType> is TrackRelease.

The <DealTerms> for a track must grant YouTube rights for subscription and advertising-supported streaming. The terms must include two <CommercialModelType> elements (SubscriptionModel and AdvertisementSupportedModel) with the <UseType> of Stream or OnDemandStream. YouTube ignores any deals for other release types and any other deal terms.

If the <DealTerms> don't specify a start date for the validity period, the deal becomes valid as soon as we receive the ERN message. If the <DealTerms> don't specify an end date, the deal is valid indefinitely or until further notice. The video is automatically published on the <StartDate> (or <StartDateTime> if provided) and for the duration of the <ValidityPeriod>.

For details on start/end dates and time zone handling for multiple-territory releases, please refer to the DDEX documentation.

YouTube supports ISO 3166-1 alpha-2 country codes for the <TerritoryCode> element. This ISO standard is newer than the ISO 3166-1 standard specified in the DDEX ERN standard. If you include a country code that is no longer valid in ISO 3166-1 alpha-2, YouTube ignores it.

The following example shows the <DealList> for a single track that has different release dates in the United Kingdom and France.

<DealList>

<ReleaseDeal>

<DealReleaseReference>R1</DealReleaseReference>

<Deal>

<DealTerms>

<CommercialModelType>SubscriptionModel</CommercialModelType>

<CommercialModelType>AdvertisementSupportedModel</CommercialModelType>

<Usage>

<UseType>OnDemandStream</UseType>

</Usage>

<TerritoryCode>UK</TerritoryCode>

<ValidityPeriod>

<StartDate>2010-05-18</StartDate>

</ValidityPeriod>

</DealTerms>

</Deal>

<Deal>

<DealTerms>

<CommercialModelType>SubscriptionModel</CommercialModelType>

<CommercialModelType>AdvertisementSupportedModel</CommercialModelType>

<Usage>

<UseType>OnDemandStream</UseType>

</Usage>

<TerritoryCode>FR</TerritoryCode>

<ValidityPeriod>

<StartDate>2010-05-20</StartDate>

</ValidityPeriod>

</DealTerms>

</Deal>

</ReleaseDeal>

</DealList>

Specify deals for Content ID only

To enable a Sound Recording for Content ID only, send a Single Resource Release feed or an Audio Album feed with YouTube_ContentID as the only MessageRecipient.

To create a reference file for Content ID, the <Deal> for the track must specify the match policy that YouTube should apply to matching content uploaded by other users. To apply a match policy to your reference file, you can:

Reference an existing saved policy from your CMS account using the <DealReference> tag
Define a custom match policy using the <RightsClaimPolicy> tag

Apply a saved match policy

To apply a saved match policy, use the <DealReference> tag with the policy name, found within the Policies page of your CMS account. Your saved policy will begin with YT_MATCH_POLICY:.

For example, if you have a policy named 'My Saved Policy' in CMS, you can apply it using the code below.

<ReleaseDeal>

<DealReleaseReference>R0</DealReleaseReference>

<Deal>

<DealReference>YT_MATCH_POLICY:My Saved Policy</DealReference>

</Deal>

</ReleaseDeal>

To use the default match policy from your CMS account, use the code below to set the <DealReference> to YT_DEFAULT_MATCH_POLICY.

<ReleaseDeal>

<DealReleaseReference>R0</DealReleaseReference>

<Deal>

<DealReference>YT_DEFAULT_MATCH_POLICY</DealReference>

</Deal>

</ReleaseDeal>

Learn how to set up a saved match policy.

Define a custom match policy

To apply a custom match policy, you must include a <RightsClaimPolicy> with <CommercialModelType> set to RightsClaimModel and the <UseType> set to UserMakeAvailableUserProvided.

The XML below will apply a match policy of monetise regardless of the location of the consumer:

<DealTerms>

<CommercialModelType>RightsClaimModel</CommercialModelType>

<Usage>

<UseType>UserMakeAvailableUserProvided</UseType>

</Usage>

<TerritoryCode>Worldwide</TerritoryCode>

<ValidityPeriod /> 

<RightsClaimPolicy>

<RightsClaimPolicyType>Monetise</RightsClaimPolicyType>

</RightsClaimPolicy>

</DealTerms>

You can also apply conditional policies using the <Condition> tag. Conditional policies only apply if the match duration or percentage exceeds/falls under a specified threshold.

The XML below will apply a match policy of monetise but only if the duration of the match is greater than 90% of the duration of the reference file:

<DealTerms>

<CommercialModelType>RightsClaimModel</CommercialModelType>

<Usage>

<UseType>UserMakeAvailableUserProvided</UseType>

</Usage>

<TerritoryCode>Worldwide</TerritoryCode>

<ValidityPeriod /> 

<RightsClaimPolicy>

<Condition>

<Value>90</Value>

<Unit>Percent</Unit>

<ReferenceCreation>ReferenceResource</ReferenceCreation>

<RelationalRelator>MoreThanOrEqualTo</RelationalRelator>

</Condition>

<RightsClaimPolicyType>Monetise</RightsClaimPolicyType>

</RightsClaimPolicy>

</DealTerms>

Combined deals for YouTube Premium and Content ID

To enable a Sound Recording for both Content ID and YouTube Premium, send an Audio Album feed that has both YouTube and YouTube_ContentID as MessageRecipients. Include deals for Content ID and YouTube Premium.
To enable a Music Video for both Content ID and YouTube Premium, send a Video Single feed that has both YouTube and YouTube_ContentID as MessageRecipients. Include deals for Content ID and YouTube Premium.

To combine YouTube Premium and Content ID <DealTerms> into a single feed using the Audio Album profile, both sets of deals should be linked to the releases that have <ReleaseType> set to TrackRelease.

The XML snippet below will enable a track worldwide for both YouTube Premium and Content ID.

<DealList>

<ReleaseDeal>

<DealReleaseReference>R1</DealReleaseReference>

<Deal>

<DealTerms>

<CommercialModelType>SubscriptionModel</CommercialModelType>

<CommercialModelType>AdvertisementSupportedModel</CommercialModelType>

<Usage>

<UseType>OnDemandStream</UseType>

</Usage>

<TerritoryCode>Worldwide</TerritoryCode>

<ValidityPeriod>

<StartDate>2016-05-18</StartDate>

</ValidityPeriod>

</DealTerms>

</Deal>

<Deal>

<DealTerms>

<CommercialModelType>RightsClaimModel</CommercialModelType>

<Usage>

<UseType>UserMakeAvailableUserProvided</UseType>

</Usage>

<TerritoryCode>Worldwide</TerritoryCode>

<ValidityPeriod/>

<RightsClaimPolicy>

<RightsClaimPolicyType>Monetise</RightsClaimPolicyType>

</RightsClaimPolicy>

</DealTerms>

</Deal>

</ReleaseDeal>

</DealList>

Specify deals for YouTube Creator Music only

To enable an existing Sound Recording for Creator Music only, send a Single Resource Release feed or an Audio Album feed with YouTube_CreatorMusic as the only MessageRecipient. The Sound Recording asset must already exist in Content Manager for this feed to be accepted.

To deliver licence strategies for Creator Music, use the <DealReference> tag to refer to a saved licence strategy from your CMS account. You can set one channel licence strategy and one platform licence strategy for each Sound Recording.

This XML example shows how to set both a platform and a channel licence strategy:

<DealList>

<ReleaseDeal>

<DealReleaseReference>R0</DealReleaseReference>

<Deal>

<DealReference>YT_PLATFORM_LICENCE_STRATEGY:Saved Platform Strategy Name</DealReference>

<DealReference>YT_CHANNEL_LICENCE_STRATEGY:Saved Channel Strategy Name</DealReference>

</Deal>

</ReleaseDeal>

</DealList>

Combined deals for YouTube Premium, Content ID and Creator Music

To enable a Sound Recording for YouTube Premium, Content ID and Creator Music, you must send an Audio Album feed that has three MessageRecipients (YouTube, YouTube_ContentID and YouTube_CreatorMusic). Include deals for Content ID, YouTube Premium and Creator Music.

To combine YouTube Premium, Content ID and Creator Music <DealTerms> into a single feed using the Audio Album profile, three sets of deals should be linked to the releases that have <ReleaseType> set to TrackRelease.

The XML example below enables a track worldwide for both YouTube Premium and Content ID, and it sets channel- and platform-based licence strategies for Creator Music.

<DealList>

<ReleaseDeal>

<DealReleaseReference>R1</DealReleaseReference>

<Deal>

<DealTerms>

<CommercialModelType>AdvertisementSupportedModel</CommercialModelType>

<CommercialModelType>SubscriptionModel</CommercialModelType>

<Usage>

<UseType>OnDemandStream</UseType>

</Usage>

<TerritoryCode>Worldwide</TerritoryCode>

<ValidityPeriod>

<StartDate>2017-01-12</StartDate>

</ValidityPeriod>

</DealTerms>

</Deal>

<Deal>

<DealTerms>

<CommercialModelType>RightsClaimModel</CommercialModelType>

<Usage>

<UseType>UserMakeAvailableUserProvided</UseType>

</Usage>

<TerritoryCode>Worldwide</TerritoryCode>

<ValidityPeriod/>

<RightsClaimPolicy>

<RightsClaimPolicyType>Monetise</RightsClaimPolicyType>

</RightsClaimPolicy>

</DealTerms>

</Deal>

<Deal>

<DealReference>YT_PLATFORM_LICENCE_STRATEGY:Saved Platform Strategy Name</DealReference>

<DealReference>YT_CHANNEL_LICENCE_STRATEGY:Saved Channel Strategy Name</DealReference>

</Deal>

</ReleaseDeal>

</DealList>

Was this helpful?

How can we improve it?

Deal list

Specify deals for YouTube Premium only

Specify deals for Content ID only

Apply a saved match policy

Define a custom match policy

Combined deals for YouTube Premium and Content ID

Specify deals for YouTube Creator Music only

Combined deals for YouTube Premium, Content ID and Creator Music

Was this helpful?

Need more help?

Try these next steps: