Visão Geral

A API do Google Analytics da V4MOS.AI centraliza dados de sessões, eventos, eventos personalizados, clientes, produtos e transações das propriedades GA4 conectadas ao seu organization. Todos os endpoints ficam sob o prefixo /v1/google-analytics e seguem os mesmos padrões de autenticação, paginação e resposta da plataforma.

Endpoints DisponíveisCopiar link da seção

• getSessões/v1/google-analytics/sessionsRetorna sessões do Google Analytics com métricas de campanha, página e origem de tráfego.
• getEventos/v1/google-analytics/eventsRetorna eventos do Google Analytics com métricas de engajamento.
• getEventos personalizados/v1/google-analytics/custom-eventsRetorna eventos personalizados do Google Analytics com mapeamentos de métricas.
• getClientes/v1/google-analytics/customersRetorna métricas de clientes do Google Analytics com segmentação geográfica e por dispositivo.
• getProdutos/v1/google-analytics/productsRetorna métricas de produtos de e-commerce do Google Analytics.
• getTransações/v1/google-analytics/transactionsRetorna métricas de transações do Google Analytics.

AutenticaçãoCopiar link da seção

Todos os endpoints exigem os headers x-client-id e x-client-secret, além do query parameter organizationId. Veja Autenticação.

Parâmetros ComunsCopiar link da seção

• organizationId (obrigatório) – Organização que possui a integração do Google Analytics
• userId – Escopo de usuário
• page – Número da página (padrão: 1)
• limit – Registros por página (padrão: 500, máx: 5000)
• createdStart / createdEnd – Filtro por intervalo de datas (ISO 8601)

Filtros Específicos por RecursoCopiar link da seção

Sessões (/v1/google-analytics/sessions)Copiar link da seção

• createdStart / createdEnd

Eventos (/v1/google-analytics/events)Copiar link da seção

• createdStart / createdEnd

Eventos Personalizados (/v1/google-analytics/custom-events)Copiar link da seção

• createdStart / createdEnd

Clientes (/v1/google-analytics/customers)Copiar link da seção

• createdStart / createdEnd

Produtos (/v1/google-analytics/products)Copiar link da seção

• createdStart / createdEnd

Transações (/v1/google-analytics/transactions)Copiar link da seção

• createdStart / createdEnd

Destaques do Modelo de Dados do Google AnalyticsCopiar link da seção

SessõesCopiar link da seção

• Campanhas e tráfego: campaign_id, campaign_name, source_medium, session_source_medium
• Páginas: page_title, page_path
• Usuários e sessões: sessions, total_users, new_users, engaged_sessions, sessions_per_user
• Data: date

EventosCopiar link da seção

• Identificação: event_name, date
• Métricas: event_count, event_count_per_user, event_value, events_per_session, key_events

Eventos PersonalizadosCopiar link da seção

• Identificação: event_name, event_date
• Métricas: metric_name, metric_value
• Mapeamento RD Station: custom_rd_action, custom_rd_asset_id, custom_rd_filter
• Categoria: custom_event_category, custom_event_label

ClientesCopiar link da seção

• Campanhas e segmentação: campaign_id, campaign_name, device_category, source_medium
• Geografia: city, region, country
• Audiência: active_users, total_users, sessions, engaged_sessions, bounce_rate
• Receita: purchase_revenue, total_revenue, total_purchases, purchaser_rate
• Data: date

ProdutosCopiar link da seção

• Identificação: item_id, item_name
• Receita e compras: item_revenue, items_purchased
• Interações: items_viewed, items_added_to_cart, items_checked_out, items_clicked_in_promotion, item_list_click_through_rate
• Data: date

TransaçõesCopiar link da seção

• Identificação: event_name, date
• Métricas: transactions, transactions_per_purchaser

RespostasCopiar link da seção

Todas as respostas seguem o padrão:

{
  "data": [...],
  "meta": {
    "page": 1,
    "limit": 500,
    "hasNextPage": true,
    "hasPreviousPage": false
  }
}