Ads [Ad Group Ads]
GET
https://rest.api.mktlab.app/v1/google/ads/ad-group-ads
Consulta os dados de anúncios do Google Ads trazendo suas métricas agregadas.
Resposta
| Campo | Tipo | Descrição |
|---|---|---|
ad_group_resource_name | string | Nome completo do recurso do grupo de anúncios no Google Ads. |
ad_group_id | string | ID único do grupo de anúncios. |
ad_group_ad_resource_name | string | Nome completo do recurso do anúncio no Google Ads. |
ad_group_ad_status | string | Status do anúncio (ex: ENABLED, PAUSED, REMOVED). |
ad_group_ad_ad_resource_name | string | Nome completo do recurso do criativo do anúncio. |
ad_group_ad_ad_id | string | ID único do anúncio. |
ad_group_ad_ad_strength | string | Nível de qualidade do anúncio (ex: AVERAGE, GOOD, EXCELLENT). |
ad_group_ad_ad_type | string | Tipo do anúncio (ex: RESPONSIVE_SEARCH_AD, IMAGE_AD, TEXT_AD). |
ad_group_ad_ad_final_urls | JSONB | Lista de URLs finais de destino do anúncio. |
ad_group_ad_ad_final_mobile_urls | JSONB | Lista de URLs finais específicas para dispositivos móveis. |
ad_group_ad_ad_responsive_search_ad_headlines | JSONB | Lista de headlines (títulos) configurados no anúncio responsivo de pesquisa. |
ad_group_ad_ad_responsive_search_ad_descriptions | JSONB | Lista de descrições configuradas no anúncio responsivo de pesquisa. |
metrics_clicks | integer | Número de cliques no anúncio. |
metrics_conversions_from_interactions_rate | float | Taxa de conversão por interação (%). |
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_all_conversions_value | float | Valor total de todas as conversões atribuídas. |
metrics_all_conversions | float | Total de todas as conversões atribuídas. |
metrics_average_cpc | float | Custo médio por clique. |
metrics_impressions | integer | Número total de impressões do anúncio. |
metrics_cost | float | Custo total do anúncio em unidades monetárias. |
integration_id | string | ID da integração com a conta do Google Ads. |
project_id | string | ID do projeto relacionado ao anúncio. |
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 do registro 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/ad-group-ads' \
--header 'Authorization: Bearer <token>'Response Response Example
{
"data": [
{
"ad_group_resource_name": "customers/0000000000/adGroups/11111111111",
"ad_group_id": "11111111111",
"ad_group_ad_resource_name": "customers/0000000000/adGroupAds/11111111111~222222222222",
"ad_group_ad_status": "ENABLED",
"ad_group_ad_ad_resource_name": "customers/0000000000/ads/222222222222",
"ad_group_ad_ad_id": "222222222222",
"ad_group_ad_ad_strength": null,
"ad_group_ad_ad_type": "RESPONSIVE_SEARCH_AD",
"ad_group_ad_ad_final_urls": ["https://www.exemplo.com"],
"ad_group_ad_ad_final_mobile_urls": ["https://m.exemplo.com"],
"ad_group_ad_ad_responsive_search_ad_headlines": [
{ "text": "Título 1" },
{ "text": "Título 2" },
{ "text": "Título 3" }
],
"ad_group_ad_ad_responsive_search_ad_descriptions": [
{ "text": "Descrição 1" },
{ "text": "Descrição 2" }
],
"metrics_clicks": 0,
"metrics_conversions_from_interactions_rate": null,
"metrics_conversions": "0.00",
"metrics_cost_micros": "0",
"metrics_cost_per_conversion": null,
"metrics_ctr": null,
"metrics_all_conversions_value": "0.00",
"metrics_all_conversions": "0.00",
"metrics_average_cpc": null,
"metrics_impressions": 0,
"metrics_cost": "0.00",
"integration_id": "000-000-0000",
"project_id": "project123",
"unit_id": "unit456",
"document_id": "doc789",
"inserted_at": "2025-05-12T21:59:06.000Z"
}
],
"meta": {
"page": 1,
"limit": 1,
"total": 199,
"totalPages": 199,
"hasNextPage": true,
"hasPreviousPage": false
}
}
Modificado em 2025-10-08 17:25:55