Introducing Graph API v22.0 and Marketing API v22.0

Hoy lanzamos la versión 22.0 de la API Graph y de la API de marketing. Como parte de este lanzamiento, a continuación, destacaremos los cambios que consideramos relevantes para nuestra comunidad de desarrolladores. Entre estos cambios, se incluyen avisos, actualizaciones de productos y notificaciones de elementos obsoletos relevantes para la integración de tus aplicaciones con nuestra plataforma.

Para obtener una lista completa de todos los cambios y los detalles correspondientes, consulta el registro de cambios.

Actualizaciones generales

La versión 22 de la API de marketing modifica el uso de públicos personalizados a partir de una lista de clientes en campañas sobre vivienda, empleo y productos y servicios financieros (incluido crédito)

Se aplica a la "versión 22.0 o versiones posteriores" y se implementará en todas las versiones en marzo de 2025.

Ya no podrán utilizarse determinados públicos personalizados creados a partir de una lista de clientes en las campañas de vivienda, empleo y productos y servicios financieros (incluidas las de crédito). Obtén más información sobre la actualización y si las restricciones se aplican a tu caso aquí. Además, el campo is_sac_cfca_terms_certified se incluirá en el nivel del conjunto de anuncios. Consulta este ejemplo. Deberás usar este campo para certificar que el público personalizado creado a partir de una lista de clientes que se esté utilizando en un conjunto de anuncios de campañas de viviendas, empleo y productos y servicios financieros (incluidos los créditos) cumple con la certificación CLCA de Meta. A partir de principios de abril de 2025, las campañas o conjuntos de anuncios activos que utilicen públicos personalizados creados a partir de listas de clientes que no cumplan con los requisitos podrían ser pausados. En ese caso, verás errores en el administrador de anuncios y las API de marketing con instrucciones.

Los siguientes puntos de conexión se verán afectados:

• POST /{ad-account-id}/adsets
• POST /{ad_set_id}

Versión 22 de la API de públicos personalizados

A partir del 6 de enero de 2025, puedes usar el nuevo campo is_eligible_for_sac_campaigns para identificar si un público personalizado puede usarse en conjuntos de anuncios de campañas de categorías de anuncios especiales. Para ello, deberás proporcionar los parámetros special_ad_categories y special_ad_category_countries correspondientes a la campaña de categoría de anuncio especial, junto con el campo ad_account_id asociado al público, ya sea para crear o editar el conjunto de anuncios.

Los siguientes puntos de conexión se verán afectados:

• GET /custom_audience_id

Llegar a las personas interesadas en las ciudades y regiones seleccionadas

Nos complace compartir el lanzamiento de una nueva función de segmentación por lugar que ayuda a los anunciantes a mejorar el rendimiento ampliando la entrega de los anuncios más allá de las ciudades o regiones definidas en la segmentación, lo que brinda a nuestro sistema la flexibilidad de entregar los anuncios a las personas que mostraron interés en un lugar determinado.

Esta función amplía nuestra función actual de segmentación por lugar, ya que te permite llegar a personas que mostraron la intención de viajar a las ciudades o regiones definidas en la segmentación (dentro del mismo país) o hacer compras allí, o que manifestaron un interés general en ellas.

Durante las pruebas, los clientes que usaron la nueva función de segmentación por lugar registraron una disminución del 6,7% del costo por resultado.

Para obtener más información, haz clic aquí.

Elementos obsoletos y cambios radicales

Reemplazo de los puntos de conexión Usuario de Instagram, Contenido multimedia de Instagram, Secuencia de Instagram y Comentario de Instagram por Usuario de IG, Contenido multimedia de IG y Comentario de IG.

Realizaremos cambios en la API Graph de Instagram y en la API de marketing para que los desarrolladores puedan crear soluciones para las empresas con mayor facilidad. Con estos cambios, los objetos Usuario de Instagram, Contenido multimedia de Instagram, Secuencia de Instagram y Comentario de Instagram quedarán obsoletos en la versión 22 de la API Graph y se sustituirán por los objetos Usuario de IG, Contenido multimedia de IG, que incluye secuencias, y Comentario de IG. También agregamos funciones a estos nuevos objetos para que sean compatibles con la mayoría de los casos de uso.

Los desarrolladores tendrán hasta el 21 de enero de 2026 para actualizar el uso de los puntos de conexión afectados de la API de marketing y hasta el 21 de abril de 2025 para actualizar el uso de los puntos de conexión afectados de la API Graph. Si actualizas automáticamente las versiones de la API Graph en tus llamadas a la API, te recomendamos que revises estos cambios, ya que se aplicarán inmediatamente a los desarrolladores que utilicen la versión 22 de la API Graph.

Consulta el blog para desarrolladores para obtener más información sobre este cambio, incluidos los puntos de conexión que cambiarán, los casos de uso que dejan de ser compatibles y los plazos aplicables.

Eliminación de las exclusiones de la segmentación detallada

Como parte de nuestras iniciativas continuas para ayudar a los anunciantes a obtener mejores resultados, eliminaremos las exclusiones de la segmentación detallada. Asimismo, seguiremos permitiendo excluir a tus empleadores de los controles del público en el nivel de la cuenta. Encuentra aquí más información sobre los controles de cuenta.

Consideramos que este cambio ayudará a mejorar el rendimiento de las campañas. En una prueba realizada con anunciantes se demostró que la mediana del costo por conversión al no usar las exclusiones de la segmentación detallada fue un 22,6% menor que la que ofrece el uso de las exclusiones de la segmentación detallada.

Como resultado de este cambio, los públicos personalizados quedarán obsoletos en el campo de exclusiones. En su lugar, puedes seguir utilizando exclusiones de públicos personalizados con el campo excluded_custom_audiences.

A partir del 21 de enero de 2025, los desarrolladores pueden empezar a implementar los cambios de código, y tendrán hasta el 21 de abril de 2025 para implementar estas actualizaciones. Este cambio se lanzará en la versión 22. Consulta el blog para desarrolladores para obtener una lista de los puntos de conexión afectados en relación con este cambio.

Eliminación del paquete de mejoras estándar de la API de marketing

Efectos de la versión 22.0 de la API de marketing en las mejoras de contenido Advantage+

En esta nueva versión de la API de marketing, eliminaremos el paquete de mejoras estándar de contenido Advantage+ y lo sustituiremos por la opción de activar mejoras de contenido individuales. Puedes obtener más información sobre el contenido Advantage+ aquí.

Obtén más información relevante para la comunidad de desarrolladores aquí y obtén detalles adicionales en nuestra documentación para desarrolladores aquí.

Las mejoras estándar dejarán de ser compatibles con estos puntos de conexión:

• POST /{ad_account_id}/adcreatives
• POST /{ad_account_id}/ads
• GET /{ad_id}/previews

Presentación de la métrica de visualizaciones de Instagram y eliminación de las métricas de impresiones y reproducciones

Para alinear mejor la funcionalidad de la API de Instagram con la app, incorporamos la métrica "views" en todas las versiones de la API, tanto para las estadísticas de contenido multimedia como para las de usuario. En las estadísticas de contenido multimedia, los objetos de feed, historias y reels devolverán la métrica de visualizaciones. En las estadísticas de usuario, la API admitirá la métrica "views" con desgloses multidimensionales por tipo de seguidor y tipo de producto de contenido multimedia.

Además, las siguientes métricas quedarán obsoletas a partir de la versión 22:

• plays (estadísticas de contenido multimedia): número de veces que el reel se empieza a reproducir después de que ya se contó una impresión.
• clips_replays_count (estadísticas de contenido multimedia): número de veces que tu reel comienza a reproducirse de nuevo después de la primera reproducción. Esto se define como repeticiones de 1 ms o más en la misma sesión de reels.
• ig_reels_aggregated_all_plays_count (estadísticas de contenido multimedia): número de veces que tu reel comienza a reproducirse o lo ven de nuevo después de que ya se contabilizó una impresión.
• impressions (estadísticas de usuario y contenido multimedia): número total de veces que se vio el objeto de contenido multimedia de Instagram.

La métrica "impressions" en las estadísticas de contenido se eliminará solo para los contenidos creados a partir del 2 de julio de 2024. En el caso del contenido multimedia creado antes de esta fecha, la API seguirá devolviendo los valores habituales en todas las versiones.

Puedes encontrar más información en nuestra documentación para desarrolladores sobre las estadísticas de usuario de Instagram y las estadísticas de contenido multimedia de Instagram. Motiva a tus desarrolladores a realizar las actualizaciones antes del 21 de abril de 2025 para evitar inconvenientes.

SDK de Meta para empresas

Lanzamiento de la versión 22 del SDK de Meta para empresas

La versión 22 del SDK de Meta para empresas se publicará poco después de la versión 22 de la API Graph. Esta versión incluirá correcciones de errores, actualizaciones de dependencias, nuevas funciones y, lo más importante, una interfaz de API actualizada para alinearse con la versión 22 de la API Graph.

Como parte de nuestro calendario de obsolescencias de 2 años correspondiente a los SDK de la plataforma, ten en cuenta los próximos elementos que quedarán obsoletos y las próximas desactivaciones:

• Mayo de 2025: se eliminará la versión 17.0 y las versiones anteriores del SDK de la plataforma de Facebook.

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 14 de mayo de 2025, quedará obsoleta la versión 16 de la API Graph y se la eliminará de la plataforma
• El 12 de septiembre de 2025, quedará obsoleta la versión 17 de la API Graph y se la eliminará de la plataforma

API de marketing

• El 4 de febrero de 2025, quedará obsoleta la versión 19.0 de la API de marketing y se la eliminará de la plataforma
• El 6 de mayo de 2025, quedará obsoleta la versión 20.0 de la API de marketing 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.