Facturation réseau

Avertissement

Ce rapport a été déconseillé. Par conséquent, il doit être utilisé uniquement pour l’activité de facturation antérieure au 1er octobre 2015. Pour les rapports postérieurs au 1er octobre 2015, consultez le rapport de facturation d’achat et le rapport de facturation de vente.

Le rapport Analyse de la facturation réseau peut être utilisé pour afficher les données de facturation sur :

• Impressions directes des annonceurs (achetées sur les éditeurs directs et l’inventaire en temps réel)
• Éditeurs directs (vendus par des annonceurs directs et d’autres acheteurs de plateforme)

Pour obtenir des instructions sur la récupération d’un rapport, consultez Service de rapports.

Remarque

Pour les impressions antérieures à 100 jours, le rapport de facturation réseau retourne désormais les valeurs par défaut dans certaines colonnes :

• Les éléments créatifs sont agrégés en une seule ligne avec 0 comme creative_id et un générique creative_name.
• Les placements sont agrégés en une ligne avec -1 comme placement_id et un générique placement_name.
• hour - Les données horaires sont agrégées en une ligne avec « AAAA-MM-JJ 00 :00 :00 » comme heure ( « AAAA-MM-JJ » est le jour UTC pendant lequel l’activité s’est produite). Cela donnera l’impression que toute l’activité s’est produite à minuit. Toutes les données quotidiennes antérieures à 100 jours sont retournées dans le fuseau horaire UTC.

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 ce rapport est de 30 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
entity_member_id	int	Oui	123	--
buyer_member_id	int	Oui	123	ID interne du membre acheteur
buyer_member_name	string	Non	"My Network"	Nom d’affichage du membre acheteur
buyer_member	string	Non	"My Network (123)"	Déconseillé (à compter du 17 octobre 2016).
buyer_type	string	Oui	"Real Time", "Direct"	Type d’acheteur
buyer_currency	string	Oui	"USD"	Devise de l’acheteur.
seller_member_id	int	Oui	456	ID interne du membre vendeur
seller_member_name	string	Non	"That Seller"	Nom d’affichage du membre vendeur
seller_member	string	Non	"That Seller (456)"	Déconseillé (à compter du 17 octobre 2016).
seller_type	string	Oui	"Real Time", "Direct"	Type de vendeur
insertion_order_id	int	Oui	451	ID interne de l’ordre d’insertion
insertion_order_name	string	Non	"Q1-2014"	Nom d’affichage de l’ordre d’insertion
campaign_id	int	Oui	728	ID interne de la campagne
campaign_name	string	Non	"Test"	Nom d’affichage de la campagne
campaign	string	Non	"Test (728)"	Déconseillé (à compter du 17 octobre 2016).
creative_id	int	Oui	554	ID interne du créatif. Remarque : Pour les impressions de plus de 100 jours, les créations sont agrégées en une seule ligne avec 0 comme creative_id. 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 d’affichage du créatif. Remarque : Pour les impressions antérieures à 100 jours, les créations sont agrégées en une seule ligne avec un générique creative_name. 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é (à compter du 17 octobre 2016).
placement_id	int	Oui	567	ID interne du placement. Remarque : Pour les impressions antérieures à 100 jours, les placements sont agrégés en une seule ligne avec -1 comme placement_id.
placement_name	string	Non	"Photos 728x90"	Nom d’affichage du placement. Remarque : Pour les impressions antérieures à 100 jours, les placements sont agrégés en une ligne avec un générique placement_name.
placement	string	Non	"Photos 728x90 (567)"	Déconseillé (à compter du 17 octobre 2016).
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	string	Oui	"Blank"	Type d’impression. Pour connaître les valeurs possibles, consultez imp_type_id.
revenue_type	string	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
payment_type	string	Oui	"com", "revshare"	Type de paiement à un répartiteur.
cleared_direct	int	Oui	0, 1	Que l’acheteur paie ou non directement le vendeur pour le coût des médias. Si 0la valeur est , Xandr perçoit le coût des médias auprès de l’acheteur et paie le vendeur. Si 1la valeur est , l’acheteur paie directement le vendeur pour le coût des médias. Conseil : Les acheteurs peuvent faire correspondre le coût du média sur leur facture en filtrant les transactions « directes effacées ».
hour	Temps	Non	"2010-02-01 06:00:00"	L’heure de l’impression. Remarque : Pour les impressions antérieures à 100 jours, les données horaires sont agrégées en une ligne avec « AAAA-MM-JJ 00 :00 :00 » comme heure (« AAAA-MM-JJ » est le jour UTC pendant lequel l’activité s’est produite). Cela donnera l’impression que toute l’activité s’est produite à minuit. Toutes les données quotidiennes antérieures à 100 jours sont retournées dans le fuseau horaire UTC.
day	Temps	Non	"2010-02-01"	Le jour de l’impression.
month	Temps	Non	"2010-02"	Mois de l’impression.
advertiser_id	int	Oui	789	ID interne de l’annonceur
advertiser_name	string	Non	"Verizon"	Nom d’affichage de l’annonceur
advertiser	string	Non	"Verizon (789)"	Déconseillé (à compter du 17 octobre 2016).
advertiser_currency	string	Oui	"USD"	Devise de l’annonceur.
line_item_id	int	Oui	932	ID interne de 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é (à compter du 17 octobre 2016).
publisher_id	int	Oui	123	ID interne de l’éditeur
publisher_name	string	Non	"Microsoft"	Nom d’affichage de l’éditeur
publisher	string	Non	"Microsoft (123)"	Déconseillé (à compter du 17 octobre 2016).
publisher_currency	string	Oui	Yes	Devise de l’éditeur.
salesperson_for_advertiser	string	Oui	"Ray Parcino"	Vendeur de l’annonceur. Pour plus d’informations, consultez le "labels" champ dans le service Annonceur .
salesperson_for_publisher	string	Oui	"Brian Young"	Vendeur de l’éditeur. Pour plus d’informations, consultez le "labels" champ dans le service serveur de publication.
account_manager_for_advertiser	string	Oui	"Rachel Dina"	Gestionnaire de compte de l’annonceur. Pour plus d’informations, consultez le "labels" champ dans le service Annonceur .
account_manager_for_publisher	string	Oui	"Ami Fisher"	Gestionnaire de compte pour l’éditeur. Pour plus d’informations, consultez le "labels" champ dans le service serveur de publication.
trafficker_for_line_item	string	Oui	"Maurice Truman"	Trafficker pour l’élément de ligne. Pour plus d’informations, consultez le "labels" champ service d’élément de ligne.
salesrep_for_line_item	string	Oui	"Beverly Heller"	Représentant commercial de l’élément de ligne. Pour plus d’informations, consultez le "labels" champ service d’élément de ligne.

Mesures

Column	Type	Exemple	Formule	Description
imps	int	234123	Lutins	Nombre total d’impressions
clicks	int	545	Clics	Nombre total de clics sur toutes les impressions
convs	int	205	total_convs	Nombre total de conversions sur toutes les impressions
media_cost	Argent	304.36	media_cost	Coût total de l’inventaire acheté.
media_cost_pub_curr	Argent	201.34	media_cost_pub_curr	Coût total de l’inventaire acheté, dans la devise de l’éditeur.
media_cost_adv_curr	Argent	201.34	media_cost_adv_curr	Coût total de l’inventaire acheté, dans la devise de l’annonceur. Remarque : Si vous ne suivez pas les revenus via Xandr, il s’agit 0de .
net_media_cost	Argent	211.23	media_cost - auction_service_deduction	Le coût total des stocks achetés, moins les déductions de frais de service de vente aux enchères de l’acheteur.
net_media_cost_adv_curr	Argent	211.23	media_cost_adv_curr - auction_service_deduction_adv_curr	Le coût total des stocks achetés, moins les déductions de frais de service de vente aux enchères de l’acheteur, dans la devise de l’annonceur. Remarque : Si vous ne suivez pas les revenus via Xandr, il s’agit 0de .
ecpm	Argent	1.30	(spend / imps) x 1000	Montant d’argent dépensé par 1 000 impressions.
ecpm_pub_curr	Argent	1.30	(spend / imps) x 1000	Montant d’argent dépensé par 1000 impressions, dans la devise de l’éditeur.
ctr	double	0.002327	clicks / imps	Taux de clics vers les impressions
convs_rate	double	0.000856	total_convs / imps	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
booked_revenue	Argent	1201.13	booked_revenue	Chiffre d’affaires du réseau réservé par le biais d’annonceurs directs.
booked_revenue_adv_curr	Argent	970.24	booked_revenue_adv_curr	Chiffre d’affaires du réseau réservé par le biais d’annonceurs directs, dans la devise de l’annonceur.
network_profit	Argent	801.08	network_revenue - media_cost	Profit de réseau réservé via des annonceurs directs et revendu aux acheteurs en temps réel.
network_rpm	Argent	5.13	(network_revenue / imps) x 1000	Chiffre d’affaires réseau par mille (1000 imps)
network_ppm	Argent	3.42	(network_profit / imps) x 1000	Profit réseau par mille (1000 imps)
network_roi	double	2.94	(network_revenue / media_cost) - 1	Retour sur investissement réseau. Retourné sous forme de pourcentage, par exemple, 0,94 = 94 %
advertiser_revenue	Argent		advertiser_revenue	Chiffre d’affaires enregistré pour l’annonceur.
advertiser_profit	Argent		advertiser_revenue - media_cost	Profit de l’annonceur
advertiser_rpm	Argent		(advertiser_revenue / imps) x 1000	Chiffre d’affaires de l’annonceur par mille (1 000 imps)
advertiser_ppm	Argent		(advertiser_profit / imps) x 1000	Profit de l’annonceur par mille (1000 imps)
advertiser_roi	Argent		(advertiser_revenue / media_cost) x 1000	Retour sur investissement de l’annonceur
spend	Argent	304.36	media_cost
creative_overage_fees	Argent		creative_overage_fees	Total des frais facturés pour les créations hébergées qui dépassent la limite de taille de création.
creative_overage_fees_adv_curr	Argent		creative_overage_fees_adv_curr	Total des frais facturés pour les créatifs hébergés qui dépassent la limite de taille créative, dans la devise de l’annonceur. Remarque : Si vous ne suivez pas les revenus via Xandr, il s’agit 0de .
auction_service_fees	Argent		auction_service_fees	Total des frais facturés pour les impressions achetées auprès de tiers. Ces frais sont facturés en plus du coût média de l’acheteur. Pour plus d’informations, consultez Mécanismes des frais de service d’enchères de l’acheteur dans la documentation Monétiser.
auction_service_fees_adv_curr	Argent		auction_service_fees_adv_curr	Total des frais facturés pour les impressions achetées auprès de tiers, dans la devise de l’annonceur. Ces frais sont facturés en plus du coût média de l’acheteur. Pour plus d’informations, consultez Mécanismes des frais de service d’enchères de l’acheteur dans la documentation Monétiser. Remarque : Si vous ne suivez pas les revenus via Xandr, il s’agit 0de .
auction_service_deduction	Argent		auction_service_deduction	Le total des déductions facturées pour les impressions achetées auprès de tiers. Ces déductions sont incluses dans le coût média de l’acheteur et déduites lors du calcul du paiement du vendeur.
auction_service_deduction_adv_curr	Argent		auction_service_deduction_adv_curr	Le total des déductions facturées pour les impressions achetées auprès de tiers, dans la devise de l’annonceur. Ces déductions sont incluses dans le coût média de l’acheteur et déduites lors du calcul du paiement du vendeur. Remarque : Si vous ne suivez pas les revenus via Xandr, il s’agit 0de .
reseller_revenue	Argent	304.23	reseller_revenue	Chiffre d’affaires généré par les ventes à des acheteurs externes (RTB).
reseller_revenue_pub_curr	Argent	304.23	reseller_revenue_pub_curr	Chiffre d’affaires généré par les ventes à des acheteurs externes (RTB), dans la devise de l’éditeur.

Exemple

Create une demande de rapport au format JSON

Le fichier JSON doit inclure les report_type "network_analytics", 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 network-billing-request.json

{
    "report": {
        "format": "csv",
        "report_interval": "last_48_hours",
        "columns": [
            "seller_member_id",
            "buyer_member_id",
            "imps",
            "clicks",
            "convs_rate"
        ],
        "report_type": "network_billing"
    }
}

POST la demande au service de création de rapports

$ curl -b cookies -c cookies -X POST -d @network-billing-request.json 'https://api.appnexus.com/report'

{
    "response": {
        "status": "OK",
        "report_id": "a2add615a52f0ca4ed13f64ce9d94a5c",
        "existing": false
    }
}

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=097f59fc3ab7d02c5d60db42081d9b69'

{
    "response": {
        "status": "OK",
        "report": {
            "name": "",
            "created_on": "2014-04-07 15:51:19",
            "json_request": "{\"report\":{\"format\":\"csv\",\"report_interval\":\"last_48_hours\",\"columns\":[\"seller_member_id\",\"buyer_member_id\",\"imps\",\"clicks\",\"convs_rate\"],\"report_type\":\"network_billing\",\"filters\":[{\"entity_member_id\":\"1309\"}]}}",
            "url": "https://hb.nym1.sand-08.adnxs.net/report-download?id=a2add615a52f0ca4ed13f64ce9d94a5c"
        },
        "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 report-download service. 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.

Conseil

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=a2add615a52f0ca4ed13f64ce9d94a5c > /tmp/network-billing-report.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.