Analyse de l’opérateur réseau

Le rapport Network Carrier Analytics vous permet de récupérer des données de performances côté achat et côté vente en fonction des opérateurs pour les appareils. Cela est particulièrement utile pour analyser la façon dont les opérateurs affectent les performances des campagnes et le paiement des annonceurs. En outre, dans les cas où les annonceurs configurent des pages d’accueil spécifiques pour chaque opérateur, ce rapport vous aide à identifier les opérateurs sur lesquels les campagnes ont été exécutées.

Pour obtenir des instructions sur la demande et la récupération de ce rapport, consultez l’exemple ci-dessous.

Période

Le report_interval champ peut être défini sur l’une des valeurs suivantes (dans le fuseau horaire UTC) :

• aujourd’hui
• yesterday
• last_2_days
• last_7_days
• last_30_days
• month_to_date
• month_to_yesterday

Vous pouvez également définir les start_date champs et end_date sur une plage au cours des 14 derniers jours. Toutefois, étant donné que les données horaires ne sont pas disponibles pour ce rapport, et start_dateend_date ne peuvent pas être identiques et doivent être mis en forme comme "YYYY-MM-DD" au lieu de "YYYY-MM-DD HH:MM:SS". Le timezone champ dans la requête JSON peut être défini uniquement "UTC"sur , mais ce n’est pas nécessaire, car le fuseau horaire est défini par défaut "UTC" sur s’il n’est pas spécifié.

Période de conservation des données

La période de conservation des données pour le rapport est de 46 jours.

Dimensions

Column	Type	Filtre?	Exemple	Description
month	Temps	Oui	"2010-02"	Le mois de la vente aux enchères.
day	Temps	Oui	"2010-02-01"	Le jour de la vente aux enchères.
carrier_id	int	Oui	20	ID de l’opérateur de l’appareil sur lequel l’impression a été servie. Pour récupérer une liste complète des ID et noms d’opérateur, utilisez le service opérateur.
carrier_name	string	Non	"Sprint - FR"	Nom de l’opérateur de l’appareil sur lequel l’impression a été servie.
carrier	string	Non	"Sprint - FR (20)"	Déconseillé.
device_type	string	Oui	"tablets"	Type d’appareil sur lequel l’impression a été servie. Les valeurs possibles sont les suivantes : - "desktops & laptops" - "tablets" - "mobile phones" - "tv" - "game consoles" - "set top box" - "media players" - "other devices"
connection_type	string	Oui	"Carrier-based"	Type de connexion Internet au moment de l’impression. Valeurs possibles : "Carrier-based" ou "Wifi or Static".
entity_member_id	int	Oui	123	Si imp_type est 1 (Vide), 2 (PSA), 3 (Erreur par défaut), 4 (Par défaut), 6 (Revendu) ou 8 (PSA résultant d’une erreur par défaut), l’ID du membre acheteur ; sinon, l’ID du membre vendeur.
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
buyer_member_name	string	Non	"My Network"	Nom du membre acheteur.
buyer_member	string	Non	"My Network (123)"	Déconseillé.
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é.
buyer_type	string	Oui	"Real Time"	Type de média acheté par le membre acheteur. Valeurs possibles : "Real Time" ou "Direct".
seller_type	string	Oui	"Real Time"	Type de média vendu par le membre vendeur. Valeurs possibles : "Real Time" ou "Direct".
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	"Mobile Zombies"	Nom de l’annonceur.
advertiser	string	Non	"Mobile Zombies (789)"	Déconseillé.
advertiser_code	string	Non	"MZB1010"	Code personnalisé pour l’annonceur.
insertion_order_id	int	Oui	321	ID de l’ordre d’insertion.
insertion_order_name	string	Non	"Mobile Insertion Order"	Nom de l’ordre d’insertion.
insertion_order	string	Non	"Mobile Insertion Order (321)"	Déconseillé.
insertion_order_code	string	Non	"Mobile Insertion Order Code"	Code personnalisé pour l’ordre d’insertion.
line_item_id	int	Oui	111	ID de l’élément de ligne.
line_item_name	string	Non	"Mobile Line Item"	Nom de l’élément de ligne.
line_item	string	Non	"Mobile Line Item (111)"	Déconseillé.
line_item_code	string	Non	"Mobile Line Item Code"	Code personnalisé pour l’élément de ligne.
campaign_id	int	Oui	222	ID de la campagne.
campaign_name	string	Non	"Mobile Campaign"	Nom de la campagne.
campaign	string	Non	"Mobile Campaign (222)"	Déconseillé.
campaign_code	string	Non	"Mobile Campaign Code"	Code personnalisé pour la campagne.
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 2"	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.
pixel_id	int	Oui	3849	ID du pixel de conversion.
media_type	string	Oui	"Banner"	Type de média du créatif. Valeurs possibles : - "Banner" - "Pop" - "Interstitial" - "Video" - "Text" - "Expandable" - "Skin". Pour récupérer une liste complète des types de médias, utilisez le service De type de média.
mediatype_id	int	Oui	1	ID du type de média du créatif.
size	string	Oui	"728x90"	Taille du placement/créatif servi.
geo_country	string	Oui	"US"	Code du pays.
geo_country_name	string	Non	"United States"	Nom du pays.
payment_type	string	Oui	"com", "revshare"	Type de paiement à un répartiteur.
revenue_type	string	Non	"CPA"	La base sur laquelle l’annonceur paie le membre.
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.
publisher	string	Oui	"AppSite (123)"	Déconseillé.
publisher_code	string	Non	"Publisher Code"	Code personnalisé pour l’éditeur.
pub_rule_name	string	Non	"Publisher Rule Name"	Nom de la règle d’éditeur.
pub_rule	string	Non	"Publisher Rule Name (555)"	Déconseillé.
pub_rule_code	string	Non	"AppSitePR123"	Code personnalisé pour la règle d’éditeur.
bid_type	string	Oui	"Manual"	Phase d’optimisation dans laquelle se trouvait le nœud lorsqu’il a demandé l’impression. Notez que le terme « abandonner » est ajouté aux types d’offres ci-dessous si l’évaluation de cette impression tombe sous le « prix d’abandonner » du lieu. Pour plus d’informations, consultez Qu’est-ce qu’un lieu ? et Abandonner le prix dans la documentation de l’interface utilisateur. Valeurs autorisées : - "Manual": s’applique lorsque vous enchérissez avec un objectif CPM, qu’il s’agisse de base, d’EAP ou d’ECP. - "Learn": S’applique lorsque vous enchérez avec optimisation (CPA, CPC ou marge) et que nous n’avons pas encore suffisamment de données pour enchérir optimisée. - "Optimized": s’applique lorsque vous effectuez des enchères avec optimisation (CPA, CPC ou marge) et que nous avons suffisamment de données pour que l’offre soit optimisée. - "Unknown": le nœud était dans une phase d’optimisation inconnue. - "Optimized give up" - "Learn give up" - "Manual give up"
imp_type_id	int	Oui	6	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	"Resold"	Type d’impression. Pour connaître les valeurs possibles, consultez imp_type_id.
venue	string	Oui	"Venue Name"	Nom du cluster de domaine, de site, d’étiquette et de pays 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.

Mesures

Column	Type	Exemple	Formule	Description
imps	int	2340	Lutins	Nombre total d’impressions (servies et revendues).
imps_blank	int	3	imps_blank	Nombre d’impressions servies avec un vide.
imps_psa	int	5	imps_psa	Nombre d’impressions qui ont servi une psa.
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 que votre annonceur a achetées 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	1	Clics	Nombre total de clics sur toutes les impressions.
click_thru_pct	double	1.12359550561797%	(clics / imps) x 100	Taux de clics vers les impressions sous forme de pourcentage.
ctr	double	0.000221877080097626	clicks / imps	Taux de clics vers les impressions.
total_convs	int	1	total_convs	Nombre total de conversions post-affichage et post-clic.
post_view_convs	int	15	post_view_convs	Nombre total de conversions post-affichage enregistrées.
post_click_convs	int	15	post_click_convs	Nombre total de conversions post-clic enregistrées.
convs_per_mm	double	221.877080097625	(total_convs / imps) x 1 000 000	Nombre de conversions par million d’impressions.
convs_rate	double	0.000221877080097626	total_convs / imps	Taux de conversions en impressions.
cost	Argent	16.833378	Coût	Montant total du coût multimédia pour l’éditeur direct et l’inventaire tiers acheté.
cpm	Argent	1.66051685393258	(coût / imps) x 1000	Coût multimédia pour 1 000 impressions.
revenue	Argent	25.767257	booked_revenue + reseller_revenue	Le chiffre d’affaires total des annonceurs directs (article ligne) et des éditeurs directs (impressions revendues).
booked_revenue	Argent	25.767257	booked_revenue	Chiffre d’affaires total réservé par l’intermédiaire d’annonceurs directs (élément de ligne).
reseller_revenue	Argent	0	reseller_revenue	Le chiffre d’affaires total des impressions revendues par les éditeurs directs.
rpm	Argent	2.60548314606741	(revenue / imps) x 1000	Chiffre d’affaires par 1 000 impressions.
profit	Argent	0.084102	booked_revenue - total_cost	Chiffre d’affaires réservé moins le coût total.
ppm	Argent	0.944966292134831	(profit / imps) x 1000	À déprécier. Le bénéfice par 1 000 impressions.
total_publisher_rpm	Argent	1.66051685393258	(coût / imps) x 1000	Coût pour 1 000 impressions payées aux éditeurs directs et tiers, y compris les erreurs.
sold_publisher_rpm	double	147.786	(coût/imps) x 1000 ----- aucune erreur	Coût par 1 000 impressions payées aux éditeurs directs et tiers, sans inclure les erreurs.
sold_network_rpm	double	231.888	(revenue/ imps) x 1000 ----- aucune erreur	Chiffre d’affaires pour 1 000 impressions qui n’étaient pas des erreurs.
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.
video_skips	int	10		Nombre total de fois où un utilisateur a ignoré la vidéo. Utilisez cette métrique pour créer des rapports lors de l’achat d’un inventaire non modifiable.
video_starts	int	11		Nombre total de fois où le premier segment de la création vidéo a été téléchargé et démarré.
video_25_pcts	int	10		Nombre total de fois où les créations vidéo ont terminé 25 % de la durée totale.
video_50_pcts	int	10		Nombre total de fois où les créations vidéo se sont terminées 50 % de la durée totale.
video_75_pcts	int	10		Nombre total de fois où les créations vidéo se sont terminées 75 % de la durée totale.
video_completions	int	12		Nombre total de fois où les créations vidéo ont été lues pendant toute la durée.
video_served	int	10		Nombre total de réponses vidéo envoyées au lecteur. Une réponse publicitaire se produit lorsque le document VAST (XML) est servi en réponse à une demande. Une réponse publicitaire n’indique pas nécessairement une impression réussie. Pour une impression, la première image de la vidéo doit être servie.
video_errors	int	2		Nombre total de fois qu’une erreur vidéo s’est produite.
revenue_per_video_complete	Argent	25.76		Chiffre d’affaires par saisie semi-automatique de la vidéo.
cost_per_video_complete	Argent	22.76		Coût par saisie semi-automatique de la vidéo.
video_completion_rate	double	1.12359550561797%	(saisies vidéo/impressions totales) x 100	Rapport entre les saisies semi-vidéo et les impressions, exprimé sous forme de pourcentage.
video_start_rate	double	1.12359550561797%		Pourcentage de fois où le premier segment de la création vidéo a été téléchargé et démarré.
video_skip_rate	double	1.12359550561797%		Pourcentage de fois où l’utilisateur a choisi d’ignorer la vidéo.

Exemple

Create une demande de rapport au format JSON

Le fichier JSON doit inclure le report_type de "network_carrier_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, excel, ou html). Pour obtenir une explication complète des champs qui peuvent être inclus dans le fichier JSON, consultez service de rapports. Dans cet exemple, nous voulons voir comment les campagnes fonctionnent sur les téléphones mobiles et les tablettes sur trois opérateurs spécifiques. Plus précisément, pour chaque combinaison d’opérateur et de type d’appareil, nous voulons le nombre d’impressions, le nombre de clics, l’argent total dépensé, l’argent dépensé par 1 000 impressions, l’argent que nous a versé l’annonceur et le bénéfice total (argent gagné - argent dépensé).

$ cat network_carrier_analytics

{
    "report": {
        "report_type": "network_carrier_analytics",
        "filters": [
            {
                "carrier_id": [
                    345,
                    567,
                    837
                ]
            },
            {
                "device_type": [
                    "mobile phones",
                    "tablets"
                ]
            }
        ],
        "columns": [
            "day",
            "carrier_id",
            "device_type",
            "imp_type",
            "imps",
            "clicks",
            "cost",
            "cpm",
            "booked_revenue",
            "profit"
        ],
        "report_interval": "last_14_days",
        "format": "csv"
    }
}

POST la demande au service de création de rapports

POST la requête JSON pour récupérer un ID de rapport.

$ curl -b cookies -c cookies -X POST -d @network_carrier_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 -c cookies 'https://api.appnexus.com/report?id=097f59fc3ab7d02c5d60db42081d9b69'
{
   "response":{
      "status":"OK",
      "report":{
         "name":null,
         "created_on":"2013-02-01 12:19:53",
            "json_request": "{\"report\":{\"report_type\":\"network_carrier_analytics\",\"filters\":[{\"advertiser_id\":1459},
             {\"geo_country\":\"US\"}],\"columns\":[\"day\",\"carrier_id\",\"device_make\",\"device_model\",\"connection_type\",
             \"imp_type\",\"imps\",\"clicks\",\"cost\",\"cpm\",\"booked_revenue\",\"profit\"],\"format\":\"csv\"]}}",
         "url": "report-download?id=097f59fc3ab7d02c5d60db42081d9b69"
      },
      "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.

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=097f59fc3ab7d02c5d60db42081d9b69' > /tmp/network_carrier_analytics.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.

Voir aussi

• Service de rapports
• Bonnes pratiques relatives aux API
• Sémantique d’API