Partager via


Performances du domaine de site réseau

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.