Mantenha tudo organizado com as coleções
Salve e categorize o conteúdo com base nas suas preferências.
A API AdMob pode gerar os seguintes relatórios:
Relatório de rede
O Relatório de rede fornece dados sobre a performance da AdMob e gera os
mesmos dados encontrados no
Relatório da rede da IU da AdMob.
Relatório de mediação
O relatório de mediação inclui a performance de terceiros. Se você não conhece o Relatório de mediação, consulte o artigo da Central de Ajuda.
Dimensões
Nos relatórios, as dimensões são usadas para fins de agrupamento. Se nenhuma dimensão for especificada, o relatório retornará uma única linha das métricas solicitadas para toda a conta. Cada relatório tem várias dimensões. Consulte o relatório de rede
e as dimensões do relatório de mediação
para mais detalhes.
Tipo do anúncio (por exemplo, "texto" ou "imagem").
Métricas
As métricas representam as diferentes medições que você pode fazer nesses dados. Quando um relatório é solicitado, as métricas são calculadas de acordo com as dimensões escolhidas. Um relatório precisa incluir pelo menos uma métrica. Cada relatório tem várias métricas. Consulte o relatório de rede e as métricas do relatório de mediação para mais detalhes.
A proporção de anúncios que são exibidos em relação aos anúncios retornados, definida como impressões / solicitações correspondentes. O valor é um valor decimal de dupla precisão (aproximado).
Filtros
Os filtros permitem restringir as linhas incluídas no relatório especificando uma dimensão a ser filtrada e a expressão de filtro.
Por exemplo, o filtro abaixo pode ser aplicado a um relatório de mediação para conferir
a performance da Meta Audience Network. Confira a lista completa de origens de anúncios que podem ser visualizadas no Relatório de mediação.
Os relatórios têm um limite de 100.000 linhas. Quando um relatório com mais de 100 mil linhas é solicitado, ele é truncado e as primeiras 100 mil linhas são retornadas. Consulte o corpo da resposta do relatório para mais informações sobre o formato da resposta.
Para garantir o recebimento de todas as linhas, tente reduzir o tamanho do relatório da seguinte forma:
Reduzir o período na solicitação.
Reduzir o número de dimensões porque elas atuam como multiplicadores. Adicionar uma dimensão multiplica o número de linhas. Adicionar uma nova métrica a um relatório produz uma nova coluna.
[null,null,["Última atualização 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."]]
