Method: accounts.campaignReport.generate

Gera um Relatório de Campanha com base nas especificações fornecidas.

Solicitação HTTP

POST https://admob.googleapis.com/v1beta/{parent=accounts/*}/campaignReport:generate

O URL usa a sintaxe de transcodificação gRPC.

Parâmetros de caminho

Parâmetros
parent

string

Nome do recurso da conta para a qual gerar o relatório. Exemplo: accounts/pub-9876543210987654

Corpo da solicitação

O corpo da solicitação contém dados com a seguinte estrutura:

Representação JSON 
{
  "reportSpec": {
    object (CampaignReportSpec)
  }
}
Campos
reportSpec

object (CampaignReportSpec)

Especificação do relatório da campanha.

Corpo da resposta

Resposta da API Campaign Report.

Se bem-sucedido, o corpo da resposta incluirá dados com a estrutura a seguir:

Representação JSON 
{
  "rows": [
    {
      object (ReportRow)
    }
  ]
}
Campos
rows[]

object (ReportRow)

Os dados do relatório da campanha do editor especificado. No máximo 100.000 linhas serão retornadas da API.

Escopos de autorização

Requer um dos seguintes escopos do OAuth:

  • https://www.googleapis.com/auth/admob.readonly
  • https://www.googleapis.com/auth/admob.report

Para mais informações, consulte a Visão geral do OAuth 2.0.

CampaignReportSpec

A especificação para gerar um relatório de campanha. Por exemplo, a especificação para obter IMPRESSIONS e CLICKS separados por CAMPAIGN_ID pode ser semelhante ao seguinte exemplo:

{
  "dateRange": {
    "startDate": {"year": 2021, "month": 12, "day": 1},
    "endDate": {"year": 2021, "month": 12, "day": 30}
  },
  "dimensions": ["CAMPAIGN_ID"],
  "metrics": ["IMPRESSIONS", "CLICKS"],
}
Representação JSON 
{
  "dateRange": {
    object (DateRange)
  },
  "dimensions": [
    enum (Dimension)
  ],
  "metrics": [
    enum (Metric)
  ],
  "languageCode": string
}
Campos
dateRange

object (DateRange)

O período para o qual o relatório é gerado. O intervalo máximo é de 30 dias.
dimensions[]

enum (Dimension)

Lista de dimensões do relatório. A combinação de valores dessas dimensões determina a linha do relatório. Se nenhuma dimensão for especificada, o relatório mostrará uma única linha de métricas solicitadas para toda a conta.
metrics[]

enum (Metric)

Lista de métricas do relatório. Um relatório precisa especificar pelo menos uma métrica.
languageCode

string

É o idioma usado para qualquer texto localizado, como determinados valores de dimensão aplicáveis. A tag de idioma é definida no IETF BCP47. O padrão é "pt-BR" se não for especificado ou for inválido.

Dimensão

As dimensões do relatório da campanha.

Enums
DIMENSION_UNSPECIFIED Valor padrão de uma dimensão não especificada. Não use.
DATE Uma data no formato AAAAMMDD (por exemplo, "20210701").
CAMPAIGN_ID O ID exclusivo da campanha, por exemplo, "123456789", que é consistente com o ID da campanha da API da lista de campanhas.
CAMPAIGN_NAME O nome da campanha.
AD_ID O ID exclusivo do anúncio, por exemplo, "123456789".
AD_NAME O nome do anúncio, que pode não ser exclusivo.
PLACEMENT_ID O ID exclusivo específico do fornecedor do app em que o anúncio é veiculado. Por exemplo, com.goog.bar para Android e 123456789 para apps iOS.
PLACEMENT_NAME O nome do app em que o anúncio é veiculado.
PLACEMENT_PLATFORM A plataforma do app em que o anúncio é veiculado.
COUNTRY O nome do país segmentado.
FORMAT Formato do bloco de anúncios (por exemplo, "banner", "nativo"), uma dimensão de exibição de anúncios.

Métrica

As métricas do relatório da campanha.

Enums
METRIC_UNSPECIFIED Valor padrão de um campo não definido. Não use.
IMPRESSIONS É o número de vezes que um anúncio é exibido ao usuário.
CLICKS O número de vezes que um usuário clica em um anúncio.
CLICK_THROUGH_RATE O número de cliques que um anúncio recebe dividido pelo número de vezes que ele é exibido.
INSTALLS Quantas vezes o download de apps foi feito nos dispositivos.
ESTIMATED_COST O custo estimado de veicular um anúncio de campanha em vez de um anúncio que gera receita. A moeda é a moeda dos relatórios das campanhas.
AVERAGE_CPI É o custo médio por instalação. Isso significa o valor médio gasto para conquistar um novo usuário. A moeda é a moeda dos relatórios das campanhas.
INTERACTIONS É o número de vezes que um usuário interage com um anúncio. Isso consiste em cliques e engajamentos.