The <DealList>
defines the key commercial information for each release, such as 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>
.
<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 States and Canada.
<DealList>
<ReleaseDeal>
<DealReleaseReference>R1</DealReleaseReference>
<Deal>
<DealTerms>
<CommercialModelType>SubscriptionModel</CommercialModelType>
<CommercialModelType>AdvertisementSupportedModel</CommercialModelType>
<Usage>
<UseType>OnDemandStream</UseType>
</Usage>
<TerritoryCode>US</TerritoryCode>
<ValidityPeriod>
<StartDate>2010-05-18</StartDate>
</ValidityPeriod>
</DealTerms>
</Deal>
<Deal>
<DealTerms>
<CommercialModelType>SubscriptionModel</CommercialModelType>
<CommercialModelType>AdvertisementSupportedModel</CommercialModelType>
<Usage>
<UseType>OnDemandStream</UseType>
</Usage>
<TerritoryCode>CA</TerritoryCode>
<ValidityPeriod>
<StartDate>2010-05-20</StartDate>
</ValidityPeriod>
</DealTerms>
</Deal>
</ReleaseDeal>
</DealList>
Specify deals for Content ID only
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, or - 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 Monetize regardless of the location of the consumer:
<DealTerms>
<CommercialModelType>RightsClaimModel</CommercialModelType>
<Usage>
<UseType>UserMakeAvailableUserProvided</UseType>
</Usage>
<TerritoryCode>Worldwide</TerritoryCode>
<ValidityPeriod /> <!-- Valid immediately and until further notice. -->
<RightsClaimPolicy>
<RightsClaimPolicyType>Monetize</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 Monetize, 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 /> <!-- Valid immediately and until further notice. -->
<RightsClaimPolicy>
<Condition>
<Value>90</Value>
<Unit>Percent</Unit>
<!-- Specifies whether the percentage refers to the reference material or UGC (ReferenceResource or ConsumerResource)-->
<!-- Added in ERN v3.8.2 -->
<ReferenceCreation>ReferenceResource</ReferenceCreation>
<RelationalRelator>MoreThanOrEqualTo</RelationalRelator>
</Condition>
<RightsClaimPolicyType>Monetize</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>
<!-- This deal is for YouTube Premium. -->
<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>
<!-- This deal is for Content ID. -->
<Deal>
<DealTerms>
<CommercialModelType>RightsClaimModel</CommercialModelType>
<Usage>
<UseType>UserMakeAvailableUserProvided</UseType>
</Usage>
<TerritoryCode>Worldwide</TerritoryCode>
<ValidityPeriod/>
<RightsClaimPolicy>
<RightsClaimPolicyType>Monetize</RightsClaimPolicyType>
</RightsClaimPolicy>
</DealTerms>
</Deal>
</ReleaseDeal>
</DealList>
Specify deals for YouTube Creator Music only
To deliver license strategies for Creator Music, use the <DealReference>
tag to refer to a saved license strategy from your CMS account. You can set one channel license strategy and one platform license strategy for each sound recording.
This XML example shows how to set both a platform and a channel license strategy:
<DealList>
<ReleaseDeal>
<DealReleaseReference>R0</DealReleaseReference>
<Deal>
<DealReference>YT_PLATFORM_LICENSE_STRATEGY:Saved Platform Strategy Name</DealReference>
<DealReference>YT_CHANNEL_LICENSE_STRATEGY:Saved Channel Strategy Name</DealReference>
</Deal>
</ReleaseDeal>
</DealList>
Combined deals for YouTube Premium, Content ID, 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 sets channel and platform-based license strategies for Creator Music.
<DealList>
<ReleaseDeal>
<DealReleaseReference>R1</DealReleaseReference>
<!-- This deal is for YouTube Premium. -->
<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>
<!-- This deal is for Content ID. -->
<Deal>
<DealTerms>
<CommercialModelType>RightsClaimModel</CommercialModelType>
<Usage>
<UseType>UserMakeAvailableUserProvided</UseType>
</Usage>
<TerritoryCode>Worldwide</TerritoryCode>
<ValidityPeriod/>
<RightsClaimPolicy>
<RightsClaimPolicyType>Monetize</RightsClaimPolicyType>
</RightsClaimPolicy>
</DealTerms>
</Deal>
<!-- This deal is for Creator Music -->
<Deal>
<DealReference>YT_PLATFORM_LICENSE_STRATEGY:Saved Platform Strategy Name</DealReference>
<DealReference>YT_CHANNEL_LICENSE_STRATEGY:Saved Channel Strategy Name</DealReference>
</Deal>
</ReleaseDeal>
</DealList>