Remarque
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de vous connecter ou de modifier des répertoires.
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de modifier des répertoires.
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_typevideo_content_genrevideo_program_typevideo_content_ratingvideo_content_durationvideo_content_languagevideo_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.66051685393258 |
(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.