La Biblioteca de Anuncios de Facebook ofrece una valiosa herramienta para analizar la publicidad que se difunde en la plataforma, incluyendo el mercado brasileño. A través de su API, podemos acceder a una gran cantidad de datos sobre anuncios políticos, sociales y de otros tipos, permitiendo una mejor comprensión de las campañas publicitarias y su impacto. Este artículo te guiará a través del uso de la API de la Biblioteca de Anuncios, enfocándose en su aplicación para el análisis de anuncios en Brasil.

¿Qué es la API de la Biblioteca de Anuncios?
La API de la Biblioteca de Anuncios de Facebook permite a los desarrolladores acceder programáticamente a información sobre los anuncios publicados en la plataforma. Esto incluye detalles como el contenido del anuncio, el público al que llegó, el período de publicación y otros metadatos relevantes. Esta información es crucial para investigadores, periodistas y cualquier persona interesada en analizar el panorama publicitario en Facebook.
Consultas y Respuestas: Un Ejemplo Práctico
Para ilustrar el uso de la API, consideremos un ejemplo. Supongamos que queremos recuperar datos de anuncios en Brasil relacionados con temas sociales o políticos que mencionen la palabra "Amazonas". La siguiente consulta (en formato curl) nos ayudaría:
curl -G \ -d "search_terms='Amazonas'" \ -d "ad_type=POLITICAL_AND_ISSUE_ADS" \ -d "ad_reached_countries=['BR']" \ -d "access_token=" \ "https://graph.facebook.com//ads_archive" Una respuesta posible podría ser similar a esta:
{ "data": [ { "page_id": "123", "page_name": "Ejemplo de Página", "ad_snapshot_url": "https://www.facebook.com/ads/archive/render_ad/?id=123&access_token=" } ], "paging": { "cursors": { "before": "MAZDZD", "after": "MAZDZD" }, "next": "https://graph.facebook.com/v1/ads_archive?access_token=&fields=page_id,page_name,ad_snapshot_url&search_terms='Amazonas'&ad_type=POLITICAL_AND_ISSUE_ADS&ad_reached_countries=['BR']&limit=25&after=MAZDZD" } } Observa que la respuesta JSON incluye información sobre el ID de la página, el nombre de la página y la URL del anuncio. La sección "paging" indica cómo obtener más resultados.
Parámetros de Búsqueda Clave para la Biblioteca de Anuncios Brasil
La API ofrece una variedad de parámetros que permiten refinar la búsqueda de anuncios. A continuación, se detallan algunos de los más importantes:
Parámetros Básicos:
- ad_reached_countries : Permite especificar el o los países a los que llegó el anuncio. Para Brasil, se usa
['BR']. - ad_type : Filtra los anuncios por tipo. Opciones incluyen:
ALL,POLITICAL_AND_ISSUE_ADS,FINANCIAL_PRODUCTS_AND_SERVICES_ADS,EMPLOYMENT_ADS,HOUSING_ADS. - search_terms : Palabras clave para buscar en el contenido del anuncio.
Parámetros Avanzados:
- ad_active_status : Filtra por el estado del anuncio (
ACTIVE,INACTIVE,ALL). - ad_delivery_date_min y ad_delivery_date_max : Especifica el rango de fechas de publicación del anuncio (formato YYYY-mm-dd).
- estimated_audience_size_min y estimated_audience_size_max : Define el rango del tamaño estimado de la audiencia.
- languages : Filtra por idioma del anuncio (códigos ISO 639-1 y 639-3).
- media_type : Filtra por tipo de medio (
IMAGE,VIDEO,ALL). - bylines : Permite filtrar por el aviso de “pagado por” (solo para anuncios políticos).
- delivery_by_region : Permite filtrar por la región donde se mostraron los anuncios (solo para anuncios políticos).
- publisher_platforms : Filtra por las plataformas donde se publicó el anuncio (
FACEBOOK,INSTAGRAM, etc.). - search_page_ids : Busca anuncios de páginas específicas usando sus IDs.
- search_type : Especifica el tipo de búsqueda de palabras clave (
KEYWORD_UNORDEREDoKEYWORD_EXACT_PHRASE). - unmask_removed_content : Indica si se deben incluir anuncios que fueron eliminados por violar las normas de Facebook.
Tabla Comparativa de Parámetros
| Parámetro | Descripción | Tipo de Dato | Ejemplo |
|---|---|---|---|
ad_reached_countries | Países donde se mostró el anuncio | Array de strings | ['BR'] |
ad_type | Tipo de anuncio | String | POLITICAL_AND_ISSUE_ADS |
search_terms | Términos de búsqueda | String | 'Elecciones Brasil' |
ad_active_status | Estado del anuncio | String | ACTIVE |
ad_delivery_date_min | Fecha mínima de publicación | String | 2023-10-26 |
ad_delivery_date_max | Fecha máxima de publicación | String | 2023-11-20 |
Consideraciones para la Biblioteca de Anuncios Brasil
Al utilizar la API de la Biblioteca de Anuncios para analizar el mercado brasileño, tener en cuenta lo siguiente:
- Restricciones de Datos : La API no proporciona todos los datos de todos los anuncios. Algunos datos pueden estar limitados o no estar disponibles.
- Términos de Servicio : Es fundamental respetar los términos de servicio de Facebook al utilizar la API.
- Volumen de Datos : La cantidad de datos que se pueden obtener puede ser considerable. Se recomienda planificar cómo procesar y analizar la información eficientemente.
- Actualizaciones de la API : Facebook puede actualizar la API con el tiempo. Es importante mantenerse al día con las últimas modificaciones.
Consultas Habituales y Optimización SEO
Para optimizar la búsqueda y el análisis de anuncios en la Biblioteca de Anuncios Brasil, es fundamental formular las consultas de manera efectiva. Aquí hay algunas consultas habituales y consejos de optimización:
- Anuncios Políticos en Sao Paulo :
ad_reached_countries=['BR']&ad_type=POLITICAL_AND_ISSUE_ADS&search_terms=ao Paulo'&ad_delivery_date_min=2023-10-01&ad_delivery_date_max=2023-11-30 - Anuncios sobre Medio Ambiente en Brasil :
ad_reached_countries=['BR']&search_terms='medio ambiente'&languages=['pt'] - Anuncios de Empleo en Rio de Janeiro :
ad_reached_countries=['BR']&ad_type=EMPLOYMENT_ADS&search_terms='Rio de Janeiro'
Recuerda utilizar una combinación estratégica de parámetros para obtener resultados precisos y relevantes. Experimenta con diferentes combinaciones para optimizar tu búsqueda.
La API de la Biblioteca de Anuncios de Facebook es una herramienta poderosa para analizar la publicidad en Brasil. Comprender sus parámetros y cómo formular consultas efectivas es clave para obtener información valiosa sobre campañas políticas, sociales y comerciales. Con esta tutorial, estarás mejor preparado para explorar el panorama publicitario brasileño y extraer información relevante para tu investigación o análisis.
"}
Si quieres conocer otros artículos parecidos a Biblioteca de anuncios brasil de la api de facebook puedes visitar la categoría Marketing digital.
