Google Ads
Conversões por campanha
GET
Retorna dados de campanhas do Google Ads segmentados por conversão, com métricas de conversão detalhadas.
Este endpoint fornece insights de conversão em nível de campanha, segmentados por categoria de ação de conversão.
Dimensões disponíveis:
- Nome do recurso/ID/nome da campanha
- Métricas: conversões, valor das conversões
- Segmentos: categoria da ação de conversão, data
Limitações:
- Máximo de 5000 registros por página
- Suporta filtro por data via
createdStartecreatedEnd(formato YYYY-MM-DD) - Suporta ordenação via
orderByeorderDirection(ASC/DESC)
Filtros:
organizationId(obrigatório)userId(opcional)integrationName(opcional)createdStart(opcional)createdEnd(opcional)
ClientIdAuthClientSecretAuthheader
x-client-id<token>Client ID
header
x-client-secret<token>Client secret
organizationId*stringIdentificador da organização (obrigatório)
userId?stringIdentificador do usuário (opcional)
integrationName?stringIdentificador do nome da integração (opcional)
createdStart?stringData inicial para filtragem (opcional, formato YYYY-MM-DD)
Formato
datecreatedEnd?stringData final para filtragem (opcional, formato YYYY-MM-DD)
Formato
datepage?integerNúmero da página para paginação (opcional)
Padrão
1limit?integerNúmero de itens por página (opcional, máx. 5000)
Intervalo
value <= 5000Padrão
500orderBy?stringCampo de ordenação (opcional)
orderDirection?stringDireção da ordenação (opcional)
Valor em
"ASC""DESC"Resposta de sucesso
application/json- response
data?array<>meta?curl -X GET "https://example.com/v1/google/ads/conversion-segmented-campaigns?organizationId=organization_123&createdStart=2024-01-01&createdEnd=2024-12-31"{ "data": [ { "campaign_resource_name": "string", "campaign_name": "string", "campaign_id": "string", "metrics_conversions_value": 0, "metrics_conversions": 0, "segments_conversion_action_category": "string", "segments_date": "2019-08-24", "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 }}