<DealList> definește informațiile comerciale esențiale pentru fiecare lansare, precum teritoriile în care poate fi disponibilă, drepturile de utilizare și data de începere / încheiere a fiecărei lansări. Fiecare element <ReleaseDeal> definește ofertele pentru o lansare din <ReleaseList>, la care se face referire prin <ReleaseReference>.
Specifică oferte doar pentru YouTube Premium
Pe YouTube, streamingul funcționează în funcție de înregistrare audio. Putem să procesăm ofertele doar pentru înregistrări audio individuale, unde <ReleaseType> este TrackRelease.
<DealTerms> pentru o înregistrare audio trebuie să acorde platformei YouTube drepturile pentru abonare și streaming cu publicitate. Condițiile trebuie să includă două elemente <CommercialModelType> (SubscriptionModel și AdvertisementSupportedModel) cu valoarea <UseType> Stream sau OnDemandStream. YouTube ignoră ofertele pentru alte tipuri de lansări și orice alte condiții ale ofertelor.
Dacă <DealTerms> nu specifică nicio dată de început pentru perioada de valabilitate, oferta va deveni validă imediat ce primim mesajul ERN. Dacă în <DealTerms> nu este specificată nicio dată finală, oferta este validă pe perioadă nedeterminată sau până la noi indicații. Videoclipul va fi publicat automat pe <StartDate> (sau <StartDateTime> dacă este inclus) și pentru durata <ValidityPeriod>.
<TerritoryCode>. Acest standard ISO este mai nou decât standardul ISO 3166-1 specificat în standardul DDEX ERN. Dacă incluzi un cod de țară care nu mai este valid în ISO 3166-1 alpha-2, YouTube îl va ignora.Exemplul următor prezintă <DealList> pentru o înregistrare audio individuală cu date de lansare diferite în Statele Unite și 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>
Specifică oferte doar pentru Content ID
Pentru a crea un fișier de referință pentru Content ID, eticheta <Deal> a înregistrării audio trebuie să menționeze politica privind potrivirile pe care YouTube trebuie să o aplice conținutului încărcat de alți utilizatori care se potrivește. Pentru a aplica o politică privind potrivirile în fișierul de referință, poți:
- să consulți o politică salvată existentă din contul CMS, folosind eticheta
<DealReference>sau - să definești o politică privind potrivirile personalizată folosind eticheta
<RightsClaimPolicy>.
Aplică o politică privind potrivirile salvată
Pentru a aplica o politică privind potrivirile salvată, folosește eticheta <DealReference> cu numele politicii, aflată pe pagina Politici a contului CMS. Politica salvată va începe cu „YT_MATCH_POLICY:”.
De exemplu, dacă ai o politică numită „Politica mea salvată” în CMS, o poți aplica folosind codul de mai jos.
<ReleaseDeal> <DealReleaseReference>R0</DealReleaseReference>
<Deal>
<DealReference>YT_MATCH_POLICY:My Saved Policy</DealReference>
</Deal>
</ReleaseDeal>
Pentru a folosi politica privind potrivirile prestabilită din contul CMS, folosește codul de mai jos pentru a seta <DealReference> la „YT_DEFAULT_MATCH_POLICY”.
<ReleaseDeal>
<DealReleaseReference>R0</DealReleaseReference>
<Deal>
<DealReference>YT_DEFAULT_MATCH_POLICY</DealReference>
</Deal>
</ReleaseDeal>
Află cum să configurezi o politică privind potrivirile salvată.
Definește o politică privind potrivirile personalizată
Pentru a aplica o politică privind potrivirile personalizată, trebuie să incluzi o etichetă <RightsClaimPolicy> cu <CommercialModelType> setat la RightsClaimModel și cu <UseType> setat la UserMakeAvailableUserProvided.
În exemplul XML de mai jos, se va aplica o politică privind potrivirile de generare de bani, indiferent de locația clientului:
<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>
Poți aplica politici condiționate și folosind eticheta <Condition>. Politicile condiționate se aplică numai dacă durata sau procentajul potrivirii scade sub pragul specificat sau îl depășește.
În exemplu XML de mai jos, se va aplica o politică privind potrivirile de generare de bani, dar numai dacă durata potrivirii depășește 90 % din durata fișierului de referință:
<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>
<!-- Specifică dacă procentul se referă la materialul de referință sau la CGU (ReferenceResource sau ConsumerResource)-->
<!-- Adăugat în ERN v3.8.2 -->
<ReferenceCreation>ReferenceResource</ReferenceCreation>
<RelationalRelator>MoreThanOrEqualTo</RelationalRelator>
</Condition>
<RightsClaimPolicyType>Monetize</RightsClaimPolicyType>
</RightsClaimPolicy>
</DealTerms>
Oferte combinate pentru YouTube Premium și Content ID
- Pentru a activa o Înregistrare audio pentru Content ID și YouTube Premium, trimite un feed Audio Album (Album audio) care are YouTube și YouTube_ContentID ca MessageRecipients. Include oferte pentru Content ID și YouTube Premium.
- Pentru a activa un videoclip muzical atât pentru Content ID, cât și pentru YouTube Premium, trimite un feed Video Single (Single video), care are YouTube și YouTube_ContentID ca MessageRecipients. Include oferte pentru Content ID și YouTube Premium.
Pentru a combina <DealTerms> YouTube Premium și Content ID într-un singur feed folosind profilul Audio Album (Album audio), ambele seturi de oferte trebuie să fie asociate lansărilor care au <ReleaseType> setat la TrackRelease.
Fragmentul XML de mai jos va activa o înregistrare audio la nivel mondial atât pentru YouTube Premium, cât și pentru Content ID.
<DealList>
<ReleaseDeal>
<DealReleaseReference>R1</DealReleaseReference>
<!-- Această ofertă este pentru 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>
<!-- Această ofertă este pentru 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>
Specifică ofertele doar pentru YouTube Creator Music
Pentru a livra strategii de licență pentru Creator Music, folosește eticheta <DealReference> pentru a face referire la o strategie de licență salvată din contul CMS. Poți seta o strategie de licență a canalului și o strategie de licență a platformei pentru fiecare înregistrare audio.
Acest exemplu XML arată cum să setezi o strategie de licență a platformei și a canalului:
<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>
Oferte combinate pentru YouTube Premium, Content ID și Creator Music
Pentru a combina <DealTerms> YouTube Premium, Content ID și Creator Music într-un singur feed folosind profilul Audio Album (Album audio), trei seturi de oferte trebuie asociate lansărilor care au <ReleaseType> setat la TrackRelease.
Exemplul de XML de mai jos activează o înregistrare audio în întreaga lume pentru YouTube Premium și Content ID și stabilește strategiile de licență pentru canal și platformă pentru Creator Music.
<DealList>
<ReleaseDeal>
<DealReleaseReference>R1</DealReleaseReference>
<!-- Această ofertă este pentru 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>
<!-- Această ofertă este pentru Content ID. -->
<Deal>
<DealTerms>
<CommercialModelType>RightsClaimModel</CommercialModelType>
<Usage>
<UseType>UserMakeAvailableUserProvided</UseType>
</Usage>
<TerritoryCode>Worldwide</TerritoryCode>
<ValidityPeriod/>
<RightsClaimPolicy>
<RightsClaimPolicyType>Monetize</RightsClaimPolicyType>
</RightsClaimPolicy>
</DealTerms>
</Deal>
<!-- Această ofertă este pentru 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>