Partager via


Analytique des annonceurs

Le rapport Advertiser Analytics peut être utilisé pour afficher les données de performances, de revenus et de bénéfices dans les campagnes et les créations d’un annonceur spécifique. Ce rapport est disponible pour les utilisateurs du réseau et des annonceurs.

Pour obtenir des instructions sur la récupération d’un rapport, consultez Service de rapports ou l’exemple ci-dessous. Ce rapport nécessite la spécification de 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 :

  • 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 plupart des données de ce rapport sont conservées de manière permanente (exceptions indiquées ci-dessous). Après:

  • 100 jours, vous ne pouvez plus générer de rapports sur les données horaires. Toutefois, des intervalles quotidiens, mensuels et cumulés sont toujours disponibles.
  • 14 mois, vous n’êtes plus en mesure de rendre compte des individus :
    • Créatifs
    • Placements
    • Marques

Dans certains cas, les rapports d’analyse peuvent afficher une remise qui ne correspond pas aux statistiques affichées ailleurs dans Microsoft Invest ou Microsoft Monetize pour un annonceur ou un éditeur donné. Cela est dû à la façon dont les données de rapports Analytics datant de plus de 100 jours et 14 mois sont agrégées. Les données des rapports de facturation sont conservées indéfiniment sous forme non agrégée. Pour plus d’informations, consultez Dates et heures dans les rapports dans la documentation de l’interface utilisateur.

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
hour Temps Non "2010-02-01 06:00" L’heure de la vente aux enchères.

Remarque : Pour les impressions antérieures à 100 jours, le jour est retourné plutôt que l’heure.
day Temps Non "2010-02-01" Le jour de la vente aux enchères.
month Temps Non "2010-02" Le mois de la vente aux enchères.
adjustment_id int Oui 890 Numéro d’identification unique de l’ajustement utilisé pour apporter des modifications au coût multimédia et/ou aux impressions, clics et conversions que vous voyez dans les rapports pour un éditeur.
advertiser_code string Non "Advertiser Code" Code personnalisé pour l’annonceur.
advertiser_currency string Oui "USD" Type d’argent utilisé par l’annonceur.
advertiser_id int Oui 3 Numéro d’identification unique pour chaque annonceur.
buyer_member_id int Oui 210 Numéro d’identification unique du membre acheteur.
seller_member_id int Oui 765 Numéro d’identification unique du membre vendeur.
seller_member_name string Non "AdMeld" Nom du membre vendeur.
seller_member string Non "AdMeld (765)" Déconseillé (à compter du 17 octobre 2016).
campaign_id int Oui 728 Numéro d’identification unique de la campagne.
campaign_name string Non "Test" Nom de la campagne.
campaign string Non "Test (123)" Déconseillé (à compter du 17 octobre 2016).
campaign_code string Non "Campaign Code" Code personnalisé pour la campagne.
campaign_priority int Non 4 Priorité d’enchère d’une campagne qui cible l’inventaire direct. L’échelle est comprise entre 1 et 10, 1 étant la plus faible et 10 étant la plus élevée.
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 split_id (s’il est inclus) est null.
split_name string 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.
creative_id int Oui 554 Numéro d’identification unique du créatif.

Remarque :
- Pour les impressions datant de plus de 14 mois, 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 complet du créatif.
Remarque :
- Pour les impressions datant de plus de 14 mois, les créations sont agrégées en une seule ligne avec "All creative data older than 14 months" comme .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 546 Numéro d’identification unique du placement.

Remarque :
- Pour les impressions de plus de 14 mois, les placements sont agrégés en une ligne avec -1 comme placement_id.
placement_name string Non "300x250 Business" Nom du placement.

Remarque : Pour les impressions datant de plus de 14 mois, les placements sont agrégés en une ligne avec "All placement data older than 100 days" comme placement_name.
placement string Non "FP 728x90 (567)" Déconseillé (à compter du 17 octobre 2016).
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é (à compter du 17 octobre 2016).
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.
placement_code string Non "FP 728x90" Code personnalisé pour le placement.
size string Oui "728x90" Taille du placement/créatif servi.
geo_country string Oui "US" Code du pays géographique.
geo_country_name string Non "United States" Nom du pays géographique.
creative_recency_bucket string Oui "15-30 minutes" Déconseillé. Si vous demandez cette dimension, seule une valeur par défaut est retournée. Utilisez le rapport Fréquence créative & Récence de l’annonceur pour afficher les données de récurrence créative.
creative_recency_bucket_id string Non 3 Déconseillé. Si vous demandez cette dimension, seule une valeur par défaut est retournée. Utilisez le rapport Fréquence créative & Récence de l’annonceur pour afficher les données de récurrence créative.
creative_frequency_bucket string Oui "11-20" Déconseillé. Si vous demandez cette dimension, seule une valeur par défaut est retournée. Utilisez le rapport Fréquence créative de l’annonceur & Recency pour afficher les données de fréquence créative.
creative_frequency_bucket_id string Non 4 Déconseillé. Si vous demandez cette dimension, seule une valeur par défaut est retournée. Utilisez le rapport Fréquence créative de l’annonceur & Recency pour afficher les données de fréquence créative.
gender string Oui "m", "f", "u" Sexe de l’utilisateur.

Remarque :
Pour les impressions antérieures à 100 jours, le sexe sera "u".
La valeur du sexe est définie par l’éditeur dans la demande d’offre. Xandr n’a pas de contrôle sur celui-ci en dehors du traitement de la valeur.
imp_type_id int Oui 1 ID du type d’impression. Valeurs possibles (types associés entre parenthèses) :
- 1 ("Blank"): Aucune créativité n’est servie.
- 2 ("PSA"): Une annonce de service public a été effectuée parce qu’il n’y avait pas d’enchères valides et qu’aucune création par défaut n’était disponible.
- 3 ("Default Error"): création par défaut servie en raison d’un problème de délai d’expiration.
- 4 ("Default"): création par défaut, car il n’y avait pas d’enchères valides.
- 5 ("Kept"): la créativité de votre annonceur servie sur le site de votre éditeur.
- 6 ("Resold"): 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 ("PSA Error"): une annonce de service public a été effectuée en raison d’un problème de délai d’expiration ou d’un manque de création par défaut.
- 9 ("External Impression"): impression provenant d’un dispositif de suivi d’impression.
- 10 ("External Click"): un clic à partir d’un dispositif de suivi des clics.
imp_type string Oui "Kept" Type d’impression. Pour connaître les valeurs possibles, consultez imp_type_id.
bid_type string Oui "Manual" Phase d’optimisation dans laquelle se trouvait le nœud lorsqu’il a demandé cette impression.

Remarque : 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. 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"
insertion_order_id int Oui 648359 Numéro d’identification unique de l’ordre d’insertion.
insertion_order_name string Non "InsertionOrderABC" Nom de l’ordre d’insertion.
insertion_order string Non "InsertionOrderABC648359" Déconseillé (à compter du 17 octobre 2016).
insertion_order_code string Non "Insertion Order Code" Code personnalisé pour l’ordre d’insertion.
line_item_id int Oui 947764 Numéro d’identification unique de l’élément de ligne.
line_item_namE string Non "LineItemDEF" Nom de l’élément de ligne.
line_item string Non "LineItemDEF947764" Déconseillé (à compter du 17 octobre 2016).
line_item_code string Non "Line Item Code" Code personnalisé pour l’élément de ligne.
supply_type string Non "web" Type d’inventaire. Valeurs possibles :
- "web"
- "mobile_web"
- "mobile_app".
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.
publisher_id int Oui 374967 Numéro d’identification unique de l’éditeur.
publisher_name string Non "Publisher XYZ" Nom de l’éditeur.
publisher string Non "Publisher XYZ 347967" Déconseillé (à compter du 17 octobre 2016).
publisher_code string Non "Publisher Code" Code personnalisé pour l’éditeur.
seller_type string Oui "Real Time", "Direct" Type de vendeur.
supply_type string Oui "web" Type d’inventaire. Valeurs possibles :
- "web"
- "mobile_web"
- "mobile_app".
media_type string Non "Banner", "Pop", "Interstitial", "Video", "Text", "Expandable", "Skin" Style d’affichage général du créatif. Vous pouvez utiliser le service de type de média pour afficher la liste complète des types de médias.
mediatype_id int Oui 2 Numéro d’identification unique du type de média auquel appartient le sous-type.
user_group_for_campaign string Oui "Test" Groupe d’utilisateurs de test/contrôle pour la campagne. Pour plus d’informations, consultez le "labels" champ dans Campaign Service .
venue int Oui 321512 Nom du cluster de domaine, de site, d’étiquette et de pays d’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.
billing_period_start_date DateHeure Non "2015-05-25 19:19:53" Date la plus ancienne de la période de facturation de la commande d’insertion.

Remarque : avis Alpha-Beta
Ce champ ou cette fonctionnalité fait partie de la fonctionnalité actuellement en phase Alpha ou Bêta. Il est donc susceptible d’être modifié.
billing_period_end_date DateHeure Non "2015-05-30 19:19:53" Dernière date de la période de facturation de la commande d’insertion.

Remarque : avis Alpha-Beta
Ce champ ou cette fonctionnalité fait partie de la fonctionnalité actuellement en phase Alpha ou Bêta. Il est donc susceptible d’être modifié.
billing_period_external_code string Non "houseware245" Code personnalisé pour la période de facturation (budget_interval).

Mesures

Column Type Exemple Formule Description
imps int 234123 Lutins Nombre total d’impressions servies.
attributed_revenue Argent 10.45 post_view_revenue + post_click_revenue Montant du chiffre d’affaires de tous les affichages post enregistrés et clics de publication.
attributed_pc_revenue Argent 121.68 post_click_revenue Montant des recettes de toutes les vues post enregistrées.
attributed_pv_revenue Argent 14 post_view_revenue Montant du chiffre d’affaires de tous les clics post enregistrés.
clicks int 545 Clics Nombre total de clics sur toutes les impressions.
click_convs_rate double 0.057 total_convs / clics Taux de conversions en clics.
click_conv_rate double 0.000064 total_convs / clics Taux de conversions en clics.

Remarque : ce champ est identique à click_convs_rate.
click_thru_pct double 0.000% clicks / imps Pourcentage d’utilisateurs affichant une création qui a cliqué dessus.
cpa Argent 1.25 booked_revenue_dollars / (post_view_convs + post_click_convs) Coût par acquisition.
cpc Argent 0.45 booked_revenue_dollars / clics Coût par clic.
cpm Argent 0.18 (booked_revenue_dollars / imps) * 1000 Coût pour 1 000 impressions.
post_view_convs int 75 post_view_convs Nombre total de conversions post-affichage enregistrées.
post_view_revenue Argent 150.00 post_view_revenue Montant total des revenus post-affichage enregistrés.
post_click_convs int 15 post_click_convs Nombre total de conversions post-clic enregistrées.
post_click_revenue Argent 300.00 post_click_revenue Montant total des revenus après clic enregistrés.
total_revenue Argent 450.00 post_view_revenue + post_click_revenue Montant total des revenus de l’affichage des publications et des clics de publication.
total_convs int 90 post_view_convs + post_click_convs Nombre total de conversions d’affichage de publication et de clic de publication.
conv_rate double 0.018654 (post_click_convs + post_view_convs) / imps Taux de conversions de post click et post view en impressions.
convs_rate double 0.0003844 total_convs / imps Taux de conversions en impressions.
convs_per_mm double 221.877080097625 (total_convs / imps) x 1 000 000 Nombre de conversions par million d’impressions.
ecpa_adv_curr Argent 1.13 booked_revenue_adv_curr / (post_view_convs + post_click_convs) Coût par acquisition dans le type de devise de l’annonceur.
ecpc_adv_curr Argent 0.16 booked_revenue_adv_curr / clics Coût par clic dans le type de devise de l’annonceur.
ecpm_adv_curr Argent 0.014 booked_revenue_adv_curr / imps * 1000 Coût pour 1 000 impressions dans le type de devise de l’annonceur.
post_view_convs_rate double 0.000320 post_view_convs / imps Taux de conversions de post-affichage en impressions.
post_click_convs_rate double 0.000064 post_click_convs / imps Taux de conversions de post-clic en impressions.
post_click_conversion_pixel int 52 post_click_convs pour cette pixel_id Nombre de conversions post-clic pour un pixel spécifique. Pour plus d’informations sur la façon dont nous allons attribuer les conversions post-affichage (et d’autres), attribution de conversion (monétiser) ou attribution de conversion (Investir) .
post_click_revenue_pixel Argent 184.25 post_click_revenue pour cette pixel_id Montant des revenus gagnés pour un pixel spécifique.
post_view_conversion_pixel int 174 post_view_convs pour cette pixel_id Nombre de conversions d’affichage post pour un pixel spécifique. Pour plus d’informations sur la façon dont nous allons attribuer des conversions post-affichage (et d’autres), consultez Attribution de conversion (monétiser) ou Attribution de conversion (Invest).
post_view_revenue_pixel Argent 303.54 post_view_revenue pour cette pixel_id Montant des revenus gagnés pour un pixel spécifique.
ppm Argent 0.944966292134831 (profit / imps) x 1000 Le bénéfice par 1 000 impressions.
rpm Argent 2.60548314606741 (revenue / imps) x 1000 Chiffre d’affaires par 1 000 impressions.
spend_adv_curr Argent 357.18 booked_revenue_adv_curr Montant total dépensé par l’annonceur dans la devise préférée de l’annonceur.
total_revenue_pixel Argent 41.253 post_click_revenue + post_view_revenue pour cette pixel_id Chiffre d’affaires total gagné pour un pixel spécifique.
ctr double 0.002327 clicks / imps Taux de clics vers les impressions.
spend Argent 304.36 Passer Les dépenses totales du marketing sur les achats de médias en temps réel et direct.
media_cost Argent 2.15 coût multimédia Montant total dépensé pour acheter toutes les impressions.
ecpm Argent 1.30 (spend / imps) x 1000 L’annonceur effectif dépense par 1000 impressions.
ecpc Argent 1.25 spend / clicks L’annonceur effectif dépense par clic.
ecpa Argent 1.20 spend / total_convs Les dépenses effectives de l’annonceur par conversion/acquisition.
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)
avg_bid_reduction double 18% avg_bid_reduction Réduction moyenne de l’enchère que vous avez obtenue sur l’élément de ligne ou la campagne. Cette valeur représente la différence (sous forme de pourcentage) entre votre offre et le coût média réel que vous avez payé pour l’impression que vous avez gagnée (par exemple, en raison de la réduction de l’offre). Cette valeur n’est valide que pour les enchères RTB (c’est-à-dire, non gérée). Actuellement, cette valeur n’est pas calculée avec précision pour les éléments de ligne pour lesquels le payment_auction_event_type champ a été défini sur 2.
video_skips int 10 video_skips 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 video_starts 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 video_25_pcts Nombre total de fois où les créations vidéo ont terminé 25 % de la durée totale.
video_50_pcts int 10 video_50_pcts 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 video_75_pcts Nombre total de fois où les créations vidéo se sont terminées 75 % de la durée totale.
video_completions int 12 video_completions Nombre total de fois où les créations vidéo ont été lues pendant toute la durée.
video_served int 10 video_served 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 video_errors Nombre total de fois qu’une erreur vidéo s’est produite.
revenue_per_video_complete Argent 25.76 revenue_per_video_complete Chiffre d’affaires par saisie semi-automatique de la vidéo.
cost_per_video_complete Argent 22.76 cost_per_video_complete 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% video_start_rate 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% video_skip_rate Pourcentage de fois où l’utilisateur a choisi d’ignorer la vidéo.

Exemples

Create une demande de rapport au format JSON

$ cat advertiser_analytics 
 
{ 
    "report": { 
        "report_type":"advertiser_analytics", 
        "columns": [ 
            "hour", 
            "seller_member_id", 
            "campaign_id", 
            "gender", 
            "imps", 
            "clicks", 
            "total_convs", 
            "ctr", 
            "convs_rate"
        ], 
        "report_interval": "last_48_hours", 
        "format":"csv" 
    } 
}

POST la demande au service de création de rapports

Vous POST la demande JSON et récupérez un ID de rapport.

$ curl -b cookies -c cookies -X post -d @advertiser_analytics "https://api.appnexus.com/report?advertiser_id=690" 
 
{
    "response": {
        "status": "OK",
        "report_id": "2790c6627d058cd467f4267add49bedc",
        "existing": true,
        "dbg_info": {
            ...
        }
    }
}

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 report-download service 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=dc0314bda06597582518c5fc3e1c47ef" 
 
{
    "response": {
        "status": "OK",
        "report": {
            "name": null,
            "created_on": "2014-04-17 01:26:00",
            "cache_hit": false,
            "fact_cache_hit": false,
            "fact_cache_error": "did not find any cache table for 1,3,6,44,30,31,32,34,15",
            "json_request": "{\"report\":{\"report_type\":\"advertiser_analytics\",\"columns\":[\"hour\",\"seller_member_id\",\"campaign_id\",\"gender\",\"imps\",\"clicks\",\"total_convs\",\"ctr\",\"convs_rate\"],\"report_interval\":\"last_48_hours\",\"format\":\"csv\",\"filters\":[{\"buyer_member_id\":\"948\"},{\"advertiser_id\":\"78216\"},{\"imp_type_id\":{\"operator\":\"!=\",\"value\":6}}]}}",
            "header_info": "Report ID:,2790c6627d058be467f4267add49bedc\r\nRun at:,2014-04-17 01:26:00\r\nStart date:,2014-04-15 01:00:00\r\nEnd date:,\r\nTimezone:,\r\nUser:,Jesse Seldess (9685)\r\n",
            "row_count": "0",
            "report_size": "75",
            "user_id": "9685",
            "entity_id": "0",
            "started_on": "2014-04-17 01:26:03",
            "finished_on": "2014-04-17 01:28:02",
            "query_time": "118",
            "url": "report-download?id=2790c6627d058be467f4267add49bedc"
        },
        "execution_status": "ready",
        "dbg_info": {
            ...
        }
    }
}

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 champ URL 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.

$ curl -b cookies -c cookies 'https://api.appnexus.com/report-download?id=b97897a7864dd8f34e7457226c7af592' > /tmp/advertiser_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.