Introducing Graph API v22.0 and Marketing API v22.0
Hoy lanzamos la versión 22.0 de la API Graph y la API de marketing Como parte de este lanzamiento, a continuación destacamos una serie de cambios que consideramos pertinentes para algunos miembros de nuestra comunidad de desarrolladores. Entre estos cambios se incluyen avisos, actualizaciones de productos y notificaciones de retiradas pertinentes sobre las integraciones de tus aplicaciones con nuestra plataforma.
Puedes consultar una lista completa de todos los cambios y los detalles correspondientes en nuestro registro de cambios.
Actualizaciones generales
La versión 22 de la API de marketing presenta cambios respecto al uso de audiencias personalizadas a partir de listas de clientes en campañas de anuncios sobre productos y servicios financieros (incluidos los créditos), empleo y vivienda
Se aplican a la versión 22.0 y versiones posteriores, y se implementarán en todas las versiones en marzo de 2025.
Ciertas audiencias personalizadas a partir de listas de clientes dejarán de estar disponibles para las campañas de anuncios sobre productos y servicios financieros (incluidos los créditos), empleo y vivienda Obtén más información sobre la actualización y descubre aquí si estas restricciones te afectan. Además, el campo is_sac_cfca_terms_certified se añadirá al conjunto de anuncios. Puedes ver un ejemplo de esto aquí. Deberás usar dicho campo para certificar que todas las audiencias personalizadas a partir de listas de clientes que se utilicen en conjuntos de anuncios de campañas sobre productos y servicios financieros (incluidos los créditos), empleo y vivienda cumplen con la certificación CLCA de Meta. A partir de principios de abril de 2025, las campañas o los conjuntos de anuncios existentes que utilicen audiencias personalizadas a partir de una lista de clientes que no cumplan los requisitos podrán ponerse en pausa. Si esto sucede, aparecerán errores en el Administrador de anuncios y la API de marketing con instrucciones.
Los siguientes extremos se verán afectados:
Versión 22 de la API de audiencia personalizada
A partir del 6 de enero de 2025, podrás usar el nuevo campo is_eligible_for_sac_campaigns para identificar si puedes utilizar una audiencia personalizada en los conjuntos de anuncios de las campañas de categorías de anuncios especiales. Tienes que proporcionar los valores previstos de special_ad_categories y special_ad_category_countries de la campaña de categoría de anuncio especial que vaya a utilizar la audiencia, así como el valor de ad_account_id que usará la audiencia para crear o editar el conjunto de anuncios.
Los siguientes extremos se verán afectados:
Llega a personas interesadas en las ciudades y regiones seleccionadas
Nos alegra anunciar el lanzamiento de una nueva función para segmentar por lugares que puede ayudar a los anunciantes a aumentar el rendimiento expandiéndose más allá de las ciudades o regiones de destino. De esta manera, el sistema de anuncios tendrá la flexibilidad necesaria para entregar tus anuncios a personas que hayan mostrado interés en un lugar concreto.
Esta característica amplía la función actual de segmentación por lugar, ya que te permite llegar a personas que hayan mostrado intención de viajar, realizar compras o un interés general en las ciudades y regiones que hayas seleccionado dentro de un mismo país.
Durante los tests, los clientes que usaron esta nueva función observaron una reducción del 6,7 % en el coste por resultado.
Para obtener más información, haz clic aquí.
Retiradas y cambios de última hora
Sustitución de los extremos “Instagram User”, “Instagram Media”, “Instagram Carousel” e “Instagram Comment” por “IG User”, “IG Media” e “IG Comment”
Estamos realizando cambios en la API Graph de Instagram y la API de marketing para que los desarrolladores puedan crear soluciones para las empresas con mayor facilidad. Estos cambios implican que vamos a dejar de usar los objetos “Instagram User”, “Instagram Media”, “Instagram Carousel” e “Instagram Comment” en la versión 22 de la API Graph y en su lugar vamos a implementar los siguientes objetos: IG User, IG Media (que incluye las secuencias) e IG Comment. Además, hemos añadido ciertas funcionalidades a estos nuevos objetos para garantizar la paridad en la mayoría de los casos de uso.
Los desarrolladores tienen hasta el 21 de enero de 2026 para actualizar el uso de los extremos afectados de la API de marketing y hasta el 21 de abril de 2025 para actualizar el uso de los extremos afectados de la API Graph. Si actualizas automáticamente tus versiones de la API Graph mediante las llamadas a la API, te recomendamos que revises estos cambios, puesto que se aplicarán inmediatamente a los desarrolladores que usen la versión 22.
Consulta el blog para desarrolladores si quieres obtener más detalles sobre esta novedad, que incluye los cambios en los extremos, qué casos de uso ya no están disponibles y qué plazos hemos determinado.
Supresión de las exclusiones de la segmentación detallada
Como parte de nuestros esfuerzos constantes por ayudar a los anunciantes a mejorar su rendimiento, vamos a suprimir las exclusiones de la segmentación detallada. Dentro de este proceso, seguiremos ofreciendo la opción de excluir a los empleados en los controles de audiencia de la cuenta. Para obtener más información sobre los controles de cuenta, accede aquí.
Creemos que este cambio va a contribuir a mejorar el rendimiento de las campañas. Un test dirigido a anunciantes demostró que el coste por conversión medio era un 22,6 % más bajo cuando no se utilizaban las exclusiones de segmentación detallada frente a cuando sí se hacía.
Como resultado de este cambio, las audiencias personalizadas quedarán obsoletas en el campo de exclusiones. Si quieres seguir usándolas, puedes usar el campo “excluded_custom_audiences” en su lugar.
A partir del 21 de enero de 2025, los desarrolladores podrán empezar a implementar cambios en el código y tendrán hasta el 21 de abril de 2025 para completar las actualizaciones. Este cambio se lanzará en la versión 22. Consulta el blog para desarrolladores si quieres acceder a la lista de extremos que se van a ver afectados por este cambio.
Retirada del paquete de mejoras estándar de la API de marketing
La versión 22.0 de la API de marketing afecta a las mejoras de contenido de Advantage+.
En esta nueva versión de la API de marketing, dejaremos de utilizar el paquete de mejoras estándar del contenido de Advantage+ y lo sustituiremos por mejoras de contenido que se pueden implementar individualmente. Aquí puedes obtener más información sobre el contenido de Advantage+.
Aquí puedes encontrar más información pertinente para la comunidad de desarrolladores y en la documentación para desarrolladores puedes obtener datos adicionales.
Las mejoras estándar dejarán de estar disponibles para estos extremos:
- POST /{ad_account_id}/adcreatives
- POST /{ad_account_id}/ads
- GET /{ad_id}/previews
Lanzamiento de la métrica “views” de Instagram y retirada de las métricas “impressions” y “plays”
Con el fin de continuar con el proceso de alinear las funcionalidades de la API de Instagram con las de la aplicación, vamos a introducir la métrica “views” en todas las versiones de la API para las insights de usuarios y contenido multimedia. Para las insights de contenido multimedia, los objetos “Feed”, “Story” y “Reels” devolverán las visualizaciones. Para las insights de usuarios, la API admitirá la métrica “views” con desgloses multidimensionales por tipo de seguidor y tipo de producto multimedia.
Además, las siguientes métricas estarán obsoletas en la versión 22:
- plays (insights de contenido multimedia): el número de veces que un reel empieza a reproducirse una vez que la impresión se ha contabilizado.
- clips_replays_count (insights de contenido multimedia): el número de veces que tu reel empieza a reproducirse de nuevo tras una primera reproducción del reel. La métrica se define como las reproducciones de 1 ms o más en la misma sesión del reel.
- ig_reels_aggregated_all_plays_count (insights de contenido multimedia): el número de veces que tu reel empieza a reproducirse o se reproduce de nuevo una vez que la impresión se ha contabilizado.
- impressions (insights de contenido multimedia y de usuario): el número de veces que se ha visto el objeto “Instagram Media”.
La métrica “impressions” de las insights de contenido multimedia solo quedará obsoleta para el contenido creado el 2 de julio de 2024 o fechas posteriores. Para el contenido multimedia creado antes de esa fecha, la API seguirá devolviendo los valores habituales en todas las versiones.
Puedes obtener más información en nuestra documentación para desarrolladores sobre las insights de usuarios de Instagram e insights de contenido multimedia de Instagram. Te recomendamos que animes a tus desarrolladores a que lleven a cabo las actualizaciones antes del 21 de abril de 2025 para evitar problemas.
Meta Business SDK
Lanzamiento de la versión 22 del Meta Business SDK
El lanzamiento de la versión 22 del Meta Business SDK se efectuará poco después del lanzamiento de la versión 22 de la API Graph. Esta versión incluirá la corrección de errores, mejoras de dependencias, nuevas funciones y, lo más importante, una interfaz de API actualizada para corresponderse con la versión 22 de la API Graph.
Como parte de nuestra programación de retiradas en dos años de los SDK de la plataforma, ten en cuenta las próximas retiradas y desapariciones:
- Mayo de 2025: la versión 17.0 y las versiones anteriores del SDK de la plataforma de Facebook dejarán de estar disponibles.
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
- 14 de mayo de 2025: la versión 16.0 de la API Graph se retirará y se suprimirá de la plataforma.
- 12 de septiembre de 2025: la versión 17.0 de la API Graph se retirará y se suprimirá de la plataforma.
API de marketing
- 4 de febrero de 2025: la versión 19.0 de la API de marketing se retirará y se suprimirá de la plataforma.
- 6 de mayo de 2025: la versión 20.0 de la API de marketing se retirará y se 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.
Actualizaciones de la API de insights de página
