Rapport Analyse des erreurs de vidéo réseau

Le rapport d’erreurs de vidéo réseau donne un aperçu des erreurs vidéo et de leur cause.

Vous pouvez utiliser ce rapport pour résoudre les problèmes liés aux paramètres vidéo et éliminer les erreurs liées à la publicité vidéo côté achat et côté vente. Les codes d’erreur VAST 3 fournissent des informations supplémentaires sur la source des erreurs.

Remarque

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 :

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

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.

• Pour les impressions antérieures à 100 jours, le jour est retourné plutôt que l’heure.

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	Oui	"2010-02"	Le mois de la vente aux enchères.
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)"	Nom et ID de l’annonceur.
bidder_name	string	Non	"ABC Plc"	Nom d’un acheteur potentiel qui a soumis une offre sur l’impression.
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	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)"	La marque associée au créatif. Xandr conserve une liste des marques d’annonceur dans nos systèmes qui peuvent être appliquées à un créatif lorsqu’il est chargé. Pour le type "Resold"d’impression , aucune information n’est disponible dans le Brand champ pour ce rapport.
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 Cette dimension a également un attribut, appelé soumissionnaire, qui identifie l’ID du soumissionnaire pour l’impression. Le type de données de l’attribut est int.
buyer_member_name	string	Non	"My Network"	Nom du membre acheteur.
buyer_member	string	Non	"My Network (123)"	Nom et ID du membre acheteur.
buyer_seat_code	string	Non	"Custom Seat"	L’ID de siège d’acheteur personnalisé (soumis par DSP) qui a été utilisé pour enchérir sur l’impression.
buyer_seat_id	int	Oui	123	ID du siège acheteur.
buyer_seat_name	string	Non	"My Custom Seat"	Nom d’affichage du code du siège acheteur.
call_type	string	Oui		Type d’appel de demande d’annonce.
campaign_id	int	Oui	123	ID de la campagne.
campaign_name	string	Non	"My Campaign"	Nom de la campagne.
campaign	string	Non	"My Campaign(123)"	Nom et ID de la campagne.
campaign_group_type_id	int	Oui	123	ID du type de groupe de campagne utilisé dans les rapports fractionnés.
creative_id	int	Oui	123	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	"My Creative"	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	"My Creative(123)"	Nom et ID du créatif.
creative_duration	int	Oui	30	Durée de la vidéo créative, en secondes.
deal_id	int	Oui	123	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	"My Deal"	Nom de la transaction.
deal	string	Non	"My Deal(123)"	Nom et ID de la transaction.
device_type	string	Oui	"Mobile"	Type d’appareil où l’impression s’est produite.
geo_country	string	Oui	001	Code du pays géographique.
geo_country_name	string	Non	"USA"	Nom du pays géographique.
imp_type	string	Oui	RTB	Type d’impression. Valeur entière qui se traduit comme suit : 1 = Vide 2 = PSA 3 = Erreur par défaut 4 = Valeur par défaut 5 = Conservé 6 = Revendu 7 = RTB 8 = Erreur PSA 9 = Impression externe 10 = Clic externe
imp_type_id	int	Oui	7	ID du type d’impression associé. Valeurs possibles : 0 = Erreur d’événement vidéo 1 = Vide : réponse « 200 OK » (vide) servie. 2 = APS : 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.
insertion_order_id	int	Oui	123	ID de l’ordre d’insertion.
insertion_order_name	string	Non	"My Insertion Order"	Nom de l’ordre d’insertion.
insertion_order	string	Non	"My Insertion Order(123)"	Nom et ID de l’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 .
trafficker_for_insertion_order	string	Oui	"Maurice Truman"	Trafficker pour l’ordre d’insertion. Pour plus d’informations, consultez le "labels" champ dans le service de commande d’insertion .
line_item_id	int	Oui	123	ID de l’élément de ligne.
line_item_name	string	Non	"My Line Item"	Nom de l’élément de ligne.
line_item	string	Non	"My Line Item(123)"	Nom et ID de l’élément de ligne.
member_id	int	Oui	123	ID du membre.
mobile_application_id	int	Oui	123	ID de l’application mobile sur l’appareil où l’impression s’est produite.
publisher_id	int	Oui	123	ID de l’éditeur.
publisher_name	string	Non	"My Publisher"	Nom de l’éditeur.
publisher	string	Non	"My Publisher(123)"	Nom et ID de l’éditeur.
seller_member_id	int	Oui	123	ID du membre vendeur.
seller_member_name	string	Non	"That Seller"	Nom du membre vendeur.
seller_member	string	Non	"That Seller (456)"	Nom et ID du membre vendeur.
site	string	Non	"That Site(123)"	Nom et ID du site.
site_id	int	Oui	123	ID du site. Remarque : Pour les impressions antérieures à 100 jours, la site_id valeur est 0.
site_domain	string	Oui	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é.
site_name	string	Non	"That Site"	Nom du site.
size	string	Oui	"728x90"	Taille du placement/créatif servi.
split_id	int	Oui	"123"	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	Non	"My Split"	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.
split	string	Non	"My Split(123)"	Nom et ID du fractionnement.
supply_type_filterable	string	Oui	"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"
tag_id	int	Oui	123	ID de la balise.
placement_code	string	Non	"Ivillage Code"	Code personnalisé pour le placement.
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_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_player_size	string	Oui	"2"	ID de la largeur du lecteur vidéo. Pour connaître les valeurs possibles, consultez Taille du joueur ci-dessous.

Mesures

Column	Type	Exemple	Formule	Description
imps	int	2340	Lutins	Nombre total d’impressions (servies et revendues).
errors	int	5	erreurs	Nombre total de fois qu’une erreur s’est produite.
cost_per_complete	double	2.056	coût/achèvements	Coût par saisie semi-automatique de la vidéo.
revenue_per_video_complete	double	15.869	chiffre d’affaires/achèvements	Chiffre d’affaires par saisie semi-automatique de la vidéo.
ad_responses	int	100	ad_responses	Nombre de réponses publicitaires vidéo.
vast_100_error_count	int	10	vast_100_error_count	Nombre d’occurrences d’erreurs VAST 100.
vast_101_error_count	int	10	vast_101_error_count	Nombre d’occurrences d’erreurs VAST 101.
vast_102_error_count	int	10	vast_102_error_count	Nombre d’occurrences d’erreurs VAST 102.
vast_200_error_count	int	10	vast_200_error_count	Nombre d’occurrences d’erreurs VAST 200.
vast_201_error_count	int	10	vast_201_error_count	Nombre d’occurrences d’erreurs VAST 201.
vast_202_error_count	int	10	vast_202_error_count	Nombre d’occurrences d’erreurs VAST 202.
vast_203_error_count	int	10	vast_203_error_count	Nombre d’occurrences d’erreurs VAST 203.
vast_300_error_count	int	10	vast_300_error_count	Nombre d’occurrences d’erreurs VAST 300.
vast_301_error_count	int	10	vast_301_error_count	Nombre d’occurrences d’erreurs VAST 301.
vast_302_error_count	int	10	vast_302_error_count	Nombre d’occurrences d’erreurs VAST 302.
vast_303_error_count	int	10	vast_303_error_count	Nombre d’occurrences d’erreurs VAST 303.
vast_400_error_count	int	10	vast_400_error_count	Nombre d’occurrences d’erreurs VAST 400.
vast_401_error_count	int	10	vast_401_error_count	Nombre d’occurrences d’erreurs VAST 401.
vast_402_error_count	int	10	vast_402_error_count	Nombre d’occurrences d’erreurs VAST 402.
vast_403_error_count	int	10	vast_403_error_count	Nombre d’occurrences d’erreurs VAST 403.
vast_405_error_count	int	10	vast_405_error_count	Nombre d’occurrences d’erreurs VAST 405.
vast_500_error_count	int	10	vast_500_error_count	Nombre d’occurrences d’erreurs VAST 500.
vast_501_error_count	int	10	vast_501_error_count	Nombre d’occurrences d’erreurs VAST 501.
vast_502_error_count	int	10	vast_502_error_count	Nombre d’occurrences d’erreurs VAST 502.
vast_503_error_count	int	10	vast_503_error_count	Nombre d’occurrences d’erreurs VAST 503.
vast_600_error_count	int	10	vast_600_error_count	Nombre d’occurrences d’erreurs VAST 600.
vast_601_error_count	int	10	vast_601_error_count	Nombre d’occurrences d’erreurs VAST 601.
vast_602_error_count	int	10	vast_602_error_count	Nombre d’occurrences d’erreurs VAST 602.
vast_603_error_count	int	10	vast_603_error_count	Nombre d’occurrences d’erreurs VAST 603.
vast_604_error_count	int	10	vast_604_error_count	Nombre d’occurrences d’erreurs VAST 604.
vast_900_error_count	int	10	vast_900_error_count	Nombre d’occurrences d’erreurs VAST 900.
vast_901_error_count	int	10	vast_901_error_count	Nombre d’occurrences d’erreurs VAST 901.
vast_error_rate	int	10	(Nombre de vidéos à l’issue d’une erreur/Nombre total de vidéos servies) x 100	Pourcentage de vidéos servies qui entraînent une erreur VAST.
rpm	Argent	2.60548314606741	(revenue / imps) x 1000	Chiffre d’affaires par 1 000 impressions.
imps_default_bidder	int	0	imps_default_bidder	Nombre d’impressions par défaut, car il n’y avait pas d’enchères valides.
imps_kept	int	0	imps_kept	Nombre d’impressions achetées par votre annonceur auprès de votre éditeur.
imps_resold	int	0	imps_resold	Nombre d’impressions que votre éditeur a vendues à un tiers.
imps_rtb	int	2332	imps_rtb	Nombre d’impressions que votre annonceur a achetées auprès d’un tiers.
clicks	int	654	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 des recettes réservées et des recettes revendues.
cpm	Argent	1.66051685393258	(coût / imps) x 1000	Coût pour 1 000 impressions.
ctr	double	0.0221877080097626 %	(clics / imps) x 100 %	Taux de clics vers les impressions exprimé sous forme de pourcentage.

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

Le fichier JSON doit inclure le report_type de video_error_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_error_analytics_network

{
    "report":
    {
        "report_type":"video_error_analytics_network",
        "columns":[
            "hour",
            "seller_member_name",
            "buyer_member_name",
            "advertiser_name",
            "publisher_name",
            "vast_error_rate",
            "imps",
            "clicks",
            "ctr",
            "vast_900_error_count"
        ],
        "report_interval":"last_48_hours",
        "format":"csv"
    }
}

POST la demande au service de création de rapports

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

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 '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_error_analytics_network\",\"columns\":[\"hour\",\"seller_member_name\",
            \"buyer_member_name\",\"advertiser_name\",\"publisher_name\",\"imps\",\"clicks\",\"vast_error_rate\",\"ctr\"],
            \"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 'https://api.appnexus.com/report-download?id=b97897a7864dd8f34e7457226c7af592' > /tmp/video_error_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.