Ads [Adset Level]
GET
https://rest.api.mktlab.app/v1/facebook/ads/adset
Resposta
| Campo | Tipo | Descrição |
|---|---|---|
| campaign_id | string | ID da campanha à qual o conjunto de anúncios pertence. |
| adset_id | string | ID do conjunto de anúncios (adset) no Facebook. |
| adset_name | string | Nome do conjunto de anúncios (adset) no Facebook. |
| impressions | integer | Quantidade de impressões do conjunto de anúncios. |
| reach | integer | Quantidade de pessoas alcançadas pelo conjunto de anúncios. |
| frequency | float | Frequência média de exibição por pessoa. |
| clicks | integer | Quantidade de cliques recebidos. |
| ctr | float | Taxa de cliques (Click-Through Rate). |
| inline_link_clicks | integer | Quantidade de cliques em links diretos. |
| inline_link_click_ctr | float | Taxa de cliques em links diretos. |
| spend | float | Valor total gasto no conjunto de anúncios (na moeda da conta). |
| cpc | float | Custo médio por clique. |
| cpm | float | Custo médio por mil impressões. |
| date_start | string | Data de início do conjunto de anúncios (formato ISO 8601). |
| date_stop | string | Data de término do conjunto de anúncios (formato ISO 8601). |
| integration_id | string | ID da integração da conta do Facebook. |
| project_id | string | ID do projeto associado ao conjunto de anúncios. |
| unit_id | string | ID da unidade de negócios associada. |
| document_id | string | ID do documento de origem dos dados. |
| inserted_at | string | Data e hora em que o registro foi inserido 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/facebook/ads/adset' \
--header 'Authorization: Bearer <token>'Response Response Example
{
"data": [
{
"campaign_id": "cmp_001",
"adset_id": "adset_001",
"adset_name": "Adset Segmento Jovem - Conversões",
"impressions": 840,
"reach": 715,
"frequency": "1.17",
"clicks": 24,
"ctr": "285.7143",
"inline_link_clicks": 18,
"inline_link_click_ctr": "214.2857",
"spend": "9.50",
"cpc": "0.40",
"cpm": "11.30",
"objective": "teste",
"website_purchase_roas": "0",
"account_id": "123",
"date_start": "2025-01-10T00:00:00Z",
"date_stop": "2025-01-11T00:00:00Z",
"integration_id": "integration_abc",
"project_id": "project_123",
"unit_id": "unit_456",
"document_id": "doc_789",
"inserted_at": "2025-05-12T21:59:56Z"
}
],
"meta": {
"page": 1,
"limit": 500,
"total": 2,
"totalPages": 1,
"hasNextPage": false,
"hasPreviousPage": false
}
}
Modificado em 2025-10-08 17:25:55