Google Ads
Geográfico
GET
Retorna dados de segmentação geográfica do Google Ads com métricas de desempenho.
Este endpoint fornece insights baseados em localização, segmentados por regiões geográficas, incluindo dados em nível de estado e cidade.
Dimensões disponíveis:
- ID/nome da campanha
- ID/nome do grupo de anúncios, estado/cidade da segmentação geográfica, 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/geographic?organizationId=organization_123&createdStart=2024-01-01&createdEnd=2024-12-31"{ "data": [ { "campaign_id": "string", "geo_target_state": "string", "geo_target_city": "string", "campaign_name": "string", "date": "2019-08-24", "impressions": 0, "cost": 0, "clicks": 0, "conversions": 0, "conversions_value": 0, "all_conversions": 0, "all_conversions_value": 0, "status": "string", "ad_group_id": "string", "ad_group_name": "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 }}