Overview

A API do Google Analytics da V4 Marketing centraliza dados de sessões, eventos, eventos personalizados, clientes, produtos e transações das propriedades GA4 conectadas ao seu workspace. 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íveis

Sessões

GET /v1/google-analytics/sessions – Sessões com campanhas, páginas e origem de tráfego

Eventos

GET /v1/google-analytics/events – Eventos padrão com contagens, valores e métricas de engajamento

Eventos Personalizados

GET /v1/google-analytics/custom-events – Métricas de eventos customizados com mapeamentos do RD Station

Clientes

GET /v1/google-analytics/customers – Métricas de audiência com segmentação geográfica e por dispositivo

Produtos

GET /v1/google-analytics/products – Métricas de performance de produtos no e-commerce

Transações

GET /v1/google-analytics/transactions – Métricas de transações de compra por evento

Autenticação

Inclua as credenciais em todas as requisições através dos cabeçalhos HTTP obrigatórios:

Parâmetros Comuns

workspaceId (obrigatório) – Workspace que possui a integração do Google Analytics

organizationId – Escopo de organização

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 Recurso

Sessões (`/v1/google-analytics/sessions`)

createdStart / createdEnd

Eventos (`/v1/google-analytics/events`)

createdStart / createdEnd

Eventos Personalizados (`/v1/google-analytics/custom-events`)

createdStart / createdEnd

Clientes (`/v1/google-analytics/customers`)

createdStart / createdEnd

Produtos (`/v1/google-analytics/products`)

createdStart / createdEnd

Transações (`/v1/google-analytics/transactions`)

createdStart / createdEnd

Destaques do Modelo de Dados do Google Analytics

Sessões

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

Eventos

Identificação: event_name, date

Métricas: event_count, event_count_per_user, event_value, events_per_session, key_events

Eventos Personalizados

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

Clientes

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

Produtos

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ções

Identificação: event_name, date

Métricas: transactions, transactions_per_purchaser

Respostas

Todas as respostas seguem o padrão:

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

Endpoints Disponíveis#

Sessões#

Eventos#

Eventos Personalizados#

Clientes#

Produtos#

Transações#

Autenticação#

Parâmetros Comuns#

Filtros Específicos por Recurso#

Sessões (/v1/google-analytics/sessions)#

Eventos (/v1/google-analytics/events)#

Eventos Personalizados (/v1/google-analytics/custom-events)#

Clientes (/v1/google-analytics/customers)#

Produtos (/v1/google-analytics/products)#

Transações (/v1/google-analytics/transactions)#

Destaques do Modelo de Dados do Google Analytics#

Sessões#

Eventos#

Eventos Personalizados#

Clientes#

Produtos#

Transações#

Respostas#

Endpoints Disponíveis

Sessões

Eventos

Eventos Personalizados

Clientes

Produtos

Transações

Autenticação

Parâmetros Comuns

Filtros Específicos por Recurso

Sessões (`/v1/google-analytics/sessions`)

Eventos (`/v1/google-analytics/events`)

Eventos Personalizados (`/v1/google-analytics/custom-events`)

Clientes (`/v1/google-analytics/customers`)

Produtos (`/v1/google-analytics/products`)

Transações (`/v1/google-analytics/transactions`)

Destaques do Modelo de Dados do Google Analytics

Sessões

Eventos

Eventos Personalizados

Clientes

Produtos

Transações

Respostas