Ads Criterion [Campaigns]
GET
https://rest.api.mktlab.app/v1/google/ads/campaigns
Consulta os dados de campanhas do Google Ads trazendo suas métricas agregadas.
Resposta
| Campo | Tipo | Descrição |
|---|---|---|
campaign_resource_name | string | Nome completo do recurso da campanha no Google Ads. |
campaign_status | string | Status da campanha (ex: ENABLED, PAUSED, REMOVED). |
campaign_advertising_channel_type | string | Tipo de canal de publicidade (ex: SEARCH, DISPLAY, VIDEO). |
campaign_name | string | Nome da campanha. |
campaign_id | string | ID único da campanha. |
campaign_start_date | date | Data de início da campanha. |
campaign_end_date | date | Data de término da campanha. |
campaign_optimization_score | float | Pontuação de otimização da campanha (%). |
metrics_clicks | integer | Número de cliques recebidos. |
metrics_search_budget_lost_impression_share | float | % de perda de impressões por orçamento insuficiente. |
metrics_search_impression_share | float | % de participação nas impressões da rede de pesquisa. |
metrics_search_rank_lost_impression_share | float | % de perda de impressões por classificação baixa. |
metrics_conversions_from_interactions_rate | float | Taxa de conversão por interação. |
metrics_conversions_value | float | Valor total das conversões atribuídas. |
metrics_conversions | float | Total de conversões atribuídas. |
metrics_cost_micros | bigint | Custo total em microssegundos de moeda (1.000.000 micros = 1 unidade). |
metrics_cost_per_conversion | float | Custo médio por conversão. |
metrics_ctr | float | Taxa de cliques (Click-Through Rate). |
metrics_average_cpc | float | Custo médio por clique. |
metrics_impressions | integer | Total de impressões da campanha. |
campaign_budget_amount_micros | bigint | Valor do orçamento em microssegundos de moeda. |
campaign_budget_resource_name | string | Nome completo do recurso de orçamento da campanha. |
metrics_cost | float | Custo total da campanha em unidades monetárias. |
metrics_roas | float | Retorno sobre gasto com anúncios (ROAS). |
integration_id | string | ID da integração com a conta do Google Ads. |
project_id | string | ID do projeto relacionado à campanha. |
unit_id | string | ID da unidade de negócios associada. |
document_id | string | ID do documento de origem dos dados. |
inserted_at | datetime | Data e hora de inserção no sistema (formato ISO 8601). |
Requisição
Parâmetros de Consulta
Respostas
Request Request Example
Shell
JavaScript
Java
Swift
curl --location --request GET 'https://rest.api.mktlab.app/v1/google/ads/campaigns' \
--header 'Authorization: Bearer <token>'Response Response Example
{
"data": [
{
"campaign_resource_name": "customers/0000000000/campaigns/111111111",
"campaign_status": "REMOVED",
"campaign_name": "Campanha Exemplo",
"campaign_id": "111111111",
"campaign_criterion_resource_name": "customers/0000000000/campaignCriteria/111111111~99999",
"campaign_criterion_type": "DEVICE",
"campaign_criterion_criterion_id": "99999",
"integration_id": "000-000-0000",
"project_id": "proj_abcdef123456",
"unit_id": "unit_abcdef123456",
"document_id": "doc_abcdef123456",
"inserted_at": "2025-07-23T00:00:00.000Z"
}
],
"meta": {
"page": 1,
"limit": 1,
"total": 732,
"totalPages": 732,
"hasNextPage": true,
"hasPreviousPage": false
}
}
Modificado em 2025-10-08 17:25:55