Partager via

Analyse vidéo de l’annonceur réseau

Le rapport Network Advertiser Video Analytics peut être utilisé pour afficher les métriques d’événements vidéo d’un annonceur spécifique qui sont plus détaillées que les données fournies dans le rapport Network Video Analytics . Ce rapport est disponible uniquement pour les utilisateurs réseau.

Remarque

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’annonceur soit spécifié dans le cadre de l’URL, par exemple :

https://api.appnexus.com/report?advertiser_id=ADVERTISER_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
  • last_available_day
  • last_7_available_days
  • last_14_available_days
  • last_30_available_days
  • month_to_date
  • month_to_yesterday
  • last_month
  • 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 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 Jour du mois.
month date date 2010-02 Mois de l’année.
seller_member_id int Oui 567 ID interne du membre vendeur.
seller_member_name string Non "AdMeld" Nom complet du membre vendeur.
seller_member string Non "AdMeld (567)" Déconseillé.
advertiser_id int Oui 344 ID interne de l’annonceur dont la campagne et la créativité ont servi dans l’impression.
campaign_id int Oui 728 Numéro permettant d’identifier la campagne.
campaign_name string Non "Test" Nom d’affichage de la campagne
campaign string Non "Test (123)" Déconseillé.
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_name sera "External Clicks" ou "External Imps".
creative string Non "Q1 2010 728x90 (554)" Déconseillé.
placement_id int Oui 567 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 "Photos 728x90" 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 string Non "Photos 728x90 (123)" Déconseillé.
placement_code string Non "Placement Code" Code personnalisé pour le placement.
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é.
size string Oui "728x90" Taille de la création/placement
geo_country string Oui "US" Code du pays géographique
geo_country_name string Non "Unites States" Nom du pays
creative_recency_bucket string Oui "11-20" 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_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_frequency_bucket string Oui "15-30 minutes" 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.
insertion_order_id int Oui 654 ID de l’ordre d’insertion
insertion_order_name string Non "Insertion Order Name" Nom de l’ordre d’insertion
insertion_order string Non "Insertion Order Name (654)" Déconseillé.
line_item_id int Oui 932 Numéro permettant d’identifier l’élément de ligne
line_item_name string Non "$3 CPM Verizon Remarketing" Nom d’affichage de l’élément de ligne
line_item string Non "$3 CPM Verizon Remarketing (932)" Déconseillé.
publisher_id int Oui 321 Numéro permettant d’identifier l’éditeur
publisher_name string Non "Test" Nom d’affichage de l’éditeur
publisher string Non "Test (123)" Déconseillé.
trafficker_for_insertion_order string Oui "Chris Mack" 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 "Jonathan Smith" Représentant commercial de la commande d’insertion. Pour plus d’informations, consultez le "labels" champ du service d’ordre d’insertion .
site_domain chaîne 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é.
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" 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.
video_content_genre 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_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, and 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.
video_delivery_type string Non "vod" Type de diffusion de contenu en streaming. Par exemple, Video On Demand (VOD) et Live.

Remarque

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

  • video_content_genre
  • video_program_type
  • video_content_rating
  • video_content_duration
  • video_content_language
  • video_content_network
  • video_delivery_typ

Mesures

Column Type Exemple Formule Description
imps int 234123 Lutins Nombre total d’impressions servies.
clicks int 545 Clics Nombre total de clics sur toutes les impressions.
post_view_convs int 75 post_view_convs Nombre total de conversions post-affichage enregistrées.
post_click_convs int 15 post_click_convs Nombre total de conversions post-clic enregistrées.
total_convs int 90 post_click_convs + post_view_convs Nombre total de conversions post-affichage et post-clic.
convs_rate double 0.0003844 total_convs / imps Taux de conversions en impressions.
post_view_convs_rate double 0.000320 post_view_convs / imps Taux de conversions post-affichage en impressions.
post_click_convs_rate double 0.000064 post_click_convs / imps Taux de conversions post-clic en impressions.
ctr double 0.2327836 clicks / imps Taux de clics vers les impressions.
profit Argent 350.00 booked_revenue - total_cost Chiffre d’affaires réservé moins le coût total.
revenue_ecpm Argent 1.9221 booked_revenue / clics Chiffre d’affaires total par 1 000 impressions.
cost_ecpm Argent 0.4271259 media_cost / imps * 1 000 Coût pour 1 000 impressions.
profit_ecpm Argent 0.4949 profit/imps * 1 000 Le bénéfice par 1 000 impressions. Le « bénéfice » est défini comme le chiffre d’affaires comptabilisé moins le coût total.
revenue_ecpc Argent 0.8256 booked_revenue / clics Chiffre d’affaires total par clic.
revenue_ecpa Argent 5.00 booked_revenue / total_convs Chiffre d’affaires total par conversion.
cost_ecpc Argent 0.1834 media_cost / clics Coût par clic.
cost_ecpa Argent 1.1111 media_cost / total_convs Coût par acquisition/conversion.
profit_margin Argent 0.7778 profit/booked_revenue Bénéfice divisé par booked_revenue. Le « bénéfice » est défini comme le chiffre d’affaires comptabilisé moins le coût total.
media_cost Argent 100.00 media_cost Montant total dépensé.
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 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.
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.
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.

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 Unknown
1 Auto-play, sound on
2 Auto-play, sound off
3 Click-to-play
4 Mouse-over
5 Auto-play, sound unknown

Contexte vidéo

ID de méthode Méthode
0 Unknown
1 Pre-roll
2 Mid-roll
3 Post-roll
4 Outstream

Taille du joueur

ID Nom
0 small
1 medium
2 large

Exemple

Create une demande de rapport JSON

Le fichier JSON doit inclure le report_type de "video_analytics_network_advertiser", 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_advertiser

{"report":
    {
        "report_type":"video_analytics_network_advertiser",
        "columns":[
            "hour",
            "seller_member_id",
            "campaign_id",
            "imps",
            "starts",
            "75_pcts",
            "completions",
            "cost_per_video_complete",
            "served"
        ],
        "report_interval":"last_48_hours",
        "format":"csv"
    }
}

POST la demande au service de création de rapports

POST demande JSON pour récupérer un ID de rapport.

$ curl -b cookies -c cookies -X post -d @video_analytics_network_advertiser "https://api.appnexus.com/report?advertiser_id=690"

{
   "response":{
      "status":"OK",
      "report_id":"09b6979a6a4c3805bdac8921378d3622"
   }
}

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 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=09b6979a6a4c3805bdac8921378d3622'

{
   "response":{
      "status":"OK",
      "report":{
         "name":null,
         "created_on":"2010-05-25 19:15:48",
         "json_request":"{\"report\":{\"report_type\":\"video_analytics_network_advertiser\",\"columns\":
          [\"hour\",\"seller_member_id\",\"campaign_id\",\"imps\",\"starts\",\"75_pcts\",
          \"completions\",\"cost_per_video_complete\",\"served\"],\"row_per\":
          [\"hour\",\"seller_member_id\",\"campaign_id\"],
          \"report_interval\":\"last_48_hours\",\"filters\":[{\"advertiser_id\":\"690\"}]}}",
         "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 l’ID de service et de rapport dans le url champ de la réponse à votre appel précédent GET . Lorsque vous identifiez le fichier dans lequel vous souhaitez enregistrer, veillez à utiliser l’extension de fichier du format de fichier que vous avez spécifié dans votre fichier 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_advertiser.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.

Service de rapports

  • Last updated on