Rapport sur les performances du domaine de site

Le rapport sur les performances du domaine de site peut être utilisé pour afficher les données de performances et d’optimisation par domaine pour un annonceur spécifique.

Conseil

Pour afficher les données de performances et d’optimisation par domaine pour plusieurs annonceurs, utilisez le rapport Performances du domaine de site réseau .

Pour obtenir des instructions sur la récupération d’un rapport, consultez Service de rapports ou consultez l’exemple ci-dessous. Pour un utilisateur annonceur, l’ID de l’annonceur est détecté en fonction de l’authentification de l’utilisateur. Toutefois, pour un utilisateur réseau, ce rapport nécessite de spécifier l’ID de l’annonceur dans le cadre de l’URL, par exemple :

https://api.appnexus.com/report?advertiser_id=ADVERTISER_ID

Période

Le report_interval champ dans la requête JSON peut être défini sur l’une des valeurs suivantes :

yesterday
last_7_days
month_to_date
month_to_yesterday

Si vous utilisez les start_date champs et end_date pour définir l’intervalle de temps, le start_date ne doit pas être supérieur à 45 jours auparavant. Étant donné que les données horaires ne sont pas disponibles pour ce rapport, start_date elles end_date ne peuvent pas être identiques et doivent être mises en forme comme "YYYY-MM-DD" au lieu de "YYYY-MM-DD HH:MM:SS". Les données de rapport ne peuvent être retournées que pour le fuseau horaire UTC.

Période de conservation des données

La période de conservation des données pour ce rapport est de 45 jours.

Dimensions

Column	Type	Filtre?	Exemple	Description
`month`	date	oui	`11/1/11`	Mois et année (avec le premier jour du mois).
`day`	date	oui	`11/16/11`	Jour, mois et année.
`site_domain`	string	Non	`bestsiteever.com - or - itunes.apple.com/app/app-name/id1234567`	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é.
`campaign`	string	Non	`ExampleCampaign (123456)`	Nom de la campagne suivi de l’ID (format Xandr).
`campaign_id`	int	oui	`123456`	ID de la campagne.
`campaign_code`	string	Non	`CampaignCode`	Code personnalisé pour la campagne.
`campaign_name`	string	Non	`ExampleCampaign`	Nom de 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.
`line_item`	string	Non	`ExampleLineItem (323)`	Nom de l’élément de ligne suivi de l’ID (format Xandr).
`line_item_id`	int	oui	`323`	ID de l’élément de ligne.
`line_item_name`	chaîne	Non	`ExampleLineItem`	Nom de l’élément de ligne.
`campaign_group`	string	Non	`ExampleCampaign(123)`	Nom du groupe de campagnes suivi de l’ID (format Xandr). Remarque : `campaign_group` est synonyme `line_item`de .
`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`	chaîne	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`.
`top_level_category_id`	int	oui	`19821`	ID de la catégorie de contenu principale affectée au domaine. Ce champ peut être `0` si le domaine n’a pas de `second_level_category` catégorie parente.
`top_level_category_name`	chaîne	Oui	`"Shopping"`	Nom de la catégorie de contenu principale affectée au domaine. Ce champ peut être vide si le domaine n’a pas de `second_level_category` catégorie parente.
`top_level_category`	chaîne	Oui	`"Shopping (19821)"`	Nom et ID de la catégorie de contenu principale affectée au domaine. Ce champ peut être vide si le domaine n’a pas de `second_level_category` catégorie parente.
`second_level_category_id`	int	oui	`20129`	ID de la catégorie de contenu de deuxième niveau affectée au domaine. Remarque : Si le domaine est une catégorie de niveau supérieur, vous ne devez pas demander cette dimension.
`second_level_category_name`	chaîne	Oui	`"Shoes"`	Nom de la catégorie de contenu de deuxième niveau affectée au domaine. Remarque : Si le domaine est une catégorie de niveau supérieur, vous ne devez pas demander cette dimension.
`second_level_category`	chaîne	Oui	`"Shoes (20129)"`	ID et nom de la catégorie de contenu de deuxième niveau affectée au domaine. Remarque : Si le domaine est une catégorie de niveau supérieur, vous ne devez pas demander cette dimension.
`deal_id`	int	Oui	`2345`	ID de la transaction. Pour plus d’informations sur les transactions que vous avez négociées avec les vendeurs, consultez 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)"`	Nom de la transaction suivi de l’ID (format Xandr).
`deal_code`	string	Non	`"External seller deal code"`	Code personnalisé pour la transaction. Pour les transactions avec des partenaires fournisseurs externes, il s’agit généralement de la chaîne que vous utilisez pour identifier la transaction.
`advertiser`	string	Non	`ExampleAdvertiser (123)`	Nom de l’annonceur suivi de l’ID (format Xandr).
`campaign_group_name`	string	Non	`ExampleGroupName`	Nom du groupe de campagne
`advertiser_id`	int	oui	`123`	ID de l’annonceur.
`campaign_group_id`	int	Non	`123`	Numéro d’identification unique du groupe de campagne
`advertiser_code`	chaîne	Non	`AdvertiserCode`	Code personnalisé pour l’annonceur.
`advertiser_name`	chaîne	Non	`ExampleAdvertiser`	Nom de l’annonceur.
`buyer_member`	string	Non	`MyNetwork (4567)`	Nom du membre acheteur suivi de l’ID (format Xandr).
`buyer_member_id`	int	oui	`4567`	ID du membre acheteur.
`buyer_member_name`	chaîne	Non	`MyNetwork`	Nom du membre acheteur.
`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'`
`mobile_application_id`	string	Oui	`‘343200656’ (iOS) or ‘com.rovio.angrybirds’ (Android)`	Un ID de App Store Apple, un nom de package Google Play ou un ID d’application Windows pouvant être ciblé.
`mobile_application_name`	string	Oui	`Angry Birds`	Nom de l’application mobile tel qu’il apparaît dans l’application Apple et google Play Stores.
`mobile_application`	string	Non	`Angry Birds (com.rovio.angrybirds)`	Nom de l’application mobile suivi de l’ID (format Xandr).
`fold_position_id`	int	Oui	`0`	ID de la position de pliage, c’est-à-dire l’emplacement sur la page où se trouve le placement. Valeurs possibles pour les impressions : `0` = « unknown » `1` = « above » `2` = « below »
`fold_position`	string	Oui	`"Unknown"`	Position du pliage, c’est-à-dire l’emplacement sur la page. Pour connaître les valeurs autorisées, consultez `fold_position_id`.
`age_bucket`	string	Oui	`"25-34"`	Compartiment pour l’âge de l’utilisateur. Pour connaître les valeurs possibles, consultez Compartiments d’âge ci-dessous. Remarque : Pour les impressions antérieures à 100 jours, la `age_bucket` valeur est `"unknown"`.
`age_bucket_id`	string	Non	`"3"`	ID du compartiment d’âge. Pour connaître les valeurs possibles, consultez Compartiments d’âge ci-dessous. Remarque : pour les impressions antérieures à 100 jours, le `age_bucket_id` sera `0`.
`gender`	string	Oui	`"m"`, `"f"`, `"u"`	Sexe de l’utilisateur. Remarque : pour les impressions antérieures à 100 jours, `gender` sera `"u"`.
`is_remarketing`	int	Oui	`0`, `1`	Si `1`la valeur est , la campagne est de remarketing. Si `0`la valeur est , la campagne n’est pas de remarketing. Remarque : pour les impressions antérieures à 100 jours, `is_remarketing` sera `-1`.
`pixel_id`	int	oui	`1942`	Numéro d’identification unique du pixel de conversion. Remarque : cette dimension retourne un maximum de 10 pixels de conversion. En outre, vous pouvez filtrer par au plus 10 pixels de conversion. Bien que `pixel_id` soit groupable, nous vous déconseillons de regrouper par cette dimension, car cela entraîne l’affichage des événements de conversion dans des lignes distinctes des événements d’impression et de clic. Nous partons généralement du principe que vous souhaitez afficher tous ces événements dans une seule ligne afin de pouvoir récupérer des valeurs précises et agrégées pour les calculs du taux de conversion et du coût par conversion. Par conséquent, nous vous recommandons plutôt de filtrer par `pixel_id` afin de pouvoir récupérer les nombres de conversions et les métriques associées pour vos ID de pixel les plus pertinents.
`operating_system_id`	int	Oui	`24`	ID du système d’exploitation de l’appareil. - Utilisez le service famille de systèmes d’exploitation pour obtenir la liste des familles de systèmes d’exploitation. - Utilisez le service étendu du système d’exploitation pour rechercher quelles versions de système d’exploitation se trouvent dans une famille de systèmes d’exploitation donnée.
`operating_system_name`	string	Oui	`"Android 2.3.5 Gingerbread"`	ID du système d’exploitation de l’appareil. - Utilisez le service famille de systèmes d’exploitation pour obtenir la liste des familles de systèmes d’exploitation. - Utilisez le service étendu du système d’exploitation pour rechercher quelles versions de système d’exploitation se trouvent dans une famille de systèmes d’exploitation donnée.
`operating_system_family_id`	int	Oui	`2`	ID du système d’exploitation de l’appareil. - Utilisez le service famille de systèmes d’exploitation pour obtenir la liste des familles de systèmes d’exploitation. - Utilisez le service étendu du système d’exploitation pour rechercher quelles versions de système d’exploitation se trouvent dans une famille de systèmes d’exploitation donnée.
`operating_system_family_name`	string	Oui	`"Android"`	ID du système d’exploitation de l’appareil. - Utilisez le service famille de systèmes d’exploitation pour obtenir la liste des familles de systèmes d’exploitation. - Utilisez le service étendu du système d’exploitation pour rechercher quelles versions de système d’exploitation se trouvent dans une famille de systèmes d’exploitation donnée.
`seller_member_id`	int	Oui	`12345`	ID du membre vendeur associé au domaine de site.
`seller_member_name`	string	Non	`"BestSellerEver"`	Nom du membre vendeur associé au domaine du site.

Mesures

Column	Type	Exemple	Formule	Description
`booked_revenue`	Argent	`450.00`	booked_revenue	Revenus reçus de l’annonceur. Pour plus d’informations, consultez Network Revenue and Billing Your Clients dans la documentation de l’interface utilisateur.
`clicks`	int	`2067`	Clics	Nombre total de clics.
`click_thru_pct`	double	`2.756%`	(clics / imps) * 100	Taux de clics vers les impressions sous forme de pourcentage.
`convs_per_mm`	double	`384.4`	(post_click_convs + post_view_convs / imps) * 1 000 000	Nombre de conversions par million d’impressions.
`convs_rate`	double	`0.0003844`	(post_click_convs + post_view_convs) / imps	Taux de conversions en impressions.
`cost_ecpa`	Argent	`1.1111`	media_cost / (post_click_convs + post_view_convs)	Coût par acquisition/conversion.
`cost_ecpc`	Argent	`0.1834`	media_cost / clics	Coût par clic.
`cpm`	Argent	`5.00`	media_cost / imps * 1000	Coût par millier d’impressions.
`ctr`	double	`0.22756`	clicks / imps	Taux de clics vers les impressions.
`imps`	int	`75000`	Lutins	Nombre total d’impressions servies.
`media_cost`	Argent	`100.00`	media_cost	Dépense pour le membre achetant. Pour plus d’informations, consultez Network Revenue and Billing Your Clients dans la documentation de l’interface utilisateur.
`post_click_convs`	int	`15`	post_click_convs	Nombre total de conversions post-clic enregistrées.
`post_click_convs_rate`	double	`0.0002`	post_click_convs / imps	Taux de conversions post-clic en impressions.
`post_view_convs`	int	`10`	post_view_convs	Nombre total de conversions post-affichage enregistrées.
`post_view_convs_rate`	double	`0.00013`	post_view_convs / imps	Taux de conversions post-affichage en impressions.
`profit`	Argent	`0.084102`	booked_revenue - total_cost	Chiffre d’affaires réservé moins le coût total.
`profit_ecpm`	Argent	`0.7778`	((booked_revenue - media_cost) / imps) * 1000	Bénéfice (défini comme le chiffre d’affaires réservé moins le coût total) pour 1 000 impressions.
`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 1 seconde consécutive.
`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)
`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.
`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.

Compartiments d’âge

ID de compartiment	Nom du compartiment
`0`	`"unknown"`
`1`	`"13-17"8`
`2`	`"18-24"`
`3`	`"25-34"`
`4`	`"35-44"`
`5`	`"45-54"`
`6`	`"55-64"`
`7`	`"65+"`

Exemple

Create une demande de rapport au format JSON

$ cat domain_performance

{
    "report":
    {
        "report_type": "site_domain_performance",
        "columns": [
            "day",
            "campaign",
            "booked_revenue",
            "imps",
            "clicks",
            "click_thru_pct",
            "site_domain"
        ]
        "report_interval": "last_7_days",
        "emails": ["js@mynetwork.com"],
        "format": "csv"
    }
}

`POST` la demande au service de création de rapports

Dans cet exemple, nous demandons l’exécution du rapport pour l’annonceur 660.

$ curl -b cookies -c cookies -X POST -d @domain_performance 'https://api.appnexus.com/report?advertiser_id=660'

{
    "response":{
        "status":"OK",
        "report_id":"07af1282c9485adcef49c95fa5d7496b"
    }
}

Utiliser l’ID de rapport pour récupérer les données du rapport

La réponse standard inclut les données du rapport et une URL de téléchargement que vous pouvez utiliser pour enregistrer les données dans un fichier. Si vous souhaitez obtenir uniquement l’URL de téléchargement sans les données du rapport, transmettez "without_data" la chaîne de requête.

$ curl -b cookies -c cookies 'https://api.appnexus.com/report?id=07af1282c9485adcef49c95fa5d7496b'

{
    "response": {
        "status": "OK",
        "report": {
            "name": null,
            "created_on": "2011-11-16 23:51:14",
            "cache_hit": false,
            "fact_cache_hit": false,
            "fact_cache_error": "fact-cache is off for report site_domain_performance",
            "json_request": "{\"report\":{\"report_type\":\"site_domain_performance\",\"columns\":[\"day\",\"campaign",
             "booked_revenue\",\"imps\",\"clicks\",\"click_thru_pct\",\"site_domain\"],\"report_interval\":\"last_7_days\",
             \"emails\":[\"js@mynetwork.com\"],\"filters\":[{\"buyer_member_id\":\"329\"},{\"advertiser_id\":\"660\"}]}}",
            "header_info": "Report type:,site_domain_performance\u000d\u000a,\u000d\u000aRun at:,2011-11-16 23:51:14\u000d\
             u000aStart date:,2011-11-09 00:00:00\u000d\u000aEnd date:,2011-11-16 00:00:00\u000d\u000aTimezone:,\u000d\
             u000aUser:,John Smith (9685)\u000d\u000a",
            "data": "day,campaign,booked_revenue,imps,clicks,click_thru_pct,site_domain\u000d\u000a2011-11-12,ExampleCampaign - 1
             (123456),.000000,24,0,.000000000000000000%,aaaa.com\u000d\u000a2011-11-13,ExampleCampaign - 2 (789012),.000000,9,0,
             .000000000000000000%,bbbb.net\u000d\u000a2011-11-12,ExampleCampaign - 3 (345678),.000000,2,0,.000000000000000000%,
             ccc.com\u000d\u000a2011-11-13,ExampleCampaign - 3 (345678),.000000,2,0,.000000000000000000%,cccc.de\u000du000a
             2011-11-14,ExampleCampaign - 3 (345678),.000000,10,0,.000000000000000000%,dddd.com\u000d\u000a2011-11-13,
             ExampleCampaign - 4 (901234), 2.574900,22,3,13.636363636363636364%,aaaa.com\u000d\u000a2011-11-15,ExampleCampaign - 3
             (345678),8.583000,2431,10,.411353352529823118%,abab.com\
             ...
            "url": "report-download?id=495d03a7667bac467bb488043ae336e9"
        },
        "execution_status": "ready"
    }
}

Utiliser l’URL de téléchargement pour enregistrer les données du rapport dans un fichier

Vous utilisez le "url" champ dans la réponse pour enregistrer les données du rapport dans un fichier. Effectuez simplement un autre GET appel et identifiez l’emplacement et le fichier dans lesquels vous souhaitez enregistrer. Veillez à utiliser le fichier l’extension du "format" que vous avez spécifié dans votre demande initiale POST .

$ curl -b cookies -c cookies 'https://api.appnexus.com/report-download?id=495d03a7667bac467bb488043ae336e9' > /tmp/site_domain.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 2025-10-22

Partager via