Google Ads
Palavras-chave
GET
Retorna dados de palavras-chave do Google Ads com métricas de desempenho detalhadas.
Este endpoint fornece insights em nível de palavra-chave, incluindo tipo de correspondência, associações com grupo de anúncios e campanha e indicadores de desempenho.
Dimensões disponíveis:
- Texto da palavra-chave, tipo de correspondência, critério do grupo de anúncios
- ID/nome/status/tipo do grupo de anúncios
- ID/nome/grupo da campanha, tipo de estratégia de lances, ID do anúncio
- Métricas: impressões, cliques, custo, conversões, valor das conversões, 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/keywords?organizationId=organization_123&createdStart=2024-01-01&createdEnd=2024-12-31"{ "data": [ { "date": "2019-08-24", "keyword_text": "string", "keyword_match_type": "string", "ad_group_criterion": "string", "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", "impressions": 0, "clicks": 0, "cost": 0, "conversions": 0, "conversions_value": 0, "all_conversions": 0, "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 }}