Os <DealList>
definem a informação comercial fundamental para cada lançamento, como os territórios em que o lançamento pode ser disponibilizado, os direitos de utilização e a data de início/fim de cada lançamento. Cada elemento do <ReleaseDeal>
define os termos de um lançamento da <ReleaseList>
, referenciado pela respetiva <ReleaseReference>
.
Especifique os termos apenas para o YouTube Premium
No YouTube, o streaming funciona faixa a faixa. Só podemos processar termos relativos a faixas individuais, em que o <ReleaseType>
é TrackRelease.
Os <DealTerms>
de uma faixa têm de conceder direitos ao YouTube para subscrição e streaming suportado por publicidade. Os termos têm de incluir dois elementos <CommercialModelType>
(SubscriptionModel e AdvertisementSupportedModel) com o <UseType>
de Stream ou OnDemandStream. O YouTube ignora quaisquer termos para outros tipos de lançamentos e quaisquer outros termos de contrato.
Se os <DealTerms>
não especificarem uma data de início para o período de validade, o contrato torna-se válido assim que recebermos a mensagem ERN. Se os <DealTerms>
não especificarem uma data de fim, o contrato é válido indefinidamente ou até informação em contrário. O vídeo será publicado automaticamente a <StartDate>
(ou a <StartDateTime>
se fornecido) e pela duração do <ValidityPeriod>
.
<TerritoryCode>
. Esta norma ISO é mais recente do que a norma ISO 3166-1 especificada na norma DDEX ERN. Se incluir um código de país que já não seja válido segundo a norma ISO 3166-1 alpha-2, o YouTube ignora-o.O seguinte exemplo apresenta os <DealList>
para uma faixa individual que possui diferentes datas de lançamento nos Estados Unidos e no Canadá.
<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>
Especifique os termos apenas para o Content ID
Para criar um ficheiro de referência para o Content ID, o <Deal>
da faixa tem de especificar a política de correspondência que o YouTube deve aplicar ao conteúdo correspondente carregado por outros utilizadores. Para aplicar uma política de correspondência ao ficheiro de referência, pode:
- Fazer referência a uma política guardada existente na sua conta CMS através da etiqueta
<DealReference>
, ou - Definir uma política de correspondência personalizada através da etiqueta
<RightsClaimPolicy>
Aplique uma política de correspondência guardada
Para aplicar uma política de correspondência guardada, use a etiqueta <DealReference>
com o nome da política, localizada na página de políticas da sua conta CMS. A política guardada vai começar com "YT_MATCH_POLICY:".
Por exemplo, se tiver uma política denominada "A minha política guardada" no CMS, pode aplicá-la com o código abaixo.
<ReleaseDeal>
<DealReleaseReference>R0</DealReleaseReference>
<Deal>
<DealReference>YT_MATCH_POLICY:A minha política guardada</DealReference>
</Deal>
</ReleaseDeal>
Para usar a política de correspondência predefinida da sua conta CMS, use o código abaixo para definir <DealReference>
como "YT_DEFAULT_MATCH_POLICY".
<ReleaseDeal>
<DealReleaseReference>R0</DealReleaseReference>
<Deal>
<DealReference>YT_DEFAULT_MATCH_POLICY</DealReference>
</Deal>
</ReleaseDeal>
Saiba como configurar uma política de correspondência guardada.
Defina uma política de correspondência personalizada
Para aplicar uma política de correspondência personalizada, deve incluir uma <RightsClaimPolicy>
com o <CommercialModelType>
definido como RightsClaimModel e o <UseType>
definido como UserMakeAvailableUserProvided.
O XML abaixo aplica uma política de correspondência de Rentabilização independentemente da localização do consumidor:
<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>
Também pode aplicar políticas condicionais com a etiqueta <Condition>
. As políticas condicionais apenas se aplicam se a duração ou a percentagem da correspondência for superior/inferior a um limite especificado.
O XML abaixo aplica uma política de correspondência de Rentabilização apenas se a duração da correspondência for superior a 90% da duração do ficheiro de referência:
<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>
Termos combinados para o YouTube Premium e o Content ID
- Para ativar uma gravação de som para o Content ID e o YouTube Premium, envie um feed de álbum de áudio que tenha YouTube e YouTube_ContentID como MessageRecipients. Inclua termos do Content ID e do YouTube Premium.
- Para ativar um vídeo de música para o Content ID e o YouTube Premium, envie um feed de vídeo único que tenha YouTube e YouTube_ContentID como MessageRecipients. Inclua termos do Content ID e do YouTube Premium.
Para combinar <DealTerms>
do YouTube Premium e do Content ID num único feed com o perfil de álbum de áudio, deve associar ambos os conjuntos de termos aos lançamentos que têm um <ReleaseType>
definido para TrackRelease.
O fragmento XML abaixo ativa uma faixa a nível mundial para o YouTube Premium e o 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>
Especifique os termos apenas para o YouTube Creator Music
Para enviar estratégias de licenças para o Creator Music, use a etiqueta <DealReference>
para referenciar uma estratégia de licença guardada na sua conta CMS. Pode definir uma estratégia de licença de canal e uma estratégia de licença de plataforma para cada gravação de som.
Este exemplo de XML mostra como definir uma estratégia de licença de plataforma e de canal:
<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>
Termos combinados para o YouTube Premium, o Content ID e o Creator Music
Para combinar <DealTerms>
do YouTube Premium, do Content ID e do Creator Music num único feed com o perfil de álbum de áudio, deve associar três conjuntos de termos aos lançamentos que têm um <ReleaseType>
definido como TrackRelease.
O exemplo de XML abaixo ativa uma faixa a nível mundial para o YouTube Premium e o Content ID, e define estratégias de licenças de canal e de plataforma para o 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>