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 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 = PSA0 = Vide319 = 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éo1 = 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_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 (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.