Pular para o conteúdo principal
GET
Obtenha o desempenho do Google Ads em tempo real, uma linha por dia, para as campanhas, grupos de anúncios ou anúncios que você criou pela Ayrshare.
  • Os números são lidos do Google no momento da chamada, não de uma cópia noturna.
  • Todos os valores monetários estão na moeda da conta de anúncios, retornada em currency em cada linha.
  • O Google omite os dias sem atividade, então um intervalo pode retornar menos linhas do que o número de dias.
  • O Google ajusta o custo e as conversões de um dia durante alguns dias após o fim dele, então os dias recentes podem mudar entre leituras.
  • Para uma campanha Performance Max, use level=campaign com o ID da campanha. Uma campanha Performance Max não tem anúncios próprios, então level=ad não retorna linhas.

Parâmetros de cabeçalho

Parâmetros de consulta

string
obrigatório
Sobre o que cada linha informa: campaign (o campaignId da criação), adSet (o adGroupId da criação) ou ad (o adId da criação).
string
obrigatório
IDs de campanha, de grupo de anúncios ou de anúncio separados por vírgula, até 50. Todos devem estar em uma mesma conta de anúncios.
string
O ID de cliente do Google Ads com 10 dígitos, com ou sem hífens (123-456-7890).Os relatórios de anúncios e de grupos de anúncios leem a conta de anúncios que você informa aqui. Sem ele, um relatório de anúncios pesquisa todas as contas de anúncios que o seu vínculo do Google Ads alcança, até 25, e um relatório de grupos de anúncios só funciona quando o seu vínculo alcança uma única conta de anúncios. Informe a conta quando o seu vínculo alcançar mais de 25 contas de anúncios, ou mais de uma em um relatório de grupos de anúncios. Caso contrário, a solicitação retorna code: 101.
string
Métricas a serem retornadas, separadas por vírgula. Omita para obter todas. Veja Métricas.
string
padrão:"30 dias atrás"
Primeiro dia, no formato YYYY-MM-DD. O Google mantém os números diários por 37 meses; um startDate mais antigo retorna code: 101.
string
padrão:"hoje"
Último dia, no formato YYYY-MM-DD.

Métricas

actions e conversionValue permanecem em 0 até que o acompanhamento de conversões seja configurado na sua conta do Google Ads. reach não está disponível, porque o Google não informa alcance único para a Pesquisa, e breakdowns não estão disponíveis no Google. Solicitar qualquer um deles retorna code: 101.

Paginação

Todas as linhas são retornadas em uma única resposta, então nextCursor é sempre null.

Erros