Ads Config [Ad Level]
GET
https://rest.api.mktlab.app/v1/facebook/ads/ad
Resposta
| Campo | Tipo | Descrição |
|---|---|---|
| adset_id | string | ID do conjunto de anúncios (adset) no Facebook. |
| ad_id | string | ID do anúncio no Facebook. |
| ad_name | string | Nome do anúncio no Facebook. |
| impressions | integer | Quantidade de impressões do anúncio. |
| reach | integer | Quantidade de pessoas alcançadas pelo anúncio. |
| frequency | float | Frequência média de exibição do anúncio por pessoa. |
| clicks | integer | Quantidade de cliques recebidos pelo anúncio. |
| ctr | float | Taxa de cliques (Click-Through Rate) do anúncio. |
| inline_link_clicks | float | Quantidade de cliques em links diretos dentro do anúncio. |
| inline_link_click_ctr | float | Taxa de cliques em links diretos dentro do anúncio. |
| spend | float | Valor total gasto no anúncio (na moeda da conta). |
| cpc | float | Custo médio por clique (Cost Per Click). |
| cpm | float | Custo médio por mil impressões (Cost Per Mille). |
| quality_ranking | string | Ranking de qualidade do anúncio com base em desempenho comparativo. |
| engagement_rate_ranking | string | Ranking da taxa de engajamento do anúncio. |
| conversion_rate_ranking | string | Ranking da taxa de conversão do anúncio. |
| date_start | string | Data de início do anúncio (formato ISO 8601). |
| date_stop | string | Data de término do anúncio (formato ISO 8601). |
| integration_id | string | ID da integração da conta do Facebook. |
| project_id | string | ID do projeto associado 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 | 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/ad' \
--header 'Authorization: Bearer <token>'Response Response Example
{
"data": [
{
"id": "12345678901234567",
"name": "NOME_DO_ANUNCIO_EXEMPLO",
"lifetime_budget": "0000",
"daily_budget":"0000",
"effective_status": "CAMPAIGN_PAUSED",
"created_time": "2021-01-01T12:00:00.000Z",
"integration_id": "act_000000000000000",
"project_id": "project_abcdef1234567890",
"unit_id": "unit_abcdef1234567890",
"document_id": "doc_abcdef1234567890",
"inserted_at": "2025-01-01T15:00:00.000Z"
}
],
"meta": {
"page": 1,
"limit": 500,
"total": 289,
"totalPages": 1,
"hasNextPage": false,
"hasPreviousPage": false
}
}
Modificado em 2025-10-08 17:25:55