Presentación de la versión 25.0 de la API Graph y de la API de marketing
De Manjari Jain
A continuación, encontrarás los aspectos más destacados de los nuevos cambios de la GAPI y la MAPI en la versión 25. Visita nuestro registro de cambios para obtener una lista completa de los cambios e información detallada.
Actualizaciones generales
API Graph: presentamos la métrica de espectadores de la página
A finales de junio de 2026, tenemos previsto presentar la métrica de espectadores de la página en la API Graph. La métrica de espectadores tiene como objetivo reemplazar la métrica de alcance anterior y proporcionar una medición coherente entre plataformas (Facebook e Instagram) de cuántas personas vieron determinado contenido. Los desarrolladores deben empezar a planificar la migración a la métrica de espectadores a fin de asegurar el acceso continuo a las estadísticas del público.
¿Qué cambiará?
Las métricas de espectadores estarán disponibles en las estadísticas de la página y de las historias
Estadísticas de publicaciones y de la página
- GET {page-id}/insights/page_total_media_view_unique*
- GET {post-id}/insights/post_total_media_view_unique*
- Se agregará una nueva métrica
- OBTENER {stories-id}/insights/metric
- PAGE_STORY_TOTAL_MEDIA_VIEW_UNIQUE
Las API Graph anteriores estarán disponibles después del lanzamiento de la versión 25. Recomendamos a los desarrolladores que consulten el registro de cambios de la API Graph para obtener la información más actualizada.
Actualización del certificado de mTLS de Webhooks
A partir del 31 de marzo de 2026, Meta comenzará a firmar los certificados de mTLS de Webhooks usando una autoridad de certificación (CA) diferente que le pertenece.
¿Qué significa esto para los desarrolladores?
Si tus servidores están configurados para solicitar y verificar el certificado de mTLS de Webhooks, debes confiar en la nueva CA de Meta. Si no actualizas el almacén de confianza antes de la fecha límite, se producirán errores en el protocolo de enlace TLS, y los servidores dejarán de recibir todos los eventos de webhooks.
Acción requerida: actualiza el almacén de confianza
Para garantizar la recepción ininterrumpida de webhooks, debes hacer lo siguiente:
- Descarga el certificado de la CA raíz de Meta: ve a Primeros pasos con webhooks y descarga el archivo denominado meta-outbound-api-ca-2025-12.pem.
La CA raíz firmará el certificado de hoja que se presentará en las solicitudes de webhooks. - Agrégalo al almacén de confianza: agrega este certificado al almacén de confianza de cualquier servidor que reciba webhooks.
- Mantén el certificado actual: debes agregar el nuevo certificado a tu almacén de confianza mientras el actual sigue activo.
Importante: No esperes hasta la fecha límite. Agrega el nuevo certificado a tu almacén de confianza inmediatamente para garantizar una transición fluida el 31 de marzo.
Fecha límite: antes del 31 de marzo de 2026.
A qué se debe este cambio
El certificado de mTLS de Webhooks actual está firmado por la CA raíz DigiCert. Dado que DigiCert dejará obsoleto el uso de la autenticación del cliente EKU, el certificado no puede renovarse con esta CA raíz y caduca el 15 de abril de 2025.
En consecuencia, el nuevo certificado de mTLS de Webhooks será firmada por una CA raíz interna de Meta. Mantendrá el mismo nombre común (client.webhooks.fbclientcerts.com) que el certificado actual.
La documentación pública sobre mTLS de Webhooks se actualizó con una notificación en relación con este cambio. Los detalles técnicos completos de la documentación se actualizarán de forma permanente en abril de 2026, una vez que finalice la transición.
Elementos obsoletos y cambios de último momento
Mensajes de error mejorados de la API asincrónica de estadísticas de anuncios
Estamos trabajando continuamente para mejorar la experiencia de los desarrolladores con nuestras API. Para brindar una mayor transparencia y permitir a los desarrolladores crear apps más resilientes, mejoraremos los informes de errores del punto de conexión GET {AD_REPORT_RUN_ID} de la API asincrónica de estadísticas de anuncios.
A partir de la versión 25.0 de la API Graph, que se lanzará el 18 de febrero de 2026, los desarrolladores tendrán acceso a información detallada sobre los errores cuando un informe asincrónico no se pueda realizar, lo que permitirá diagnosticar más fácilmente los errores y mejorar la eficiencia de las integraciones de las API. En el caso de los desarrolladores que actualmente tengan acceso al campo error_code, el tipo se cambiará de uint a int.
¿Qué cambiará?
Presentamos los siguientes nuevos campos predeterminados en la respuesta del punto de conexión GET {AD_REPORT_RUN_ID} de la API asincrónica de estadísticas de anuncios para todas las apps:
- error_code: el código de error. Nota: El campo se cambiará de
uintaintpara cualquier desarrollador que actualmente tenga acceso a él - error_message: un mensaje correspondiente al
error_code. - error_subcode: el subcódigo específico del error.
- error_user_title: un título fácil de entender para el subcódigo de error.
- error_user_msg: un mensaje fácil de entender en el que se detalla el subcódigo de error.
Cuando se produzcan errores en la ejecución de un informe, se completarán estos campos. Te recomendamos revisar la integración de tu API para garantizar la compatibilidad con los nuevos campos predeterminados en la respuesta.
El lanzamiento de esta actualización está previsto junto con la próxima versión de la API Graph. Recomendamos a los desarrolladores que consulten el registro de cambios de la API Graph para obtener la información más actualizada. La documentación para desarrolladores también se actualizó para reflejar estos cambios.
API Graph: el parámetro de consulta de metadatos quedó obsoleto
A partir de la versión 25 de la API Graph, el parámetro de consulta metadata=1 quedará obsoleto. Este parámetro se usaba anteriormente para devolver metadatos sobre los campos de un nodo y las conexiones en las respuestas de la API. Esta función tiene poco uso y quedará obsoleta para simplificar la plataforma. Una vez obsoleto, el parámetro metadata se ignorará en las solicitudes a la API.
Los desarrolladores que actualmente utilizan metadata=1 deberán hacer la transición y empezar a usar nuestra documentación oficial de la API para descubrir los campos y conexiones disponibles para cada tipo de nodo.
¿Qué cambiará?
Cambio | Plazo |
Obsolescencia del parámetro de consulta | v25 (febrero de 2026) |
Eliminación del parámetro de consulta | Mayo de 2026 |
Antes (versión 24 y anteriores):
Agregar ?metadata=1 a una solicitud de la API Graph devolvía metadatos adicionales sobre el nodo, incluidos los campos y las conexiones disponibles.
Después (versión 25 y posteriores):
Se ignorará el parámetro metadata=1. Las solicitudes que incluyan este parámetro seguirán devolviendo respuestas estándar sin metadatos. No se producirán errores ni cambios de último momento: tus solicitudes no generarán errores ni se interrumpirán si incluyen metadata=1; el parámetro simplemente no tendrá efecto.
API Graph: las métricas de alcance e impresiones de la página quedarán obsoletas
En junio de 2026, tenemos previsto dejar obsoletas las métricas de alcance de la publicación/página, impresiones de video e impresiones de historias en la API Graph. Estas métricas anteriores ya no aparecen en nuestras herramientas de estadísticas, pero permanecieron disponibles a través de las API hasta ahora.
Para alinear nuestros productos y API en un marco de métricas único y coherente, y para mejorar la confiabilidad general del sistema, se procederá a retirar estas métricas anteriores. Una vez obsoletas, los desarrolladores deberán migrar a las nuevas métricas de visualizaciones de contenido multimedia y espectadores de contenido multimedia, que sustituyen a los anteriores conceptos de impresiones, alcance y espectadores de video.
¿Qué cambiará?
Las siguientes métricas quedarán obsoletas en junio de 2026 en todas las versiones de la API. Recomendamos a los desarrolladores que consulten el registro de cambios de la API Graph para obtener la información más actualizada:
Alcance de la publicación/página
- GET {page-id}/insights/page_impressions_unique*
- GET {page-id}/insights/page_impressions_paid_unique*
- GET {page-id}/insights/page_impressions_viral_unique*
- GET {page-id}/insights/page_impressions_nonviral_unique*
- GET {page-id}/insights/page_posts_impressions*
- GET {page-id}/insights/page_posts_impressions_unique*
- GET {page-id}/insights/page_posts_impressions_paid*
- GET {page-id}/insights/page_posts_impressions_paid_unique*
- GET {page-id}/insights/page_posts_impressions_organic_unique*
- GET {page-id}/insights/page_posts_served_impressions_organic_unique*
- GET {page-id}/insights/page_posts_impressions_viral*
- GET {page-id}/insights/page_posts_impressions_viral_unique*
- GET {page-id}/insights/page_posts_impressions_nonviral*
- GET {page-id}/insights/page_posts_impressions_nonviral_unique*
- GET {post-id}/insights/post_impressions_unique*
- GET {post-id}/insights/post_impressions_paid_unique*
- GET {post-id}/insights/post_impressions_fan_unique*
- GET {post-id}/insights/post_impressions_organic_unique*
- GET {post-id}/insights/post_impressions_viral_unique*
- GET {post-id}/insights/post_impressions_nonviral_unique*
- GET {post-id}/insights/post_impressions_nonviral_unique*
- GET {video-id}/video_insights/post_impressions_unique
- GET {video-id}/video_insights/total_video_impressions
- GET {video-id}/video_insights/total_video_impressions_unique
- GET {video-id}/video_insights/total_video_impressions_paid_unique
- GET {video-id}/video_insights/total_video_impressions_paid
- GET {video-id}/video_insights/total_video_impressions_organic_unique
- GET {video-id}/video_insights/total_video_impressions_organic
- GET {video-id}/video_insights/total_video_impressions_viral_unique
- GET {video-id}/video_insights/total_video_impressions_viral
- GET {video-id}/video_insights/total_video_impressions_fan_unique
- GET {video-id}/video_insights/total_video_impressions_fan
- GET {video-id}/video_insights/total_video_impressions_fan_paid_unique
- GET {video-id}/video_insights/total_video_impressions_fan_paid
- Se reemplazarán dos métricas
- GET {stories-id}/insights/metric
- PAGE_STORY_IMPRESSIONS_BY_STORY_ID
- PAGE_STORY_IMPRESSIONS_BY_STORY_ID_UNIQUE
En cambio, recomendamos usar las siguientes métricas:
- GET {page-id}/insights/page_total_media_view_unique
- GET {post-id}/insights/post_total_media_view_unique
Específicamente para los desgloses entre alcance orgánico y pagado, recomendamos usar las siguientes métricas, que proporcionan estadísticas sustancialmente similares:
- GET {page-id}/insights/page_media_view
- GET {post-id}/insights/post_media_view
API Graph: las métricas de espectadores de 3 segundos quedarán obsoletas
En junio de 2026, tenemos previsto dejar obsoletas las métricas de espectadores de 3 segundos. Estas métricas anteriores ya no aparecen en nuestras herramientas de estadísticas, pero permanecieron disponibles a través de las API Graph hasta ahora.
Para alinear nuestros productos y API en un marco de métricas único y coherente, y para mejorar la confiabilidad general del sistema, se procederá a retirar estas métricas anteriores. Una vez obsoletas, los desarrolladores deberán migrar a las nuevas métricas de visualizaciones de contenido multimedia y espectadores de contenido multimedia, que sustituyen a los anteriores conceptos de impresiones, alcance y espectadores de video.
¿Qué cambiará?
Las siguientes métricas quedarán obsoletas en junio de 2026 en todas las versiones de la API. Recomendamos a los desarrolladores que consulten el registro de cambios de la API Graph para obtener la información más actualizada:
- GET {page-id}/insights/page_video_views_unique
- GET {post-id}/insights/post_video_views_organic_unique
- GET {post-id}/insights/post_video_views_paid_unique
- GET {post-id}/insights/post_video_views_unique
- GET {video-id}/video_insights/total_video_views_organic_unique
- GET {video-id}/video_insights/total_video_views_paid_unique
- GET {video-id}/video_insights/total_video_views_unique
En cambio, recomendamos usar las siguientes métricas:
- GET {page-id}/insights/page_total_media_view_unique
- GET {post-id}/insights/post_total_media_view_unique
Específicamente para los desgloses entre espectadores de 3 segundos orgánicos y pagados, recomendamos usar las siguientes métricas, que proporcionan estadísticas sustancialmente similares:
- GET {page-id}/insights/page_media_view
- GET {post-id}/insights/post_media_view
API de marketing: las campañas de compra Advantage+ (ASC) y campañas de app Advantage+ (AAC) quedarán obsoletas
La unificación de la automatización hace que las campañas de app, ventas y clientes potenciales tengan una configuración de Advantage+ óptima centrada en la automatización de forma predeterminada. Además, permite a los anunciantes y socios acceder de manera simplificada a los productos de automatización más recientes y eficaces de Meta. Estamos llevando a cabo una eliminación gradual de las API anteriores y una migración a la nueva unificación de la automatización, la configuración Advantage+ para desarrolladores de la API de marketing.
A partir de la versión 25.0 (18 de febrero de 2026), las campañas ASC y AAC ya no podrán crearse ni actualizarse utilizando la API de marketing. Esto se hará extensivo a todas las versiones de la MAPI al cabo de 90 días (a más tardar el 19 de mayo de 2026).
En la versión 26.0 (con lanzamiento estimado para septiembre de 2026), se pausarán todas las campañas ASC y AAC.
Las campañas ASC o AAC que usen límites de presupuesto de clientes actuales (ECBC) seguirán siendo editables hasta la versión 26.0. Esta función no está disponible en las campañas Advantage+. Los desarrolladores con una campaña de ECBC deben tomar medidas y utilizar uno de los siguientes métodos para replicar las campañas con ECBC antes de la versión 26.0:
- Duplicación manual: abre una campaña ASC/AAC preexistente con ECBC en el administrador de anuncios y se te indicará que dupliques la campaña. Este paso de un solo clic crea una nueva campaña que replica la configuración de la campaña actual.
- Para replicar campañas con ECBC mediante la API, sigue las instrucciones proporcionadas en la documentación para desarrolladores aquí.
- Solicita la migración masiva en el nivel de la cuenta publicitaria. En el caso de los socios administrados, podemos realizar una acción única para replicar todas las campañas con ECBC en una fecha acordada. Ponte en contacto con tu punto de contacto de Meta y proporciona los identificadores de las cuentas y la fecha preferida para realizar la migración.
Nota: Ten en cuenta que todas las duplicaciones de campañas con ECBC generarán un nuevo identificador de campaña.
Esto afecta a los siguientes puntos de conexión:
- POST /{campaign-id}
- POST /{campaign-id}/copies
Lee la documentación para desarrolladores y las preguntas frecuentes actualizadas para ver todos los detalles de este cambio.
Enlace a la documentación para desarrolladores
Enlace al artículo de ayuda sobre la función
Versiones de la API obsoletas:
Como parte del calendario de versiones de Facebook correspondiente a la API Graph y la API de marketing, ten en cuenta los próximos elementos que quedarán obsoletos:
API Graph
- El 21 de mayo de 2026, quedará obsoleta la versión 19 de la API Graph y se la eliminará de la plataforma.
- El 24 de septiembre de 2026, quedará obsoleta la versión 20 de la API Graph y se la eliminará de la plataforma.
Para evitar interrupciones en tu negocio, te recomendamos que migres todas las llamadas a la última versión de la API que lanzamos hoy.
Recibir nuestro newsletter
Regístrate para recibir actualizaciones mensuales de Meta for Developers.