Partager via

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.

  • Last updated on