Ads Platform
GET
https://rest.api.mktlab.app/v1/facebook/ads/platform
Resposta
| Campo | Tipo | Descrição |
|---|---|---|
| adset_id | string | ID do conjunto de anúncios (adset) relacionado à segmentação. |
| ad_id | string | ID do anúncio relacionado à segmentação. |
| clicks | integer | Total de cliques registrados. |
| reach | integer | Total de pessoas alcançadas. |
| impressions | integer | Total de impressões do anúncio. |
| objective | string | Objetivo da campanha (ex: CONVERSIONS, TRAFFIC, etc.). |
| spend | float | Valor total gasto na campanha (em moeda local da conta). |
| full_view_reach | integer | Alcance com visualização completa. |
| date_start | string | Data e hora de início do período analisado (formato ISO 8601). |
| date_stop | string | Data e hora de término do período analisado (formato ISO 8601). |
| publisher_platform | string | Plataforma de publicação (ex: Facebook, Instagram, Audience Network). |
| platform_position | string | Posição da plataforma onde o anúncio foi exibido (ex: Feed, Stories). |
| integration_id | string | ID da integração da plataforma com a conta do Facebook. |
| project_id | string | ID do projeto associado à segmentação por plataforma. |
| unit_id | string | ID da unidade de negócios associada à segmentação. |
| document_id | string | ID do documento associado à segmentação. |
| 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/platform' \
--header 'Authorization: Bearer <token>'Response Response Example
{
"data": [
{
"adset_id": "adset12345",
"ad_id": "ad12345",
"clicks": 2000,
"reach": 60000,
"impressions": 120000,
"objective": "CONVERSIONS",
"spend": 1500.75,
"full_view_reach": 40000,
"date_start": "2025-03-01T00:00:00Z",
"date_stop": "2025-03-15T23:59:59Z",
"publisher_platform": "Facebook",
"platform_position": "Feed",
"integration_id": "integration123",
"project_id": "project456",
"unit_id": "unit789",
"document_id": "doc123",
"inserted_at": "2025-03-16T12:00:00Z"
}
],
"meta": {
"page": 1,
"limit": 500,
"total": 1,
"totalPages": 1,
"hasNextPage": false,
"hasPreviousPage": true
}
}Modificado em 2025-10-08 17:25:55