Films, musique et séries TV
Le tableau suivant définit les champs qui apparaissent dans les rapports gérés par le système de l'API YouTube Reporting pour les partenaires de films, de musique et de TV:
Champs | |
---|---|
active_claims |
Nombre de revendications actives. |
active_reference_id |
ID généré par YouTube pour la référence active associée. |
activity_month |
Mois du rapport. |
adjustment_type |
Indique si la ligne représente des données sur les revenus normales ou un ajustement des revenus précédemment déclarés:
|
administer_publish_rights |
Indique si la maison de disques gère les droits de publication, c'est-à-dire qu'elle collecte et gère les paiements de redevances pour les auteurs-compositeurs, les compositeurs ou les éditeurs, ou d'autres parties propriétaires de la composition. Les valeurs possibles sont True et False .
|
adsense_earnings_month |
Mois des revenus pour lequel interroger le rapport AdSense. |
album |
Album contenant l'enregistrement audio. La valeur ne doit pas dépasser 255 octets. |
approx_daily_views |
Nombre moyen de vues quotidiennes de l'élément. |
artist |
Nom de l'artiste associé à l'asset identifié dans la ligne du rapport. La valeur ne doit pas dépasser 255 octets. |
asset_channel_id |
Chaîne propriétaire de la vidéo mise en ligne par un partenaire revendiquée par l'élément (asset_id ). La valeur du champ correspond à un ID de chaîne YouTube qui identifie de manière unique la chaîne. Vous pouvez récupérer des données supplémentaires sur la chaîne à l'aide de la méthode channels.list de l'API YouTube Data.
|
asset_custom_id |
Champ facultatif de métadonnées de l'élément permettant d'identifier celui-ci de façon unique (il s'agit souvent d'un code interne). Les autres partenaires n'ont pas accès à vos ID personnalisés. |
asset_id |
ID d'élément YouTube qui identifie de manière unique l'élément associé aux données de la ligne. Vous pouvez récupérer des données supplémentaires sur l'élément à l'aide de la méthode assets.list de l'API YouTube Content ID ou consulter l'élément sur la page "Éléments" de studio.youtube.com.
|
asset_labels |
Libellés d'éléments associés à l'élément. Les libellés d'éléments permettent de regrouper des éléments dans des catégories personnalisées. Vous pourrez ensuite utiliser les libellés pour rechercher des éléments, mettre à jour des groupes d'éléments, créer des campagnes pour des éléments avec libellé, filtrer YouTube Analytics, etc. |
asset_metadata_type |
Type d'élément de la référence, par exemple Web ou "Film".
|
asset_owners |
Propriétaires actuels de l'élément de la référence. |
asset_policy_block |
Territoires dans lesquels la règle du propriétaire est Block . La valeur correspond au code pays ou région à deux lettres du territoire.
|
asset_policy_id |
Identifiant unique d'une règle propriétaire. Actuellement, cette valeur n'est disponible que dans l'API. Cette information n'est pas affichée dans le Gestionnaire de contenu de Studio. |
asset_policy_monetize |
Territoires dans lesquels la règle du propriétaire est Monetize . La valeur correspond au code pays ou régional à deux lettres du territoire.
|
asset_policy_track |
Territoires dans lesquels la règle du propriétaire est Track . La valeur correspond au code pays ou régional à deux lettres du territoire.
|
asset_title |
Titre de l'élément. |
asset_type |
Type de l'élément. Les valeurs possibles sont les suivantes:
|
audio_royalties |
Revenus constatés issus de YouTube Audio Tier. Ces données correspondent au montant le plus élevé entre la part des revenus du partenaire de niveau audio dans les revenus publicitaires nets de niveau audio, et les revenus du partenaire issus du tarif minimum par lecture du contenu audio. |
audio_share |
Ratio entre le nombre de lectures Audio Tier du partenaire et le nombre total des lectures Audio Tier. |
category |
Genre de la vidéo, tel qu'affiché sur la page de lecture de la vidéo. La valeur correspond à un ID de catégorie de vidéos YouTube. Vous pouvez utiliser la méthode videoCategories.list de l'API YouTube Data pour obtenir un mappage des ID de catégories vidéo et des noms de catégories.
|
channel_display_name |
Nom à afficher de la chaîne qui a mis en ligne la vidéo |
channel_id |
Chaîne propriétaire de la vidéo (video_id ) associée aux données de la ligne. La valeur du champ est un ID de chaîne YouTube qui identifie de manière unique la chaîne. Vous pouvez récupérer des données supplémentaires sur la chaîne à l'aide de la méthode channels.list de l'API YouTube Data.
|
claiming_asset_type |
Type d'asset pour la revendication. |
claim_created_date |
Date à laquelle la revendication a été créée |
claim_id |
ID de revendication YouTube qui identifie de manière unique l'élément associé à une revendication dans la ligne. Vous pouvez récupérer des données supplémentaires sur l'élément à l'aide de la méthode claims.list de l'API YouTube Content ID ou rechercher l'élément sur la page des revendications de studio.youtube.com.
|
claim_origin |
Méthode utilisée pour revendiquer la vidéo Les valeurs possibles pour ce champ sont les suivantes:
|
claim_policy_block |
Territoires dans lesquels la règle applicable de la revendication est Block . La valeur correspond au code pays/région à deux lettres.
|
claim_policy_id |
Identifiant unique d'une règle appliquée. Actuellement, cette valeur n'est disponible que dans l'API. Cette information n'est pas affichée dans le Gestionnaire de contenu de Studio. |
claim_policy_monetize |
Territoires dans lesquels la règle applicable de la revendication est Monetize . La valeur correspond au code pays/région à deux lettres.
|
claim_policy_track |
Territoires dans lesquels la règle applicable de la revendication est Track . La valeur correspond au code pays/région à deux lettres.
|
claim_status |
Indique si l'état d'une revendication est ACTIVE , INACTIVE ou PENDING .
|
claim_status_detail |
Informations sur l'état d'une revendication, par exemple : CLOSED_MANUALLY .
|
claim_type |
Indique si la revendication couvre la partie audio, vidéo ou audiovisuelle du contenu revendiqué. Voici les valeurs valides pour ce champ:
|
claim_quality |
Source de la vidéo revendiquée. Les valeurs possibles pour ce champ sont les suivantes :
Remarque:Ce champ est appelé |
claimed_by_another_owner |
Indique si un autre propriétaire de contenu a une revendication propriétaire ou tierce active sur la vidéo. |
claimed_by_this_owner |
Indique si le titulaire des droits d'auteur qui génère le rapport a une revendication first party ou tierce active sur la vidéo. |
comments_allowed |
Indique si les commentaires sont activés pour la vidéo. |
composition_right_type |
Indique les types de droits de composition associés à la revendication. Voici les valeurs valides pour ce champ :
|
conflicting_country_code |
Codes pays ISO pour les territoires dans lesquels il existe un conflit de propriété avec d'autres partenaires |
conflicting_owner |
ID des autres partenaires avec un élément faisant l'objet d'un conflit de propriété |
content_type |
Source de la vidéo revendiquée. Les valeurs possibles sont les suivantes :
|
constituent_asset_id |
ID précédent d'un élément avant la fusion. |
constituent_asset_ids |
ID précédents des éléments avant leur fusion. |
country |
Indique le pays où l'activité s'est produite. |
country_code |
Indique le code du pays où l'activité a eu lieu. La valeur est un code pays ISO 3166-1 alpha-2. |
currency |
Indique la devise monétaire représentée par la ligne. |
currency_code |
Indique le code de devise monétaire que représente la ligne. |
custom_id |
Valeur unique que vous, en tant que fournisseur de métadonnées, utilisez pour identifier un élément. La valeur peut être un ID unique que vous avez créé pour l'élément ou un identifiant standard, tel qu'un ISRC. La valeur peut comporter jusqu'à 64 octets et peut contenir des caractères alphanumériques, des traits d'union (-), des traits de soulignement (_), des points (.), des symboles arobase (@) ou des barres obliques (/). |
date |
Date à laquelle l'activité s'est produite. La valeur est au format YYYYMMDD .
|
date_created |
Date et heure de création de la référence (exprimées en heure UTC) |
date_id |
Date à laquelle l'activité s'est produite. La valeur est au format YYYYMMDD .
|
day |
Jour de l'activité. |
director |
Réalisateur associé à l'élément. |
directors |
Réalisateurs associés à l'élément. |
display_ads_enabled |
Indique si des annonces tierces sont diffusées dans la vidéo. |
effective_policy |
Règles d'utilisation appliquées à la vidéo dans les pays où le propriétaire de contenu détient les droits de propriété. |
eidr |
Identifiant EIDR (Entertainment Identifier Registry) attribué à un film ou à un épisode de télévision. La valeur est composée d'un préfixe standard pour le registre EIDR, suivi d'une barre oblique, d'une chaîne de 20 caractères hexadécimaux, et d'un caractère alphanumérique de contrôle (0-9 A-Z). |
embedding_allowed |
Indique si la vidéo peut être intégrée sur des sites Web tiers. |
end_date |
Date et heure de fin |
episode_number |
Numéro de l'épisode associé à la vidéo. |
episode_title |
Titre d'un épisode de série TV ou de film |
excluded_perc |
Pourcentage des parties exclues de la référence, en fonction des exclusions totales et de la longueur. |
exclusions |
Parties exclues de la référence et type d'exclusions (par exemple, chevauchement de références, exclusion manuelle, segment incorrect)
Types d'exclusions disponibles :
|
grid |
Identifiant GRid (Global Release Identifier), champ facultatif de métadonnées permettant d'identifier un élément de façon unique La valeur du champ contient exactement 18 caractères alphanumériques. |
has_multiple_claims |
Indique si la vidéo fait l'objet de plusieurs revendications. La valeur est false si une seule revendication est associée à la vidéo et true si plusieurs revendications le sont.Remarque:Ce champ est appelé Multiple Claims? dans les rapports téléchargeables dans le menu "Rapports" de YouTube Studio.
|
hfa |
Code à six caractères attribué par la Harry Fox Agency (HFA) pour identifier de façon unique une composition. |
hfa_song_code |
Code à six caractères attribué par la Harry Fox Agency (HFA) pour identifier de façon unique une composition. |
inactive_reference_id |
ID généré par YouTube pour la référence inactive associée. |
is_made_for_kids_effective_setting |
Paramètre "Conçue pour les enfants" effectif de la vidéo. |
is_made_for_kids_modifiable |
Indique si l'utilisateur peut modifier le paramètre "Conçu pour les enfants". |
is_made_for_kids_user_selection |
Indique si l'utilisateur a désigné la vidéo comme "Conçue pour les enfants". |
is_merged |
Indique si l'élément a été créé suite à la fusion d'éléments. |
isrc |
Code ISRC (International Standard Recording Code) de l'élément associé. La valeur du champ contient exactement 12 caractères alphanumériques. |
iswc |
Code ISWC (International Standard Musical Work Code) de l'élément Composition. La valeur du champ contient exactement 11 caractères au format d'une lettre (T) suivie de 10 chiffres. |
label |
Maison de disques qui a publié un enregistrement audio. La valeur ne doit pas dépasser 255 octets. |
length_sec |
Durée de la référence en secondes. |
local_currency |
Type de devise locale dans laquelle les revenus sont versés. |
longest_match |
Correspondance la plus longue de la revendication |
long_nonskippable_video_ads_enabled |
Indique si les annonces longues non désactivables tierces peuvent être diffusées pendant la vidéo. Les annonces vidéo InStream sont diffusées pendant la lecture du contenu vidéo. |
match_policy |
Règle de correspondance appliquée à l'élément. |
matching_duration |
Durée totale de la correspondance de la revendication |
metadata_origination |
Source des métadonnées de l'élément. |
monetized_views |
Nombre total de flux audio uniquement et audiovisuels attribués à vos contenus dans le service sur abonnement YouTube Premium. Cette valeur n'est pertinente que pour les partenaires de musique. |
monetized_views_art_track_audio |
Nombre de flux audio uniquement de pistes artistiques attribués à vos contenus dans le service sur abonnement YouTube Premium. Ce champ n'est disponible que pour les partenaires de musique. |
monetized_views_art_track_audio_visual |
Nombre de flux audiovisuels de pistes artistiques attribués à vos contenus dans le service sur abonnement YouTube Premium. Ce champ n'est disponible que pour les partenaires de musique. |
monetized_views_audio |
Nombre total de flux audio uniquement attribués à vos contenus dans le service sur abonnement YouTube Premium. La valeur correspond à la somme des champs monetized_views_art_track_audio , monetized_views_partner_owned_audio et monetized_views_ugc_audio . Ce champ n'est disponible que pour les partenaires de musique.
|
monetized_views_audio_visual |
Nombre total de flux audiovisuels attribués à vos contenus dans le service sur abonnement YouTube Premium. La valeur correspond à la somme des champs monetized_views_art_track_audiovisual , monetized_views_partner_owned_audiovisual et monetized_views_ugc_audiovisual . Ce champ n'est disponible que pour les partenaires de musique.
|
monetized_views_partner_owned_audio |
Nombre de flux audio uniquement de contenus fournis par un partenaire et de clips musicaux officiels attribués à vos contenus dans le service sur abonnement YouTube Premium. Ce champ n'est disponible que pour les partenaires de musique. |
monetized_views_partner_owned_audio_visual |
Nombre de flux audiovisuels de contenus fournis par un partenaire et de clips musicaux officiels attribués à vos contenus dans le service sur abonnement YouTube Premium. Ce champ n'est disponible que pour les partenaires de musique. |
monetized_views_total_sub_service |
Somme de toutes les vues monétisées audiovisuelles et audio uniquement pour tous les contenus revendiqués de partenaires de musique YouTube dans le service sur abonnement YouTube Premium. Cette valeur n'est disponible que pour les partenaires de musique. |
monetized_views_ugc_audio |
Nombre de flux audio uniquement de contenus générés par les utilisateurs attribués à vos contenus dans le service sur abonnement YouTube Premium. Les contenus générés par les utilisateurs désignent les vidéos mises en ligne par les utilisateurs qui ne sont pas traitées de la même manière que les contenus sous licence fournis par les partenaires pour le partage des revenus. Ce champ n'est disponible que pour les partenaires de musique. |
monetized_views_ugc_audio_visual |
Nombre de flux audiovisuels de contenus générés par les utilisateurs attribués à vos contenus dans le service sur abonnement YouTube Premium. Les contenus générés par les utilisateurs désignent les vidéos mises en ligne par les utilisateurs qui ne sont pas traitées de la même manière que les contenus sous licence fournis par les partenaires pour le partage des revenus. Ce champ n'est disponible que pour les partenaires de musique. |
monetized_views_ugc_master_audio_visual |
Nombre total de flux audiovisuels de l'enregistrement master attribués à vos contenus dans le service sur abonnement YouTube Premium. Cette valeur n'est pertinente que pour les partenaires de musique. |
monetized_views_ugc_cover_audio_visual |
Nombre total de flux vidéo de reprises générés par les utilisateurs attribués à vos contenus dans le service sur abonnement YouTube Premium. Cette valeur n'est pertinente que pour les partenaires de musique. |
monetized_views_ugc_cover_shared_audio_visual |
Nombre total de vidéos reprises générées par les utilisateurs avec partage des revenus tripartite attribuées à vos contenus dans le service sur abonnement YouTube Premium. Cette valeur n'est pertinente que pour les partenaires de musique. |
monetized_watchtime |
Durée totale de visionnage des abonnements à YouTube Premium, en secondes, attribuée à vos vidéos non musicales |
month |
Mois de l'activité. |
midrolls_enabled |
Indique si des annonces mid-roll peuvent être diffusées pour la vidéo. Les annonces mid-roll sont des annonces vidéo qui s'affichent pendant une autre vidéo ou un autre événement. Par exemple, une annonce vidéo mid-roll peut s'afficher à intervalles réguliers pendant un long-métrage. Les annonces mid-roll ne sont destinées qu'aux contenus sous licence. |
multiple_claims |
Indique si la vidéo fait l'objet de plusieurs revendications. La valeur est false si une seule revendication est associée à la vidéo et true si plusieurs revendications le sont.Remarque:Ce champ est appelé Multiple Claims? dans les rapports téléchargeables dans le menu "Rapports" de YouTube Studio.
|
music_claim_type |
Indique si la revendication couvre la partie audio, vidéo ou audiovisuelle du contenu revendiqué. Voici les valeurs valides pour ce champ :
|
music_share |
Pourcentage de l'activité musicale en fonction du pays et de l'offre |
net_partner_revenue |
Revenus nets du partenaire. |
net_partner_revenue_post_revshare |
Revenu net du partenaire après le partage des revenus. |
revshare_rate_type |
Type de taux de partage des revenus appliqué aux revenus. |
nonskippable_video_ads_enabled |
Indique si des annonces tierces non désactivables sont diffusées pour la vidéo. Les annonces vidéo InStream sont diffusées pendant la lecture du contenu vidéo. |
notes |
Indique le paiement d'un mois précédent en cas de paiements d'ajustement différés. |
offweb_syndicatable |
Indique si la vidéo peut être affichée en dehors du navigateur. |
overlay_ads_enabled |
Indique si des annonces en superposition sont diffusées pour la vidéo. Les superpositions sont des annonces display qui s'affichent au-dessus de la vidéo au bout de 10 secondes. |
other_owners_claiming |
Noms des autres propriétaires de contenu qui revendiquent également la vidéo |
other_ownership_origination |
Source de la création de la propriété pour les autres propriétaires. |
owned_views |
Nombre total de vues de vos contenus pour lesquels la règle que vous avez définie est "Monétiser" ou "Suivre". Les rapports sur les annonces YouTube et les rapports sur les abonnements YouTube Premium pour les contenus non musicaux contiennent tous deux le champ policy , qui indique si la règle associée aux données était monetize ou track .
|
owned_subscription_views |
Nombre total de vues de vos contenus que vous possédez pour lesquels les règles sur le contenu sont "Monétiser" ou "Suivre", par abonnement YouTube Premium. |
ownership |
Propriétaire d'un élément dans des territoires spécifiques |
ownership_last_updated |
Date et heure de la dernière mise à jour de la propriété. |
ownership_origination |
Source de la création de la propriété. |
ownership_percentage |
Pourcentage de la composition dont vous êtes propriétaire. |
partner_audio_ad_revshare |
Prorata de votre part de revenus YouTube Audio Tier, prenant en compte le ou les tarifs du partage des revenus. Sert à déterminer le revenu le plus élevé. |
partner_audio_ad_revshare_rate |
Pourcentage de la part des revenus publicitaires du partenaire. |
partner_playbacks |
Lectures attribuées à votre contenu dans le service YouTube Audio Tier |
partner_revenue |
Vos revenus publicitaires en USD après la répartition des revenus. Ce champ apparaît dans les rapports sur les annonces YouTube. Le champ youtube_revenue_split contient le total des revenus avant que la répartition des revenus ne soit appliquée.
|
partner_revenue_art_track |
Prorata de votre part de revenus des abonnements à YouTube Premium, correspondant aux contenus de pistes artistiques et diffusés en mode audiovisuel |
partner_revenue_audio |
Prorata de votre part de revenus des abonnements à YouTube Premium correspondant aux contenus diffusés en mode audio uniquement |
partner_revenue_local |
Vos revenus publicitaires dans la devise locale après la répartition des revenus Ce champ apparaît dans les rapports sur les annonces YouTube. Le champ youtube_revenue_split contient le total des revenus avant que la répartition des revenus ne soit appliquée.
|
partner_revenue_usd |
Vos revenus publicitaires après le partage des revenus Ce champ apparaît dans les rapports sur les annonces YouTube. Le champ youtube_revenue_split contient le total des revenus avant que la répartition des revenus ne soit appliquée.
|
partner_revenue_auction |
Revenus générés par les annonces AdSense vendues aux enchères |
partner_revenue_per_play_min |
Revenus calculés en fonction du tarif minimum par lecture. Sert à déterminer le revenu le plus élevé au niveau du pays. |
partner_revenue_per_sub_min |
Revenus par pays, calculés en fonction du minimum par abonné ; sert à déterminer le revenu le plus élevé. |
partner_revenue_pro_rata |
Prorata de votre part de revenus des abonnements à YouTube Premium, prenant en compte le ou les tarifs du partage des revenus |
partner_revenue_pro_rata_audio |
Prorata de votre part de revenus des abonnements à YouTube Premium correspondant aux contenus diffusés en mode audio uniquement |
partner_revenue_pro_rata_audio_per_sub_min |
Prorata de votre part de revenus des abonnements à YouTube Premium correspondant aux contenus diffusés en mode audio uniquement |
partner_revenue_pro_rata_audio_visual |
Prorata de votre part de revenus des abonnements à YouTube Premium, correspondant aux contenus diffusés en mode audiovisuel |
partner_revenue_pro_rata_partner_owned |
Prorata de votre part de revenus des abonnements à YouTube Premium, correspondant aux contenus mis en ligne par le partenaire et diffusés en mode audiovisuel |
partner_revenue_pro_rata_ugc |
Prorata de votre part de revenus des abonnements à YouTube Premium, correspondant aux contenus générés par les utilisateurs et diffusés en mode audiovisuel |
partner_revenue_pro_rata_art_track |
Prorata de votre part de revenus des abonnements à YouTube Premium, correspondant aux contenus de pistes artistiques et diffusés en mode audiovisuel |
partner_revenue_partner_sold_partner_served |
Vos revenus issus des annonces que vous avez vendues et diffusées à partir de vos propres serveurs publicitaires externes. |
partner_revenue_partner_sold_youtube_served |
Vos revenus issus de la publicité vendue via DoubleClick for Publishers (DFP) après la répartition du partage des revenus. |
partner_revenue_reserved |
Vos revenus issus de la publicité vendue en réservation via DoubleClick (DCLK) et d'autres sources vendues par YouTube après la répartition du partage des revenus. |
partner_revenue_ugc |
Vos revenus issus des contenus générés par les utilisateurs |
payment_period |
Période pendant laquelle le paiement a été effectué. |
per_play_minimum |
Tarif minimum par lecture dans ce pays |
per_play_minimum_currency |
Devise définie pour le tarif minimum par lecture du contenu audio. |
per_play_minimum_partner_revenue |
Revenus calculés en fonction du tarif minimum par lecture. Sert à déterminer le revenu le plus élevé. |
per_sub_min_rate |
Revenus par pays, calculés en fonction du minimum par abonné ; sert à déterminer le revenu le plus élevé. |
per_subs_min_rate |
Tarif par minimum d'abonnés dans ce pays |
policy |
Règle appliquée à la vidéo La valeur est monetize ou track .
|
pool_participating_rate |
Part de marché des contenus financés par la publicité (AVOD) de tous les partenaires participants au pool dynamique par rapport à la grande entreprise de référence. |
postrolls_enabled |
Indique si des annonces post-roll peuvent être diffusées pour la vidéo. Les annonces post-roll sont diffusées après la vidéo ou la diffusion en direct que le spectateur regarde. |
prerolls_enabled |
Indique si des annonces pré-roll peuvent être diffusées pour la vidéo. Les annonces pré-roll sont diffusées avant la vidéo ou la diffusion en direct que le spectateur regarde. Il arrive que plusieurs annonces pré-roll soient diffusées. |
provider |
Nom du propriétaire du contenu qui a envoyé la référence. |
ratings_allowed |
Indique si les évaluations sont activées pour la vidéo. |
record_label |
Nom de la maison de disques indiqué dans les métadonnées de l'élément Applicable uniquement aux partenaires de musique. |
reference_id |
ID généré par YouTube pour la référence associée à une revendication Ce champ reste vide pour les revendications mises en ligne par le partenaire. |
reference_type |
Type ou canal de référence, tels que Audio , Visual ou AudioVisual .
|
reference_video_id |
ID vidéo généré par YouTube pour une référence Applicable uniquement si la revendication est associée à une référence créée à partir d'une vidéo YouTube. |
release_date |
Date de sortie indiquée dans les métadonnées de l'élément Applicable uniquement aux partenaires TV/film. |
revenue_source |
Indique la source des revenus. Les valeurs possibles sont les suivantes :
|
revenue_type |
Indique le type de revenus représenté par la ligne. |
right_type |
Indique les types de droits de composition associés à la revendication. Voici les valeurs valides pour ce champ :
|
season |
Numéro de la saison associée à un épisode de télévision. La longueur maximale du champ est de cinq octets. |
shorts_flat_fee_revenue_usd |
Revenus issus du tarif fixe en USD pour les Shorts. |
shorts_monthly_pool_usd |
Revenus mensuels (en USD) de la mise en commun des revenus des Shorts. |
shorts_partner_revenue_usd |
Revenus du partenaire en USD pour les Shorts |
shorts_usages_marketshare |
Part de marché de l'utilisation des Shorts. |
skippable_video_ads_enabled |
Indique si les annonces vidéo désactivables sont activées pour la vidéo. Les annonces InStream désactivables sont diffusées avant, pendant ou après d'autres vidéos sur YouTube, ainsi que sur les sites Web et applications des partenaires vidéo Google. L'utilisateur peut choisir de les désactiver après un délai de cinq secondes et de continuer à regarder la vidéo. |
source_of_fingerprint |
Source de l'empreinte numérique d'un fichier de référence donné. |
sponsored_cards_enabled |
Indique si les fiches sponsorisées sont activées pour la vidéo. Les fiches d'informations sur les produits sponsorisées permettent aux spectateurs d'acheter les produits qu'ils voient dans les vidéos. |
start_date |
Date et heure de début |
status |
Indique l'état de l'asset. Les valeurs possibles sont active ou inactive .
|
studio |
Studio associé à l'élément. |
subscribers |
Nombre d'abonnés. |
tax_withholding_rate |
Taux de retenue à la source applicable dans le rapport sur la retenue à la source. |
tax_withheld_amount |
Montant de la retenue à la source dans le rapport sur la retenue à la source. |
third_party_ads_enabled |
Indique si les annonces tierces sont activées pour la vidéo. |
third_party_video_id |
ID vidéo fourni par le partenaire, utilisé par celui-ci pour identifier la vidéo à des fins de ciblage publicitaire. |
time_published |
Date et heure de publication de la vidéo sur YouTube, au format MM/DD/YYYY HH:MM:SS . Ce champ est vide pour les vidéos qui n'ont jamais été rendues publiques (vidéos privées ou non répertoriées, par exemple).
|
time_uploaded |
Date et heure de mise en ligne de la vidéo sur YouTube au format MM/DD/YYYY HH:MM:SS .
|
tms |
Valeur d'ID TMS (Tribune Media Systems) de 12 à 14 caractères qui identifie de manière unique un film ou un épisode de série TV. |
total_playbacks |
Nombre total de lectures dans le service YouTube Audio Tier. |
total_revenue_by_source |
Total des revenus par source, comme les revenus publicitaires ou les revenus issus des abonnements. |
total_views |
Nombre total de vues. |
unlaunched_territories_adjustment |
Ajustement du pool Shorts pour les territoires non lancés. |
upc |
Code produit universel (UPC), champ facultatif de métadonnées permettant d'identifier de façon unique un élément |
uploader |
Nom du propriétaire du contenu ayant mis en ligne la vidéo |
upload_source |
Méthode utilisée pour mettre en ligne la vidéo sur YouTube |
us_sourced_revenue |
Montant des revenus provenant des États-Unis. |
usd_local_rate |
Taux de change utilisé pour convertir les montants USD en devise locale. Cette valeur correspond à un taux moyen pour les transactions quotidiennes survenant au cours de la période de référence. |
username |
Nom du propriétaire de contenu YouTube. |
video_channel_id |
Identifiant généré par YouTube pour désigner la chaîne sur laquelle la vidéo revendiquée a été mise en ligne |
video_duration |
Durée de la vidéo. |
video_duration_sec |
Durée de la vidéo en secondes. |
video_id |
Vidéo revendiquée associée aux données de la ligne. La valeur du champ est un ID vidéo YouTube, qui identifie de manière unique la vidéo. Vous pouvez récupérer des données supplémentaires sur la vidéo à l'aide de la méthode videos.list de l'API YouTube Data.
|
video_length |
Durée de la vidéo en secondes. |
video_privacy_status |
Indique si la vidéo est publique, privée ou non répertoriée. |
video_title |
Titre de la vidéo associée aux données de la ligne. |
video_upload_date |
Date à laquelle la vidéo revendiquée a été mise en ligne |
video_url |
URL de la vidéo sur YouTube. |
views |
Nombre de fois où la vidéo a été regardée. |
writers |
Liste des auteurs de la composition, délimitée par des barres verticales. |
youtube_revenue_split |
Pour les maisons de disques, les partenaires TV et les partenaires cinéma:revenus publicitaires YouTube totaux générés par vos contenus. Ce montant est ensuite réparti en fonction du taux de partage des revenus. Le champ
Pour les éditeurs de musique:revenus publicitaires YouTube totaux générés par vos contenus, en tenant compte de la propriété des éléments, mais avant d'être répartis en fonction du taux de partage des revenus. Le champ |
youtube_revenue_split_auction |
Pour les maisons de disques, les studios de cinéma et les chaînes de télévision:revenus totaux générés par les annonces AdSense vendues aux enchères avant l'application des répartitions des revenus. Pour les éditeurs de musique:revenus totaux générés par la publicité AdSense vendue aux enchères, en tenant compte de la propriété des éléments, mais avant d'appliquer les répartitions du partage des revenus. |
youtube_revenue_split_partner_sold_partner_served |
Pour les maisons de disques, les partenaires TV et les partenaires cinéma:revenus totaux générés par les annonces vendues et diffusées par un partenaire. Ce montant est ensuite réparti en fonction du taux de partage des revenus.
Pour les éditeurs de musique:revenus totaux générés par les annonces vendues et diffusées par un partenaire, en tenant compte de la propriété des éléments. Ce montant est ensuite réparti en fonction du taux de partage des revenus. |
youtube_revenue_split_partner_sold_youtube_served |
Pour les maisons de disques, les studios de cinéma et les chaînes de télévision:revenus totaux issus de DoubleClick for Publishers (DFP). Ce montant est ensuite réparti en fonction du taux de partage des revenus.
Pour les éditeurs musicaux:revenus totaux issus de DoubleClick for Publishers (DFP), en tenant compte de la propriété des éléments. Ce montant est ensuite réparti en fonction du taux de partage des revenus. |
youtube_revenue_split_reserved |
Pour les maisons de disques, les partenaires TV/film:revenus totaux générés par la publicité vendue en réservation via DoubleClick (DCLK) et d'autres sources vendues par YouTube. Ce montant est ensuite réparti en fonction du taux de partage des revenus.
Pour les éditeurs de musique:revenus totaux générés par la publicité vendue par réservation via DoubleClick (DCLK) et d'autres sources vendues par YouTube, en tenant compte de la propriété des éléments. Ce montant est ensuite réparti en fonction du taux de partage des revenus. |
Primetime
Le tableau suivant définit les champs qui apparaissent dans les rapports gérés par le système de l'API YouTube Reporting pour les partenaires de programmation Primetime:
Champs | |
---|---|
AgeGroup |
Tranche d'âge des spectateurs dans le rapport. Notez qu'au moins 50 événements de visionnage doivent être enregistrés par des membres d'une tranche d'âge donnée pour que ce groupe soit listé. Les valeurs possibles pour ce champ sont les suivantes :
|
AverageViewDuration |
Nombre moyen de secondes regardées du programme pour tous les événements de visionnage. |
AverageViewPercent |
Pourcentage moyen de visionnage du programme pour l'ensemble des événements de visionnage. |
CallSign |
Le cas échéant, identifie l'indicatif de la chaîne sur laquelle le programme a été diffusé. |
ConcurrentViewers |
Nombre total d'événements de visionnage au cours desquels une minute spécifique de l'épisode, identifiée par la valeur du champ MinutesSinceStart , a été visionnée.
|
ContentId |
Valeur unique que vous, fournisseur de métadonnées, utilisez pour identifier un élément et que vous avez fournie à YouTube. Vous pouvez utiliser cette valeur pour rapprocher l'asset de votre propre système de gestion de contenu. La valeur peut être un ID unique que vous avez créé pour l'élément ou un identifiant standard, tel qu'un ID TMS. La valeur peut comporter jusqu'à 64 octets et peut contenir des caractères alphanumériques, des traits d'union (-), des traits de soulignement (_), des points (.), des symboles arobase (@) ou des barres obliques (/). |
ContentLength |
Durée du programme en secondes. Notez que la durée des annonces n'est pas incluse pour les programmes VOD avec insertion dynamique d'annonces (DAI). |
ContentType |
Comment le spectateur a regardé le contenu Les valeurs possibles pour ce champ sont les suivantes :
|
Date |
Date à laquelle les vues du programme ont eu lieu. La valeur est au format YYYYMMDD .
|
DeviceType |
Type d'appareil sur lequel l'utilisateur a regardé le contenu. Notez qu'il doit y avoir au moins 50 événements de visionnage pour un type d'appareil donné pour que ce type d'appareil soit listé. Les valeurs possibles pour ce champ sont les suivantes :
|
DmaId |
Identifiant à trois chiffres que Nielsen utilise pour identifier la zone de marché désignée (DMA) associée aux événements de visionnage décrits dans la ligne de données. |
EpisodeNumber |
Le cas échéant, indique le numéro séquentiel de l'épisode du programme dans la saison spécifiée.
La saison est identifiée par le champ SeasonNumber . Par exemple, cette valeur sera 1 pour le premier épisode de la deuxième saison d'un programme.
|
Gender |
Genre des spectateurs dans le rapport. Notez qu'au moins 50 événements de visionnage doivent être enregistrés par des spectateurs d'un genre donné pour que ce genre soit listé. Les valeurs possibles pour ce champ sont les suivantes :
|
MinutesSinceStart |
Nombre de minutes écoulées depuis le début d'un programme au moment où l'événement de visionnage a commencé. Notez que ce nombre inclut à la fois la durée du programme et la durée des annonces, à l'exception des programmes à la demande (VOD) qui utilisent l'insertion dynamique d'annonces (DAI). Pour la programmation VOD avec l'insertion dynamique d'annonces, le nombre n'inclut que la durée du programme. |
Network |
Chaîne ou chaîne de télévision qui a diffusé le contenu ou sur laquelle il a été diffusé. |
PeakConcurrentViewers |
Nombre maximal d'événements de visionnage simultanés à une minute donnée pour un programme donné. |
Platform |
Comment le spectateur a regardé le contenu Les valeurs possibles pour ce champ sont les suivantes:
|
ProgramTitle |
Titre ou nom de l'épisode, du film ou de l'événement. |
ProgramType |
Type de programme regardé par l'utilisateur. Les valeurs possibles pour ce champ sont les suivantes:
|
PublishDateTime |
Date de diffusion ou de sortie du programme. La valeur est au format YYYY-MM-DD .
|
SeasonNumber |
Numéro de la saison associée au programme. La longueur maximale du champ est de cinq octets. |
SeriesTitle |
Titre de la série associée aux données de la ligne du rapport. Par exemple, pour un programme TV, cette valeur spécifie le nom de l'émission, et le champ ProgramTitle spécifie le titre de l'épisode.
|
TmsId |
Valeur d'ID TMS (Tribune Media Systems) de 12 à 14 caractères qui identifie de manière unique le programme. |
TotalWatchTime |
Durée totale, en secondes, pendant laquelle le programme a été regardé pour l'ensemble des événements de visionnage. |
ViewersComplete |
Nombre total d'événements de visionnage en direct, DVR et VOD au cours desquels l'utilisateur a cessé de regarder la vidéo pendant une minute donnée, identifiée par la valeur du champ MinutesSinceStart . Si la valeur MinutesSinceStart est inférieure à la durée totale du programme (ContentLength ), cela signifie que ces spectateurs ont arrêté de regarder le programme avant la fin.
|
ViewersResume |
Nombre total d'événements de visionnage au cours desquels l'utilisateur lance un programme DVR ou un programme VOD à un autre moment que la première minute (minute 0) de la vidéo. |
ViewersStart |
Nombre total d'événements de visionnage pour lesquels l'une des conditions suivantes est remplie :
|
Views |
Nombre total de fois où le programme a été visionné pour tous les événements de visionnage. |