Partager via


Analyse vidéo réseau

Le rapport Network Video Analytics peut être utilisé pour afficher les métriques d’événement vidéo d’un membre du réseau. Pour explorer les analyses plus précises d’un annonceur ou d’un éditeur spécifique, consultez les rapports Network Video Advertiser Analytics et Network Video Publisher Analytics .

Remarque

  • Les métriques vidéo sont enregistrées uniquement pour les créations VAST.
  • Pour obtenir des instructions sur la récupération d’un rapport, consultez Service de rapports ou l’exemple ci-dessous.

Période

Le report_interval champ peut être défini sur l’une des valeurs suivantes :

  • aujourd’hui
  • yesterday
  • last_hour
  • last_24_hours
  • last_48_hours
  • month_to_date
  • month_to_yesterday
  • last_2_days
  • last_7_days
  • last_14_days
  • last_30_days
  • last_7_available_days
  • last_14_available_days
  • last_30_available_days
  • last_365_days

Période de conservation des données

Les données de ce rapport sont conservées pendant 420 jours.

Remarque

Pour exécuter un rapport pour une période personnalisée, définissez les start_date champs et end_date dans votre demande de rapport. Pour plus d’informations sur ces champs, consultez Service de rapports.

Dimensions

Column Type Filtre? Exemple Description
hour Temps Oui "2010-02-01 06:00:00" L’heure de la vente aux enchères.

Remarque : Pour les impressions antérieures à 100 jours, le jour est retourné plutôt que l’heure.
day Temps Oui "2010-02-01" Le jour de la vente aux enchères.
month Temps Non "2010-02" Le mois de la vente aux enchères.
buyer_member_id int Oui 123 ID du membre acheteur. Si l’impression n’a pas été achetée, ce champ affiche l’une des valeurs suivantes :
229 = PSA
0 = Vide
319 = Valeur par défaut
buyer_member_name string Non "My Network" Nom du membre acheteur.
buyer_member string Non "My Network (123)" Déconseillé (à compter du 17 octobre 2016).
split_id int Oui 342 ID du fractionnement qui a acheté les impressions dans ce jeu de données. Les fractionnements s’appliquent uniquement aux éléments de ligne augmentée. Pour tous les rapports qui contiennent des campagnes, le (s’il split_id est inclus) est null.
split_name string Oui "Mobile Split A" Nom du fractionnement qui a acheté les impressions dans ce jeu de données. Les fractionnements s’appliquent uniquement aux éléments de ligne augmentée. Pour tous les rapports qui contiennent des campagnes, le (s’il split_name est inclus) est null.
creative_id int Oui 554 ID du créatif.

Remarque : pour les suivis de clic ou d’impression externes, creative_id sera "External Clicks" ou "External Imps".
creative_name string Non "Q1 2010 728x90" Nom du créatif.

Remarque : pour les suivis de clic ou d’impression externes, creative_id sera "External Clicks" ou "External Imps".
creative string Non "Q1 2010 728x90 (554)" Déconseillé (à compter du 17 octobre 2016).
member_id int Oui 767 ID du membre.
seller_member_id int Oui 456 ID du membre vendeur.
seller_member_name string Non "That Seller" Nom du membre vendeur.
seller_member string Non "That Seller (456)" Déconseillé (à compter du 17 octobre 2016).
advertiser_id int Oui 789 ID de l’annonceur. Si la valeur est 0, soit l’impression a été achetée par un acheteur externe, soit une valeur par défaut ou une valeur PSA a été affichée.
advertiser_name string Non "Verizon Wireless" Nom de l’annonceur.
advertiser string Non "Verizon Wireless (789)" Déconseillé (à compter du 17 octobre 2016).
advertiser_currency string Oui "USD" Devise de l’annonceur.
publisher_id int Oui 321 ID de l’éditeur.
publisher_name string Non "Test" Nom de l’éditeur.
publisher string Non "Test (123)" Déconseillé (à compter du 17 octobre 2016).
publisher_currency string Oui "USD" Devise de l’éditeur.
site_id int Oui 194 ID du site.

Remarque : Pour les impressions antérieures à 100 jours, la site_id valeur est 0.
site_name string Non "Site Name" Nom du site.
site string Non "Site Name (194)" Déconseillé (à compter du 17 octobre 2016).
placement_id int Oui 456 ID du placement.

Remarque : Pour les impressions antérieures à 100 jours, les placements sont agrégés en une ligne avec -1 comme placement_id.
placement_name string Non "Ivillage 160x600" Nom du placement.

Remarque : Pour les impressions antérieures à 100 jours, les placements sont agrégés en une ligne avec "All placement data older than 100 days" comme placement_name.
placement_code string Non "Ivillage Code" Code personnalisé pour le placement.
insertion_order_id int Oui 321 ID de l’ordre d’insertion.
insertion_order_name string Non "Insertion Order" Nom de l’ordre d’insertion.
insertion_order string Non "Insertion Order (321)" Déconseillé (à compter du 17 octobre 2016).
line_item_id int Oui 111 ID de l’élément de ligne.
line_item_name string Non "Default Line Item" Nom de l’élément de ligne.
line_item string Non "Default Line Item (111)" Déconseillé (à compter du 17 octobre 2016).
line_item_code string Non "Default Line Item Code" Code personnalisé pour l’élément de ligne.
campaign_id int Oui 222 ID de la campagne.
campaign_name string Non "Default Campaign" Nom de la campagne.
campaign string Non "Default Campaign (222)" Déconseillé (à compter du 17 octobre 2016).
size string Oui "728x90" Taille du placement/créatif servi.
brand_id int Tes 3 ID de la marque associée à un créatif. Pour imp_type_id = 6, aucune information n’est disponible dans le brand_id champ de ce rapport. Consultez plutôt le Rapport d’évaluation de la marque du vendeur.
brand_name string Non "Ace Hardware" Nom de la marque associée à un créatif. Pour imp_type_id = 6, aucune information n’est disponible dans le brand_name champ de ce rapport. Consultez plutôt le Rapport d’évaluation de la marque du vendeur.
brand string Non "Ace Hardware (3)" Déconseillé (à compter du 17 octobre 2016).
geo_country string Oui "US" Code du pays géographique.
geo_country_name string Non "United States" Nom du pays géographique.
deal_id int Oui 2345 ID de la transaction. Pour plus d’informations sur les transactions négociées entre les acheteurs et les vendeurs, consultez Deal Service et Deal Buyer Access Service.
deal_name string Non "Private deal for buyer 1085 with floor of $2.50" Nom de la transaction.
deal string Non "Private deal for buyer 1085 with floor of $2.50 (45)" Déconseillé (à compter du 17 octobre 2016).
trafficker_for_insertion_order string Oui "Maurice Truman" Trafficker pour l’ordre d’insertion. Pour plus d’informations, consultez le "labels" champ du service d’ordre d’insertion .
salesrep_for_insertion_order string Oui "Beverly Heller" Représentant commercial de la commande d’insertion. Pour plus d’informations, consultez le "labels" champ du service d’ordre d’insertion .
creative_recency_bucket_id string Non "4" ID du compartiment de récence créative. Pour connaître les valeurs possibles, consultez Compartiments de récence créatifs ci-dessous.
creative_recency_bucket chaîne Oui "15-30 minutes" Compartiment de l’affichage récent de la création. Pour connaître les valeurs possibles, consultez Compartiments de récence créatifs ci-dessous.
creative_frequency_bucket chaîne Oui "11-20" Compartiment correspondant à la fréquence à laquelle le créatif a été affiché. Pour connaître les valeurs possibles, consultez Compartiments de fréquence de création ci-dessous.
creative_frequency_bucket_id string Non "3" ID du compartiment de fréquence de création. Pour connaître les valeurs possibles, consultez Compartiments de fréquence de création ci-dessous.
site_domain string Non bestsiteever.com Domaine dans lequel l’impression s’est produite. Pour les applications mobiles, il peut s’agir de l’URL de l’emplacement de l’application dans l’App Store.
Il existe deux valeurs supplémentaires qui peuvent apparaître à la place d’un domaine, en particulier : "deals.unknown" ou "managed.unknown". Cela signifie que nous n’avons pas reçu de domaine valide en tant que référent. Par exemple, le domaine peut être vide ou mal formé.
mobile_application_id int Oui 343200656 Un ID App Store Apple, un ID d’application Android ou un ID d’application Windows pouvant être ciblé.
supply_type string Oui "mobile_web" Canal classé vendeur pour dénominer l’offre en termes d’impressions web, web optimisée pour les appareils mobiles et d’applications mobiles. Les valeurs possibles sont les suivantes :
- "web"
- "mobile_app"
- "mobile_web"
video_playback_method string Oui "1" Méthode de lecture pour le créatif. Consultez La méthode de lecture vidéo ci-dessous pour connaître les valeurs possibles.
video_context string Oui "3" Type de la vidéo créative. Pour connaître les valeurs possibles, consultez Contexte vidéo ci-dessous.
video_player_size_id string Oui "2" ID de la largeur du lecteur vidéo. Pour connaître les valeurs possibles, consultez Taille du joueur ci-dessous.
imp_type_id int Oui 3 ID du type d’impression associé. Valeurs possibles : valeur entière qui se traduit comme suit :
0 = Erreur d’événement vidéo
1 = Vide : réponse « 200 OK » (vide) servie.
2 = PSA : une annonce de service public a servi parce qu’aucun autre élément créatif n’était admissible.
3 = Erreur par défaut : création par défaut servie en raison d’un problème de délai d’expiration.
4 = Valeur par défaut : un élément créatif par défaut a été fourni, car aucune offre de campagne ou aucun autre élément créatif n’était éligible.
5 = Conservé : l’un de vos annonceurs gérés a servi un créatif.
6 = Revendu : l’impression a été vendue à un acheteur tiers.
7 = RTB : votre créativité a servi sur l’inventaire tiers.
8 = Erreur PSA : une annonce de service public a été effectuée en raison d’un problème de délai d’expiration.
9 = Impression externe : impression provenant d’un dispositif de suivi d’impression.
10 = Clic externe : clic à partir d’un dispositif de suivi des clics.
bidder_id int Oui 45 ID du soumissionnaire associé.
creative_duration int Oui 30 Durée de la création vidéo en secondes.
video_delivery_type string Non "vod" Type de diffusion de contenu en streaming. Par exemple, Video On Demand (VOD) et Live.
video_content_genre string Non "action" Le genre principal du programme dans lequel la publicité sera jouée. Par exemple, Action, Adventure, Biography, Business, Comedy, , etc.
video_program_type string Non "series" Catégorisation de niveau supérieur du format du programme vidéo sur lequel la publicité sera lue. Par exemple, Movie, Series, Special, Show, Event, Clip, etc.
video_content_rating string Non "teens" Groupe d’audience identifié par l’éditeur pour lequel le contenu est évalué. Par exemple, All, Children (7+) , Teens (13+), Young Adults (14+)ou Adults (18+).
content_duration_secs int Oui 480 Longueur du contenu vidéo en secondes.
device_type string Oui
- Desktops & Laptops
- Mobile Phones
- Tablets
- TV
- Game Consoles
- Media Players
- Set Top Box
- Other Devices
Type d’appareil sur lequel le créatif a été configuré pour la lecture.
video_content_duration int Oui 100 Longueur du contenu vidéo en secondes.
video_content_language string Non "Spanish" Langue du programme vidéo dans lequel la publicité sera lue. Par exemple : Spanish.
video_content_network string Non "AMC" Réseau qui distribue le contenu vidéo. Par exemple, 9 Story, CBC, Disney, AMC, Fox, , etc.
code_1 string Non "Code A" Alias ajouté à l’objet de placement qui peut être rapporté en tant que sous-dimension de Placement. Le rapport affiche la valeur actuelle de l’alias et ne reflète pas les valeurs historiques. Ces informations sont uniquement à signaler aux vendeurs.
code_2 string Non "Code B" Alias ajouté à l’objet de placement qui peut être rapporté en tant que sous-dimension de Placement. Le rapport affiche la valeur actuelle de l’alias et ne reflète pas les valeurs historiques. Ces informations sont uniquement à signaler aux vendeurs.
code_3 string Non "Code C" Alias ajouté à l’objet de placement qui peut être rapporté en tant que sous-dimension de Placement. Le rapport affiche la valeur actuelle de l’alias et ne reflète pas les valeurs historiques. Ces informations sont uniquement à signaler aux vendeurs.

Remarque

Les données des dimensions suivantes sont disponibles uniquement si l’éditeur a implémenté la taxonomie vidéo.

  • video_delivery_type
  • video_content_genre
  • video_program_type
  • video_content_rating
  • video_content_duration
  • video_content_language
  • video_content_network

Mesures

Column Type Exemple Formule Description
imps int 2340 Lutins Nombre total d’impressions (servies et revendues).
ad_requests int 1234 ad_requests Nombre de demandes d’annonces associées au placement.
ad_responses int 2340 ad_responses Nombre de réponses remises au navigateur de l’utilisateur (ou au serveur de médiation). Une réponse peut entraîner une impression, une erreur dans le joueur ou une enchère sans événement d’impression.

Remarque : Un imp fait référence au moment où le lecteur vidéo charge la vidéo et démarre la première image. Vidéos servies fait référence au document VAST servi en réponse à une demande du lecteur vidéo.
clicks int 1 Clics Nombre total de clics sur toutes les impressions.
cost Argent 16.833378 Coût Montant total du coût multimédia pour l’éditeur direct et l’inventaire acheté en temps réel.
revenue Argent 25.767257 booked_revenue + reseller_revenue Somme du chiffre d’affaires réservé et du chiffre d’affaires des revendeurs.
profit Argent 0.084102 booked_revenue - total_cost Chiffre d’affaires réservé moins le coût total.
cpm Argent 1.66051685393258 (coût / imps) x 1000 Coût pour 1 000 impressions.
total_convs int 5 total_convs Nombre total de conversions post-affichage et post-clic.
convs_rate double 0.000221877080097626 total_convs / imps Taux de conversions en impressions.
ctr double 0.000221877080097626 clicks / imps Taux de clics vers les impressions.
rpm Argent 2.60548314606741 (revenue / imps) x 1000 Chiffre d’affaires par 1 000 impressions.
rpm_including_fees Argent 2.60548314606741 (revenue_including_fees / imps) x 1000 À déprécier. Le chiffre d’affaires moins les commissions pour 1 000 impressions.
total_network_rpm Argent 2.60548314606741 (revenue / imps) x 1000 Chiffre d’affaires par 1 000 impressions.
ppm Argent 0.944966292134831 (profit / imps) x 1000 À déprécier. Le bénéfice par 1 000 impressions.
ppm_including_fees Argent 0.662460674157303 (profit_including_fees / imps) x 1000 À déprécier. Le bénéfice incluant les frais supplémentaires par 1000 impressions.
cpm_including_fees Argent 2.60548314606741 (cost_including_fees / imps) x 1000 À déprécier. Le coût, y compris les frais supplémentaires pour 1000 impressions.
errors int 5 erreurs Nombre total de fois qu’une erreur s’est produite.
starts int 360 Commence Nombre total de fois où le premier segment de la création vidéo a été téléchargé et démarré.
start_rate double 25.85 starts / imps Le nombre de vidéos commence divisé par le nombre d’impressions.
skips int 20 Saute Nombre total de fois où un utilisateur a ignoré la vidéo.
skip_rate double 20.5 skips / imps Nombre d’skips vidéo divisé par le nombre d’impressions.
25_pcts int 780 25 % sont terminés Nombre total de fois où les créations vidéo ont terminé 25 % de la durée totale.
50_pcts int 654 50 % terminé Nombre total de fois où la vidéo s’est terminée 50 % de la durée totale.
75_pcts int 567 75 % sont terminés Nombre total de fois où la vidéo s’est terminée 75 % de la durée totale.
completions int 989 100 % terminé Nombre total de fois que la vidéo a été lue pendant toute la durée.
completion_rate double 85.45 completions / imps Nombre de saisies vidéo divisées par le nombre d’impressions.
revenue_per_video_complete double 15.869 chiffre d’affaires / achèvements Chiffre d’affaires par saisie semi-automatique de la vidéo.
cost_per_video_complete double 2.056 cost / completions Coût par saisie semi-automatique de la vidéo.
served int 87649 impressions vidéo servies Nombre total d’impressions vidéo servies.

Remarque : un Imp fait référence au moment où le lecteur vidéo charge la vidéo et démarre la première image. Vidéos servies fait référence au document VAST servi en réponse à une demande du lecteur vidéo.
imps_viewed int 30,450 imps_viewed Nombre d’impressions mesurées qui étaient visibles, selon la définition de l’affichage IAB, qui indique qu’une impression est visible si 50 % des pixels sont affichés pendant 2 secondes consécutives.
view_measured_imps int 10,120 view_measured_imps Nombre total d’impressions qui ont été mesurées pour la visibilité.
view_rate double 58% view_rate Pourcentage d’impressions visibles par rapport au nombre total d’impressions mesurées pour la visibilité. (Imps consultés / Afficher les imposs mesurés)
view_measurement_rate double 45% view_measurement_rate Pourcentage d’impressions mesurées pour la visibilité sur le nombre total d’impressions. (Afficher imps/imps mesurés)
started_video_completion_rate double 85.45 completions / video_starts Nombre de saisies vidéo divisées par le nombre de démarrages vidéo.
total_cost Argent 123.45 total_cost = media_cost + data_costs + partner_fees + commissions + serving_fees + publisher_revenue Montant total des coûts accumulés au cours de la période indiquée. Cela inclut généralement deux types de coûts, les coûts budgétés (coût des médias, coût des données, frais de partenaire, frais de service, commissions) et les revenus des éditeurs si vous suivez les paiements des éditeurs sur la plateforme.

Remarque : Nous avons ajouté une logique pour empêcher le double comptage des frais tiers pendant la période de changement cassant.
total_cost_ecpm Argent 123.45 (total_cost/imps) * 1 000 Coût total pour 1 000 imps.
total_cost_ecpc Argent 123.45 total_cost/clics Coût total par clic.
total_cost_ecpa Argent 123.45 total_cost/conversions Coût total par conversion.
network_profit Argent 123.45 (booked_revenue + reseller_revenue) - total_cost Somme du chiffre d’affaires réservé et du chiffre d’affaires du revendeur moins le coût total.
network_profit_ecpm Argent 123.45 (network_profit/imps) * 1 000 Profit réseau par 1 000 imps.
network_profit_ecpc Argent 123.45 network_profit/clics Profit réseau par clic.
network_profit_ecpa Argent 123.45 network_profit/conversions Profit réseau par conversion.
network_profit_margin Argent 123.45 network_profit/(booked_revenue + reseller_revenue) Marge bénéficiaire du réseau.
profit_ecpm Argent 123.45 ((booked_revenue - total_cost)/imps) * 1 000 Profit par 1 000 imps.
profit_ecpc Argent 123.45 (booked_revenue - total_cost)/clics Profit par clic.
profit_ecpa Argent 123.45 (booked_revenue - total_cost)/conversions Profit par conversion.
profit_margin Argent 123.45 (booked_revenue - total_cost)/booked_revenue Marge bénéficiaire de l’acheteur.
Average View Time int 28 sum (creative_duration * (((0,125 × commence) + (0,25 × first_quartiles) + (0,25 × second_quartiles) + (0,25 × third_quartiles) + (0,125 × achèvements)) / sum (starts)) Estimation de la durée moyenne en secondes (arrondie à 0 décimale) du créatif qui a été consulté. Cela est calculé en environ la durée de visionnage comme point intermédiaire entre les événements vidéo (par exemple, un événement de début estimerait que 12,5 % de la création est visionnée).
Average View Time Percent Pourcentage 89% sum (((0,125 × commence) + (0,25 × first_quartiles) + (0,25 × second_quartiles) + (0,25 × third_quartiles) + (0,125 × achèvements))∕commence) Temps d’affichage moyen exprimé sous la forme d’un pourcentage du temps d’affichage total possible.
fill_rate double 85.00 (imps_resold+imps_kept)/total_ad_requests Pourcentage d’impressions totales (à la fois revendues et conservées) sur le nombre total de demandes de publicité envoyées à Xandr pour la vente aux enchères.

Compartiments de fréquence de création

ID de compartiment Nom du compartiment
-2 "no-cookie-date"
-1 "no-cookie"
0 "0"
1 "1"
2 "2-5"
3 "6-10"
4 "11-20"
5 "21-40"
6 "41-60"
7 "61-100"
8 "101-150"
9 "151-250"
10 "251-500"
11 "500+"

Compartiments de récence créatifs

ID de compartiment Nom du compartiment
-2 "no-cookie-date"
-1 "no-cookie"
0 "< 1 minute"
1 "1-5 minutes"
2 "5-15 minutes"
3 "15-30 minutes"
4 "30-60 minutes"
5 "1-4 hours"
6 "4-12 hours"
7 "12-24 hours"
8 "1-2 days"
9 "2-7 days"
10 "8-14 days"
11 "14-30 days"

Méthode de lecture vidéo

ID de méthode Méthode
0 Inconnu
1 Lecture automatique, son activé
2 Lecture automatique, son off
3 Démarrer en un clic
4 Survol de la souris
5 Lecture automatique, son inconnu

Contexte vidéo

ID de méthode Méthode
0 Inconnu
1 Pré-roll
2 Mi-rouleau
3 Post-roll
4 Outstream

Taille du joueur

ID Nom
0 small
1 medium
2 large

Exemple

Créer une demande de rapport au format JSON

Le fichier JSON doit inclure le report_type de "video_analytics_network", ainsi que les colonnes (dimensions et métriques) et report_interval que vous souhaitez récupérer. Vous pouvez également filtrer des dimensions spécifiques, définir la granularité (year, month, day) et spécifier le format dans lequel les données doivent être retournées (csv, excelou html). Pour obtenir une explication complète des champs qui peuvent être inclus dans le fichier JSON, consultez service de rapports.

$ cat video_analytics_network

{
    "report":
    {
        "report_type":"video_analytics_network",
        "columns":[
            "hour",
            "seller_member_id",
            "buyer_member_id",
            "advertiser_id",
            "publisher_id",
            "imps",
            "ad_requests",
            "ad_responses",
            "25_pcts",
            "completions",
            "completion_rate",
            "convs_rate"
        ],
        "report_interval":"last_48_hours",
        "format":"csv"
    }
}

POST la demande au service de création de rapports

$ curl -b cookies -c cookies -X POST -d @video_analytics_network 'https://api.appnexus.com/report'
{
   "response":{
      "status":"OK",
      "report_id":"097f59fc3ab7d02c5d60db42081d9b69"
   }
}

GET l’état du rapport à partir du service de rapports

Effectuez un GET appel avec l’ID de rapport pour récupérer l’état du rapport. Continuez à effectuer cet appel jusqu’à ce que soit execution_status"ready". Utilisez ensuite le service de téléchargement de rapports pour enregistrer les données de création de rapports dans un fichier (décrit à l’étape suivante).

$ curl -b cookies -c cookies 'https://api.appnexus.com/report?id=097f59fc3ab7d02c5d60db42081d9b69'
{
   "response":{
      "status":"OK",
      "report":{
         "name":null,
         "created_on":"2010-05-25 19:19:53",
         "json_request":"{\"report\":{\"report_type\":\"video_analytics_network\",\"columns\":[\"hour\",\"seller_member_id\",
   \"buyer_member_id\",\"advertiser_id\",\"publisher_id\",\"imps\",\"25_pcts\",\"completions\",\"completion_rate\",\"convs_rate\"],
            \"row_per\":[\"hour\",\"seller_member_id\",\"buyer_member_id\",\"advertiser_id\",\"publisher_id\"],
            \"report_interval\":\"last_48_hours\"}}",
         "url": "report-download?id=b97897a7864dd8f34e7457226c7af592"
      },
      "execution_status":"ready"
   }
}

GET les données de rapport du service de téléchargement de rapports

Pour télécharger les données du rapport dans un fichier, effectuez un autre GET appel avec l’ID de rapport, mais cette fois au service de téléchargement de rapports . Vous trouverez le service et l’ID de rapport dans le url champ de la réponse précédente GET . Lorsque vous identifiez le fichier dans lequel vous souhaitez enregistrer, veillez à utiliser l’extension de fichier du "format" que vous avez spécifié dans votre initial POST.

Remarque

Si une erreur se produit pendant le téléchargement, l’en-tête de réponse inclut un code d’erreur HTTP et un message. Utilisez -i ou -v dans votre appel pour exposer l’en-tête de réponse.

$ curl -b cookies -c cookies 'https://api.appnexus.com/report-download?id=b97897a7864dd8f34e7457226c7af592' > /tmp/video_analytics_network.csv

Remarque

Il existe une limite de 100 000 lignes par rapport lorsque vous les téléchargez en tant que fichier XLSX et Excel.