Elenco delle offerte

Queste funzionalità sono disponibili solo per i partner che utilizzano Content Manager di YouTube per gestire i propri contenuti protetti da copyright.

L'elemento <DealList> definisce le informazioni commerciali principali per ciascuna uscita, ad esempio i territori in cui può essere resa disponibile, i diritti di utilizzo e la data di inizio/fine dell'uscita. Ogni elemento <ReleaseDeal> definisce le offerte per una delle uscite dell'elemento <ReleaseList>, indicata dal relativo elemento <ReleaseReference>.

Specificare le offerte solo per YouTube Premium

Su YouTube, ogni traccia viene presa in considerazione singolarmente ai fini dello streaming. Pertanto, possiamo elaborare solo offerte relative a singole tracce, in cui l'elemento <ReleaseType> è uguale a TrackRelease.

L'elemento <DealTerms> per una traccia deve concedere a YouTube i diritti per lo streaming supportato dalla pubblicità e su abbonamento. I termini devono includere due elementi <CommercialModelType> (SubscriptionModel e AdvertisingmentSupportedModel) con <UseType> impostato su Stream o OnDemandStream. YouTube ignora le offerte per altri tipi di uscite e altri termini di offerta.

Se l'elemento <DealTerms> non specifica una data di inizio del periodo di validità, l'offerta entra in vigore nel momento in cui riceviamo il messaggio ERN. Se l'elemento <DealTerms> non specifica una data di fine, l'offerta ha validità illimitata o rimane valida fino a nuova comunicazione. Il video viene automaticamente pubblicato il giorno <StartDate> (o <StartDateTime>, se disponibile) e per la durata di <ValidityPeriod>.

Per informazioni dettagliate sulle date di inizio/fine e sulla gestione del fuso orario per le uscite in più territori, consulta la documentazione DDEX.

YouTube supporta i codici paese ISO 3166-1 alpha-2 per l'elemento <TerritoryCode>. Questo standard ISO è più recente rispetto allo standard ISO 3166-1 specificato nello standard DDEX ERN. Se includi un codice paese non più valido in ISO 3166-1 alpha-2, YouTube lo ignora.

Il seguente esempio mostra l'elemento <DealList> per una singola traccia con date di uscita diverse negli Stati Uniti e in 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>

Specificare le offerte solo per Content ID

Per attivare una registrazione audio solo per Content ID, invia un feed Single Resource Release (Uscita risorsa singola) o un feed Audio Album (Album audio) con YouTube_ContentID come unico MessageRecipient.

Per creare un file di riferimento per Content ID, l'elemento <Deal> della traccia deve specificare la norma di corrispondenza che YouTube deve applicare ai contenuti corrispondenti caricati da altri utenti. Per applicare una norma di corrispondenza al file di riferimento, puoi:

• Fare riferimento a una norma già salvata nell'account CMS utilizzando il tag <DealReference> oppure
• Definire una norma di corrispondenza personalizzata mediante il tag <RightsClaimPolicy>

Applicare una norma di corrispondenza salvata

Per applicare una norma di corrispondenza salvata, utilizza il tag <DealReference> con il nome della norma, che trovi nella pagina Norme del tuo account CMS. Il nome della norma salvata sarà preceduto da "YT_MATCH_POLICY:".

Ad esempio, se hai una norma denominata "La mia norma salvata" in CMS, puoi applicarla utilizzando il codice riportato di seguito.

<ReleaseDeal>

  <DealReleaseReference>R0</DealReleaseReference>

  <Deal>

    <DealReference>YT_MATCH_POLICY:La mia norma salvata</DealReference>

  </Deal>

</ReleaseDeal>

Per utilizzare la norma di corrispondenza predefinita del tuo account CMS, utilizza il codice di seguito per impostare <DealReference> su "YT_DEFAULT_MATCH_POLICY".

<ReleaseDeal>

  <DealReleaseReference>R0</DealReleaseReference>

  <Deal>

    <DealReference>YT_DEFAULT_MATCH_POLICY</DealReference>

  </Deal>

</ReleaseDeal>

Scopri come configurare una norma di corrispondenza salvata.

Definire una norma di corrispondenza personalizzata

Per applicare una norma di corrispondenza personalizzata, devi includere un elemento <RightsClaimPolicy> con <CommercialModelType> impostato su RightsClaimModel e <UseType> impostato su UserMakeAvailableUserProvided.

Nel codice XML seguente viene applicata una norma di corrispondenza di tipo Monetizza indipendentemente dalla località in cui si trova il consumatore:

<DealTerms>

  <CommercialModelType>RightsClaimModel</CommercialModelType>

  <Usage>

    <UseType>UserMakeAvailableUserProvided</UseType>

  </Usage>

  <TerritoryCode>Worldwide</TerritoryCode>

  <ValidityPeriod />  <!-- Validità immediata e fino a nuova comunicazione. -->

  <RightsClaimPolicy>

    <RightsClaimPolicyType>Monetize</RightsClaimPolicyType>

  </RightsClaimPolicy>

</DealTerms>

Puoi anche applicare norme condizionali utilizzando il tag <Condition>. Le norme condizionali si applicano solo se la durata o la percentuale di corrispondenza supera o scende sotto una determinata soglia.

Nel codice XML riportato di seguito viene applicata la norma di corrispondenza Monetizza solo se la durata della corrispondenza supera il 90% della durata del file di riferimento:

<DealTerms>

  <CommercialModelType>RightsClaimModel</CommercialModelType>

  <Usage>

    <UseType>UserMakeAvailableUserProvided</UseType>

  </Usage>

  <TerritoryCode>Worldwide</TerritoryCode>

  <ValidityPeriod />  <!-- Validità immediata e fino a nuova comunicazione. -->

  <RightsClaimPolicy>

    <Condition>

      <Value>90</Value>

      <Unit>Percent</Unit>

      <!-- Specifica se la percentuale è riferita al materiale di riferimento o ai contenuti generati dagli utenti (rispettivamente ReferenceResource o ConsumerResource)-->

      <!-- Possibilità introdotta nella versione 3.8.2 di ERN -->

      <ReferenceCreation>ReferenceResource</ReferenceCreation>

      <RelationalRelator>MoreThanOrEqualTo</RelationalRelator>

    </Condition>

    <RightsClaimPolicyType>Monetize</RightsClaimPolicyType>

  </RightsClaimPolicy>

</DealTerms>

Offerte combinate per YouTube Premium e Content ID

• Per attivare una registrazione audio sia per Content ID che per YouTube Premium, invia un feed Audio Album (Album audio) che abbia YouTube e YouTube_ContentID come MessageRecipient. Includi le offerte per Content ID e YouTube Premium.
• Per attivare un video musicale sia per Content ID che per YouTube Premium, invia un feed Video Single (Singolo video) con YouTube e YouTube_ContentID come MessageRecipient. Includi le offerte per Content ID e YouTube Premium.

Per combinare i termini dell'offerta <DealTerms> di YouTube Premium e Content ID in un unico feed tramite il profilo Audio Album (Album audio), entrambe le serie di offerte devono essere collegate alle uscite che hanno l'elemento <ReleaseType> impostato su TrackRelease.

Lo snippet XML riportato di seguito attiva una traccia a livello mondiale sia per YouTube Premium che per Content ID.

<DealList>

  <ReleaseDeal>

    <DealReleaseReference>R1</DealReleaseReference>

    <!-- Questa offerta è per 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>

    <!-- Questa offerta è per 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>

Specificare le offerte solo per YouTube Creator Music

Per attivare una registrazione audio esistente solo per Creator Music, invia un feed Single Resource Release (Uscita risorsa singola) o un feed Audio Album (Album audio) con YouTube_CreatorMusic come unico MessageRecipient. Perché il feed venga accettato, la risorsa registrazione audio deve già esistere in Content Manager.

Per specificare le strategie di licenza per Creator Music, utilizza il tag <DealReference> per fare riferimento a una strategia di licenza salvata nel tuo account CMS. Per ogni registrazione audio, puoi impostare una sola strategia di licenza basata sul canale e una sola strategia di licenza basata sulla piattaforma.

Questo XML di esempio mostra come impostare sia una strategia di licenza basata sulla piattaforma che una basata sul canale:

<DealList>

  <ReleaseDeal>

    <DealReleaseReference>R0</DealReleaseReference>

    <Deal>

      <DealReference>YT_PLATFORM_LICENSE_STRATEGY:Nome della strategia basata sulla piattaforma salvata</DealReference>

      <DealReference>YT_CHANNEL_LICENSE_STRATEGY:Nome della strategia basata sul canale salvata</DealReference>

    </Deal>

  </ReleaseDeal>

</DealList>

Offerte combinate per YouTube Premium, Content ID e Creator Music

Per attivare una registrazione audio per YouTube Premium, Content ID e Creator Music, devi inviare un feed Audio Album (Album audio) con tre MessageRecipient (YouTube, YouTube_ContentID e YouTube_CreatorMusic). Includi le offerte per Content ID, YouTube Premium e Creator Music.

 Per combinare i termini dell'offerta <DealTerms> di YouTube Premium, Content ID e Creator Music in un unico feed utilizzando il profilo Audio Album (Album audio), le tre serie di offerte devono essere collegate alle uscite che hanno l'elemento <ReleaseType> impostato su TrackRelease.

L'XML di esempio riportato di seguito attiva una traccia a livello mondiale sia per YouTube Premium che per Content ID e imposta strategie di licenza basate sul canale e sulla piattaforma per Creator Music.

<DealList>

  <ReleaseDeal>

    <DealReleaseReference>R1</DealReleaseReference>

    <!-- Questa offerta è per 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>

    <!-- Questa offerta è per Content ID. -->

    <Deal>

      <DealTerms>

        <CommercialModelType>RightsClaimModel</CommercialModelType>

        <Usage>

          <UseType>UserMakeAvailableUserProvided</UseType>

        </Usage>

        <TerritoryCode>Worldwide</TerritoryCode>

        <ValidityPeriod/>

        <RightsClaimPolicy>

          <RightsClaimPolicyType>Monetize</RightsClaimPolicyType>

        </RightsClaimPolicy>

      </DealTerms>

    </Deal>

    <!-- Questa offerta è per Creator Music -->

    <Deal>

      <DealReference>YT_PLATFORM_LICENSE_STRATEGY:Nome della strategia basata sulla piattaforma salvata</DealReference>

<DealReference>YT_CHANNEL_LICENSE_STRATEGY:Nome della strategia basata sul canale salvata</DealReference>

    </Deal>

  </ReleaseDeal>

</DealList>