Presentación de la versión 25.0 de la API Graph y la API de marketing

A continuación se detalla lo más destacado de los nuevos cambios de la API de conversiones y la API de marketing en la versión 25. Consulta nuestro registro de cambios para ver una lista completa de los cambios y sus detalles.

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. Está previsto que esta métrica reemplace a la de alcance obsoleta y que proporcione una medición coherente en distintas plataformas (Facebook e Instagram) de la cantidad de personas que han visto una pieza de contenido. Los desarrolladores deben empezar a planificar la migración de los espectadores para asegurar el acceso ininterrumpido a las insights de audiencia.

¿Qué va a cambiar?

Las métricas de los espectadores estarán disponibles en las insights de páginas y de historias

Insights de publicaciones/páginas

• GET {page-id}/insights/page_total_media_view_unique*
• GET {post-id}/insights/post_total_media_view_unique*

Insights de historias

• Se añadirá una nueva métrica
• GET {stories-id}/insights/metric
  • PAGE_STORY_TOTAL_MEDIA_VIEW_UNIQUE

Las API Graph anteriores estarán disponibles tras el 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 de certificados mTLS de webhooks

A partir del 31 de marzo de 2026, Meta empezará a firmar los certificados mTLS de webhooks con una autoridad de certificación (CA) diferente que pertenece a Meta.

¿Qué implica esto para los desarrolladores?

Si tus servidores están configurados para exigir y verificar el certificado mTLS de webhooks, debes confiar en la nueva autoridad de certificación 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 tu tienda de confianza

Para asegurarte de que la recepción de webhooks no se interrumpa, debes hacer lo siguiente:

1. Descarga el certificado de la autoridad de certificación raíz de Meta: ve a Introducción a los webhooks y descarga el archivo con el nombre meta-outbound-api-ca-2025-12.pem.
   La autoridad de certificación raíz firmará el certificado final que se presentará en las solicitudes de webhooks.
2. Añádelo a tu almacén de confianza: añade este certificado al almacén de confianza de cualquier servidor que reciba webhooks.
3. Mantén el certificado actual: debes añadir el nuevo certificado al almacén de confianza mientras el actual siga activo.

Importante: No esperes hasta el último momento. Deberías añadir el nuevo certificado a tu almacén de confianza de inmediato 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 mTLS de webhooks actual lo ha firmado la autoridad de certificación raíz de DigiCert. DigiCert está retirando el uso del EKU de autenticación de cliente, por lo que el certificado que caduca el 15 de abril de 2025 no se puede renovar con esta autoridad de certificación raíz.

En consecuencia, el nuevo certificado de mTLS de webhooks se firmará con una autoridad de certificación interna de Meta. Conservará el mismo nombre habitual (client.webhooks.fbclientcerts.com) que el certificado actual.

La documentación pública sobre el mTLS de webhooks se ha actualizado con una notificación sobre este cambio. La documentación incluirá información técnica completa actualizada de forma permanente en abril de 2026, una vez que se haya completado la transición.

Retiradas y cambios de última hora

Mensajes de error mejorados para la API de insights de anuncios asíncrona

Trabajamos continuamente para mejorar la experiencia de los desarrolladores con nuestras API. Para proporcionar una mayor transparencia y permitir que los desarrolladores creen aplicaciones más resilientes, estamos mejorando los informes de errores para el extremo GET {AD_REPORT_RUN_ID} de la API de insights de anuncios asíncrona.

A partir de la próxima 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 falle un informe asíncrono, lo que permite diagnosticar los errores con mayor facilidad y mejora la eficiencia de las integraciones de la API. Para los desarrolladores que actualmente tengan acceso al campo error_code, el tipo se cambiará de uint a int.

¿Qué va a cambiar?

Vamos a introducir los siguientes campos predeterminados nuevos en la respuesta del extremo GET {AD_REPORT_RUN_ID} de la API de insights de anuncios asíncrona para todas las aplicaciones:

• error_code: código de error. Nota: El campo cambiará de uint a int para todos los desarrolladores que tengan acceso a él actualmente.
• error_message: mensaje correspondiente a la sección error_code.
• error_subcode: subcódigo específico del error.
• error_user_title: título descriptivo del subcódigo de error.
• error_user_msg: mensaje sencillo que indica el subcódigo de error.

Estos campos se rellenarán cuando falle la ejecución de un informe. Te animamos a revisar la integración de la API para garantizar la compatibilidad con los nuevos campos predeterminados en la respuesta.

Está previsto que esta actualización se lance 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 ha actualizado para que refleje estos cambios.

API Graph: se ha retirado el parámetro de consulta de metadatos

A partir de la versión 25 de la API Graph, retiramos el parámetro de consulta metadata=1. Este parámetro se usaba anteriormente para devolver metadatos sobre los campos y las conexiones de un nodo en las respuestas de la API. Esta función tiene un uso reducido y se va a retirar para simplificar la plataforma. Tras la retirada, el parámetro metadata se ignorará en las solicitudes a la API.

Los desarrolladores que actualmente utilicen “metadata=1” deberán pasar a usar nuestra documentación oficial de la API para consultar los campos y conexiones disponibles para cada tipo de nodo.

¿Qué va a cambiar?

Antes (versión 24 y anteriores):

Al añadir ?metadata=1 a una solicitud de la API Graph, se devolvían metadatos adicionales sobre el nodo, incluidos los campos y conexiones disponibles.

Después (versión 25 o superior):

El parámetro metadata=1 se ignorará. Las solicitudes que incluyan este parámetro seguirán devolviendo respuestas estándar sin metadatos. No se producirán errores ni cambios importantes: tus solicitudes no mostrarán errores ni se interrumpirán si incluyen “metadata=1”; el parámetro simplemente no tendrá ningún efecto.

API Graph: retirada de las métricas de impresiones y alcance de la página

En junio de 2026, tenemos previsto retirar las métricas de alcance de la publicación o la página, impresiones de vídeo e impresiones de historia en la API Graph. Estas métricas obsoletas ya no se muestran en nuestras herramientas de insights, pero seguían estando disponibles a través de las API hasta ahora.

Para ajustar nuestros productos y API a un único marco de métricas coherente y mejorar la fiabilidad general del sistema, vamos a retirar estas métricas obsoletas. Tras su retirada, los desarrolladores deberán migrar a las nuevas métricas de visualizaciones de contenido multimedia y espectadores de contenido multimedia, que sustituirán a los conceptos obsoletos de impresiones, alcance y espectadores de vídeo.

¿Qué va a cambiar?

En junio de 2026 se retirarán las siguientes métricas para 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 o la 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*

Impresiones de vídeos

• 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

Impresiones de historias

• 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 su lugar, recomendamos usar las siguientes métricas:

• GET {page-id}/insights/page_total_media_view_unique
• GET {post-id}/insights/post_total_media_view_unique

En concreto, para los desgloses entre el alcance orgánico y el de pago, recomendamos usar las siguientes métricas, que proporcionan insights considerablemente similares:

• GET {page-id}/insights/page_media_view
• GET {post-id}/insights/post_media_view

API Graph: retirada de las métricas de espectadores de 3 segundos

En junio de 2026, tenemos previsto retirar las métricas de espectadores de 3 segundos. Estas métricas obsoletas ya no se muestran en nuestras herramientas de insights, pero seguían estando disponibles a través de la API Graph hasta ahora.

Para ajustar nuestros productos y API a un único marco de métricas coherente y mejorar la fiabilidad general del sistema, vamos a retirar estas métricas obsoletas. Tras su retirada, los desarrolladores deberán migrar a las nuevas métricas de visualizaciones de contenido multimedia y espectadores de contenido multimedia, que sustituirán a los conceptos obsoletos de impresiones, alcance y espectadores de vídeo.

¿Qué va a cambiar?

En junio de 2026 se retirarán las siguientes métricas para 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 su lugar, recomendamos usar las siguientes métricas:

• GET {page-id}/insights/page_total_media_view_unique
• GET {post-id}/insights/post_total_media_view_unique

En concreto, para los desgloses entre los espectadores de 3 segundos orgánicos y de pago, recomendamos usar las siguientes métricas, que proporcionan insights considerablemente similares:

• GET {page-id}/insights/page_media_view
• GET {post-id}/insights/post_media_view

API de marketing: retirada de las campañas de compras automatizadas y las campañas de aplicaciones automatizadas

La unificación de la automatización permite que las campañas de aplicaciones, ventas y clientes potenciales utilicen la configuración óptima de Advantage+ basada en la automatización de forma predeterminada y permite a anunciantes y partners un acceso simplificado a los productos de automatización más recientes y con mayor rendimiento de Meta. Estamos llevando a cabo una retirada por fases de las API obsoletas y una migración a la nueva configuración de unificación de la automatización de Advantage+ para desarrolladores de la API de marketing.

A partir de la versión 25.0 (18 de febrero de 2026), ya no se podrán crear ni actualizar campañas de compras automatizadas y campañas de aplicaciones automatizadas usando la API de marketing. Esta medida se ampliará a todas las versiones de la API de marketing 90 días después (antes del 19 de mayo de 2026).

En la versión 26.0 (con fecha prevista en septiembre de 2026), se pausarán todas las campañas de compras automatizadas y las campañas de aplicaciones automatizadas que queden.

Este tipo de campañas con límites de presupuesto para clientes actuales (ECBC) se podrán seguir editando hasta la versión 26.0. Esta función no está disponible para las campañas de Advantage+. Los desarrolladores con campañas con límites de presupuesto para clientes actuales deberán tomar medidas a través de uno de los siguientes métodos para replicarlas antes de la versión 26.0:

• Duplicación manual: abre una campaña de compras automatizadas o una campaña de aplicaciones automatizadas existente con límites de presupuesto para clientes actuales en el Administrador de anuncios y se te pedirá que dupliques la campaña. Con este paso de un solo clic se creará una campaña que replica la configuración de la campaña actual.
• Replica las campañas con límites de presupuesto para clientes actuales usando la API: sigue las indicaciones que se detallan en la documentación para desarrolladores para replicar las campañas usando la API aquí.
• Solicita la migración masiva de las cuentas publicitarias: en el caso de los socios administrados, podemos ofrecer una acción única para replicar todas las campañas con límites de presupuesto para clientes actuales en una fecha acordada. Dirígete a tu persona de contacto de Meta e indícale los identificadores de las cuentas y la fecha de migración preferida.

Nota: Ten en cuenta que todas las duplicaciones de campañas con límites de presupuesto para clientes actuales generarán un nuevo identificador de campaña.

Este cambio afecta a los extremos siguientes:

• POST /{campaign-id}
• POST /{campaign-id}/copies

Consulta 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

• Documentación para desarrolladores: experiencia de campañas de Advantage+ para ventas, aplicaciones y clientes potenciales

Enlace al artículo de ayuda sobre la función

• Servicio de ayuda: campañas de Advantage+
• Servicio de ayuda: categorías de anuncios especiales

Retiradas de versiones de la API:

Como parte de la programación del control de versiones de Facebook de la API Graph y la API de marketing, ten en cuenta las próximas retiradas:

API Graph

• 21 de mayo de 2026: la versión 19.0 de la API Graph se retirará y suprimirá de la plataforma.
• 24 de septiembre de 2026: la versión 20 de la API Graph se retirará y suprimirá de la plataforma.

Para evitar cualquier interrupción en las empresas, recomendamos migrar todas las llamadas a la versión de la API más reciente que lanzamos hoy.