Partager via


Analyse vidéo de l’éditeur de réseau

Le rapport Network Publisher Video Analytics peut être utilisé pour afficher les métriques d’événement vidéo pour un éditeur spécifique au sein de votre réseau qui est plus granulaire que les données fournies dans le rapport Network Video Analytics . Ce rapport est disponible uniquement pour les utilisateurs réseau.

Remarque

video_content_genre Les métriques vidéo sont enregistrées uniquement pour les créations VAST.

Pour obtenir des instructions d’utilisation, consultez l’exemple ci-dessous. Notez que ce rapport nécessite qu’un ID d’éditeur soit spécifié dans le cadre de l’URL, par exemple :

https://api.appnexus.com/report?publisher_id=PUBLISHER_ID

Période

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

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

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 date Non "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 date Non "2010-02-01" Le jour de la vente aux enchères.
month date Non "2010-02" Le mois de la vente aux enchères.
member_id int Oui 767 ID du membre.
buyer_member_id int oui 567 ID du membre acheteur.
buyer_member_name chaîne Non "Network" Nom du membre acheteur.
advertiser_id int oui 728 ID de l’annonceur.
advertiser_name chaîne Non "Test" Nom de l’annonceur.
brand_id int oui 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 chaîne 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.
publisher_id int oui 6787 Numéro permettant d’identifier l’éditeur.
publisher_currency chaîne 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 chaîne Non "Site Name" Nom du site.
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.
geo_country chaîne Oui "US" Code du pays géographique.
geo_country_name string Non "United States" Nom du pays.
placement_id int oui 546 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 "300x250 Business" 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 "300x250 Business Code" Code personnalisé pour le placement.
site_domain string Non bestsiteever.com Domaine de site d’une impression.
application_id string Oui '343200656' (iOS) Ou
'com.rovio.angrybirds'(Android)
Un ID de App Store Apple, un nom de package Google Play 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" Quand et où la vidéo est lue. 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.
video_delivery_type1 string Non "vod" Type de diffusion de contenu en streaming. Par exemple, Video On Demand (VOD) et Live.
video_content_genre1 string Non "action" Le main genre du programme dans lequel la publicité sera jouée. Par exemple, Action, Adventure, Biography, Business, Comedy, , etc.
video_program_type1 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_rating1 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, and Other Devices. Type d’appareil sur lequel le créatif a été configuré pour la lecture.
video_content_duration1 int Oui 100 Longueur du contenu vidéo en secondes.
video_content_language1 string Non "Spanish" Langue du programme vidéo dans lequel la publicité sera lue. Par exemple : Spanish.
video_content_network1 string Non "AMC" Réseau qui distribue le contenu vidéo. Par exemple, 9 Story, CBC, Disney, AMC, Fox, , etc.

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.
clicks int 545 Clics Nombre total de clics sur toutes les impressions.
total_convs int 90 post_click_convs + post_view_convs Nombre total de conversions post-affichage et post-clic.
ctr double 0.2327836 clicks / imps * 100 Taux de clics vers les impressions.
convs_rate double 0.0384413 total_convs / imps * 100 Taux de conversions en impressions.
network_revenue Argent 1201.13 network_revenue Chiffre d’affaires du réseau réservé par le biais d’annonceurs directs et revendu aux acheteurs en temps réel
total_network_rpm Argent 2.60548314606741 (network_revenue / imps) x 1000 Chiffre d’affaires réseau pour 1 000 impressions.
publisher_revenue Argent 400.05 publisher_revenue Le revenu versé à l’éditeur (basé sur revshare ou cpm).
network_profit Argent 801.08 (booked_revenue + reseller_revenue) - total_cost Profit réseau moins le coût total.
network_roi double 2.94 (network_revenue / media_cost) - 1 À déprécier. Retour sur investissement réseau. Retourné sous forme de pourcentage, par exemple, 0,94 = 94 %
sold_network_rpm double 231.888 (revenue/ imps) x 1000 ----- aucune erreur Chiffre d’affaires pour 1 000 impressions qui n’étaient pas des erreurs.
total_publisher_rpm Argent 1.6605168
5393258
(coût / imps) x 1000 Coût pour 1 000 impressions payées aux éditeurs directs et tiers, y compris les erreurs.
sold_publisher_rpm double 147.786 (coût/imps) x 1000 ----- aucune erreur Coût par 1 000 impressions payées aux éditeurs directs et tiers, sans inclure les erreurs.
network_ppm Argent 9.23 (profit / imps) x 1000 À déprécier. Le bénéfice par 1 000 impressions.
imps_sold int 42500 imps_sold Nombre d’impressions que vous avez vendues à d’autres membres.
video_errors int 23 erreurs Nombre total d’erreurs de service d’impressions vidéo
ad_responses int 2340 Servi 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.
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 1 seconde consécutive.
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)
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_ecpm Argent 123.45 ((booked_revenue + reseller_revenue - total_cost)/imps) * 1 000 Profit réseau par 1 000 imps.
network_profit_ecpc Argent 123.45 (booked_revenue + reseller_revenue - total_cost)/clics Profit réseau par clic.
network_profit_ecpa Argent 123.45 (booked_revenue + reseller_revenue - total_cost)/conversions Profit réseau par conversion.
network_profit_margin Argent 123.45 (booked_revenue + reseller_revenue - total_cost)/(booked_revenue + reseller_revenue) Marge bénéficiaire du réseau.
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.

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

Create une demande de rapport au format JSON

$ cat video_analytics_network_publisher
{
    "report":
    {
        "report_type":"video_analytics_network_publisher",
        "columns":[
            "hour",
            "buyer_member",
            "brand_name",
            "deal_name",
            "deal_id",
            "imps_sold",
            "video_errors",
            "total_convs",
            "served"
        ],
        "row_per":[
            "hour",
            "buyer_member",
            "sold_network_rpm"
        ],
        "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_publisher "https://api.appnexus.com/report?publisher_id=4642"
{
   "response":{
      "status":"OK",
      "report_id":"f4ebb93755dd01dde4fc157f86198ea9"
   }
}

GETle rapport status à partir du service de rapports

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

$ curl -b cookies -c cookies "https://api.appnexus.com/report?id=f4ebb93755dd01dde4fc157f86198ea9"
{
   "response":{
      "status":"OK",
      "report":{
         "name":null,
         "created_on":"2010-05-25 19:37:31",
         "json_request":"{\"report\":{\"report_type\":\"video_analytics_network_publisher\",\"columns\":[\"hour\",\"buyer_member\",\"brand_name\",
            \"deal_name\",\"deal_id\",\"imps_sold\",\"video_errors\",\"total_convs\",\"served\"],
            \"row_per\":[\"hour\",\"buyer_member\",\"sold_network_rpm\"],\"report_interval\":\"last_48_hours\",
            \"filters\":[{\"publisher_id\":\"4642\"}]}}",
         "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_publisher.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.