System-Managed Reports - Fields

Film, musica e TV

La seguente tabella definisce i campi visualizzati nei report gestiti dal sistema dell'API YouTube Reporting per i partner di film, musica e TV:

Campi
active_claims Il numero di rivendicazioni attive.
active_reference_id L'ID generato da YouTube per il riferimento attivo associato.
activity_month Il mese del report.
adjustment_type Indica se la riga rappresenta dati sulle entrate normali o un aggiustamento delle entrate registrate in precedenza:
  • Se la riga rappresenta dati normali sulle entrate, il valore del campo è None. Inoltre, i dati in quella riga riportano i dati relativi al mese associato al report.
  • Se la riga rappresenta un aggiustamento dei dati registrati in precedenza, il campo contiene uno dei valori nell'elenco seguente. In questo caso, la riga potrebbe contenere dati di mesi diversi da quello associato al report. Ad esempio, il report di novembre 2016 potrebbe contenere aggiustamenti applicabili agli eventi di ottobre 2016 o di altri mesi precedenti.

    I possibili tipi di aggiustamento sono:
    • Backpay - Pagamento trattenuto a causa della mancanza della proprietà.
    • Conflict Resolution - Pagamento trattenuto a causa di un conflitto di proprietà. Si tratta anche di una forma di pagamento arretrato.
    • Dispute Resolution - Pagamento relativo a una controversia risolta per le entrate trattenute prima dei pagamenti del mese in corso.
    • Dispute Conflict Resolution: un pagamento di arretrati derivante da una contestazione risolta che è stato trattenuto a causa di un conflitto di proprietà.
    • Spam Adjustment - Pagamento relativo alla correzione dello spam. Si tratta di una detrazione, che AdSense riporta come Invalid Activity - YouTube.
    • Revenue Correction - Pagamento relativo a un bug tecnico o alla correzione dei dati. Questo valore può essere un credito o una detrazione.
administer_publish_rights Indica se la casa discografica amministra i diritti di pubblicazione, ovvero raccoglie e gestisce i pagamenti delle royalty per autori, compositori o editori o altre parti che possiedono la composizione. I valori possibili sono True e False.
adsense_earnings_month Mese di utili in cui eseguire una query sul report AdSense.
album L'album in cui è inclusa una registrazione audio. Il valore ha una lunghezza massima di 255 byte.
approx_daily_views La media delle visualizzazioni giornaliere della risorsa.
artist Il nome dell'artista associato alla risorsa identificata nella riga del report. Il valore ha una lunghezza massima di 255 byte.
asset_channel_id Il canale proprietario del video caricato dal partner che è oggetto di rivendicazione da parte della risorsa (asset_id). Il valore del campo è un ID canale YouTube che identifica in modo univoco il canale. Puoi recuperare ulteriori dati sul canale utilizzando il metodo channels.list dell'API YouTube Data.
asset_custom_id Un campo facoltativo dei metadati della risorsa utilizzato per identificare in modo univoco una risorsa (di solito, un codice interno). Gli altri partner non possono visualizzare il tuo ID personalizzato.
asset_id L'ID risorsa di YouTube che identifica in modo univoco la risorsa associata ai dati nella riga. Puoi recuperare ulteriori dati sulla risorsa utilizzando il metodo assets.list dell'API YouTube Content ID o cercando la risorsa nella pagina Risorse di studio.youtube.com.
asset_labels Etichette delle risorse associate alla risorsa. Le etichette delle risorse consentono di raggruppare le risorse in categorie personalizzate. Le etichette possono essere utilizzate per cercare risorse, aggiornare gruppi di risorse, creare campagne per le risorse con etichetta, filtrare YouTube Analytics e altro ancora.
asset_metadata_type Il tipo di risorsa per il riferimento, ad esempio Web o Film.
asset_owners Proprietari attuali della risorsa per il riferimento.
asset_policy_block I territori in cui la norma del proprietario è Block. Il valore è il codice paese o regione di due lettere per il territorio.
asset_policy_id Identificatore univoco per una norma del proprietario. Al momento, questo valore è disponibile solo nell'API. Questa informazione non viene visualizzata in Studio Content Manager.
asset_policy_monetize I territori in cui la norma del proprietario è Monetize. Il valore è il codice di due lettere del paese o della regione per il territorio.
asset_policy_track I territori in cui la norma del proprietario è Track. Il valore è il codice di due lettere del paese o della regione per il territorio.
asset_title Titolo della risorsa.
asset_type Il tipo di risorsa. I valori possibili sono:
  • Art Track: rappresenta una traccia su YouTube di una registrazione audio che non dispone di un video musicale premium.
  • Composition: rappresenta una composizione musicale. Una composizione musicale include metadati come l'ISWC e gli autori. È l'unico tipo di risorsa che può avere più proprietari per territorio. Potrebbe essere incorporata in una risorsa registrazione audio.
  • Movie: rappresenta un lungometraggio. Un film include metadati come l'ISAN/EIDR e il regista.
  • Music Video: rappresenta il video musicale ufficiale di una registrazione audio. Un video musicale include metadati come l'ISRC video, il brano musicale e gli artisti. Una risorsa "video musicale" incorpora una risorsa "registrazione audio".
  • Sound Recording: rappresenta una registrazione audio. Una registrazione audio è provvista di metadati quali l'ISRC, l'artista e l'album. Incorpora una risorsa "composizione" e può a sua volta essere incorporata in una risorsa "video musicale".
  • Television episode: rappresenta una puntata di un programma televisivo. Una puntata include metadati come la stagione e il numero della puntata.
  • Web: rappresenta i video originali di YouTube o altri tipi di contenuti video non coperti dagli altri tipi di risorse.
audio_royalties Le tue entrate riconosciute derivanti dalle entrate del livello audio di YouTube. Calcolate in base al massimale tra la quota audio del partner delle entrate pubblicitarie nette derivanti da annunci audio e le entrate del partner basate sui valori minimi per riproduzione audio.
audio_share Rapporto tra riproduzioni del livello audio del partner e riproduzioni del livello audio totali.
category Il genere del video, come visualizzato nella relativa pagina di visualizzazione. Il valore è un ID categoria video di YouTube. Puoi utilizzare il metodo videoCategories.list dell'API YouTube Data per recuperare una mappatura degli ID categoria video ai nomi delle categorie.
channel_display_name Il nome visualizzato del canale che ha caricato il video.
channel_id Il canale proprietario del video (video_id) associato ai dati nella riga. Il valore del campo è un ID canale YouTube che identifica in modo univoco il canale. Puoi recuperare ulteriori dati sul canale utilizzando il metodo channels.list dell'API YouTube Data.
claiming_asset_type Il tipo di risorsa per la rivendicazione.
claim_created_date La data di creazione della rivendicazione.
claim_id L'ID rivendicazione di YouTube che identifica in modo univoco la risorsa associata a una rivendicazione nella riga. Puoi recuperare dati aggiuntivi sulla risorsa utilizzando il metodo claims.list dell'API YouTube Content ID o cercando la risorsa nella pagina Reclami di studio.youtube.com.
claim_origin Metodo con cui è stata creata la rivendicazione nei confronti del video. I valori possibili per il campo sono:
  • 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 I territori in cui la norma di rivendicazione applicata è Block. Il valore è il codice paese/regione di due lettere.
claim_policy_id Identificatore univoco per un criterio applicato. Al momento, questo valore è disponibile solo nell'API. Questa informazione non viene visualizzata in Studio Content Manager.
claim_policy_monetize I territori in cui la norma di rivendicazione applicata è Monetize. Il valore è il codice paese/regione di due lettere.
claim_policy_track I territori in cui la norma di rivendicazione applicata è Track. Il valore è il codice paese/regione di due lettere.
claim_status Indica se lo stato di una rivendicazione è ACTIVE, INACTIVE o PENDING.
claim_status_detail Dettaglio sullo stato di una rivendicazione, ad esempio CLOSED_MANUALLY.
claim_type Indica se la rivendicazione copre la parte audio, video o audiovisiva dei contenuti rivendicati. I valori validi per questo campo sono:
  • Audio
  • Audiovisivo
  • Visivo
claim_quality L'origine del video rivendicato. I valori possibili per il campo sono:
  • Partner-provided: il video è stato caricato da un partner di YouTube.
  • Premium UGC: il video è stato caricato da terze parti, con segmenti protetti da copyright conformi ai requisiti di durata e proporzionalità necessari per essere considerati alla stregua dei contenuti concessi in licenza forniti dai partner per la condivisione delle entrate.
  • UGC: il video è costituito da contenuti generati dagli utenti, ovvero è stato caricato da una terza parte, ma non soddisfa i requisiti per essere considerato alla stregua dei contenuti concessi in licenza forniti dai partner per la condivisione delle entrate.

Nota: questo campo si chiama Content Type nei report scaricabili dal menu Report di YouTube Studio.

claimed_by_another_owner Indica se un altro proprietario dei contenuti ha una rivendicazione proprietaria o di terze parti attiva sul video.
claimed_by_this_owner Indica se il proprietario dei contenuti che genera il report ha una rivendicazione proprietaria o di terze parti attiva sul video.
comments_allowed Indica se i commenti sono abilitati per il video.
composition_right_type Specifica i tipi di diritti di composizione associati alla rivendicazione. I valori validi per questo campo sono:
  • Apparecchiature meccaniche
  • Prestazioni
  • Sincronizzazione
conflicting_country_code I codici paese ISO per i territori con conflitti di proprietà con altri partner.
conflicting_owner Gli ID partner di altri partner con proprietà in conflitto.
content_type L'origine del video rivendicato. I valori possibili sono:
  • Partner-provided: il video che carichi su un canale YouTube di tua proprietà. Lo rivendichi al momento del caricamento e applichi una norma di utilizzo. La rivendicazione dei contenuti caricati dai partner abilita le opzioni di monetizzazione, le corrispondenze di Content ID e la segnalazione.
  • Premium UGC: un video caricato da una terza parte che include segmenti protetti da copyright conformi ai requisiti di durata e proporzionalità necessari per essere considerati alla stregua dei contenuti concessi in licenza forniti dai partner.
  • UGC: un video caricato da terze parti che include contenuti di tua proprietà, come stabilito da una corrispondenza di Content ID o da una rivendicazione manuale. La norma di corrispondenza associata alla rivendicazione determina dove e come il video è disponibile su YouTube.
constituent_asset_id ID precedente di una risorsa prima dell'unione.
constituent_asset_ids ID precedenti delle risorse prima dell'unione.
country Identifica il paese in cui si è verificata l'attività.
country_code Identifica il codice paese del paese in cui si è verificata l'attività. Il valore è un codice paese ISO 3166-1 alpha-2.
currency Indica la valuta monetaria rappresentata dalla riga.
currency_code Indica il codice valuta monetaria rappresentato dalla riga.
custom_id Un valore univoco che tu, in qualità di fornitore di metadati, utilizzi per identificare una risorsa. Il valore può essere un ID univoco creato per la risorsa o un identificatore standard, ad esempio un codice ISRC. Il valore ha una lunghezza massima di 64 byte e può contenere caratteri alfanumerici, trattini (-), trattini bassi (_), punti (.), simboli "at" (@) o barre (/).
date La data in cui si è verificata l'attività. Il valore è in formato YYYYMMDD.
date_created Data e ora in cui è stato creato il riferimento in UTC.
date_id La data in cui si è verificata l'attività. Il valore è in formato YYYYMMDD.
day Il giorno in cui si è verificata l'attività.
director Regista associato alla risorsa.
directors Registi associati alla risorsa.
display_ads_enabled Indica se nel video vengono mostrati annunci di terze parti.
effective_policy Le norme di utilizzo applicate al video nei territori di proprietà del proprietario dei contenuti.
eidr L'Entertainment Identifier Registry (EIDR) assegnato a un film o a una puntata di un programma televisivo. Il valore contiene un prefisso standard per il registro EIDR, seguito da una barra, una stringa esadecimale composta da 20 caratteri e un carattere di controllo alfanumerico (0-9A-Z).
embedding_allowed Indica se il video può essere incorporato su siti web di terze parti.
end_date Data e ora di fine.
episode_number Il numero di puntata associato al video.
episode_title Il titolo di una puntata di un programma televisivo o di un film.
excluded_perc Percentuale del riferimento esclusa, in base a esclusioni e durata totali.
exclusions Parti del riferimento escluse e tipo di esclusione (ad es. sovrapposizione nei riferimenti, esclusione manuale, segmento non valido). Tipi di esclusioni disponibili:
  • O = Esclusione manuale tramite Content Manager
  • P = Esclusione manuale tramite API
  • I = Esclusione manuale tramite Content Delivery
  • C = Sovrapposizione nei riferimenti
  • S = Segmento non valido
  • B = Esclusione definitiva
grid Global Release Identifier (GRid), un campo di metadati facoltativo usato per identificare in modo univoco una risorsa. Il valore del campo contiene esattamente 18 caratteri alfanumerici.
has_multiple_claims Indica se il video presenta più rivendicazioni. Il valore è false se esiste una rivendicazione sul video e true se ce ne sono più di una.

Nota: questo campo si chiama Multiple Claims? nei report scaricabili dal menu Report di YouTube Studio.
hfa Il codice di sei caratteri assegnato dalla Harry Fox Agency (HFA) per identificare in modo univoco una composizione.
hfa_song_code Il codice di sei caratteri assegnato dalla Harry Fox Agency (HFA) per identificare in modo univoco una composizione.
inactive_reference_id L'ID generato da YouTube per il riferimento inattivo associato.
is_made_for_kids_effective_setting L'impostazione "Destinato ai bambini" effettiva del video.
is_made_for_kids_modifiable Indica se l'impostazione "Destinato ai bambini" è modificabile dall'utente.
is_made_for_kids_user_selection Indica se il video è stato contrassegnato come "Destinato ai bambini" dall'utente.
is_merged Indica se la risorsa è stata creata a seguito dell'unione di risorse.
isrc L'International Standard Recording Code (ISRC) della risorsa correlata. Il valore del campo contiene esattamente 12 caratteri alfanumerici.
iswc L'International Standard Musical Work Code (ISWC) della risorsa di composizione. Il valore del campo contiene esattamente 11 caratteri ed è composto da una lettera (T) seguita da 10 numeri.
label La casa discografica che ha pubblicato una registrazione audio. Il valore ha una lunghezza massima di 255 byte.
length_sec La durata del riferimento in secondi.
local_currency Il tipo di valuta locale in cui vengono pagate le entrate.
longest_match La parte corrispondente più lunga relativa a una rivendicazione.
long_nonskippable_video_ads_enabled Indica se durante il video possono essere riprodotti annunci di terze parti lunghi non ignorabili. Gli annunci video in-stream vengono mostrati durante la riproduzione dei contenuti video.
match_policy La norma di corrispondenza applicata alla risorsa.
matching_duration La durata totale della corrispondenza relativa a una rivendicazione.
metadata_origination L'origine dei metadati della risorsa.
monetized_views Il numero totale di stream solo audio e audiovisivi attribuiti ai tuoi contenuti nel servizio in abbonamento YouTube Premium. Questo valore è pertinente solo per i partner musicali.
monetized_views_art_track_audio Il numero di stream solo audio degli art track attribuiti ai tuoi contenuti nel servizio in abbonamento YouTube Premium. Questo campo è supportato solo per i partner musicali.
monetized_views_art_track_audio_visual Il numero di stream audiovisivi di art track attribuiti ai tuoi contenuti nel servizio in abbonamento YouTube Premium. Questo campo è supportato solo per i partner musicali.
monetized_views_audio Il numero totale di stream solo audio attribuiti ai tuoi contenuti nel servizio in abbonamento YouTube Premium. Il valore è la somma dei campi monetized_views_art_track_audio, monetized_views_partner_owned_audio e monetized_views_ugc_audio. Questo campo è supportato solo per i partner musicali.
monetized_views_audio_visual Il numero totale di stream audiovisivi attribuiti ai tuoi contenuti nel servizio in abbonamento YouTube Premium. Il valore è la somma dei campi monetized_views_art_track_audiovisual, monetized_views_partner_owned_audiovisual e monetized_views_ugc_audiovisual. Questo campo è supportato solo per i partner musicali.
monetized_views_partner_owned_audio Il numero di stream solo audio dei contenuti di video musicali ufficiali forniti dai partner che sono stati attribuiti ai tuoi contenuti nel servizio in abbonamento YouTube Premium. Questo campo è supportato solo per i partner musicali.
monetized_views_partner_owned_audio_visual Il numero di stream audiovisivi di contenuti video musicali ufficiali e forniti dai partner attribuiti ai tuoi contenuti nel servizio in abbonamento YouTube Premium. Questo campo è supportato solo per i partner musicali.
monetized_views_total_sub_service La somma di tutte le visualizzazioni monetizzate in modalità solo audio e audiovisivo, riconducibili a tutti i contenuti rivendicati di partner musicali di YouTube, nel servizio in abbonamento YouTube Premium. Questo valore è disponibile solo per i partner musicali.
monetized_views_ugc_audio Il numero di stream solo audio di contenuti generati dagli utenti attribuiti ai tuoi contenuti nel servizio in abbonamento YouTube Premium. Per contenuti generati dagli utenti si intendono i video caricati dagli utenti che non vengono trattati come i contenuti concessi in licenza dal partner per la condivisione delle entrate. Questo campo è supportato solo per i partner musicali.
monetized_views_ugc_audio_visual Il numero di stream audiovisivi di contenuti generati dagli utenti attribuiti ai tuoi contenuti nel servizio in abbonamento YouTube Premium. Per contenuti generati dagli utenti si intendono i video caricati dagli utenti che non vengono trattati come i contenuti concessi in licenza dal partner per la condivisione delle entrate. Questo campo è supportato solo per i partner musicali.
monetized_views_ugc_master_audio_visual Il numero totale di stream audiovisivi delle registrazioni master attribuiti ai tuoi contenuti nel servizio in abbonamento YouTube Premium. Questo valore è pertinente solo per i partner musicali.
monetized_views_ugc_cover_audio_visual Il numero totale di stream video di copertina generati dagli utenti attribuiti ai tuoi contenuti nel servizio in abbonamento YouTube Premium. Questo valore è pertinente solo per i partner musicali.
monetized_views_ugc_cover_shared_audio_visual Il numero totale di video di copertina generati dagli utenti con condivisione delle entrate a tre parti attribuiti ai tuoi contenuti nel servizio in abbonamento YouTube Premium. Questo valore è pertinente solo per i partner musicali.
monetized_watchtime La quantità totale di tempo di visualizzazione associato agli abbonamenti a YouTube Premium, in secondi, attribuito ai tuoi video non musicali.
month Il mese in cui si è verificata l'attività.
midrolls_enabled Indica se gli annunci mid-roll possono essere riprodotti per il video. Gli annunci mid-roll sono annunci video che vengono visualizzati durante un altro video o evento. Ad esempio, un annuncio video mid-roll può essere visualizzato a intervalli durante un film. Gli annunci mid-roll sono riservati solo ai contenuti concessi in licenza.
multiple_claims Indica se il video presenta più rivendicazioni. Il valore è false se esiste una rivendicazione sul video e true se ce ne sono più di una.

Nota: questo campo si chiama Multiple Claims? nei report scaricabili dal menu Report di YouTube Studio.
music_claim_type Indica se la rivendicazione copre la parte audio, video o audiovisiva dei contenuti rivendicati. I valori validi per questo campo sono:
  • Audio
  • Audiovisivo
  • Visivo
music_share Percentuale di attività musicale per paese e offerta.
net_partner_revenue Entrate nette del partner.
net_partner_revenue_post_revshare Entrate nette del partner dopo l'applicazione della suddivisione della quota di condivisione delle entrate.
revshare_rate_type Il tipo di tariffa della quota di condivisione delle entrate applicata alle entrate.
nonskippable_video_ads_enabled Indica se vengono riprodotti annunci non ignorabili di terze parti per il video. Gli annunci video in-stream vengono mostrati durante la riproduzione dei contenuti video.
notes Indica il pagamento di un mese precedente nel caso di pagamenti di aggiustamenti differiti.
offweb_syndicatable Indica se il video può essere visualizzato al di fuori del browser.
overlay_ads_enabled Indica se gli annunci in overlay vengono riprodotti per il video. Gli annunci in overlay sono annunci display mostrati sopra il video dopo 10 secondi.
other_owners_claiming I nomi di altri proprietari dei contenuti che hanno rivendicato il video.
other_ownership_origination L'origine della proprietà per altri proprietari.
owned_views Il numero totale di visualizzazioni dei tuoi contenuti di proprietà per i quali hai impostato la monetizzazione o il monitoraggio.

I report Annunci di YouTube e i report Abbonamenti a YouTube Premium per i contenuti non musicali contengono entrambi il campo policy, che indica se il criterio associato ai dati era monetize o track.
owned_subscription_views Il numero totale di visualizzazioni generate dagli abbonati a YouTube Premium dei tuoi contenuti di proprietà per i quali le norme relative ai contenuti prevedono la monetizzazione o il monitoraggio.
ownership Il proprietario di una risorsa in determinati territori
ownership_last_updated Data e ora dell'ultimo aggiornamento della proprietà.
ownership_origination L'origine della proprietà.
ownership_percentage La percentuale di tua proprietà della composizione.
partner_audio_ad_revshare La tua quota di compartecipazione alle entrate del livello audio di YouTube, su base proporzionale, tenendo conto delle quote di compartecipazione alle entrate. Utilizzato per calcolare il massimale.
partner_audio_ad_revshare_rate Percentuale della quota di condivisione delle entrate pubblicitarie del partner.
partner_playbacks Riproduzioni all'interno del servizio del livello audio di YouTube attribuite ai tuoi contenuti.
partner_revenue Le entrate in dollari provenienti dalla pubblicità dopo l'applicazione della suddivisione della quota di condivisione delle entrate. Questo campo viene visualizzato nei report sugli annunci di YouTube. Il campo youtube_revenue_split contiene le entrate totali prima dell'applicazione della suddivisione della quota di condivisione delle entrate.
partner_revenue_art_track La tua quota di condivisione delle entrate generate da un abbonamento a YouTube Premium per i contenuti art track riprodotti in modalità audiovisiva.
partner_revenue_audio La tua quota di condivisione delle entrate generate da un abbonamento a YouTube Premium per i contenuti riprodotti in modalità solo audio.
partner_revenue_local Le entrate pubblicitarie nella valuta locale dopo l'applicazione della suddivisione della quota di condivisione delle entrate. Questo campo viene visualizzato nei report sugli annunci di YouTube. Il campo youtube_revenue_split contiene le entrate totali prima dell'applicazione della suddivisione della quota di condivisione delle entrate.
partner_revenue_usd Le entrate pubblicitarie dopo l'applicazione della suddivisione della quota di condivisione delle entrate. Questo campo viene visualizzato nei report sugli annunci di YouTube. Il campo youtube_revenue_split contiene le entrate totali prima dell'applicazione della suddivisione della quota di condivisione delle entrate.
partner_revenue_auction Le tue entrate pubblicitarie di AdSense vendute tramite asta.
partner_revenue_per_play_min Entrate calcolate sulla base dei valori minimi per riproduzione. Utilizzato per calcolare il massimale aggregato a livello di paese.
partner_revenue_per_sub_min Entrate per paese calcolate sulla base di valori minimi per abbonato; utile per il calcolo del massimale.
partner_revenue_pro_rata La tua quota di condivisione delle entrate generate da un abbonamento a YouTube Premium, su base proporzionale, tenendo conto delle tariffe applicate per la quota di condivisione delle entrate.
partner_revenue_pro_rata_audio La tua quota di condivisione delle entrate generate da un abbonamento a YouTube Premium, su base proporzionale, per i contenuti riprodotti in modalità solo audio.
partner_revenue_pro_rata_audio_per_sub_min La tua quota di condivisione delle entrate generate da un abbonamento a YouTube Premium, su base proporzionale, per i contenuti riprodotti solo in audio.
partner_revenue_pro_rata_audio_visual La tua quota di condivisione delle entrate generate da un abbonamento a YouTube Premium, su base proporzionale, per i contenuti riprodotti in modalità audiovisiva.
partner_revenue_pro_rata_partner_owned La tua quota di condivisione delle entrate generate da un abbonamento a YouTube Premium, su base proporzionale, per i contenuti caricati dai partner e riprodotti in modalità audiovisiva.
partner_revenue_pro_rata_ugc La tua quota di condivisione delle entrate generate da un abbonamento a YouTube Premium, su base proporzionale, per i contenuti generati dagli utenti e riprodotti in modalità audiovisiva.
partner_revenue_pro_rata_art_track La tua quota di condivisione delle entrate generate da un abbonamento a YouTube Premium, su base proporzionale, per i contenuti Art Track riprodotti in modalità audiovisiva.
partner_revenue_partner_sold_partner_served Le entrate generate dagli annunci che hai venduto e pubblicato dai tuoi ad server esterni.
partner_revenue_partner_sold_youtube_served Le entrate pubblicitarie vendute tramite DoubleClick for Publishers (DFP) dopo l'applicazione della suddivisione della quota di condivisione delle entrate.
partner_revenue_reserved Le entrate pubblicitarie generate da annunci venduti con prenotazione tramite DoubleClick (DCLK) e altre fonti vendute da YouTube dopo l'applicazione della suddivisione della quota di condivisione delle entrate.
partner_revenue_ugc Le tue entrate generate dai contenuti generati dagli utenti.
payment_period Periodo di tempo in cui è stato effettuato il pagamento.
per_play_minimum La tariffa minima per riproduzione nel paese specificato.
per_play_minimum_currency La valuta del valore minimo per riproduzione audio.
per_play_minimum_partner_revenue Entrate calcolate sulla base dei valori minimi per riproduzione. Utilizzato per calcolare il massimale.
per_sub_min_rate Entrate per paese calcolate sulla base di valori minimi per abbonato; utile per il calcolo del massimale.
per_subs_min_rate La tariffa per numero minimo di abbonati nel paese specificato.
policy La norma applicata al video. Il valore è monetize o track.
pool_participating_rate La quota di mercato con pubblicità (AVOD) di tutti i partner partecipanti al pool dinamico rispetto al benchmark principale.
postrolls_enabled Indica se gli annunci post-roll possono essere riprodotti per il video. Gli annunci post-roll vengono riprodotti dopo il video o il live streaming che lo spettatore sta guardando.
prerolls_enabled Indica se è possibile riprodurre annunci pre-roll per il video. Gli annunci pre-roll vengono riprodotti prima del video o del live streaming che lo spettatore sta guardando. A volte viene riprodotto più di un annuncio pre-roll.
provider Il nome del proprietario dei contenuti che ha fornito il riferimento.
ratings_allowed Indica se le valutazioni sono attive per il video.
record_label Il nome della casa discografica contenuto nei metadati della risorsa. Pertinente solo per i partner musicali.
reference_id L'ID generato da YouTube per il riferimento associato a una rivendicazione. Il campo è lasciato vuoto per le rivendicazioni caricate da partner.
reference_type Il tipo di riferimento o il canale, ad esempio Audio, Visual, AudioVisual.
reference_video_id L'ID video generato da YouTube di un riferimento. Pertinente solo se la rivendicazione è associata a un riferimento creato da un video di YouTube.
release_date La data di uscita contenuta nei metadati della risorsa. Pertinente solo per i partner TV/film.
revenue_source Indica la fonte delle entrate. I valori possibili sono:
  • Ads: entrate generate dagli annunci mostrati sul video.
  • Subscriptions - Entrate generate dagli abbonamenti a pagamento a YouTube Premium.
  • Transactions - Entrate generate dalle transazioni, come contenuti a pagamento o acquisti.
revenue_type Indica il tipo di entrate rappresentato dalla riga.
right_type Specifica i tipi di diritti di composizione associati alla rivendicazione. I valori validi per questo campo sono:
  • Apparecchiature meccaniche
  • Prestazioni
  • Sincronizzazione
season Il numero di stagione associato a una puntata di un programma televisivo. Il campo ha una lunghezza massima di 5 byte.
shorts_flat_fee_revenue_usd Le entrate da tariffa fissa in dollari statunitensi per Shorts.
shorts_monthly_pool_usd Le entrate mensili in dollari per il pool di Shorts.
shorts_partner_revenue_usd Le entrate partner in dollari statunitensi per Shorts.
shorts_usages_marketshare La quota di mercato per l'utilizzo di Shorts.
skippable_video_ads_enabled Indica se gli annunci video ignorabili sono attivati per il video. Gli annunci in-stream ignorabili vengono riprodotti prima, durante o dopo altri video su YouTube e nelle app e sui siti web dei partner video Google. Trascorsi 5 secondi, lo spettatore può, se vuole, saltare l'annuncio e continuare a guardare il video.
source_of_fingerprint L'origine del fingerprint per un determinato file di riferimento.
sponsored_cards_enabled Indica se le schede sponsorizzate sono attivate per il video. Le schede informative sui prodotti sponsorizzati consentono agli spettatori di acquistare i prodotti che vedono nei video.
start_date Data e ora di inizio.
status Indica lo stato della risorsa. I valori possibili sono active o inactive.
studio Lo studio associato alla risorsa.
subscribers Il numero di iscritti.
tax_withholding_rate L'aliquota della ritenuta fiscale applicabile nel report sulle ritenute fiscali.
tax_withheld_amount L'importo dell'imposta trattenuta nel report sulle ritenute fiscali.
third_party_ads_enabled Indica se gli annunci di terze parti sono abilitati per il video.
third_party_video_id L'ID video fornito dal partner utilizzato dal partner per identificare il video a fini di targeting degli annunci.
time_published Data e ora di pubblicazione del video su YouTube in formato MM/DD/YYYY HH:MM:SS. Questo campo sarà vuoto per i video che non sono mai stati resi pubblici (ad es.video privati o non in elenco).
time_uploaded Data e ora in cui il video è stato caricato su YouTube in formato MM/DD/YYYY HH:MM:SS.
tms Il valore dell'ID Tribune Media Systems (TMS) di 12-14 caratteri che identifica in modo univoco un film o una puntata TV.
total_playbacks Numero totale delle riproduzioni all'interno del servizio del livello audio di YouTube.
total_revenue_by_source Le entrate totali per origine, ad esempio entrate pubblicitarie o da abbonamenti.
total_views Il numero totale di visualizzazioni.
unlaunched_territories_adjustment L'aggiustamento al pool di Shorts per i territori in cui la funzionalità non è stata lanciata.
upc L'Universal Product Code (UPC), un campo di metadati facoltativo usato per identificare in modo univoco una risorsa.
uploader Il nome del proprietario dei contenuti che ha caricato il video.
upload_source Il metodo utilizzato per caricare il video su YouTube.
us_sourced_revenue L'importo delle entrate provenienti dagli Stati Uniti.
usd_local_rate Il tasso di cambio utilizzato per convertire i dollari nella valuta locale. Il valore rappresenta un tasso medio per le transazioni giornaliere effettuate nell'arco del periodo del report.
username Il nome del proprietario dei contenuti di YouTube.
video_channel_id L'identificatore di canale generato da YouTube per il canale in cui è stato pubblicato il video oggetto della rivendicazione.
video_duration La durata del video.
video_duration_sec La durata del video in secondi.
video_id Il video rivendicato associato ai dati nella riga. Il valore del campo è un ID video di YouTube, che identifica in modo univoco il video. Puoi recuperare dati aggiuntivi sul video utilizzando il metodo videos.list dell'API YouTube Data.
video_length La durata del video in secondi.
video_privacy_status Indica se il video è pubblico, privato o non in elenco.
video_title Il titolo del video associato ai dati nella riga.
video_upload_date La data di pubblicazione del video oggetto della rivendicazione.
video_url L'URL del video su YouTube.
views Il numero di volte in cui il video è stato visualizzato.
writers Un elenco delimitato da barre verticali degli autori della composizione.
youtube_revenue_split

Per case discografiche, partner TV e film: entrate pubblicitarie totali di YouTube generate dai tuoi contenuti. Questo importo viene successivamente suddiviso in base alla percentuale di condivisione delle entrate. Il campo partner_revenue contiene le tue entrate.

Per i publisher musicali: entrate totali generate dagli annunci di YouTube provenienti dai tuoi contenuti, tenendo conto della proprietà degli asset, ma prima della suddivisione in base alla quota di condivisione delle entrate. Il campo partner_revenue contiene le tue entrate.

youtube_revenue_split_auction

Per case discografiche, partner TV e cinematografici: entrate totali generate dalla pubblicità AdSense venduta all'asta prima dell'applicazione delle suddivisioni della quota di condivisione delle entrate.

Per i publisher di musica: entrate totali generate dalla pubblicità AdSense venduta all'asta, tenendo conto della proprietà degli asset, ma prima dell'applicazione delle suddivisioni della quota di condivisione delle entrate.

youtube_revenue_split_partner_sold_partner_served

Per case discografiche, partner TV e film: entrate totali generate dagli annunci venduti e pubblicati dal partner. Questo importo viene successivamente suddiviso in base alla percentuale di condivisione delle entrate. Il valore partner_revenue_partner_served_partner_sold contiene le tue entrate generate dagli annunci venduti e pubblicati dai partner.

Per gli editori musicali: entrate totali generate dagli annunci venduti e pubblicati dal partner, tenendo conto della proprietà delle risorse. Questo importo viene successivamente suddiviso in base alla percentuale di condivisione delle entrate. Il valore partner_revenue_partner_served_partner_sold contiene le tue entrate generate dagli annunci venduti e pubblicati dai partner.

youtube_revenue_split_partner_sold_youtube_served

Per case discografiche, film e partner TV: entrate totali generate da DoubleClick for Publishers (DFP). Questo importo viene successivamente suddiviso in base alla percentuale di condivisione delle entrate. partner_revenue_partner_served_partner_sold contiene le tue entrate generate dagli annunci venduti e pubblicati dai partner.

Per i publisher di musica: entrate totali generate da DoubleClick for Publishers (DFP), tenendo conto della proprietà delle risorse. Questo importo viene successivamente suddiviso in base alla percentuale di condivisione delle entrate. Il valore partner_revenue_partner_sold_youtube_sold contiene le tue entrate generate dagli annunci venduti e pubblicati dai partner.

youtube_revenue_split_reserved

Per case discografiche, partner TV e cinematografici: entrate totali generate dalla pubblicità venduta con prenotazione tramite DoubleClick (DCLK) e altre fonti vendute da YouTube. Questo importo viene successivamente suddiviso in base alla percentuale di condivisione delle entrate. Il file partner_revenue_reserved contiene le tue entrate provenienti da queste fonti.

Per gli editori musicali: entrate totali generate dalla pubblicità venduta su prenotazione tramite DoubleClick (DCLK) e altre sorgenti vendute da YouTube, tenendo conto della proprietà degli asset. Questo importo viene successivamente suddiviso in base alla percentuale di condivisione delle entrate. Il file partner_revenue_reserved contiene le tue entrate provenienti da queste fonti.

Primetime

La tabella seguente definisce i campi visualizzati nei report gestiti dal sistema dell'API YouTube Reporting per i partner di programmazione Primetime:

Campi
AgeGroup La fascia d'età dei visualizzatori nel report. Tieni presente che devono essere presenti almeno 50 eventi di visualizzazione da parte di membri di una determinata fascia d'età affinché il gruppo venga elencato. I valori possibili per il campo sono:
  • 13-17
  • 18-24
  • 25-34
  • 35-44
  • 45-54
  • 55-64
  • 65+
AverageViewDuration Il numero medio di secondi visualizzati del programma in tutti gli eventi di visualizzazione.
AverageViewPercent La percentuale media del programma visualizzata in tutti gli eventi di visualizzazione.
CallSign Se applicabile, identifica il codice identificativo della stazione su cui è stato trasmesso il programma.
ConcurrentViewers Il numero totale di eventi di visualizzazione durante i quali è stato visualizzato un determinato minuto della puntata, identificato dal valore del campo MinutesSinceStart.
ContentId Un valore univoco che tu, in qualità di fornitore di metadati, utilizzi per identificare una risorsa e che hai fornito a YouTube. Puoi utilizzare questo valore per riconciliare la risorsa con il tuo sistema di gestione dei contenuti. Il valore può essere un ID univoco creato per la risorsa o un identificatore standard, ad esempio un ID TMS. Il valore ha una lunghezza massima di 64 byte e può contenere caratteri alfanumerici, trattini (-), trattini bassi (_), punti (.), simboli "at" (@) o barre (/).
ContentLength La durata del programma in secondi. Tieni presente che la durata degli annunci non è inclusa per i programmi VOD con inserzione di annunci dinamici (DAI).
ContentType Il modo in cui lo spettatore ha guardato i contenuti. I valori possibili per il campo sono:
  • DVR: lo spettatore ha registrato il programma e lo ha salvato sul DVR.
  • Live: lo spettatore ha guardato il programma durante la trasmissione live originale. Ad esempio, lo spettatore ha guardato un evento sportivo in diretta.
  • VOD: lo spettatore ha selezionato una puntata o un programma disponibile on demand.
Date La data in cui si sono verificate le visualizzazioni del programma. Il valore è in formato YYYYMMDD.
DeviceType Il tipo di dispositivo su cui lo spettatore ha guardato i contenuti. Tieni presente che devono essere presenti almeno 50 eventi di visualizzazione per un determinato tipo di dispositivo affinché questo venga elencato. I possibili valori di campo sono:
  • Computer
  • Console
  • Mobile Phone
  • Tablet
  • TV
DmaId L'identificatore di 3 cifre utilizzato da Nielsen per identificare la Designated Market Area (DMA) associata agli eventi di visualizzazione descritti nella riga di dati.
EpisodeNumber Se applicabile, identifica il numero sequenziale della puntata del programma all'interno della stagione specificata. La stagione è identificata dal campo SeasonNumber. Ad esempio, questo valore sarà 1 per la prima puntata della seconda stagione di un programma.
Gender Il genere degli spettatori nel report. Tieni presente che devono essere presenti almeno 50 eventi di visualizzazione da parte di membri di un determinato genere affinché questo venga elencato. I valori possibili per il campo sono:
  • Male
  • Female
MinutesSinceStart Il numero di minuti dall'inizio di un programma quando è iniziato l'evento di visualizzazione. Tieni presente che questo numero include sia il tempo del programma sia il tempo dell'annuncio, ad eccezione della programmazione on demand (VOD) che utilizza l'inserimento di annunci dinamici (DAI). Per la programmazione VOD con DAI, il numero include solo la durata del programma.
Network La stazione o la rete che ha pubblicato i contenuti o su cui sono stati trasmessi.
PeakConcurrentViewers Il numero massimo di eventi di visualizzazione simultanea in un determinato minuto di un determinato programma.
Platform Il modo in cui lo spettatore ha guardato i contenuti. I valori possibili per il campo sono:
  • Android
  • iOS
  • TV HTML5
  • Web
ProgramTitle Il titolo o il nome della puntata, del film o dell'evento.
ProgramType Il tipo di programma guardato dallo spettatore. I valori possibili per il campo sono:
  • 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 La data di messa in onda o di uscita del programma. Il valore è in formato YYYY-MM-DD.
SeasonNumber Il numero della stagione associato al programma. Il campo ha una lunghezza massima di 5 byte.
SeriesTitle Il titolo della serie associata ai dati nella riga del report. Ad esempio, per un programma TV, questo valore specifica il nome del programma e il campo ProgramTitle specifica il titolo della puntata.
TmsId Il valore dell'ID Tribune Media Systems (TMS) da 12 a 14 caratteri che identifica in modo univoco il programma.
TotalWatchTime La quantità di tempo totale, in secondi, in cui il programma è stato guardato in tutti gli eventi di visualizzazione.
ViewersComplete Il numero totale di eventi di visualizzazione di live, DVR e VOD durante i quali lo spettatore ha interrotto la visione del video in un determinato minuto, identificato dal valore del campo MinutesSinceStart. Se il valore MinutesSinceStart è inferiore alla durata dell'intero programma (ContentLength), significa che questi spettatori hanno smesso di guardare prima della fine del programma.
ViewersResume Il numero totale di eventi di visualizzazione in cui lo spettatore avvia un programma DVR o VOD in un momento diverso dal primo minuto (minuto 0) del video.
ViewersStart Il numero totale di eventi di visualizzazione in cui si verifica una delle seguenti condizioni:
  • Lo spettatore si è unito a un live streaming in qualsiasi momento del programma.
  • Lo spettatore ha avviato un programma DVR in qualsiasi momento del primo minuto (minuto 0).
  • Lo spettatore ha avviato un programma VOD in qualsiasi momento del primo minuto (minuto 0).
Views Il numero totale di volte in cui il programma è stato visualizzato in tutti gli eventi di visualizzazione.