V4MOS.AI API
GuiasReferência da APIapp.v4mos.ai
Google Ads

Conversões

GET
/v1/google/ads/conversions

Retorna dados de conversões do Google Ads com métricas de desempenho detalhadas.

Este endpoint fornece insights em nível de conversão, incluindo detalhes das ações de conversão, categorias e indicadores de desempenho segmentados por tipo de conversão.

Dimensões disponíveis:

  • Nome/ID/categoria da ação de conversão
  • Indicador de ajuste de conversão
  • Conversões, valor das conversões, todas as conversões, valor de todas as conversões
  • ID/nome/status/tipo do grupo de anúncios
  • ID/nome/grupo da campanha, tipo de estratégia de lances, ID do anúncio
  • Data

Limitações:

  • Máximo de 5000 registros por página
  • Suporta filtro por data via createdStart e createdEnd (formato YYYY-MM-DD)
  • Suporta ordenação via orderBy e orderDirection (ASC/DESC)

Filtros:

  • organizationId (obrigatório)
  • userId (opcional)
  • integrationName (opcional)
  • createdStart (opcional)
  • createdEnd (opcional)

Autorização

ClientIdAuthClientSecretAuth
headerx-client-id<token>

Client ID

headerx-client-secret<token>

Client secret

Parâmetros de query

organizationId*string

Identificador da organização (obrigatório)

userId?string

Identificador do usuário (opcional)

integrationName?string

Identificador do nome da integração (opcional)

createdStart?string

Data inicial para filtragem (opcional, formato YYYY-MM-DD)

Formatodate
createdEnd?string

Data final para filtragem (opcional, formato YYYY-MM-DD)

Formatodate
page?integer

Número da página para paginação (opcional)

Padrão1
limit?integer

Número de itens por página (opcional, máx. 5000)

Intervalovalue <= 5000
Padrão500
orderBy?string

Campo de ordenação (opcional)

orderDirection?string

Direção da ordenação (opcional)

Valor em"ASC""DESC"

Corpo da resposta

Resposta de sucesso

application/json
  1. response
data?array<>
meta?
curl -X GET "https://example.com/v1/google/ads/conversions?organizationId=organization_123&createdStart=2024-01-01&createdEnd=2024-12-31"
{  "data": [    {      "date": "2019-08-24",      "conversion_action_name": "string",      "conversion_action_id": "string",      "conversion_action_category": "string",      "conversion_adjustment": true,      "all_conversions": 0,      "all_conversions_value": 0,      "conversions": 0,      "conversions_value": 0,      "ad_group_type": "string",      "ad_group_status": "string",      "ad_group_name": "string",      "ad_group_id": "string",      "ad_id": "string",      "ad_group_campaign": "string",      "campaign_bidding_strategy_type": "string",      "campaign_id": "string",      "campaign_name": "string",      "campaign_group": "string",      "organization_id": "string",      "user_id": "string",      "document_id": "string",      "integration_name": "string",      "inserted_at": "2019-08-24T14:15:22Z"    }  ],  "meta": {    "page": 0,    "limit": 0,    "hasNextPage": true,    "hasPreviousPage": true  }}

Palavras-chave GET

Página anterior

Faixa etária GET

Próxima página