Analyse de l’éditeur réseau

Le rapport Network Publisher Analytics peut être utilisé pour afficher les données de performances d’un serveur de publication spécifique au sein de votre réseau qui sont plus précises que les données fournies dans le rapport Network Analytics. Ce rapport est disponible uniquement pour les utilisateurs réseau. Les utilisateurs du serveur de publication peuvent utiliser le rapport Publisher Analytics .

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 :

• current_hour
• last_hour
• aujourd’hui
• yesterday
• last_48_hours
• last_2_days
• last_7_days
• last_30_days
• month_to_date
• month_to_yesterday
• quarter_to_date
• last_month
• Vie

Période de conservation des données

La période de conservation des données pour le rapport est de 428 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.
buyer_member_id	int	oui	567	ID du membre acheteur.
buyer_member_name	string	Non	"Network"	Nom du membre acheteur. Remarque : le nom peut être "Default" ou "Default Error", ce qui signifie qu’il n’y avait pas d’acheteur pour l’impression et qu’un élément créatif par défaut a été servi.
buyer_member	string	Non	"Network (567)"	Déconseillé.
seller_member_id	int	oui	67	ID du membre vendeur.
advertiser_id	int	oui	728	ID de l’annonceur.
advertiser_name	chaîne	Non	"Test"	Nom de l’annonceur.
advertiser	string	Non	"Test (123)"	Déconseillé.
advertiser_code	string	Non	"Code"	Code personnalisé pour l’annonceur.
line_item_id	int	oui	554	ID de l’élément de ligne.
line_item_name	chaîne	Non	"Q1 Pepsi"	Nom de l’élément de ligne.
line_item	chaîne	Non	"Q1 Pepsi (554)"	Déconseillé.
line_item_code	chaîne	Non	"Q1 Pepsi Code"	Code personnalisé pour l’élément de ligne.
campaign_id	int	oui	567	ID de la campagne.
campaign_name	string	Non	"Photos 728x90"	Nom de la campagne.
campaign	string	Non	"Photos 728x90 (567)"	Déconseillé.
campaign_code	chaîne	Non	"Photos Code"	Code personnalisé pour la campagne.
campaign_priority	int	Non	5	Priorité d’enchère d’une campagne qui cible l’inventaire direct. Pour plus d’informations, consultez Priorité des enchères dans la documentation de l’interface utilisateur. Valeurs possibles : 1 - 10, où 10 est la priorité la plus élevée.
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 impressions antérieures à 100 jours, les créations sont agrégées en une ligne avec 0 comme creative_id. - Pour les suivis de clic ou d’impression externes, creative_id sera "External Clicks" ou "External Imps".
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)"	Déconseillé.
publisher_id	int	oui	6787	Numéro permettant d’identifier l’éditeur.
publisher_code	string	Non	"Publisher Code"	Code personnalisé pour identifier l’éditeur.
publisher_currency	chaîne	Oui	"USD"	Devise de l’éditeur.
pub_rule_id	int	Non	54	Numéro permettant d’identifier la règle d’éditeur.
pub_rule_name	string	Non	"50% Revshare"	Nom de la règle d’éditeur.
pub_rule	string	Non	"50% Revshare (54)"	Déconseillé.
pub_rule_code	chaîne	Non	"50% Revshare Code"	Code personnalisé pour la règle d’é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	chaîne	Non	"Site Name (593)"	Déconseillé.
site_code	string	Non	"Site Name Code"	Code personnalisé pour le 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.
deal	string	Non	"Private deal for buyer 1085 with floor of $2.50 (45)"	Déconseillé.
deal_code	string	Non	"External seller deal code"	Code personnalisé pour la transaction.
geo_country	chaîne	Oui	"US"	Code du pays géographique.
geo_country_name	string	Non	"Unites States"	Nom du pays.
size	chaîne	Non	"300x250"	La taille du créatif servi.
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	chaîne	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	chaîne	Oui	"300x250 Business (546)"	Déconseillé.
placement_code	string	Non	"300x250 Business Code"	Code personnalisé pour le placement.
imp_type_id	int	oui	1	ID du type d’impression. Valeurs possibles (types associés entre parenthèses) : 1 (« Vide ») : aucun créativité servi. 2 (« PSA ») : Une annonce d’intérêt public a été rendue publique parce qu’il n’y avait pas d’offre valide et qu’aucune création par défaut n’était disponible. 3 (« Erreur par défaut ») : création par défaut fournie en raison d’un problème de délai d’expiration. 4 (« Valeur par défaut ») : valeur créative par défaut fournie, car il n’y avait pas d’enchères valides. 5 (« Conservé ») : la créativité de votre annonceur servie sur le site de votre éditeur. 6 (« Revendu ») : l’impression de votre éditeur a été vendue à un acheteur tiers. 7 (« RTB ») : la créativité de votre annonceur servie 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 ou d’une absence de création par défaut. 9 (« Impression externe ») : impression provenant d’un dispositif de suivi d’impression. 10 (« Clic externe ») : clic à partir d’un dispositif de suivi des clics.
imp_type	chaîne	Oui	"Kept"	Type d’impression. Pour connaître les valeurs possibles, consultez imp_type_id.
buyer_type	chaîne	Oui	"Reseller"	Type d’acheteur, défini par Xandr.
supply_type	string	Non	"web"	Type d’inventaire. Valeurs possibles : - "web" - "mobile_web" - "mobile_app"
payment_type	chaîne	Oui	"cpm", "revshare"	Type de paiement à un répartiteur.
revenue_type	chaîne	Oui	"CPA"	Base sur laquelle le membre est payé.
revenue_type_id	int	oui	4	ID du type de revenu. Valeurs possibles : -1 = Aucun paiement 0 = CPM plat 1 = Cost Plus CPM 2 = Coût plus marge 3 = CPC 4 = CPA 5 = Revshare 6 = Frais fixes 7 = Variable CPM 8 = Estimation du CPM
external_inv_id	int	Oui	4921	ID du code d’inventaire externe passé dans l’appel publicitaire et prédéfini par l’éditeur. Pour plus d’informations, consultez Service de code d’inventaire externe. Pour les impressions antérieures à 100 jours, le external_inv_id sera 0.
external_inv_name	string	Non	"External Inv Name"	Nom du code d’inventaire externe passé dans l’appel publicitaire et prédéfini par l’éditeur. Pour plus d’informations, consultez Service de code d’inventaire externe.
external_inv	string	Non	"External Inv Name (4921)"	Déconseillé.
media_type	string	Non	"Banner", "Pop", "Interstitial", "Video", "Text", "Expandable", "Skin"	Style d’affichage général du créatif. Vous pouvez utiliser le service de type de média pour afficher la liste complète des types de médias.
mediatype_id	int	oui	2	En lecture seule. ID du type de média auquel appartient le sous-type.
adjustment_id	int	oui	890	ID de l’ajustement utilisé pour apporter des modifications au coût du média et/ou aux impressions, clics et conversions que vous voyez dans les rapports pour un éditeur.
venue	chaîne	Oui	"Venue Name"	Nom du cluster de domaine, de site, d’étiquette et de pays d’utilisateur que le système d’optimisation de Xandr utilise pour déterminer les évaluations des enchères. Une campagne ne peut pas cibler explicitement un lieu.
predict_rev_type	int	oui	2	Phase d’optimisation d’une campagne qui a servi à l’inventaire de l’éditeur. Valeurs possibles : -2 = Aucune phase de prédiction -1 = Phase de prédiction de base 0 = Don d’apprentissage 1 = Learn 2 = Limité 3 = Optimisé 4 = Biaisé 5 = Optimisé 1 8 = Don optimisé 9 = Enchère de base sous l’offre

Mesures

Column	Type	Exemple	Formule	Description
imps_total	int	2340	Lutins	Nombre total d’impressions (servies et revendues).
imps_sold	int	42500	imps_sold	Nombre d’impressions que vous avez vendues à d’autres membres.
imps_default	int	321	imps_default	Nombre d’impressions par défaut.
imps_blank	int	3	imps_blank	Nombre d’impressions servies avec un vide.
imps_psa	int	5	imps_psa	Nombre d’impressions servies avec un PSA.
imps_psa_error	int	0	imps_psa_error	Nombre d’impressions servies avec un psa en raison d’une erreur par défaut.
imps_default_error	int	0	imps_default_error	Nombre d’impressions par défaut en raison d’un problème de délai d’expiration.
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 conservées (directes).
imps_resold	int	0	imps_resold	Nombre d’impressions revendues.
imps_rtb	int	2332	imps_rtb	Nombre d’impressions rtb.
external_impression	int	0	external_impression	Nombre d’impressions externes.
external_click	int	0	external_click	Nombre de clics externes.
clicks	int	545	Clics	Nombre total de clics sur toutes les impressions.
click_thru_pct	double	1.12359550561797	(clics / imps) * 100	Taux de clics vers les impressions sous forme de pourcentage.
total_convs	int	90	post_click_convs + post_view_convs	Nombre total de conversions post-affichage et post-clic.
post_view_convs_pixel	int	23		Publier les conversions d’affichage pour le pixel. Pour plus d’informations sur la façon dont nous attributons les conversions post-affichage (et d’autres), consultez Attribution de conversion (Microsoft Monetize) ou Attribution de conversion (Microsoft Invest).
post_clicks_convs_pixel	int	15		Publier les conversions de clic pour le pixel. Publier les conversions d’affichage pour le pixel. Pour plus d’informations sur la façon dont nous allons attribuer des conversions post-affichage (et d’autres), consultez Attribution de conversion (monétiser) ou Attribution de conversion (Invest).
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.
convs_per_mm	double	221.877080097625	(total_convs / imps) x 1 000 000	Nombre de conversions par million d’impressions.
network_revenue	Argent	1201.13	network_revenue	Chiffre d’affaires du réseau réservé via des 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).
publisher_revenue_pub_curr	Argent	400.05	publisher_revenue	Revenu versé à l’éditeur (basé sur revshare ou cpm), dans la devise de l’éditeur.
publisher_rpm_pub_curr	Argent	1.71	(publisher_revenue / imps) x 1000	Chiffre d’affaires de l’éditeur par 1 000 impressions, dans la devise de l’éditeur.
network_profit	Argent	801.08	(chiffre d’affaires réservé + chiffre d’affaires des revendeurs) - total_cost	Somme du chiffre d’affaires réservé et du chiffre d’affaires du revendeur moins le coût total.
network_roi	Argent			À déprécier. Le retour sur investissement du réseau.
network_roi_net_commissions	double			À déprécier.
network_rpm	Argent	3.42	(network_revenue / imps) x 1000	Chiffre d’affaires réseau pour 1 000 impressions.
sold_network_rpm	double
publisher_rpm	Argent	1.71	(publisher_revenue / imps) x 1000	Chiffre d’affaires de l’éditeur pour 1 000 impressions.
total_publisher_rpm	Argent
sold_publisher_rpm	double
network_ppm	Argent	9.23	(profit / imps) x 1000	À déprécier. Le bénéfice par 1 000 impressions.
network_revenue_net_commissions	Argent			À déprécier.
network_profit_net_commissions	Argent			À déprécier.
network_rpm_net_commissions	Argent			À déprécier.
network_ppm_net_commissions	Argent			À déprécier.
media_cost_pub_curr	Argent	16.833378	media_cost_pub_curr	Coût total de l’inventaire acheté, dans la devise de l’éditeur.
commissions	Argent	0	Commissions pour les articles standard, 0 $ pour les ALI.	Frais qui proviennent du chiffre d’affaires réservé. Commissions pour les articles standard, 0 $ pour les ALI.
serving_fees	Argent	0.025143	Frais de service pour les articles standard, 0 $ pour les ALI.	Frais qui sont ajoutés au coût du média. Frais de service pour les articles standard, 0 $ pour les ALI.
imps_viewed	int	30,450	imps_viewed	Nombre d’impressions mesurées qui étaient visibles selon la définition de la capacité d’affichage IAB.
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)
partner_fees	Argent	123.45		Montant total des coûts tiers, budgétés à l’aide du service Des frais de partenaire, qui se sont accumulés sur un élément de ligne augmenté au cours de la période indiquée.
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 - coût total)/imps) * 1 000	Profit réseau par 1 000 imps.
network_profit_ecpc	Argent	123.45	(booked_revenue + reseller_revenue - coût total)/clics	Profit réseau par clic.
network_profit_ecpa	Argent	123.45	(booked_revenue + reseller_revenue - coût total)/conversions	Profit réseau par conversion.
network_profit_margin	Argent	123.45	(booked_revenue + reseller_revenue - coût total)/(booked_revenue + reseller_revenue)	Marge bénéficiaire du réseau.
buying_currency_total_segment_data_costs	Argent	123.45	total_segment_data_costs * advertiser_exchange_rate	Tous les coûts liés à l’utilisation des segments dans la Place de marché de données. Elle s’applique lorsque des segments spécifiques sont appliqués à des éléments de ligne et que la tarification associée est affichée dans la plateforme. Il est dans la devise utilisée par l’acheteur pour acheter l’inventaire.
selling_currency_total_segment_data_costs	Argent	123.45	total_segment_data_costs * publisher_exchange_rate	Tous les coûts liés à l’utilisation des segments dans la Place de marché de données. Elle s’applique lorsque des segments spécifiques sont appliqués à des éléments de ligne et que la tarification associée est affichée dans la plateforme. Il est dans la devise utilisée par le vendeur pour vendre l’inventaire.

Exemple

Create demande de rapport au format JSON

{code}$ cat network_publisher_analytics
{
    "report":
    {
        "report_type":"network_publisher_analytics",
        "columns":[
            "hour",
            "buyer_member_id",
            "inventory_source",
            "gender",
            "imps_total",
            "imps_sold",
            "imps_default",
            "clicks",
            "total_convs",
            "ctr",
            "convs_rate"
        ],
        "row_per":[
            "hour",
            "buyer_member_id",
            "inventory_source_id",
            "gender"
        ],
        "report_interval":"last_48_hours",
        "format":"csv"
    }
}
{code}

POST la demande au service de création de rapports

{code}$ curl -b cookies -c cookies -X post -d @network_publisher_analytics "https://api.appnexus.com/report?publisher_id=4642"
{
   "response":{
      "status":"OK",
      "report_id":"f4ebb93755dd01dde4fc157f86198ea9"
   }
}
{code}

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.

{code}$ 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\":\"network_publisher_analytics\",\"columns\":[\"hour\",\"buyer_member_id\",\"inventory_source\",
            \"gender\",\"imps_total\",\"imps_sold\",\"imps_default\",\"clicks\",\"total_convs\",\"ctr\",\"convs_rate\"],
            \"row_per\":[\"hour\",\"buyer_member_id\",\"inventory_source_id\",\"gender\"],\"report_interval\":\"last_48_hours\",
            \"filters\":[{\"publisher_id\":\"4642\"}]}}",
         "url":"report-download?id=b97897a7864dd8f34e7457226c7af592"
      },
      "execution_status":"ready"
   }
}
{code}

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.

{code}$ curl -b cookies -c cookies 'https://api.appnexus.com/report-download?id=b97897a7864dd8f34e7457226c7af592' > /tmp/network_publisher_analytics.csv
{code}

Remarque

Il existe une limite de 100 000 lignes par rapport lorsque vous les téléchargez en tant que fichier XLSX et Excel.