A <DealList>
define as principais informações comerciais para cada lançamento, como em quais territórios o lançamento pode ser disponibilizado, os direitos de uso e a data de início/término para cada lançamento. Cada elemento <ReleaseDeal>
define as ofertas para um lançamento da <ReleaseList>
, que é mencionada em <ReleaseReference>
.
Especificar ofertas apenas para o YouTube Premium
No YouTube, a transmissão é baseada em músicas. Só podemos processar ofertas para músicas individuais, em que <ReleaseType>
é TrackRelease.
Os <DealTerms>
da música precisam conceder ao YouTube os direitos de transmissão por assinatura e oferecer suporte à publicidade. Os termos precisam incluir dois elementos <CommercialModelType>
(SubscriptionModel e AdvertisingmentSupportedModel) com o <UseType>
definido como Stream ou OnDemandStream. O YouTube ignora todas as ofertas para outros tipos de lançamento e outros termos da oferta.
Se os <DealTerms>
não especificarem uma data de início para o período de validade, a oferta se torna válida assim que recebermos a mensagem ERN. Se os <DealTerms>
não especificarem uma data de término, a oferta será válida indefinidamente ou até novo aviso. O vídeo será publicado automaticamente na <StartDate>
(ou <StartDateTime>
, se fornecido) e vai ficar ativo durante o <ValidityPeriod>
.
<TerritoryCode>
. Essa norma ISO é mais recente do que a ISO 3166-1 especificada na norma DDEX ERN. Se você incluir um código do país que não seja mais válido na ISO 3166-1 alfa-2, este código será ignorado.O exemplo a seguir mostra a <DealList>
para uma única música que tenha datas de lançamento diferentes 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>
Especificar ofertas apenas para o Content ID
Para criar um arquivo de referência para o Content ID, o <Deal>
da música precisa especificar a política de correspondência que o YouTube deve aplicar a conteúdos correspondentes enviados por outros usuários. Para aplicar uma política de correspondência ao seu arquivo de referência, sigas as etapas abaixo:
- Indique uma política salva na sua conta do CMS usando a tag
<DealReference>
ou - Defina uma política de correspondência personalizada usando a tag
<RightsClaimPolicy>
Aplicar política de correspondência salva
Para aplicar uma política de correspondência salva, use a tag <DealReference>
com o nome da política, conforme definido na página de políticas da sua conta do CMS. Sua política salva vai começar com "YT_MATCH_POLICY:".
Por exemplo, se você tiver uma política chamada "Minha política salva" no CMS, aplique-a usando o código abaixo.
<ReleaseDeal>
<DealReleaseReference>R0</DealReleaseReference>
<Deal>
<DealReference>YT_MATCH_POLICY:My Saved Policy</DealReference>
</Deal>
</ReleaseDeal>
Para usar a política de correspondência padrão da sua conta no CMS, use o código abaixo para definir a <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 salva.
Definir uma política de correspondência personalizada
Para aplicar uma política de correspondência personalizada, inclua uma <RightsClaimPolicy>
com o <CommercialModelType>
definido como RightsClaimModel e o <UseType>
configurado como UserMakeAvailableUserProvided.
O XML abaixo aplicará a política de correspondência Monetize independentemente do local 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 é possível aplicar políticas condicionais usando a tag <Condition>
. Elas são aplicáveis somente se a duração ou a porcentagem da correspondência exceder ou ficar abaixo de um limite especificado.
O XML abaixo vai aplicar uma política de correspondência Monetize, mas somente se a correspondência for maior que 90% da duração do arquivo 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>
Ofertas combinadas 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 com YouTube e YouTube_ContentID como os MessageRecipients. Inclua ofertas para o Content ID e o YouTube Premium.
- Para ativar um vídeo de música no Content ID e no YouTube Premium, envie um feed de vídeo único com YouTube e YouTube_ContentID como os MessageRecipients. Inclua ofertas para o Content ID e o YouTube Premium.
Para combinar os <DealTerms>
do YouTube Premium e do Content ID em um único feed usando o perfil de álbum de áudio, os dois conjuntos de ofertas devem ser vinculados aos lançamentos que tenham o <ReleaseType>
definido como TrackRelease.
O snippet XML abaixo ativará uma música global 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>
Especificar ofertas apenas para o YouTube Creator Music
Para enviar estratégias de licenciamento para o Creator Music, use a tag <DealReference>
para se referir a uma estratégia de licenciamento salva na sua conta do CMS. É possível definir uma estratégia de licenciamento de canal único e para a plataforma para cada gravação de som.
Este exemplo em XML mostra como definir uma estratégia de licenciamento de canal e para a plataforma:
<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>
Ofertas combinadas para o YouTube Premium, o Content ID e o Creator Music
Para combinar os <DealTerms>
do YouTube Premium, do Content ID e do Creator Music em um único feed usando o perfil de álbum de áudio, três conjuntos de ofertas devem ser vinculados aos lançamentos que têm <ReleaseType>
definidos para TrackRelease.
O exemplo de XML abaixo ativa uma música global para o YouTube Premium e o Content ID e define estratégias de licenciamento baseadas na plataforma e no canal 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>