Restez organisé à l'aide des collections
Enregistrez et classez les contenus selon vos préférences.
L'API AdMob permet de générer les rapports suivants:
Rapport sur le réseau
Le rapport sur le réseau fournit des données sur les performances d'AdMob et génère les mêmes données que dans le rapport sur le réseau de l'UI AdMob.
Rapport sur la médiation
Le rapport sur la médiation inclut les performances des tiers. Si vous ne connaissez pas le rapport sur la médiation, consultez cet article du Centre d'aide.
Dimensions
Dans les rapports, les dimensions sont utilisées à des fins de regroupement et si aucune dimension n'est spécifiée, le rapport renvoie une seule ligne des métriques demandées pour l'ensemble du compte. Chaque rapport comporte différentes dimensions. Pour en savoir plus, consultez Rapport sur le réseau et Dimensions du rapport sur la médiation.
Type de l'annonce (par exemple, "texte" ou "image").
Métriques
Les métriques représentent les différentes mesures que vous pouvez effectuer à partir de ces données. Lorsqu'un rapport est demandé, les métriques sont calculées en fonction des dimensions choisies. Un rapport doit inclure au moins une métrique. Chaque rapport comporte différentes métriques. Pour en savoir plus, consultez les sections concernant le rapport sur le réseau et les métriques du rapport sur la médiation.
Ratio entre le nombre d'annonces affichées et les annonces renvoyées. Il correspond au nombre d'impressions divisé par le nombre de demandes avec correspondance. La valeur est une valeur décimale à double précision (approximative).
Filtres
Les filtres vous permettent de limiter les lignes incluses dans le rapport en spécifiant une dimension à filtrer et l'expression de filtre.
Par exemple, le filtre ci-dessous peut être appliqué à un rapport sur la médiation pour afficher les performances de Meta Audience Network. Consultez la liste complète des sources d'annonces disponible dans le rapport sur la médiation.
Les rapports peuvent contenir au maximum 100 000 lignes. Lorsqu'un rapport de plus de 100 000 lignes est demandé, il est tronqué et les 100 000 premières lignes sont renvoyées. Pour en savoir plus sur le format de la réponse, consultez le corps de la réponse du rapport.
Pour vous assurer de recevoir toutes les lignes, essayez de réduire la taille du rapport en:
Réduire la plage de dates de la requête
Le nombre de dimensions est réduit, car elles agissent comme un multiplicateur. L'ajout d'une dimension multiplie le nombre de lignes, tandis que l'ajout d'une métrique à un rapport génère une nouvelle colonne.
Sauf indication contraire, le contenu de cette page est régi par une licence Creative Commons Attribution 4.0, et les échantillons de code sont régis par une licence Apache 2.0. Pour en savoir plus, consultez les Règles du site Google Developers. Java est une marque déposée d'Oracle et/ou de ses sociétés affiliées.
Dernière mise à jour le 2025/08/31 (UTC).
[null,null,["Dernière mise à jour le 2025/08/31 (UTC)."],[[["\u003cp\u003eThe AdMob API offers Network and Mediation reports to provide insights into ad performance and third-party network data.\u003c/p\u003e\n"],["\u003cp\u003eReports utilize dimensions for grouping data and metrics for measuring performance, with customizable options for filtering and reducing report size.\u003c/p\u003e\n"],["\u003cp\u003eNew user roles and permissions will impact the data returned by the AdMob API, requiring users to review updated documentation.\u003c/p\u003e\n"],["\u003cp\u003eReports are limited to 100,000 rows, and users can adjust date ranges and dimensions to retrieve complete data.\u003c/p\u003e\n"]]],["The AdMob API generates network and mediation reports. Reports utilize dimensions for grouping data; without them, a single row with metrics is returned. Metrics are measurements calculated based on chosen dimensions; at least one is required per report. Filters, like `AD_SOURCE`, restrict rows based on a dimension. Reports are limited to 100,000 rows. To manage this limit you can reduce the number of dimensions, or shorten the date range. Note that new user roles will impact data returned by the API.\n"],null,["# Reporting\n\n| **Important:** New user roles and permissions will affect data returned by the AdMob API. [Learn more](//support.google.com/admob/answer/2784628)\n\nThe AdMob API has the ability to generate the following reports:\n\nNetwork report\n: The network report provides data on AdMob's performance and generates the\n same data found in the\n [AdMob UI network report](//support.google.com/admob/answer/9005740).\n\nMediation report\n: The mediation report includes third-party performance. If you are unfamiliar\n with the mediation report, take a look at the\n [Help Center article](//support.google.com/admob/answer/9005741).\n\nDimensions\n----------\n\n| **Note:** Some dimensions and metrics are incompatible and will cause a conflict to arise in a single report. For additional information, see the [report reference documentation](/admob/api/v1/reference/rest/v1/accounts.networkReport/generate#dimension).\n\nIn reports, dimensions are used for grouping purposes, and if no dimensions are\nspecified, the report returns a single row of the requested metrics for the\nentire account. Each report has various dimensions, see [network report](/admob/api/v1/reference/rest/v1/accounts.networkReport/generate#dimension)\nand [mediation report dimensions](/admob/api/v1/reference/rest/v1/accounts.mediationReport/generate#dimension)\nfor more details.\n\nExamples:\n\n| Report type | Dimension | Description |\n|------------------|------------------------------------------------------------------------------------------|---------------------------------------------------------------------------------------------------------|\n| Mediation report | [AD_SOURCE](/admob/api/v1/reference/rest/v1/accounts.mediationReport/generate#dimension) | The unique ID of the ad source (for example, \"5450213213286189855\" and \"AdMob Network\" as label value). |\n| Network report | [AD_TYPE](/admob/api/v1/reference/rest/v1/accounts.networkReport/generate#dimension) | Type of the ad (for example, \"text\" or \"image\"). |\n\nMetrics\n-------\n\nMetrics represent the different measurements you can make on that data. When a\nreport is requested, the metrics are calculated according to the chosen\ndimensions. A report must include at least one metric. Each report has various\nmetrics, see [network report](/admob/api/v1/reference/rest/v1/accounts.networkReport/generate#metric)\nand [mediation report metrics](/admob/api/v1/reference/rest/v1/accounts.mediationReport/generate#metric)\nfor more details.\n\nExamples:\n\n| Report type | Metric | Description |\n|------------------|----------------------------------------------------------------------------------------------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| Mediation report | [OBSERVED_ECPM](/admob/api/v1/reference/rest/v1/accounts.mediationReport/generate#dimension) | The third-party ad network's estimated average eCPM. |\n| Network report | [SHOW_RATE](/admob/api/v1/reference/rest/v1/accounts.networkReport/generate#metric) | The ratio of ads that are displayed over ads that are returned, defined as impressions / matched requests. The value is a double precision (approximate) decimal value. |\n\nFilters\n-------\n\nFilters allow you to restrict the rows that get included in the report by\nspecifying a [dimension to filter](/admob/api/v1/reference/rest/v1/accounts.mediationReport/generate#dimensionfilter) on and the filter expression.\n\nFor example, the filter below can be applied to a mediation report to view\nMeta Audience Network's performance. Take a look at the complete [list of ad sources](/admob/api/v1/ad-sources-reference)\nthat can be viewed in the mediation report.\n\n| Dimension Filter | Filter Expression | Description |\n|------------------|-------------------------------------|-------------------------------------------------------------------------------|\n| AD_SOURCE | matchesAny = {10568273599589928883} | Filters report rows based on [ad source](/admob/api/v1/ad-sources-reference). |\n\nReduce report limits\n--------------------\n\nReports have a limit of 100,000 rows. When a report with over 100,000 rows is\nrequested, the report will be truncated and the first 100,000 rows will be\nreturned. See the [report response body](/admob/api/v1/reference/rest/v1/accounts.networkReport/generate#response-body)\nfor additional information on the response format.\n\nTo ensure you are receiving all rows, try reducing the size of the report by:\n\n- Reducing the date range in the request.\n- Reducing the number of dimensions as they act as a multiplier. Adding a dimension multiplies the number of rows, whereas adding a new metric to a report produces a new column."]]
