Google Ads - Campanhas

Permite buscar dados de tráfego, orçamentos e custos das campanhas do Google Ads ativas em sua conta IntegraOn.

Endpoint

GET https://api.integraon.com.br?versao=v1&token={token}&servico=google-ads&recurso=campanha

Parâmetros do Body (JSON)

Campo Tipo Obrigatoriedade Descrição
data_inicial string Obrigatório Data de início (Formato: YYYY-MM-DD).
data_final string Obrigatório Data final (Formato: YYYY-MM-DD). Intervalo máximo permitido: 31 dias.

Estrutura de Retorno (JSON)

O retorno é estruturado de forma hierárquica por data de emissão, identificador de conta Business, contendo a lista de campanhas, grupos de anúncios (AdGroups) e anúncios com os parâmetros de rastreamento (UTMs).

Exemplo de Resposta (Google Ads) 
{
  "2026-06-01": {
    "9998887776": {
      "id": 9998887776,
      "nome": "Minha Conta Google Ads",
      "status": "ativo",
      "campanhas": {
        "1234567890": {
          "id": 1234567890,
          "nome": "Campanha Conversão Junho",
          "orcamento": 100.00,
          "status": "ativo",
          "impressoes": 50000,
          "cliques": 2500,
          "ctr": 5.0,
          "cpc": 0.40,
          "valor_gasto": 1000.00,
          "conversao": 150.00,
          "data_atualizacao": "2026-06-01 23:59:59",
          "gruposAnuncios": {
            "5555555": {
              "id": 5555555,
              "nome": "AdGroup - Interesses",
              "status": "ativo",
              "impressoes": 25000,
              "cliques": 1200,
              "ctr": 4.8,
              "cpc": 0.42,
              "valor_gasto": 504.00,
              "anuncios": {
                "7777777": {
                  "id": 7777777,
                  "nome": "Criativo Imagem 01",
                  "status": "ativo",
                  "impressoes": 12500,
                  "cliques": 600,
                  "ctr": 4.8,
                  "cpc": 0.42,
                  "valor_gasto": 252.00,
                  "link": "https://site.com/url-final",
                  "trackeamento": {
                    "utm_source": "google",
                    "utm_medium": "cpc",
                    "utm_campaign": "campanha_junho"
                  },
                  "data_atualizacao": "2026-06-01 23:59:59"
                }
              }
            }
          }
        }
      }
    }
  }
}
Simulador de Requisição: Google Ads
Comando Curl Gerado 
Aguardando parâmetros...