In de <DealList> staan de belangrijkste commerciële gegevens voor elke release, zoals de gebieden waarin de release kan worden aangeboden, de gebruiksrechten en de begin- en einddatum voor elke release. Elk element van een <ReleaseDeal> geeft de deals voor een release uit de <ReleaseList> aan. Hiernaar wordt verwezen met de <ReleaseReference>.
Deals alleen voor YouTube Premium opgeven
Op YouTube werkt streaming per track. We kunnen alleen deals voor afzonderlijke tracks verwerken met het <ReleaseType> TrackRelease.
De <DealTerms> voor een track moeten YouTube rechten geven voor het streamen met abonnementen en advertenties. De voorwaarden moeten 2 <CommercialModelType>-elementen (SubscriptionModel en AdvertisingmentSupportedModel) bevatten met het <UseType> Stream of OnDemandStream. Deals voor andere soorten releases en andere dealvoorwaarden worden genegeerd.
Als in de <DealTerms> geen startdatum voor de geldigheidsperiode staat, wordt de deal geldig zodra we het ERN-bericht hebben gekregen. Als in de <DealTerms> geen einddatum staat, is de deal onbeperkt geldig (zolang deze niet wordt gewijzigd). De video wordt automatisch gepubliceerd op de <StartDate> (of <StartDateTime> indien ingevuld) en voor de duur van de <ValidityPeriod>.
<TerritoryCode>. Deze ISO-norm is recenter dan de ISO 3166-1-norm die is opgenomen in de ERN-norm van DDEX. Landcodes die niet meer geldig zijn volgens ISO 3166-1 alpha-2, worden genegeerd.Het volgende voorbeeld geeft de <DealList> weer voor één track met verschillende releasedatums in de Verenigde Staten en 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>
Deals alleen voor Content ID opgeven
Als je een referentiebestand wilt maken voor Content ID, moet <Deal> voor de track het overeenkomstbeleid aangeven dat YouTube moet toepassen op content die is geüpload door andere gebruikers. Zo pas je een overeenkomstbeleid toe op je referentiebestand:
- Verwijs naar een bestaand opgeslagen beleid vanuit je CMS-account met de tag
<DealReference>, of - Definieer een aangepast overeenkomstbeleid met de tag
<RightsClaimPolicy>
Een opgeslagen overeenkomstbeleid toepassen
Als je een opgeslagen overeenkomstbeleid wilt toepassen, gebruik je de tag <DealReference> met de beleidsnaam. Deze vind je op de pagina Beleid van je CMS-account. Je opgeslagen beleid begint met YT_MATCH_POLICY:.
Als je bijvoorbeeld het beleid 'Mijn opgeslagen beleid' in CMS hebt, kun je dit toepassen met de onderstaande code.
<ReleaseDeal> <DealReleaseReference>R0</DealReleaseReference>
<Deal>
<DealReference>YT_MATCH_POLICY:Mijn opgeslagen beleid</DealReference>
</Deal>
</ReleaseDeal>
Als je het standaard overeenkomstbeleid van je CMS-account wilt gebruiken, gebruik je de onderstaande code om <DealReference> in te stellen op YT_DEFAULT_MATCH_POLICY.
<ReleaseDeal>
<DealReleaseReference>R0</DealReleaseReference>
<Deal>
<DealReference>YT_DEFAULT_MATCH_POLICY</DealReference>
</Deal>
</ReleaseDeal>
Meer informatie over hoe je een opgeslagen overeenkomstbeleid instelt
Een aangepast overeenkomstbeleid definiëren
Als je een aangepast overeenkomstbeleid wilt toepassen, voeg je een <RightsClaimPolicy> toe met <CommercialModelType> ingesteld op RightsClaimModel en <UseType> ingesteld op UserMakeAvailableUserProvided.
In onderstaande XML wordt het overeenkomstbeleid Inkomsten genereren toegepast, ongeacht de locatie van de consument:
<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>
Je kunt ook voorwaardelijk beleid toepassen met de tag <Condition>. Een voorwaardelijk beleid wordt alleen toegepast als de duur of het percentage van de overeenkomst hoger/lager is dan een specifieke grenswaarde.
In de XML hieronder wordt het overeenkomstbeleid Inkomsten genereren toegepast, maar alleen als de overeenkomst groter is dan 90% van de duur van het referentiebestand:
<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>
Gecombineerde deals voor YouTube Premium en Content ID
- Als je een geluidsopname voor zowel Content ID als YouTube Premium wilt aanzetten, stuur je een Audio Album-feed met zowel YouTube als YouTube_ContentID als MessageRecipients. Voeg deals toe voor zowel Content ID als YouTube Premium.
- Als je een muziekvideo voor zowel Content ID als YouTube Premium mogelijk wilt maken, stuur je een Video Single-feed met zowel YouTube als YouTube_ContentID als MessageRecipients. Voeg deals toe voor zowel Content ID als YouTube Premium.
Als je <DealTerms> voor YouTube Premium en Content ID wilt combineren in één feed met het Audio Album-profiel, moeten beide dealsets zijn gekoppeld aan de releases waarvoor <ReleaseType> is ingesteld op TrackRelease.
Met het onderstaande XML-fragment wordt een track wereldwijd aangezet voor zowel YouTube Premium als 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>
Deals alleen voor YouTube Creator Music opgeven
Als je licentiestrategieën voor Creator Music wilt leveren, gebruik je de tag <DealReference> om naar een opgeslagen licentiestrategie in je CMS-account te verwijzen. Je kunt voor elke geluidsopname één kanaalgebaseerde licentiestrategie en één platformgebaseerde licentiestrategie instellen.
Dit XML-voorbeeld toont hoe je een platformgebaseerde en een kanaalgebaseerde licentiestrategie instelt:
<DealList>
</ReleaseDeal>
<DealReleaseReference>R0</DealReleaseReference>
<Deal>
<DealReference>YT_PLATFORM_LICENSE_STRATEGY:Naam van opgeslagen platformgebaseerde strategie</DealReference>
<DealReference>YT_CHANNEL_LICENSE_STRATEGY:Naam van opgeslagen kanaalgebaseerde strategie</DealReference>
</Deal>
</ReleaseDeal>
</DealList>
Gecombineerde deals voor YouTube Premium, Content ID en Creator Music
Om <DealTerms> voor YouTube Premium, Content ID en Creator Music te combineren in één feed met het Audio Album-profiel, moeten er 3 dealsets worden gekoppeld aan de releases met <ReleaseType> ingesteld op Trackrelease.
In het XML-voorbeeld hieronder wordt een track wereldwijd aangezet voor YouTube Premium en Content ID. Daarnaast worden kanaal- en platformgebaseerde licentiestrategieën ingesteld voor 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:Naam van opgeslagen platformgebaseerde strategie</DealReference>
<DealReference>YT_CHANNEL_LICENSE_STRATEGY:Naam opgeslagen kanaalgebaseerde strategie<DealReference>
</Deal>
</ReleaseDeal>
</DealList>