Remarque
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de vous connecter ou de modifier des répertoires.
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de modifier des répertoires.
Le rapport performances du domaine de site réseau peut être utilisé pour afficher les données de performances et d’optimisation par domaine pour tous les annonceurs d’un réseau.
Remarque
Pour afficher les données de performances et d’optimisation par domaine pour un annonceur spécifique, filtrez ce rapport par advertiser_idou utilisez le rapport rapport sur les performances du domaine de site.
Pour obtenir des instructions sur la récupération d’un rapport, consultez Service de rapports ou l’exemple ci-dessous.
Période
Le report_interval champ peut être défini sur l’une des valeurs suivantes :
- yesterday
- last_7_days
- month_to_yesterday
- month_to_date
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 à 30 jours auparavant. É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".
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-Ou- 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é. |
buyer_member |
string | Non | MyNetwork (4567) |
Déconseillé. |
buyer_member_id |
int | oui | 4567 |
ID du membre acheteur. |
buyer_member_name |
chaîne | Non | MyNetwork |
Nom du membre acheteur. |
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. |
campaign |
chaîne | Non | ExampleCampaign (123456) |
Déconseillé. |
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) |
Déconseillé. |
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 | ExampleGroupName(123) |
Déconseillé. |
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. |
top_level_category_name |
chaîne | Oui | "Shopping" |
Nom de la catégorie de contenu principale affectée au domaine. |
top_level_category |
chaîne | Oui | "Shopping (19821)" |
Déconseillé. |
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)" |
Déconseillé. |
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)" |
Déconseillé. |
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) |
Déconseillé. |
campaign_group_name |
chaîne | Non | ExampleGroupName |
Nom du groupe de campagnes. |
advertiser_id |
int | oui | 123 |
ID de l’annonceur. |
campaign_group_id |
int | oui | 123 |
Numéro d’identification unique du groupe de campagnes. |
advertiser_code |
string | Non | AdvertiserCode |
Code personnalisé pour l’annonceur. |
advertiser_name |
string | Non | ExampleAdvertiser |
Nom de l’annonceur. |
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) Ou'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) | Déconseillé. |
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, le sexe sera "u". |
is_remarketing |
int | Oui |
0, 1 |
Si 1la valeur est , la campagne est de remarketing. Si 0la 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. |
insertion_order_id |
int | Oui | 451 |
ID de l’ordre d’insertion. |
insertion_order_name |
string | Non | "Q1-2016" |
Nom d’affichage de l’ordre d’insertion. |
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 |
(profit / imps) * 1000 | Le bénéfice (défini comme le chiffre d’affaires réservé moins le coût total) pour 1 000 imps. |
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. |
media_cost_buying_currency |
Argent | 100.0 |
media_cost_buying_currency | Coût pour le membre acheteur pour les médias dans la devise que l’acheteur a définie (c’est-à-dire la devise d’achat). |
profit_buying_currency |
Argent | 0.084102 |
booked_revenue - total_cost | Chiffre d’affaires réservé moins le coût total dans la devise d’achat. |
revenue_ecpa_buying_currency |
Argent | 123.45 |
booked_revenue/conversions | Chiffre d’affaires par conversion dans la devise d’achat. |
revenue_ecpc_buying_currency |
Argent | 123.45 |
booked_revenue /clicks | Chiffre d’affaires par clic dans la devise d’achat. |
revenue_ecpm_buying_currency |
Argent | 123.45 |
(booked_revenue/imps) * 1 000 | Chiffre d’affaires réservé pour 1 000 impressions dans la devise d’achat. |
revenue_ecpa |
Argent | 123.45 |
booked_revenue/conversions | Chiffre d’affaires par conversion en devise défini selon le paramètre Currency 2.0. |
revenue_ecpc |
Argent | 123.45 |
booked_revenue /clicks | Chiffre d’affaires par conversion en devise défini selon le paramètre Currency 2.0. |
revenue_ecpm |
Argent | 123.45 |
(booked_revenue/imps) * 1 000 | Chiffre d’affaires réservé pour 1 000 imps dans la devise définie selon le paramètre Currency 2.0. |
Remarque
Devise 2.0 : selon le paramètre Currency 2.0, la devise est une variable d’entrée pour les rapports. Les utilisateurs peuvent utiliser une liste déroulante monétaire dans l’interface utilisateur et le processeur de rapports prend l’entrée monétaire et retourne tous les champs monétaires du rapport dans la devise applicable. Les utilisateurs peuvent choisir parmi les options ci-dessous pour sélectionner une devise :
- Devise du membre : il s’agit de la devise définie au niveau du membre qui se trouve en haut. Bien que les annonceurs et d’autres objets puissent être définis dans différentes devises sous un membre, des rapports peuvent être générés dans cette devise.
- Devise de l’annonceur : il s’agit de la devise dans laquelle l’annonceur opère. Lors de la création de l’annonceur, la devise de fonctionnement de celui-ci est définie et des rapports peuvent être générés dans cette devise.
- Devise de l’éditeur : il s’agit de la devise dans laquelle l’éditeur vend son inventaire. Tous les objets enfants tels que les groupes de placement/placements sous l’éditeur héritent de cette devise.
- Devise de l’élément de ligne : il s’agit de la devise dans laquelle le budget est défini au niveau de l’élément de ligne.
- Devise de facturation : il s’agit de la devise dans laquelle les paramètres de facturation sont définis au niveau de l’ordre d’insertion.
Compartiments d’âge
| ID de compartiment | Nom du compartiment |
|---|---|
0 |
"unknown" |
1 |
"13-17" |
2 |
"18-24" |
3 |
"25-34" |
4 |
"35-44" |
5 |
"45-54" |
6 |
"'55-64" |
7 |
"65+" |
Métriques de définition visualisables personnalisées
| Column | Type | Exemple | Formule | Description |
|---|---|---|---|---|
viewdef_viewed_imps |
int | 4399 |
viewdef_viewed_imps | Nombre d’impressions mesurées qui étaient visibles, selon la configuration de définition personnalisée au niveau du membre (pour plus d’informations, contactez votre représentant de compte Xandr). |
viewdef_viewed_rate |
double | 96% |
viewdef_viewed_imps / view_measured_imps | Pourcentage d’impressions visibles, par configuration de définition personnalisée au niveau du membre, sur le nombre total d’impressions mesurées pour la visibilité. |
Exemple
Create une demande de rapport au format JSON
$ cat network_site_domain_performance
{
"report":
{
"report_type" : "network_site_domain_performance",
"columns":[
"day",
"advertiser_id",
"site_domain",
"campaign_id",
"line_item_id",
"booked_revenue",
"imps",
"clicks",
"click_thru_pct",
"post_click_convs",
"post_view_convs"],
"report_interval": "last_7_days",
"emails": ["js@mynetwork.com"],
"format": "csv"
}
}
POST la demande au service de création de rapports
$ curl -b cookies -c cookies -X POST -d @network_site_domain_performance 'https://api.appnexus.com/report'
{
"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-12-06 23:24:34",
"cache_hit": false,
"fact_cache_hit": false,
"json_request": "{\"report\":{\"report_type\":\"network_site_domain_performance\",\"columns\":[\"day\",\"advertiser_id\",
\"site_domain\",\"campaign_id\",\"line_item_id\",\"booked_revenue\",\"imps\",\"clicks\",\"click_thru_pct\",\"post_click_convs\",
\"post_view_convs\"],\"report_interval\":\"last_7_days\",\"emails\":[\"js@mynetwork.com\"],\"filters\":
[{\"buyer_member_id\":\"882\"}]}}",
"header_info": "Report type:,member_site_domain_performance\u000d\u000a,\u000d\u000aRun at:,2011-12-06 23:24:34\u000d
\u000aStart date:,2011-11-29 00:00:00\u000d\u000aEnd date:,2011-12-06 00:00:00\u000d\u000aTimezone:,\u000d\u000aUser:,
John Smith (10055)\u000d\u000a",
"data": "day,advertiser_id,site_domain,campaign,line_item,booked_revenue,imps,clicks,click_thru_pct,post_click_convs,
post_view_convs\u000d\u000a2011-12-05,33347,site1.com,Fall 2011 C2 - targeted inv (145034),Fall 2011 Revenue CPM (61047),
.003000,1,0,.000000000000000000%,0,0\u000d\u000a2011-12-05,33347,site2.com,Fall 2011 C2 - targeted inv (145034),
Fall 2011 Revenue CPM (61047),.006000,2,0,.000000000000000000%,0,0\u000d\u000a2011-12-05,55672,site1.com,
Fall 2011 C2 - targeted inv (145034),Fall 2011 Revenue CPM (61047),.003000,1,0,.000000000000000000%,0,0\u000d\u000a2011-12-05,
55672,site2.com,Fall 2011 C2 - targeted inv (145034),Fall 2011 Revenue CPM (61047),1.251000,417,0,.000000000000000000%,0,0\
u000d\u000a2011-12-05,55672,site3.com,Fall 2011 C2 - targeted inv (145034),Fall 2011 Revenue CPM (61047),.003000,1,0,
.000000000000000000%,0,0\u000d\u000a" ...,
"url": "report-download?id=c52347fdcaabbb669b18f55c05698422"
},
"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=c52347fdcaabbb669b18f55c05698422' > /tmp/network_site_domain_performance.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.