Introducing Graph API v20.0 and Marketing API v20.0

Hoy lanzamos la versión 20.0 de la API Graph y de la API de marketing de Facebook. 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

Actualización automática de la versión de la API de marketing

Para mejorar la experiencia general con la API al hacerla más sencilla y eficiente, nos entusiasma anunciar el próximo lanzamiento de la función de actualización automática de la versión de la API de marketing. A partir de hoy, activaremos la función de actualización automática de la versión en los puntos de conexión de la API de marketing que no se ven afectados entre versiones. Esto significa que, entre una versión que va a quedar obsoleta y la siguiente versión disponible, si un punto de conexión no se ve afectado, la plataforma actualizará la llamada a la siguiente versión disponible de manera automática, en lugar de rechazar directamente la solicitud.

Para obtener más información sobre el comportamiento, consulta Versiones de la API de marketing y el blog de lanzamiento.

Para comprobar los puntos de conexión afectados en cada versión, consulta el registro de cambios.

Sigue leyendo para conocer las actualizaciones más específicas de la versión 20.0.

Anuncios con recordatorio de la API de marketing

Antes del 13 de mayo de 2024, los desarrolladores no podían admitir la creación de anuncios con recordatorio de Instagram a través de la API de marketing de Instagram, y sus clientes solo podían crear este tipo de anuncios en el administrador de anuncios de Meta. Esta incompatibilidad generaba una fricción no deseada entre nuestros socios y sus clientes que querían publicar anuncios con recordatorio.

Después de recibir comentarios constantes sobre esta incompatibilidad, a partir del 13 de mayo de 2024, admitimos la creación de anuncios con recordatorio a través de la API de marketing.

Agradecemos los comentarios recibidos de nuestra comunidad de desarrolladores y sus clientes, y esperamos poder seguir mejorando la experiencia de los anuncios con recordatorio disponible a través de la API de marketing.

Información sobre los anuncios con recordatorio de Instagram

Los anuncios con recordatorio de Instagram ayudan a los anunciantes a salvar la distancia entre la promoción y la fecha de lanzamiento de los productos invitando a las personas interesadas a programar recordatorios. Si activan la función, recibirán recordatorios en momentos clave antes del evento.

Información sobre la creación y edición de eventos

Los anuncios con recordatorio de Instagram utilizan la fecha y hora de inicio del evento para determinar cuándo se entregarán los recordatorios. Este cambio les permite a los desarrolladores crear y editar eventos en la API Graph de Instagram. Puedes crear anuncios con recordatorio a través de la API de marketing de Instagram después de adjuntar los eventos al contenido del anuncio.

Nueva API en el nodo de la cuenta publicitaria

La nueva actualización del nodo de la cuenta publicitaria no es un cambio radical, sino la incorporación de una API. Al activarla, se mostrará una lista de todas las campañas de dicha cuenta publicitaria que tienen recomendaciones, junto con las recomendaciones y la mejora del costo por acción (CPA) prevista.

La nueva API les permitirá a los anunciantes ver las recomendaciones de Meta en relación con sus campañas. Estos datos ya existen en el centro de socios, donde están disponibles para todos los socios. Sin embargo, es posible acceder a ellos a través de la UI. Para ver las recomendaciones, es necesario seleccionar manualmente una sola cuenta publicitaria.

Al automatizar el acceso a estos datos a través de la API CPA_GUIDANCE, esperamos eliminar el trabajo manual necesario para consultar las recomendaciones de cada cuenta publicitaria por separado. El acceso a esta API les permitirá a nuestros socios crear vistas personalizadas internamente y ver las tendencias en el tiempo.

Si tu negocio administra cientos o miles de cuentas, será difícil verificar las métricas una por una, en especial cuando existan limitaciones de tiempo (las recomendaciones de RSS se actualizan todos los días y contemplan campañas activas de los últimos 28 días). Esta API les permitirá a las agencias identificar las campañas más prometedoras que pueden optimizarse por medio de las recomendaciones provistas, las cuales posteriormente se incorporarán a sus sistemas.

La API CPA_GUIDANCE habilita específicamente a las agencias a brindar recomendaciones a sus socios de marca respecto de qué productos o categorías tienen el mayor costo por captación (CPA). Al compartir esta información, las agencias pueden ayudar a sus socios de marca a optimizar su gasto publicitario y mejorar el rendimiento general de sus campañas colaborativas.

Las agencias también podrán hacer un seguimiento de las recomendaciones que se implementaron y las que no si observan una tendencia positiva del CPA.

Anuncios multianunciante

Hoy queremos informar que los anunciantes tendrán la posibilidad de activar la creación de anuncios multianunciante a través de la API de marketing. Antes de esta actualización, los desarrolladores no podían admitir la creación de anuncios multianunciante a través de la API, y sus clientes solo podían crear este tipo de anuncios en el administrador de anuncios de Meta.

Información sobre los anuncios multianunciante

Los anuncios multianunciante pueden ayudar a las personas a descubrir productos y servicios de varias empresas. En algunas ubicaciones en Facebook e Instagram, los anuncios pueden aparecer junto a otros en el mismo bloque de anuncios para ayudar a las personas a descubrir productos y servicios de empresas que sean personalizados para ellas. Un bloque de anuncios es un contenedor que muestra varios anuncios, generalmente en la misma página. Obtén más información en el servicio de ayuda para empresas.

Implicaciones para los desarrolladores

Al momento del lanzamiento, la entrega de anuncios multianunciante creados a través de la API de marketing está desactivada de forma predeterminada, lo que significa que los desarrolladores deberán implementar cambios en el código para que los anuncios de sus clientes puedan incluirse en la experiencia. La creación de anuncios multianunciante es compatible con todas las versiones de la API de marketing, pero todas las solicitudes de creación de anuncios que sean aptas para anuncios multianunciante deberán especificar si el anuncio acepta o no su uso. El 19 de agosto de 2024, los anuncios multianunciante comenzarán a estar activados de manera predeterminada y los desarrolladores que todavía no hayan implementado los cambios en el código correspondientes deberán hacerlo para brindarles a sus clientes la posibilidad de no participar en la experiencia.

Funciones de contenido con tecnología de IA generativa próximamente disponibles a través de la API de marketing: generación de texto, ampliación de imágenes y generación de fondos

En octubre de 2023, anunciamos el lanzamiento de nuestras primeras funciones publicitarias de contenido con tecnología de IA generativa: la generación de texto, la ampliación de imágenes y la generación de fondos dirigido a las empresas en el administrador de anuncios. Hoy queremos informarte que pondremos estas funciones de contenido con tecnología de IA generativa a disposición de los anunciantes a través de nuestra API de marketing (MAPI), de modo que los socios, las agencias y los anunciantes también puedan aprovechar la oferta de IA generativa de Meta a través de la MAPI.

Estas funciones permiten la generación de variaciones de contenido de manera rápida y automática, lo que abre la puerta a una nueva era de creatividad que maximiza la productividad, la personalización y el rendimiento de todos los anunciantes:

• Generación de fondos: permite crear hasta cuatro fondos para complementar imágenes de productos, lo que posibilita la diversificación del contenido en función de tus públicos. Los fondos generados estarán basados en las imágenes originales de tus productos y, por lo general, serán fondos simples con colores y patrones.

• Ampliación de imágenes: permite ajustar el tamaño de los activos de contenido de imagen para adaptarlo a las diferentes relaciones de aspecto en distintas plataformas. Esta función pronto estará disponible en Reels, lo que te permitirá destinar menos tiempo y recursos a la reutilización de activos de contenido.

• Generación de texto: permite generar varias versiones del texto de un anuncio a partir de tu texto original, destacando los argumentos de venta de los productos y servicios y generando varias opciones de texto para diversificar tus anuncios en función de tus públicos.

Hoy ponemos estas funciones a disposición de más anunciantes y es para nosotros un placer compartir con un público más amplio el poder de nuestra IA generativa.

En consonancia con nuestro enfoque para probar productos nuevos que pueden estar sujetos a un mayor escrutinio, es posible que ciertos sectores no tengan acceso inmediato a todas las funciones de la IA generativa. Estos sectores incluyen, entre otros, los de servicios financieros, farmacia y salud, y los anuncios de viviendas, empleo o servicios financieros y de crédito, además de los anuncios sobre temas sociales, elecciones y política.

¿Cómo funcionará?

A partir de hoy, se admitirán estas funciones como parte de nuestra API de marketing, más específicamente las API de contenido del anuncio. Los anunciantes tendrán la posibilidad de activar estas funciones y de obtener una vista previa del contenido creado con IA generativa desde la API.

En el siguiente ejemplo, se muestra cómo activar las funciones de IA generativa para usarlas con el contenido de tus anuncios en la API de marketing.

          curl -X POST \
          -F 'name=Generative AI Creative' \
          -F 'object_story_spec={
          ...
          }' \
          -F 'degrees_of_freedom_spec={
          "creative_features_spec": {
          "image_background_gen": {
          "enroll_status": "OPT_IN"
          }
          }
          }' \
          -F 'access_token=<ACCESS_TOKEN>'\
          https://graph.facebook.com/<GRAPH_API_VERSION>/act_<AD_ACCOUNT_ID>/adcreatives
        

Nota: en el ejemplo anterior, se muestra la activación de la función de generación de fondos. De igual manera, para activar la función de ampliación de imágenes, usa la clave image_uncrop y, para activar la función de generación de texto, usa la clave text_generation en creative_features_spec.

Los anunciantes también podrán obtener una vista previa del contenido transformado con IA generativa a través de la API. Visita el enlace a la documentación para desarrolladores y obtén más información sobre cómo generar contenido, proporcionar el contenido del anuncio y obtener una vista previa del contenido generado en cada una de nuestras funciones de IA generativa.

API de video de Instagram: subida reanudable en la API de video de Instagram

Desde el 15 de mayo de 2024, el nuevo "protocolo de subida reanudable" admite la publicación de videos de Instagram (Reels, historias con video y secuencias de video), videos tanto locales como de URL de servicios de hosting públicos. Este nuevo protocolo permite la subida de archivos locales, la subida de archivos más largos solo en el caso de Reels (con una duración hasta 15 minutos) y la reanudación de una operación de subida tras una interrupción de la red u otro fallo de transmisión.

Anteriormente, para crear videos de Instagram, los archivos de video tenían que subirse a un servicio de hosting de acceso público, donde se obtenía una URL para compartir que se proporcionaba a Meta a fin de publicar el video.

Para conocer los detalles del proceso mejorado de publicación de contenido, consulta la documentación para desarrolladores sobre publicación de contenido. Para obtener más información sobre el contenido multimedia de Instagram, visita este enlace.

API Graph de Instagram: incorporación de nuevas métricas

Hoy se incorporarán a la API Graph seis métricas adicionales de contenido multimedia del contenedor de secuencia. Estas métricas son Me gusta, Comentarios, Veces que se compartió, Seguidores, Actividad del perfil (es decir, la cantidad de acciones realizadas cuando un usuario visita tu perfil) y Visitas al perfil (es decir, la cantidad de veces que se visitó tu perfil). Si bien estas métricas ya estaban disponibles en la página de estadísticas de Instagram, esta nueva incorporación permitirá acceder a ellas también a través de la API Graph.

Al agregarse Me gusta, Comentarios, Veces que se compartió, Seguidores, Actividad del perfil y Visitas al perfil a los puntos de conexión de la API Graph de las publicaciones por secuencia, podrás leer estas métricas directamente desde la llamada a la API.

Si deseas consultar la lista completa de métricas, visita este enlace para agregar las métricas relevantes a tu llamada de la API GET de las publicaciones del contenedor de secuencia.

Modificación de la fecha de retirada la API de conversiones offline (OCAPI) de Meta

El año pasado, anunciamos que la versión 17 de la API de conversiones offline dejaría de admitir eventos offline y que estaba previsto discontinuar dicha API en el tercer trimestre de 2024. Posteriormente, esa fecha de retirada prevista se modificó y, en el día de hoy, queremos confirmar que la API de conversiones offline (OCAPI) dejará de estar disponible en mayo de 2025. Si bien la fecha de retirada de la OCAPI se aplazó del tercer trimestre de 2024 a mayo de 2025, reiteramos nuestra recomendación a los anunciantes que actualmente envían eventos offline a través de la API de conversiones offline (OCAPI) de planificar la migración de su configuración actual para empezar a enviar los eventos offline a través de la API de conversiones (CAPI para eventos offline).

Elementos obsoletos y cambios radicales

Eliminación del botón "Reservar" en Messenger API

A partir de este momento, el botón "Reservar" dejará de ser compatible con las llamadas a Messenger API. Este cambio no afecta otras plantillas ni botones, y las empresas podrán seguir administrando las reservas con Meta Business Suite.

Eliminación de la creación del tipo de anuncio "Mensajes publicitarios" en la API de marketing

A partir de hoy, la creación del tipo de anuncio "Mensajes publicitarios" dejará de estar disponible en la versión 20.0 de la API de marketing y la compatibilidad de la creación de anuncios con este tipo de anuncio de las versiones anteriores de la API llegará a su fin en un plazo de 90 días. Este cambio no afectará otros tipos de anuncios de mensajes.

Recomendamos revisar las integraciones actuales y ajustar las apps según sea necesario a fin de asegurar una transición fluida para los usuarios.

Eliminación de plazos no críticos de las métricas demográficas de las estadísticas (a través de la API Graph de Instagram externa)

El 21 de mayo de 2024, lanzamos nuestra versión 20 de la API Graph de Instagram.

Noventa días después de este lanzamiento (el 19 de agosto de 2024), la API Graph dejará de compartir métricas demográficas sobre los miembros del público alcanzados o con quienes hubo una interacción dentro de plazos no críticos en la API Graph de Instagram (por ejemplo, información sobre la distribución de países, ciudades, edades y géneros durante los últimos 14 y 90 días).

La API Graph de Instagram seguirá enviando información demográfica del mes anterior ("this_month") y de la semana anterior ("this_week"), similar a la de la app de Instagram, con el fin de garantizar la coherencia en las distintas plataformas.

Esta nueva actualización evita confusiones y aumenta la confiabilidad y calidad de nuestros informes.

Consulta la documentación para desarrolladores para obtener más información.

Versiones de la API obsoletas:

Como parte del calendario de versiones de Facebook correspondiente a la Graph API y la API de marketing, ten en cuenta los próximos elementos que quedarán obsoletos:

API Graph

• El 28 de mayo de 2024, quedará obsoleta la versión 13.0 de la API Graph y se la eliminará de la plataforma.

• El 17 de septiembre de 2024, quedará obsoleta la versión 14.0 de la API Graph y se la eliminará de la plataforma.

• El 20 de noviembre de 2024, quedará obsoleta la versión 15.0 de la API Graph y se la eliminará de la plataforma.

API de marketing

• El 13 de agosto de 2024, quedará obsoleta la versión 18.0 de la API de marketing y se la eliminará de la plataforma.

• 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.

Para evitar interrupciones en tu negocio, te recomendamos que migres todas las llamadas a la última versión de la API que lanzamos hoy.

SDK de Meta para empresas

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

La versión 20 del SDK de Meta para empresas se publicará poco después de la versión 20 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 20 de la API Graph.

En esta versión, también incorporaremos una mayor compatibilidad con las API de Instagram. Estas son IGMediaForIGOnlyAPI, IGUserForIGOnlyAPI, IGRefreshAccessTokenForIGOnlyAPI y IGAccessTokenForIGOnlyAPI. Habilitan más métodos, además de las API de Instagram actuales, que te permiten recuperar contenido multimedia de manera directa. Nuestro objetivo es incorporar más API que cubran los productos de Meta a fin de enriquecer el ecosistema del SDK para empresas.

Como parte de nuestro calendario de retiro 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:

• En mayo de 2024, quedarán obsoletas las versiones 13.0 o anteriores del SDK de la plataforma de Facebook.