System-Managed Reports - Fields

Filmes, músicas e TV

A tabela a seguir define os campos que aparecem nos relatórios gerenciados pelo sistema da API Reporting do YouTube para parceiros de filmes, músicas e TV:

Campos
active_claims O número de reivindicações ativas.
active_reference_id ID gerado pelo YouTube para a referência ativa associada.
activity_month O mês do relatório.
adjustment_type Indica se a linha representa dados de receita normais ou um ajuste na receita informada anteriormente:
  • Se a linha representar dados de receita normais, o valor do campo será None. Além disso, os dados dessa linha são referentes ao mês associado ao relatório.
  • Se a linha representar um ajuste nos dados informados anteriormente, o campo vai conter um dos valores na lista abaixo. Nesse caso, a linha pode conter dados de meses diferentes do mês associado ao relatório. Por exemplo, o relatório de novembro de 2016 pode conter ajustes aplicáveis a eventos de outubro de 2016 ou outros meses anteriores.

    Os tipos de ajuste possíveis são:
    • Backpay: pagamento retido devido à ausência de propriedade.
    • Conflict Resolution: pagamento retido devido a um conflito de propriedade. Essa também é uma forma de estorno.
    • Dispute Resolution: pagamento relacionado a uma disputa resolvida de receita retida antes dos pagamentos do mês atual.
    • Dispute Conflict Resolution: um pagamento de retroativo derivado de uma disputa resolvida que foi retido devido a um conflito de propriedade.
    • Spam Adjustment: pagamento relacionado à correção de spam. Essa é uma dedução, que o Google AdSense informa como Invalid Activity - YouTube.
    • Revenue Correction: pagamento relacionado a um bug técnico ou correção de dados. Esse valor pode ser um crédito ou uma dedução.
administer_publish_rights Indica se a gravadora administra os direitos de publicação, ou seja, se ela coleta e gerencia os pagamentos de royalties para compositores, editores ou outras partes que são proprietárias da composição. Os valores possíveis são True e False.
adsense_earnings_month Mês de ganhos em que o relatório do Google AdSense será consultado.
album O álbum em que a gravação de som aparece. O valor tem um comprimento máximo de 255 bytes.
approx_daily_views A média de visualizações diárias do recurso.
artist O nome do artista associado ao recurso identificado na linha do relatório. O valor tem um comprimento máximo de 255 bytes.
asset_channel_id O canal que tem o vídeo enviado pelo parceiro reivindicado pelo recurso (asset_id). O valor do campo é um ID do canal do YouTube que identifica exclusivamente o canal. É possível recuperar outros dados sobre o canal usando o método channels.list da API YouTube Data.
asset_custom_id O campo de metadados do recurso opcional usado para identificar com exclusividade um recurso, normalmente um código interno. Outros parceiros não podem ver seus códigos personalizados.
asset_id O ID do recurso do YouTube que identifica exclusivamente o recurso associado aos dados na linha. É possível recuperar outros dados sobre o recurso usando o método assets.list da API Content ID do YouTube ou pesquisar o recurso na página de recursos do studio.youtube.com.
asset_labels Rótulos de recursos associados ao recurso. Os rótulos de recursos oferecem uma maneira de agrupar recursos em categorias personalizadas. Os rótulos podem ser usados para pesquisar recursos, atualizar grupos de recursos, criar campanhas para recursos rotulados, filtrar o YouTube Analytics e muito mais.
asset_metadata_type O tipo de recurso da referência, como Web ou Filme.
asset_owners Atuais proprietários de recursos da referência.
asset_policy_block Territórios em que a política do proprietário é Block. O valor é o código de país ou região de duas letras da região.
asset_policy_id Identificador exclusivo de uma política do proprietário. No momento, esse valor está disponível apenas na API. Essa informação não é exibida no Gerenciador de conteúdo do Studio.
asset_policy_monetize Os territórios onde a política do proprietário é Monetize. O valor é o código de país ou região de duas letras do território.
asset_policy_track Os territórios onde a política do proprietário é Track. O valor é o código de país ou região com duas letras do território.
asset_title O título do recurso.
asset_type O tipo do recurso. Os valores possíveis são:
  • Art Track: representa uma faixa no YouTube de uma gravação de som que não tem um vídeo de música premium.
  • Composition: representa uma composição musical. Uma composição tem metadados como ISWC e escritores. É o único tipo de recurso que pode ter vários proprietários por território. Ele pode ser incorporado a um recurso de gravação de som.
  • Movie: representa um longa-metragem. Esse recurso tem metadados como ISAN/EIDR e diretores.
  • Music Video: representa o vídeo de música oficial de uma gravação de som. Um vídeo de música tem metadados como ISRC de vídeo, música e artistas. Um recurso de vídeo de música incorpora um recurso de gravação de som.
  • Sound Recording: representa uma gravação de áudio. Uma gravação de som tem metadados como ISRC, artista e álbum. Ela incorpora um recurso de composição que, por sua vez, pode ser incorporado a um recurso de vídeo de música.
  • Television episode: representa um episódio de um programa de TV. Esse recurso tem metadados como temporada e número do episódio.
  • Web: representa vídeos originais do YouTube ou outros tipos de conteúdo de vídeo que não se encaixam nos outros tipos de recurso.
audio_royalties Sua receita reconhecida da receita do nível de áudio do YouTube Com base no cálculo de maior valor entre a Receita líquida da parcela de áudio do parceiro e a Receita do parceiro do mínimo de áudio por exibição.
audio_share Proporção de exibições do nível de áudio do parceiro em relação ao total de exibições do nível de áudio.
category O gênero do vídeo, conforme exibido na página de exibição do vídeo. O valor é um ID de categoria de vídeo do YouTube. É possível usar o método videoCategories.list da API Data do YouTube para extrair um mapeamento de IDs de categoria de vídeo para nomes de categoria.
channel_display_name O nome de exibição do canal que fez o upload do vídeo.
channel_id O canal proprietário do vídeo (video_id) associado aos dados na linha. O valor do campo é um ID do canal do YouTube que identifica exclusivamente o canal. É possível recuperar outros dados sobre o canal usando o método channels.list da API YouTube Data.
claiming_asset_type O tipo de recurso da reivindicação.
claim_created_date A data em que a reivindicação foi criada.
claim_id O ID de reivindicação do YouTube que identifica exclusivamente o recurso associado a uma reivindicação na linha. É possível recuperar outros dados sobre o recurso usando o método claims.list da API Content ID do YouTube ou pesquisar o recurso na página de reivindicações studio.youtube.com.
claim_origin O método usado para criar a reivindicação do vídeo. Os valores possíveis para o campo são:
  • Audio Match
  • Audio Swap
  • Batch Tool
  • CMS_UPLOAD
  • Content ID API
  • Descriptive Search
  • External
  • GameID Match
  • Google Dev ID
  • Hashcode
  • Melody Match
  • SFTP Upload
  • Video Match
  • Web Search
  • Web Upload
  • YouTube Admin
claim_policy_block Os territórios onde a política de reivindicação aplicada é Block. O valor é o código de país/região com duas letras.
claim_policy_id Identificador exclusivo de uma política aplicada. No momento, esse valor está disponível apenas na API. Essa informação não é exibida no Gerenciador de conteúdo do Studio.
claim_policy_monetize Os territórios onde a política de reivindicação aplicada é Monetize. O valor é o código de país/região com duas letras.
claim_policy_track Os territórios onde a política de reivindicação aplicada é Track. O valor é o código de país/região com duas letras.
claim_status Especifica se o status de uma reivindicação é ACTIVE, INACTIVE ou PENDING.
claim_status_detail Detalhe sobre o status de uma reivindicação, como CLOSED_MANUALLY.
claim_type Indica se a reivindicação abrange a parte de áudio, vídeo ou audiovisual do conteúdo reivindicado. Os valores válidos para este campo são:
  • Áudio
  • audiovisual
  • Visual
claim_quality A origem do vídeo reivindicado. Os valores possíveis para o campo são:
  • Partner-provided: o vídeo foi enviado por um parceiro do YouTube.
  • Premium UGC: o vídeo foi enviado por um terceiro, com segmentos protegidos por direitos autorais que atendem aos requisitos de duração e de proporcionalidade para serem tratados como conteúdo licenciado fornecido por parceiro para a participação na receita.
  • UGC: o vídeo é conteúdo gerado pelo usuário, ou seja, foi enviado por um terceiro, mas não atende aos requisitos para ser tratado como conteúdo licenciado fornecido por parceiro para a participação na receita.

Observação:esse campo é chamado de Content Type nos relatórios que podem ser baixados no menu Relatórios do YouTube Studio de Criação.

claimed_by_another_owner Indica se outro proprietário de conteúdo tem uma reivindicação ativa de primeira ou terceira parte no vídeo.
claimed_by_this_owner Indica se o proprietário do conteúdo que gerou o relatório tem uma reivindicação ativa de terceiros ou própria no vídeo.
comments_allowed Indica se os comentários estão ativados para o vídeo.
composition_right_type Especifica os tipos de direitos de composição associados à reivindicação. Os valores válidos para este campo são:
  • Maquinário
  • Desempenho
  • Sincronização
conflicting_country_code Os códigos ISO dos países para territórios em conflito de propriedade com outros parceiros.
conflicting_owner Os IDs de outros parceiros com conflitos de propriedade.
content_type A origem do vídeo reivindicado. Os valores possíveis de são:
  • Partner-provided: o vídeo que você envia para um canal do YouTube que é seu. Você reivindica o vídeo ao enviar e aplica uma política de uso a ele. A reivindicação de conteúdo enviado por parceiros ativa opções de monetização, de correspondência de Content ID e de criação de relatórios.
  • Premium UGC: um vídeo enviado por um terceiro que contém segmentos protegidos por direitos autorais que atendem aos requisitos de duração e de proporcionalidade para serem tratados como conteúdo licenciado fornecido por parceiro.
  • UGC: um vídeo enviado por terceiros que contém conteúdo seu, conforme determinado por uma correspondência do Content ID ou uma reivindicação manual. A política de correspondência associada a essa reivindicação determina onde e como o vídeo é disponibilizado no YouTube.
constituent_asset_id ID anterior de um recurso antes da fusão.
constituent_asset_ids Os IDs anteriores dos recursos antes da fusão.
country Identifica o país em que a atividade ocorreu.
country_code Identifica o código do país em que a atividade ocorreu. O valor é um código de país ISO 3166-1 alfa-2.
currency Indica a moeda que a linha representa.
currency_code Indica o código da moeda que a linha representa.
custom_id Um valor exclusivo que você, o provedor de metadados, usa para identificar um recurso. O valor pode ser um ID exclusivo criado para o recurso ou um identificador padrão, como um ISRC. O valor tem um comprimento máximo de 64 bytes e pode conter caracteres alfanuméricos, hífens (-), sublinhados (_), pontos (.), arrobas (@) ou barras (/).
date A data em que a atividade ocorreu. O valor está no formato YYYYMMDD.
date_created A data e a hora em que a referência foi criada em UTC.
date_id A data em que a atividade ocorreu. O valor está no formato YYYYMMDD.
day O dia em que a atividade ocorreu.
director Diretor associado ao recurso.
directors Diretores associados ao recurso.
display_ads_enabled Indica se anúncios de terceiros são exibidos no vídeo.
effective_policy A política de uso aplicada ao vídeo nos territórios do proprietário do conteúdo.
eidr O Registro Identificador de Entretenimento (EIDR, na sigla em inglês) atribuído a um filme ou episódio de TV. O valor contém um prefixo padrão do registro EIDR, seguido de uma barra inclinada, uma sequência hexadecimal de 20 caracteres e um caractere verificador alfanumérico (0-9A-Z).
embedding_allowed Indica se o vídeo pode ser incorporado em sites de terceiros.
end_date Data e hora de término.
episode_number O número do episódio associado ao vídeo.
episode_title O título de um episódio de TV ou filme.
excluded_perc A porcentagem que foi excluída da referência, com base em exclusões e comprimento totais.
exclusions Os trechos da referência que foram excluídos e o tipo de exclusão (por exemplo, sobreposição de referência, exclusão manual, segmento inválido). Tipos de exclusão disponíveis:
  • O = exclusão manual pelo Gerenciador de conteúdo
  • P = exclusão manual pela API
  • I = exclusão manual pelo Envio de conteúdo
  • C = sobreposição de referência
  • S = segmento inválido
  • B = exclusão permanente
grid O Global Release Identifier (GRid), um campo de metadados opcional usado para identificar um recurso exclusivamente. O valor do campo contém exatamente 18 caracteres alfanuméricos.
has_multiple_claims Indica se há mais de uma reivindicação no vídeo. O valor é false se houver uma reivindicação no vídeo e true se houver mais de uma.

Observação:esse campo é chamado de Multiple Claims? nos relatórios que podem ser baixados no menu "Relatórios" do YouTube Studio.
hfa O código de seis caracteres emitido pela Agência Harry Fox (HFA) para identificar uma composição de forma exclusiva.
hfa_song_code O código de seis caracteres emitido pela Agência Harry Fox (HFA) para identificar uma composição de forma exclusiva.
inactive_reference_id ID gerado pelo YouTube para a referência inativa associada.
is_made_for_kids_effective_setting A configuração "Conteúdo para crianças" do vídeo.
is_made_for_kids_modifiable Indica se a configuração "Conteúdo para crianças" pode ser modificada pelo usuário.
is_made_for_kids_user_selection Indica se o vídeo foi especificado pelo usuário como "conteúdo para crianças".
is_merged Indica se o recurso foi criado devido à fusão de recursos.
isrc O código de gravação padrão internacional (ISRC) do recurso relacionado. O valor do campo contém exatamente 12 caracteres alfanuméricos.
iswc O código internacional de obras musicais (ISWC, na sigla em inglês) do recurso de composição. O valor do campo contém exatamente 11 caracteres no formato de uma letra (T) seguida por 10 dígitos.
label A gravadora que lançou uma gravação de som. O valor tem um comprimento máximo de 255 bytes.
length_sec A duração da referência em segundos.
local_currency O tipo de moeda local em que a receita é paga.
longest_match O maior trecho de correspondência de uma reivindicação.
long_nonskippable_video_ads_enabled Indica se anúncios não puláveis longos de terceiros podem ser veiculados durante o vídeo. Os anúncios em vídeo in-stream são exibidos durante a reprodução do conteúdo em vídeo.
match_policy A política de correspondência aplicada ao recurso.
matching_duration A duração total da correspondência de uma reivindicação.
metadata_origination A origem dos metadados do recurso.
monetized_views O número total de transmissões audiovisuais e apenas de áudio atribuídas ao seu conteúdo no serviço de assinatura do YouTube Premium. Esse valor é relevante apenas para parceiros de música.
monetized_views_art_track_audio O número de transmissões somente de áudio de músicas com arte da capa atribuídas ao seu conteúdo no serviço de assinatura do YouTube Premium. Este campo só é aceito para parceiros de música.
monetized_views_art_track_audio_visual O número de transmissões audiovisuais de músicas com arte da capa atribuídas ao seu conteúdo no serviço de assinatura do YouTube Premium. Esse campo só é aceito para parceiros de música.
monetized_views_audio O número total de transmissões somente áudio atribuídas ao seu conteúdo no serviço de assinatura do YouTube Premium. O valor é a soma dos campos monetized_views_art_track_audio, monetized_views_partner_owned_audio e monetized_views_ugc_audio. Este campo só é aceito para parceiros de música.
monetized_views_audio_visual O número total de transmissões audiovisuais atribuídas ao seu conteúdo no serviço de assinatura YouTube Premium. O valor é a soma dos campos monetized_views_art_track_audiovisual, monetized_views_partner_owned_audiovisual e monetized_views_ugc_audiovisual. Esse campo só é aceito para parceiros de música.
monetized_views_partner_owned_audio O número de transmissões somente de áudio do conteúdo de vídeos de música oficiais e fornecidos por parceiros que foram atribuídos ao seu conteúdo no serviço de assinatura do YouTube Premium. Esse campo só é aceito para parceiros de música.
monetized_views_partner_owned_audio_visual O número de transmissões audiovisuais de conteúdo de vídeos de música oficiais fornecidos por parceiros que foram atribuídos ao seu conteúdo no serviço de assinatura do YouTube Premium. Esse campo só é aceito para parceiros de música.
monetized_views_total_sub_service A soma de todas as visualizações monetizadas audiovisuais e apenas de áudio em todo o conteúdo reivindicado de parceiros de música do YouTube no serviço de assinatura do YouTube Premium. Esse valor está disponível apenas para parceiros de música.
monetized_views_ugc_audio O número de transmissões somente áudio de conteúdo gerado pelo usuário (UGC) atribuído ao seu conteúdo no serviço de assinatura do YouTube Premium. O UGC se refere a vídeos enviados pelo usuário que não são tratados da mesma forma que o conteúdo licenciado fornecido pelo parceiro para a participação na receita. Este campo só é aceito para parceiros de música.
monetized_views_ugc_audio_visual O número de transmissões audiovisuais de conteúdo gerado pelo usuário (UGC) atribuído ao seu conteúdo no serviço de assinatura do YouTube Premium. O UGC se refere a vídeos enviados pelo usuário que não são tratados da mesma forma que o conteúdo licenciado fornecido pelo parceiro para a participação na receita. Esse campo só é aceito para parceiros de música.
monetized_views_ugc_master_audio_visual O número total de transmissões de gravações master audiovisuais atribuídas ao seu conteúdo no serviço de assinatura do YouTube Premium. Esse valor é relevante apenas para parceiros de música.
monetized_views_ugc_cover_audio_visual É o número total de transmissões de vídeo de capa geradas pelo usuário que foram atribuídas ao seu conteúdo no serviço de assinatura do YouTube Premium. Esse valor é relevante apenas para parceiros de música.
monetized_views_ugc_cover_shared_audio_visual É o número total de vídeos de capa gerados pelo usuário com participação na receita em três vias atribuídos ao seu conteúdo no serviço de assinatura do YouTube Premium. Esse valor é relevante apenas para parceiros de música.
monetized_watchtime O tempo total de exibição de uma assinatura do YouTube Premium, em segundos, atribuído aos seus vídeos que não são de música.
month O mês em que a atividade ocorreu.
midrolls_enabled Indica se os anúncios intermediários podem ser veiculados no vídeo. Os anúncios intermediários são anúncios em vídeo que aparecem durante outro vídeo ou evento. Por exemplo, um anúncio em vídeo intermediário pode aparecer em intervalos durante um filme de longa-metragem. Os anúncios intermediários são destinados apenas a conteúdo licenciado.
multiple_claims Indica se há mais de uma reivindicação no vídeo. O valor é false se houver uma reivindicação no vídeo e true se houver mais de uma.

Observação:esse campo é chamado de Multiple Claims? nos relatórios que podem ser baixados no menu "Relatórios" do YouTube Studio.
music_claim_type Indica se a reivindicação abrange a parte de áudio, vídeo ou audiovisual do conteúdo reivindicado. Os valores válidos para este campo são:
  • Áudio
  • audiovisual
  • Visual
music_share Porcentagem de atividade musical por país e oferta.
net_partner_revenue Receita líquida do parceiro.
net_partner_revenue_post_revshare Receita líquida do parceiro após a divisão da participação na receita.
revshare_rate_type O tipo de taxa de participação na receita aplicada à receita.
nonskippable_video_ads_enabled Indica se anúncios não puláveis de terceiros são reproduzidos no vídeo. Os anúncios em vídeo in-stream são exibidos durante a reprodução do conteúdo em vídeo.
notes Indica o pagamento de um mês anterior no caso de pagamentos de ajustes adiados.
offweb_syndicatable Indica se o vídeo pode ser exibido fora do navegador.
overlay_ads_enabled Indica se os anúncios overlay são reproduzidos no vídeo. As sobreposições são anúncios de display exibidos na parte de cima do vídeo após 10 segundos.
other_owners_claiming Os nomes de outros proprietários de conteúdo que também têm reivindicações sobre o vídeo.
other_ownership_origination A origem da propriedade de outros proprietários.
owned_views O número total de visualizações do seu conteúdo para o qual a política definida é de monetização ou rastreamento.

Os relatórios de anúncios do YouTube e de assinatura do YouTube Premium para conteúdo não musical contêm o campo policy, que indica se a política associada aos dados foi monetize ou track.
owned_subscription_views O número total de visualizações de assinantes do YouTube Premium do seu conteúdo em que a política de conteúdo é monetizar ou monitorar.
ownership O dono de um recurso em territórios específicos.
ownership_last_updated Data e hora da última atualização de propriedade.
ownership_origination A origem da origem da propriedade.
ownership_percentage A porcentagem da composição que você possui.
partner_audio_ad_revshare Sua participação nos lucros pro rata do nível do áudio do YouTube, considerando taxas RevShare. Usada para fazer o cálculo do maior valor.
partner_audio_ad_revshare_rate Taxa de participação na receita do anúncio do parceiro.
partner_playbacks As exibições no serviço do nível de áudio do YouTube atribuídas ao seu conteúdo.
partner_revenue Sua receita em USD de publicidade depois que a divisão da receita foi aplicada. Esse campo aparece nos relatórios de anúncios do YouTube. O campo youtube_revenue_split contém a receita total antes da divisão da participação na receita.
partner_revenue_art_track Sua participação na receita da assinatura do YouTube Premium para conteúdo de música com arte da capa reproduzido no modo audiovisual.
partner_revenue_audio Sua participação na receita da assinatura do YouTube Premium para conteúdo reproduzido no modo somente áudio.
partner_revenue_local Sua receita na moeda local gerada pela publicidade depois que a divisão da participação na receita foi aplicada. Esse campo aparece nos relatórios de anúncios do YouTube. O campo youtube_revenue_split contém a receita total antes da divisão da participação na receita.
partner_revenue_usd Sua receita de publicidade após a divisão da receita ter sido aplicada. Esse campo aparece nos relatórios de anúncios do YouTube. O campo youtube_revenue_split contém a receita total antes da divisão da participação na receita.
partner_revenue_auction Sua receita com a publicidade do Google AdSense vendida em leilões.
partner_revenue_per_play_min A receita calculada com base em valores mínimos por exibição. Ela é usada para fazer o cálculo do maior valor quando agregada no nível do país.
partner_revenue_per_sub_min Receita por país calculada com base nos valores mínimos por inscrito, usada para fazer o cálculo do maior valor.
partner_revenue_pro_rata Sua participação nos lucros pro rata da assinatura do YouTube Premium, considerando as taxas RevShare.
partner_revenue_pro_rata_audio Sua participação na receita pro rata das assinaturas do YouTube Premium para conteúdo reproduzido no modo somente áudio.
partner_revenue_pro_rata_audio_per_sub_min Sua participação nos lucros pro rata da assinatura do YouTube Premium para conteúdo reproduzido apenas em áudio.
partner_revenue_pro_rata_audio_visual Sua participação na receita pro rata da assinatura do YouTube Premium para conteúdo exibido no modo audiovisual.
partner_revenue_pro_rata_partner_owned Sua participação na receita pro rata das assinaturas do YouTube Premium para conteúdo enviado por parceiros reproduzido no modo audiovisual.
partner_revenue_pro_rata_ugc Sua participação na receita pro rata da assinatura do YouTube Premium para UGC (Conteúdo gerado pelo usuário) reproduzido no modo audiovisual.
partner_revenue_pro_rata_art_track Sua participação na receita pro rata da assinatura do YouTube Premium para conteúdo de música com arte da capa reproduzido no modo audiovisual.
partner_revenue_partner_sold_partner_served Sua receita de anúncios que você vendeu e veiculou nos seus próprios servidores de anúncios externos.
partner_revenue_partner_sold_youtube_served Sua receita de publicidade vendida pela DoubleClick for Publishers (DFP) depois que a divisão da participação na receita foi aplicada.
partner_revenue_reserved Sua receita de publicidade vendida reservadamente pela DoubleClick (DCLK) e outras fontes vendidas pelo YouTube após a aplicação da divisão de participação na receita.
partner_revenue_ugc Sua receita gerada pelo conteúdo gerado pelo usuário.
payment_period Período em que o pagamento foi feito.
per_play_minimum A taxa por número mínimo de exibição no país específico.
per_play_minimum_currency A moeda do mínimo de áudio por exibição.
per_play_minimum_partner_revenue A receita calculada com base em valores mínimos por exibição. Usada para fazer o cálculo do maior valor.
per_sub_min_rate Receita por país calculada com base nos valores mínimos por inscrito, usada para fazer o cálculo do maior valor.
per_subs_min_rate A taxa por número mínimo de inscrições no país específico.
policy A política aplicada ao vídeo. O valor é monetize ou track.
pool_participating_rate Participação de mercado com publicidade (AVOD, na sigla em inglês) de todos os parceiros participantes no pool dinâmico em relação ao valor de referência principal.
postrolls_enabled Indica se os anúncios finais podem ser reproduzidos no vídeo. Os anúncios post-roll são veiculados após o vídeo ou a transmissão ao vivo que o espectador está assistindo.
prerolls_enabled Indica se os anúncios precedentes podem ser reproduzidos no vídeo. Os anúncios precedentes são exibidos antes do vídeo ou da transmissão ao vivo que o espectador está assistindo. Às vezes, mais de um anúncio precedente é exibido.
provider O nome do proprietário do conteúdo que forneceu a referência.
ratings_allowed Indica se as classificações estão ativadas para o vídeo.
record_label O nome da gravadora fornecido nos metadados do recurso. Relevante apenas para parceiros de música.
reference_id ID gerado pelo YouTube para a referência associada a uma reivindicação. Esse campo ficará em branco no caso de reivindicações enviadas por parceiros.
reference_type O tipo ou canal de referência, como Audio, Visual, AudioVisual.
reference_video_id O ID gerado pelo YouTube para o vídeo de referência. Aplicável apenas se a reivindicação estiver associada a uma referência criada em um vídeo do YouTube.
release_date A data de lançamento fornecida nos metadados do recurso. Relevante apenas para parceiros de TV/Filme.
revenue_source Indica a origem da receita. Os valores possíveis de são:
  • Ads: receita dos anúncios exibidos no vídeo.
  • Subscriptions: receita de assinaturas pagas do YouTube Premium.
  • Transactions: receita de transações, como conteúdo pago ou compras.
revenue_type Indica o tipo de receita que a linha representa.
right_type Especifica os tipos de direitos de composição associados à reivindicação. Os valores válidos para este campo são:
  • Maquinário
  • Desempenho
  • Sincronização
season O número da temporada associada a um episódio de TV. O campo tem um comprimento máximo de 5 bytes.
shorts_flat_fee_revenue_usd A receita da taxa fixa em USD para os Shorts.
shorts_monthly_pool_usd A receita mensal em USD do pool dos Shorts.
shorts_partner_revenue_usd A receita do parceiro em dólares americanos para os Shorts.
shorts_usages_marketshare A participação de mercado do uso dos Shorts.
skippable_video_ads_enabled Indica se os anúncios em vídeo puláveis estão ativados para o vídeo. Os anúncios in-stream puláveis aparecem antes, durante ou após outros vídeos no YouTube e em sites e apps dos parceiros de vídeo do Google. Depois de cinco segundos, o espectador pode pular o anúncio e continuar assistindo ao vídeo.
source_of_fingerprint A origem da impressão digital de um determinado arquivo de referência.
sponsored_cards_enabled Indica se os cards patrocinados estão ativados para o vídeo. Os cards de informações de produtos patrocinados permitem que os espectadores comprem os itens que aparecem nos vídeos.
start_date Data e hora de início.
status Indica o status do recurso. Os valores possíveis são active ou inactive.
studio O estúdio associado ao recurso.
subscribers O número de inscritos.
tax_withholding_rate A taxa de retenção na fonte aplicável no relatório de retenção de tributos.
tax_withheld_amount O valor do imposto retido no relatório de retenção de tributos.
third_party_ads_enabled Indica se os anúncios de terceiros estão ativados para o vídeo.
third_party_video_id O ID do vídeo fornecido pelo parceiro usado para identificar o vídeo para fins de segmentação de anúncios.
time_published É a data e a hora em que o vídeo foi publicado no YouTube no formato MM/DD/YYYY HH:MM:SS. Este campo fica em branco para vídeos que nunca foram publicados (ou seja, vídeos privados ou não listados)
time_uploaded Data e hora em que o vídeo foi enviado para o YouTube no formato MM/DD/YYYY HH:MM:SS.
tms O valor de ID do Tribune Media Systems (TMS) de 12 a 14 caracteres que identifica um filme ou episódio de TV de forma exclusiva.
total_playbacks Total de exibições no serviço do nível de áudio do YouTube.
total_revenue_by_source A receita total por origem, como anúncios ou assinaturas.
total_views O número total de visualizações.
unlaunched_territories_adjustment O ajuste do pool de Shorts para territórios não lançados.
upc O UPC (Código universal de produto), um campo de metadados opcional usado para identificar exclusivamente um material.
uploader O nome do proprietário do conteúdo que enviou o vídeo.
upload_source O método usado para enviar o vídeo para o YouTube.
us_sourced_revenue O valor da receita gerada nos Estados Unidos.
usd_local_rate A taxa de câmbio usada para converter de USD para a moeda local. O valor representa uma taxa média de transações diárias no período do relatório.
username O nome do proprietário do conteúdo do YouTube.
video_channel_id O identificador gerado pelo YouTube para o canal em que o vídeo foi publicado.
video_duration A duração do vídeo.
video_duration_sec A duração do vídeo em segundos.
video_id O vídeo reivindicado associado aos dados na linha. O valor do campo é um ID do vídeo do YouTube, que identifica o conteúdo de forma exclusiva. É possível recuperar outros dados sobre o vídeo usando o método videos.list da API YouTube Data.
video_length A duração do vídeo em segundos.
video_privacy_status Indica se o vídeo é público, privado ou não listado.
video_title O título do vídeo associado aos dados na linha.
video_upload_date A data de publicação do vídeo reivindicado.
video_url O URL do vídeo no YouTube.
views É o número de vezes que o vídeo foi visualizado.
writers Uma lista delimitada por barras verticais dos autores da composição.
youtube_revenue_split

Para gravadoras, parceiros de filmes e TV:receita total de anúncios do YouTube com seu conteúdo. Esse valor é dividido de acordo com a taxa de participação na receita. O campo partner_revenue contém sua receita.

Para editores de música:receita total de anúncios do YouTube do seu conteúdo, considerando a propriedade do recurso, mas antes da divisão de acordo com a taxa de participação na receita. O campo partner_revenue contém sua receita.

youtube_revenue_split_auction

Para gravadoras, estúdios de cinema e parceiros de TV:receita total da publicidade do Google AdSense vendida em leilão antes da aplicação das divisões de participação na receita.

Para editores de música:receita total da publicidade do Google AdSense vendida em leilões, considerando a propriedade do recurso, mas antes de aplicar as divisões de participação na receita.

youtube_revenue_split_partner_sold_partner_served

Para gravadoras, estúdios de cinema e parceiros de TV:receita total dos anúncios vendidos e veiculados por parceiros. Esse valor é dividido de acordo com a taxa de participação na receita. O partner_revenue_partner_served_partner_sold contém sua receita de anúncios veiculados e vendidos por parceiros.

Para editores de música:receita total dos anúncios vendidos e veiculados pelo parceiro, considerando a propriedade do recurso. Esse valor é dividido de acordo com a taxa de participação na receita. O partner_revenue_partner_served_partner_sold contém sua receita de anúncios veiculados e vendidos por parceiros.

youtube_revenue_split_partner_sold_youtube_served

Para gravadoras, estúdios de cinema e parceiros de TV:receita total do DoubleClick for Publishers (DFP). Esse valor é dividido de acordo com a taxa de participação na receita. O partner_revenue_partner_served_partner_sold contém sua receita de anúncios veiculados e vendidos por parceiros.

Para editores de música:receita total da DoubleClick for Publishers (DFP), considerando a propriedade do recurso. Esse valor é dividido de acordo com a taxa de participação na receita. O partner_revenue_partner_sold_youtube_sold contém sua receita de anúncios veiculados e vendidos por parceiros.

youtube_revenue_split_reserved

Para gravadoras, estúdios de cinema e parceiros de TV:receita total da publicidade reservada vendida pela DoubleClick (DCLK) e outras fontes vendidas pelo YouTube. Esse valor é dividido de acordo com a taxa de participação na receita. O partner_revenue_reserved contém sua receita dessas origens.

Para editores de música:receita total gerada com publicidade reservada vendida pelo DoubleClick (DCLK) e outras fontes vendidas pelo YouTube, considerando a propriedade do recurso. Esse valor é dividido de acordo com a taxa de participação na receita. O partner_revenue_reserved contém sua receita dessas origens.

Primetime

A tabela a seguir define os campos que aparecem nos relatórios gerenciados pelo sistema da API Reporting do YouTube para parceiros de programação do Primetime:

Campos
AgeGroup A faixa etária dos leitores no relatório. É necessário que haja pelo menos 50 eventos de visualização de membros de uma determinada faixa etária para que esse grupo seja listado. Os valores possíveis para o campo são:
  • 13-17
  • 18-24
  • 25-34
  • 35-44
  • 45-54
  • 55-64
  • 65+
AverageViewDuration O número médio de segundos assistidos do programa em todos os eventos de visualização.
AverageViewPercent A porcentagem média do programa que foi assistido em todos os eventos de visualização.
CallSign Se aplicável, identifica o indicativo de chamada da estação em que o programa foi veiculado.
ConcurrentViewers O número total de eventos de visualização em que um minuto específico do episódio, identificado pelo valor do campo MinutesSinceStart, foi assistido.
ContentId Um valor exclusivo que você, o provedor de metadados, usa para identificar um recurso e que você forneceu ao YouTube. Você pode usar esse valor para reconciliar o recurso com seu próprio sistema de gerenciamento de conteúdo. O valor pode ser um ID exclusivo criado para o recurso ou um identificador padrão, como um ID do TMS. O valor tem um comprimento máximo de 64 bytes e pode conter caracteres alfanuméricos, hífens (-), sublinhados (_), pontos (.), símbolos de arroba (@) ou barras (/).
ContentLength A duração do programa em segundos. A duração dos anúncios não é incluída nos programas VOD com inserção de anúncios dinâmicos (DAI).
ContentType A forma como o espectador assistiu o conteúdo. Os valores possíveis para o campo são:
  • DVR: o espectador gravou o programa e o salvou no DVR.
  • Live: o espectador assistiu o programa durante a transmissão ao vivo original. Por exemplo, o usuário assistiu a um evento esportivo ao vivo.
  • VOD: o espectador selecionou um episódio ou programa disponível sob demanda.
Date A data em que as visualizações do programa ocorreram. O valor está no formato YYYYMMDD.
DeviceType O tipo de dispositivo em que o espectador assistiu o conteúdo. É necessário ter pelo menos 50 eventos de visualização para um determinado tipo de dispositivo para que ele seja listado. Os possíveis valores de campo são:
  • Computer
  • Console
  • Mobile Phone
  • Tablet
  • TV
DmaId O identificador de três dígitos que a Nielsen usa para identificar as áreas de mercado designadas (DMAs) associadas aos eventos de visualização descritos na linha de dados.
EpisodeNumber Se aplicável, identifica o número sequencial do episódio do programa na temporada especificada. A temporada é identificada pelo campo SeasonNumber. Por exemplo, esse valor será 1 para o primeiro episódio da segunda temporada de um programa.
Gender O gênero dos espectadores no relatório. É necessário que haja pelo menos 50 eventos de visualização de membros de um determinado gênero para que ele seja listado. Os valores possíveis para o campo são:
  • Male
  • Female
MinutesSinceStart O número de minutos desde o início de um programa quando o evento de visualização começou. Observe que esse número inclui o tempo de exibição do programa e do anúncio, com exceção da programação sob demanda (VOD) que usa a inserção de anúncios dinâmicos (DAI). Para programação VOD com DAI, o número inclui apenas o tempo do programa.
Network A emissora ou rede que lançou o conteúdo ou em que ele foi veiculado.
PeakConcurrentViewers O número máximo de eventos de visualização simultânea em qualquer minuto de um programa específico.
Platform A maneira como o espectador assistiu o conteúdo. Os valores possíveis para o campo são:
  • Android
  • iOS
  • TV HTML5
  • Web
ProgramTitle O título ou nome do episódio, filme ou evento.
ProgramType O tipo de programa que o espectador assistiu. Os valores possíveis para o campo são:
  • PROGRAM_TYPE_UNKNOWN
  • PROGRAM_TYPE_MOVIE
  • PROGRAM_TYPE_EPISODE
  • PROGRAM_TYPE_COMPLEX_EPISODE
  • PROGRAM_TYPE_SPORTS
  • PROGRAM_TYPE_SPECIAL
  • PROGRAM_TYPE_EVENT
  • PROGRAM_TYPE_PAID_PROGRAMMING
PublishDateTime A data de exibição ou lançamento do programa. O valor está no formato YYYY-MM-DD.
SeasonNumber O número da temporada associada ao programa. O campo tem um comprimento máximo de 5 bytes.
SeriesTitle O título da série associada aos dados na linha do relatório. Por exemplo, em um programa de TV, esse valor especifica o nome do programa, e o campo ProgramTitle especifica o título do episódio.
TmsId O valor de ID do TMS (Tribune Media Systems) de 12 a 14 caracteres que identifica o programa de forma exclusiva.
TotalWatchTime É o tempo total, em segundos, que o programa foi assistido em todos os eventos de visualização.
ViewersComplete O número total de eventos de visualização de conteúdo ao vivo, DVR e VOD em que o espectador parou de assistir o vídeo em um minuto específico, identificado pelo valor do campo MinutesSinceStart. Se o valor de MinutesSinceStart representar um valor menor que o programa inteiro (ContentLength), esses espectadores pararam de assistir antes do fim do programa.
ViewersResume O número total de eventos de visualização em que o espectador inicia um programa de DVR ou VOD em qualquer momento, exceto no primeiro minuto (minuto 0) do vídeo.
ViewersStart O número total de eventos de visualização em que qualquer uma das seguintes condições é verdadeira:
  • O espectador entrou em uma transmissão ao vivo a qualquer momento do programa.
  • O espectador iniciou um programa de DVR em qualquer momento do primeiro minuto (minuto 0).
  • O espectador começou a assistir um programa VOD em qualquer momento do primeiro minuto (minuto 0).
Views O número total de vezes que o programa foi visualizado em todos os eventos de visualização.