Ads Keywords Dimension
GET
https://rest.api.mktlab.app/v1/google/ads/keywords
Resposta
| Campo | Tipo | Descrição |
|---|---|---|
date | Date | Data em que os dados foram registrados ou coletados. |
keyword_text | string | Texto da palavra-chave associada à campanha. |
keyword_match_type | string | Tipo de correspondência da palavra-chave (ex: broad, exact, phrase). |
ad_group_criterion | string | Critério do grupo de anúncios (identificador da segmentação ou critério associado). |
ad_group_type | string | Tipo de grupo de anúncios (ex: SEARCH_STANDARD, DISPLAY_STANDARD). |
ad_group_status | string | Status atual do grupo de anúncios (ex: ENABLED, PAUSED). |
ad_group_name | string | Nome do grupo de anúncios associado à palavra-chave. |
ad_group_id | string | ID único do grupo de anúncios. |
ad_id | string | ID único do anúncio relacionado à palavra-chave. |
ad_group_campaign | string | ID da campanha associada ao grupo de anúncios. |
campaign_bidding_strategy_type | string | Tipo de estratégia de lance da campanha (ex: CPC, CPM, CPA). |
campaign_id | string | ID único da campanha no Google Ads. |
campaign_name | string | Nome da campanha no Google Ads. |
campaign_group | string | Nome ou identificador do grupo de campanhas, se aplicável. |
impressions | number | Número de impressões (vezes que anúncios foram exibidos para essa palavra-chave). |
clicks | number | Número de cliques recebidos pela palavra-chave. |
cost | number | Custo total associado à palavra-chave. |
conversions | number | Número de conversões atribuídas à palavra-chave. |
conversions_value | number | Valor monetário das conversões atribuídas à palavra-chave. |
all_conversions | number | Número total de conversões (diretas e indiretas) atribuídas à palavra-chave. |
integration_id | string | ID da integração entre o sistema e o Google Ads. |
project_id | string | ID do projeto associado à palavra-chave. |
unit_id | string | ID da unidade de negócios associada à palavra-chave. |
document_id | string | ID do documento relacionado à palavra-chave ou conversão. |
inserted_at | DateTime | Data e hora em que o registro foi inserido no sistema (formato ISO 8601). |
Requisição
Parâmetros de Consulta
Parâmetros Header
Respostas
Request Request Example
Shell
JavaScript
Java
Swift
curl --location --request GET 'https://rest.api.mktlab.app/v1/google/ads/keywords' \
--header 'Authorization: Bearer <token>'Response Response Example
{
"data": [
{
"date": "2025-01-01T00:00:00Z",
"keyword_text": "comprar celular barato",
"keyword_match_type": "broad",
"ad_group_criterion": "criterion123",
"ad_group_type": "search",
"ad_group_status": "ATIVO",
"ad_group_name": "Grupo de Anúncios 1",
"ad_group_id": "AG123",
"ad_id": "AD456",
"ad_group_campaign": "CAM123",
"campaign_bidding_strategy_type": "CPC",
"campaign_id": "CAM123456",
"campaign_name": "Campanha de Celulares 2025",
"campaign_group": null,
"impressions": 15000,
"clicks": 600,
"cost": 200,
"conversions": 70,
"conversions_value": 1400,
"all_conversions": 80,
"all_conversions_value": 1600,
"integration_id": "INTEGR123",
"project_id": "PROJ123",
"unit_id": "UNIT123",
"document_id": "DOC123",
"inserted_at": "2025-01-01T09:00:00Z"
}
],
"meta": {
"page": 1,
"limit": 500,
"total": 1,
"totalPages": 1,
"hasNextPage": false,
"hasPreviousPage": true
}
}Modificado em 2025-10-08 17:25:55