Ads [Campaign Level]
GET
https://rest.api.mktlab.app/v1/facebook/ads/campaigns
Resposta
| Campo | Tipo | Descrição |
|---|---|---|
| campaign_name | string | Nome da campanha no Facebook. |
| campaign_id | string | ID da campanha no Facebook. |
| impressions | integer | Quantidade de impressões da campanha. |
| reach | integer | Quantidade de pessoas alcançadas pela campanha. |
| 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 na campanha (na moeda da conta). |
| cpc | float | Custo médio por clique. |
| cpm | float | Custo médio por mil impressões. |
| actions | JSON | Ações realizadas na campanha (ex: conversões, visualizações, etc.). |
| date_start | string | Data de início da campanha (formato ISO 8601). |
| date_stop | string | Data de término da campanha (formato ISO 8601). |
| integration_id | string | ID da integração da conta do Facebook. |
| project_id | string | ID do projeto associado à campanha. |
| 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/campaigns' \
--header 'Authorization: Bearer <token>'Response Response Example
{
"data": [
{
"campaign_id": "cmp_abc123",
"campaign_name": "Campanha Promocional 2025",
"impressions": 3200,
"reach": 2500,
"frequency": "1.28",
"clicks": 145,
"ctr": "452.3100",
"inline_link_clicks": 60,
"inline_link_click_ctr": "192.3076",
"spend": "150.75",
"cpc": "1.04",
"cpm": "47.10",
"actions": [
{ "value": 400, "action_type": "page_engagement" },
{ "value": 35, "action_type": "landing_page_view" },
{ "value": 400, "action_type": "post_engagement" },
{ "value": 25, "action_type": "view_content" },
{ "value": 10, "action_type": "link_click" },
{ "value": 5, "action_type": "video_view" }
],
"objective": "LINK_CLICKS",
"website_purchase_roas": "00",
"account_id": "1235479",
"date_start": "2025-01-01T00:00:00Z",
"date_stop": "2025-01-07T00:00:00Z",
"integration_id": "integration_456",
"project_id": "project_789",
"unit_id": "unit_123",
"document_id": "doc_456",
"inserted_at": "2025-01-08T12:00:00Z"
}
],
"meta": {
"page": 1,
"limit": 500,
"total": 1,
"totalPages": 1,
"hasNextPage": false,
"hasPreviousPage": false
}
}
Modificado em 2025-10-08 17:25:55