Configuração de conjuntos de anúncios
Retorna dados de configuração de conjuntos de anúncios do Facebook Ads, incluindo configurações de segmentação, de orçamento e demais ajustes em nível de conjunto de anúncios.
Este endpoint fornece informações detalhadas de configuração dos conjuntos de anúncios.
Dimensões disponíveis:
- ID da configuração, nome, status efetivo, data de criação
- Orçamento: orçamento total (lifetime), orçamento diário
- Segmentação: idade mín./máx., gêneros, flexible spec, localizações geográficas, localizações personalizadas, lugares, tipos de localização, bairros, automação de segmentação
- Plataformas: plataformas de publicação, posições no Facebook/Instagram/Messenger, plataformas de dispositivos
Limitações:
- Máximo de 5000 registros por página
- Suporta filtro por data via
dateStart(formato ISO 8601) - Suporta ordenação via
orderByeorderDirection(ASC/DESC)
Filtros:
organizationId(obrigatório)userId(opcional)integrationName(opcional)dateStart(opcional)
Nota: Este endpoint retorna dados de configuração e pode não suportar filtro por
dateEnd.
ClientIdAuthClientSecretAuthx-client-id<token>Client ID
x-client-secret<token>Client secret
organizationId*stringIdentificador da organização (obrigatório)
userId?stringIdentificador do usuário (opcional)
integrationName?stringIdentificador do nome da integração (opcional)
dateStart?stringData inicial para filtragem (opcional, formato ISO 8601)
datepage?integerNúmero da página para paginação (opcional)
1limit?integerNúmero de itens por página (opcional, máx. 5000)
value <= 5000500orderBy?stringCampo de ordenação (opcional)
orderDirection?stringDireção da ordenação (opcional)
"ASC""DESC"Resposta de sucesso
application/json- response
data?array<>meta?curl -X GET "https://example.com/v1/facebook/ads/adset-config?organizationId=organization_123&dateStart=2024-01-01"{ "data": [ { "id": "string", "name": "string", "effective_status": "string", "created_time": "2019-08-24T14:15:22Z", "lifetime_budget": 0, "daily_budget": 0, "targeting_age_max": 0, "targeting_age_min": 0, "targeting_flexible_spec": "string", "targeting_genders": "string", "targeting_geo_locations_custom_locations": "string", "targeting_geo_locations_places": "string", "targeting_geo_locations_location_types": "string", "targeting_geo_locations_neighborhoods": "string", "targeting_targeting_automation_advantage_audience": "string", "targeting_targeting_automation_individual_setting_geo": "string", "targeting_publisher_platforms": "string", "targeting_facebook_positions": "string", "targeting_instagram_positions": "string", "targeting_device_platforms": "string", "targeting_messenger_positions": "string", "organization_id": "string", "user_id": "string", "document_id": "string", "integration_name": "string", "inserted_at": "2019-08-24T14:15:22Z" } ], "meta": { "page": 0, "limit": 0, "hasNextPage": true, "hasPreviousPage": true }}