Google Ads
Faixa etária
GET
Retorna dados de segmentação por faixa etária do Google Ads com métricas de desempenho.
Este endpoint fornece insights demográficos segmentados por faixa etária, incluindo associações com campanha e grupo de anúncios.
Dimensões disponíveis:
- ID/nome da campanha
- ID/nome do grupo de anúncios, faixa etária, status, tipo de estratégia de lances
- Métricas: impressões, cliques, custo, conversões, valor das conversões, todas as conversões, valor de todas as conversões
- 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/age-range?organizationId=organization_123&createdStart=2024-01-01&createdEnd=2024-12-31"{ "data": [ { "campaign_id": "string", "campaign_name": "string", "date": "2019-08-24", "impressions": 0, "clicks": 0, "cost": 0, "conversions": 0, "conversions_value": 0, "all_conversions": 0, "all_conversions_value": 0, "status": "string", "ad_group_id": "string", "ad_group_name": "string", "age_range": "string", "bidding_strategy_type": "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 }}