Partager via

API de plateforme numérique - Rapport sur les performances des segments d’acheteur

Ce rapport fournit aux acheteurs les performances des segments entre les campagnes et plusieurs annonceurs.

Le time_granularity des données est hourly. Pour obtenir des instructions sur la récupération d’un rapport, consultez service de rapports ou les exemples.

Remarque

Impressions sur les segments d’utilisateurs : Étant donné que ce rapport agrège les impressions servies par segment d’utilisateurs, les impressions associées aux utilisateurs présents dans plusieurs segments sont comptées plusieurs fois. Par conséquent, veillez à regrouper par segment_id lors de l’exécution du rapport.

Période

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

  • aujourd’hui
  • yesterday
  • last_7_days
  • last_14_days
  • last_30_days

Période de conservation des données

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

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? Exemples Description
month Temps Non "2010-02" Le mois de la vente aux enchères.
day date oui "2010-02-01" Le jour de la vente aux enchères.
hour Temps Non "2010-02-01 06:00:00" L’heure de la vente aux enchères.
insertion_order_id int oui 321 ID de l’ordre d’insertion. Si la valeur est 0, l’impression a été achetée par un acheteur tiers.
campaign_id int oui 222 ID de la campagne qui a acheté l’impression.
campaign_name string Non "Fall Wares" Nom de la campagne qui a acheté l’impression.
campaign string Non "Fall Wares (222)" Déconseillé.
advertiser_id int oui 789 ID de l’annonceur. Si la valeur est 0, soit l’impression a été achetée par un acheteur tiers, soit une valeur par défaut ou une valeur psa a été affichée.
line_item_id int oui 111 ID de l’élément de ligne. Si la valeur est 0, l’impression a été achetée par un acheteur tiers.
advertiser_name chaîne Non "Amco" Nom de l’annonceur.
advertiser string Non "Amco (789)" Déconseillé.
line_item_name string Non "Kitchen" Nom de l’élément de ligne.
line_item string Non "Kitchen (111)" 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.
campaign_code string Non "Mobile Campaign Code" Code personnalisé pour la campagne.
segment_id int oui 220 ID du pixel de segment.
segment_name string Non "Submitted application" Nom du segment.
segment string Non "Submitted application (220)" Déconseillé.
insertion_order_name string Non "Mobile Insertion Order" Nom de l’ordre d’insertion.
insertion_order chaîne Non "Mobile Insertion Order (321)" Déconseillé.
segment_code chaîne Non "Mobile Insertion Order Code" Code personnalisé (facultatif) associé au segment utilisateur présent pour cette impression.
pixel_id int oui 1942 Numéro d’identification unique du pixel de conversion.

Note: 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.
gender chaîne Oui "m", "f", "u" Sexe de l’utilisateur.

Note: Pour les impressions antérieures à 100 jours, le sexe sera "u".
age_bucket chaîne Oui "18-24, "45-54" Compartiment d’âge dans lequel l’utilisateur est contenu. Pour plus d’informations, consultez Compartiment d’âge ci-dessous.
age_bucket_id int oui 1, 3, 0 ID du compartiment d’âge. Pour plus d’informations, consultez Compartiment d’âge ci-dessous.

Compartiment 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+"

Mesures

Column Type Exemple Formule Description
imps int 34534 Lutins Nombre total d’impressions (y compris les valeurs par défaut).
clicks int 345 Clics Nombre total de clics sur toutes les impressions.
total_convs int 5 total_convs Nombre total de conversions post-affichage et post-clic.
convs_rate double 0.000221877080097626 total_convs / imps Taux de conversions en impressions.
ctr double 0.002327 clicks / imps Taux de clics vers les impressions.
booked_revenue Argent 450.00 post_view_revenue + post_click_revenue Chiffre d’affaires total réservé par l’intermédiaire d’annonceurs directs.
booked_revenue_buying_currency Argent 145.00 (post_view_revenue + post_click_revenue) dans la devise d’achat Chiffre d’affaires total réservé par les annonceurs directs exprimé en devise d’achat.
post_view_convs int 15 post_view_convs Nombre de conversions post-affichage.
post_view_revenue Argent 150.00 post_view_revenue Revenus des annonceurs provenant des conversions post-affichage.
post_click_convs int 10 post_click_convs Nombre de conversions post-clic qui se sont produites.
post_click_revenue Argent 300.00 post_click_revenue Chiffre d’affaires des annonceurs provenant des conversions post-clic.
post_view_convs_rate double 0.00013 post_view_convs / imps Taux de conversions post-affichage en impressions.
post_click_convs_rate double 0.0002 post_click_convs / imps Taux de conversions post-clic en impressions.
spend Argent 304.36 Passer Les dépenses totales du marketing dans les médias direct et en temps réel achètent pour ce segment.
media_cost Argent 100.00 media_cost Coût total de l’inventaire acheté.
cpm Argent 5.00 media_cost / imps * 1000 Coût par millier d’impressions.
revenue_ecpm Argent 1.9221 (booked_revenue / impressions) x 1000 Chiffre d’affaires total par 1 000 impressions.
profit Argent 4.14 booked_revenue - total_cost Chiffre d’affaires réservé moins le coût total.
profit_ecpm Argent 0.4949 (booked_revenue - total_cost)/imps * 1 000 Le bénéfice (défini comme le chiffre d’affaires réservé moins le coût total) pour 1 000 impressions.
revenue_ecpc Argent 0.8256 booked_revenue / clics Chiffre d’affaires total par clic.
revenue_ecpa Argent 5.00 booked_revenue / total_convs Chiffre d’affaires total par conversion.
cost_ecpc Argent 0.1834 media_cost / clics Coût par clic.
cost_ecpa Argent 1.1111 media_cost / total_convs Coût par acquisition/conversion.
commissions Argent 0 Commissions pour les articles standard, 0 $ pour les ALI. Frais qui proviennent du chiffre d’affaires réservé.
serving_fees Argent 0.025143 Frais de service pour les articles standard, 0 $ pour les ALI. Frais qui sont ajoutés au coût du média.
convs_per_mm double 384.4 (total_convs / imps) * 1 000 000 Nombre de conversions par million d’impressions.
partner_fees Argent 123.45 partner_fees Montant total des coûts tiers, budgétés à l’aide du service Des frais de partenaire, qui se sont accumulés sur un élément de ligne augmenté au cours de la période indiquée.
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.

Note: Nous avons ajouté une logique pour empêcher le double comptage des frais de tiers pendant la période de changement cassant (6 août- Après 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.
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 la demande de rapport JSON

Le fichier JSON doit inclure le report_type de "buyer_segment_performance", 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, excelou html). Pour obtenir une explication complète des champs qui peuvent être inclus dans le fichier JSON, consultez service de rapports.

$ cat buyer_segment_performance

{"report": 
    {
        "format": "csv",
        "report_interval": "yesterday",
        "row_per": ["campaign_id"],
        "columns": ["campaign_id", "segment_id", "advertiser_id", "advertiser_name","line_item_id"],
        "report_type": "buyer_segment_performance"
    }
}

POST la demande adressée au service de rapports

POST demande JSON pour récupérer un ID de rapport.

$ curl -b cookies -c cookies -X POST -d @buyer_segment_performance "https://api.appnexus.com/report"

{
   "response":{
      "status":"OK",
      "report_id":"71816ec6d09b32a5140730afe5cf6af5"
   }
}

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=71816ec6d09b32a5140730afe5cf6af5'

{
    "response": {
        "status": "OK",
        "report": {
            "name": null,
            "created_on": "2014-11-19 21:15:10",
            "json_request": "{\"report\":{\"format\":\"csv\",\"report_interval\":\"yesterday\",\"row_per\":[\"campaign_id\"],\"columns\":[\"campaign_id\",\"segment_id\",\"advertiser_id\",\"advertiser_name\",\"line_item_id\"],\"report_type\":\"buyer_segment_performance\",\"filters\":[{\"member_id\":\"1234\"}]}}",
            "url": "report-download?id=71816ec6d09b32a5140730afe5cf6af5"
        },
        "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 l’ID de service et de rapport dans le url champ de la réponse à votre appel précédent GET . Lorsque vous identifiez le fichier dans lequel vous souhaitez enregistrer, veillez à utiliser l’extension de fichier du format de fichier que vous avez spécifié dans votre fichier initial POST.

Remarque

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=71816ec6d09b32a5140730afe5cf6af5' > /tmp/buyer_segment_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.

Service de rapports

  • Last updated on