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

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

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

Para mejorar la experiencia general de la API y hacer que sea más fluida y eficiente, nos complace 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 para los extremos de la API de marketing que no se vean afectados entre versiones. Esto significa que, si un extremo no se ve afectado entre una versión que se va a retirar y la siguiente versión disponible, la plataforma actualizará automáticamente la llamada a la siguiente versión disponible en lugar de generar un error de solicitud directamente.

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

Para saber qué extremos se ven afectados en cada versión, consulta el registro de cambios.

Si quieres saber más novedades sobre la versión 20.0, sigue leyendo.

Anuncios-recordatorio mediante la API de marketing

Antes del 13 de mayo de 2024, los desarrolladores no admitían la creación de anuncios-recordatorio de Instagram mediante la API de marketing de la plataforma, por lo que sus clientes solo podían crearlos en el Administrador de anuncios de Meta. Esta falta de compatibilidad provocaba complicaciones no deseadas para nuestros partners y los clientes que querían publicar este tipo de anuncios.

Tras recibir constantes comentarios sobre esta incompatibilidad, a partir del 13 de mayo de 2024 ya admitimos la creación de anuncios-recordatorio mediante la API de marketing de Instagram.

Agradecemos los comentarios que hemos recibido de nuestra comunidad de desarrolladores y sus clientes, y esperamos seguir mejorando la experiencia de anuncios-recordatorio disponible mediante la API de marketing.

Información sobre los anuncios-recordatorio de Instagram

Los anuncios-recordatorio de Instagram permiten a los anunciantes reducir la brecha entre el periodo promocional y el momento del lanzamiento al animar a la gente interesada a programar recordatorios. De esta forma, la gente recibirá recordatorios en el momento más importante antes del evento.

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

Los anuncios-recordatorio de Instagram utilizan la fecha y hora del inicio del evento para determinar cuándo entregar los recordatorios. Este cambio permite a los desarrolladores crear y editar eventos en la API Graph de Instagram. Puedes crear un anuncio-recordatorio mediante la API de marketing de Instagram tras adjuntar eventos a su contenido.

Nueva API en el nodo de cuenta publicitaria

La nueva actualización del nodo de cuenta publicitaria no es un cambio importante, sino la adición de una API. Al llamarlo, se indican todas las campañas de dicha cuenta publicitaria que tienen recomendaciones de asesoramiento, además de la expectativa de mejora y el asesoramiento con respecto al coste por acción.

La nueva API permitirá a los anunciantes consultar el asesoramiento de Meta para sus campañas. Estos datos ya están disponibles en el Partner Center para todos los partners. Sin embargo, para consultarlos, la IU obliga a seleccionar manualmente una única cuenta publicitaria.

Al automatizar el acceso a estos datos mediante la API CPA_GUIDANCE, esperamos eliminar el trabajo manual necesario para consultar el asesoramiento por cuenta publicitaria. En el caso de nuestros partners, el acceso a esta API les permitirá crear vistas personalizadas de manera interna y consultar las tendencias a lo largo del tiempo.

Si tu empresa administra cientos o miles de cuentas, es difícil consultar métricas sobre ellas una por una, sobre todo si dependen del momento temporal (las recomendaciones de RSS se actualizan cada día y tienen en cuenta las campañas activas en los últimos 28 días). La API permitirá a las agencias identificar las campañas más prometedoras que puedan optimizarse con las recomendaciones proporcionadas, las cuales se incorporarán a sus sistemas posteriormente.

En concreto, la API CPA_GUIDANCE permite a las agencias proporcionar asesoramiento a sus partners de marca sobre qué productos o categorías tienen el coste por captación más elevado. Al compartir esta información, las agencias pueden ayudar a sus partners de marca a optimizar su gasto publicitario y a mejorar el rendimiento de sus campañas colaborativas en general.

Las agencias también podrán hacer un seguimiento para comprobar si se han aplicado las recomendaciones de asesoramiento observando si el CPA tiene una tendencia de mejora.

Anuncios multianunciante

A partir de hoy, los anunciantes podrán activar los anuncios multianunciante mediante la API de marketing. Antes de esta actualización, los desarrolladores no admitían la creación de anuncios multianunciante mediante la API, por lo que sus clientes solo podían activarlos en el Administrador de anuncios de Meta.

Información sobre los anuncios multianunciante

Los anuncios multianunciante ayudan a la gente a descubrir productos y servicios de diferentes empresas. En ciertas ubicaciones en Facebook e Instagram, los anuncios pueden aparecer junto a otros anuncios del mismo bloque para ayudar a la gente a descubrir productos y servicios de empresas personalizados. 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.

Qué significa para los desarrolladores

En el momento del lanzamiento, la entrega de los anuncios multianunciante creados mediante la API de marketing estará desactivada de forma predeterminada, por lo que los desarrolladores tendrán que implementar cambios en el código para que los anuncios de sus clientes puedan entregarse en la experiencia. La creación de anuncios multianunciante se admite en 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 activa su uso o no. A partir del 19 de agosto de 2024, los anuncios multianunciante estarán activados de forma predeterminada y los desarrolladores que todavía no hayan implementado cambios en el código deberán hacerlo para que sus clientes puedan desactivar la experiencia.

Funciones de contenido con IA generativa próximamente en la API de marketing: generación de texto, expansió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 (generación de texto, expansión de imágenes y generación de fondos) para empresas en el Administrador de anuncios. Hoy queríamos informarte de que vamos a habilitar estas funciones de contenido con IA generativa para los anunciantes mediante nuestra API de marketing, de forma que los partners, las agencias y los anunciantes también puedan sacar partido de los servicios de IA generativa de Meta mediante la API de marketing.

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

• Generación de fondos: crea hasta cuatro fondos para complementar las imágenes de productos, lo que permite diversificar el contenido para tus audiencias. Los fondos se generarán según las imágenes originales de tus productos y suelen ser sencillos, con colores y patrones.

• Expansión de imágenes: ajusta de manera sencilla las piezas de contenido de imagen para adaptarlas a las diferentes relaciones de aspecto de cada superficie, lo que te permitirá invertir menos tiempo y recursos en reutilizar piezas de contenido. Esta función se podrá empezar a utilizar en el feed y, próximamente, se ampliará a Reels.

• Generación de texto: genera varias versiones del texto del anuncio a partir del texto original. Se destacan los argumentos principales para la venta de los productos y servicios y se generan diferentes opciones de texto para diversificar los anuncios de cara a las audiencias.

Hoy vamos a habilitar estas funciones para un mayor número de anunciantes. Nos complace ofrecer el poder de nuestra IA generativa a una audiencia más amplia.

En consonancia con nuestra postura respecto a la prueba de nuevos productos que puedan estar sujetos a un escrutinio adicional, algunos sectores de la industria, como el de servicios financieros y empresas farmacéuticas/de salud, y los anuncios sobre oportunidades de vivienda, empleo y créditos, o temas relacionados con cuestiones sociales, elecciones o política, podrían no tener un acceso inmediato a todas las funciones de la IA generativa.

¿Cómo funcionará?

A partir de hoy, podrán utilizarse estas funciones como parte de nuestra API de marketing, más concretamente, las API de contenido publicitario. Los anunciantes podrán activar el uso de estas funciones, así como obtener una vista previa de las piezas de contenido de IA generativa desde la API.

El siguiente ejemplo muestra cómo activar las funciones de IA generativa en la API de marketing para el contenido de tu anuncio.

          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: El ejemplo anterior muestra cómo activar la función Generación de fondos. De manera similar, para la expansión de imágenes, utiliza la clave image_uncrop y, para la generación de texto, utiliza la clave text_generation en creative_features_spec.

Los anunciantes también podrán obtener una vista previa de las piezas de contenido transformadas por la IA generativa mediante la API. Accede al enlace de documentación para desarrolladores para obtener más información sobre cómo generar, proporcionar el contenido del anuncio y obtener una vista previa del contenido generado con cada una de nuestras funciones de IA generativa.

API de vídeo de Instagram: subida reanudable para la API de vídeo de Instagram

A partir del 15 de mayo de 2024, el nuevo “protocolo de subida reanudable” admitirá la publicación de vídeos de Instagram (es decir, reels, historias de vídeo y secuencias de vídeo) tanto desde vídeos locales como desde vídeos con URL alojadas públicamente. Este nuevo protocolo permite subir archivos locales y vídeos más largos solo para Reels (hasta 15 minutos), y reanudar una operación de subida después de una interrupción de red u otro error de transmisión.

Anteriormente, para crear vídeos de Instagram, los archivos de vídeo tenían que subirse a un servicio de alojamiento accesible públicamente, donde se obtenía una URL que se podía compartir y que se proporcionaba a Meta para poder publicar el vídeo.

Puedes consultar los detalles del proceso de publicación de contenido mejorado en la documentación para desarrolladores sobre la publicación de contenido. Asimismo, aquí encontrarás información adicional sobre el contenido multimedia de Instagram.

API Graph de Instagram: incorporamos nuevas métricas

A partir de hoy, habrá seis métricas adicionales para el contenido multimedia del contenedor de secuencia, disponibles mediante la API Graph: Me gusta, comentarios, veces que se ha compartido, nuevos seguidores, actividad del perfil (es decir, el número de acciones realizadas cuando un usuario visita tu perfil) y visitas al perfil (es decir, el número de veces que se ha visitado tu perfil). Estas métricas ya estaban disponibles en la página de insights de Instagram, pero ahora podrán consultarse también mediante la API Graph.

Al añadir los Me gusta, los comentarios, las veces que se ha compartido, los nuevos seguidores, la actividad del perfil y las visitas al perfil a los extremos de la API Graph para las publicaciones por secuencia, deberías poder consultar estas métricas directamente con la llamada a la API.

Consulta la lista completa de estas métricas aquí para poder añadir las que sean pertinentes a la llamada GET a la API para las publicaciones del contenedor de secuencia hoy mismo.

Programación de retirada actualizada: API de conversiones offline de Meta

El año pasado anunciamos que la versión 17 de la API de conversiones offline dejará de admitir los eventos offline y anticipamos que esta API dejaría de estar disponible en el tercer trimestre de 2024. Desde entonces, la programación de esta retirada anticipada se ha actualizado y confirmamos que la API de conversiones offline se retirará en mayo de 2025. Aunque la retirada de la API de conversiones offline se ha ampliado del tercer trimestre de 2024 a mayo de 2025, seguimos animando a los anunciantes que actualmente envían eventos offline mediante la API de conversiones offline a que mantengan la idea de migrar su configuración actual para empezar a enviar los eventos offline mediante la API de conversiones.

Retiradas y cambios de última hora

Retirada del botón de reserva en la Messenger API

A partir de este momento, el botón de reserva dejará de admitirse en las llamadas a la Messenger API. Este cambio no afecta a otras plantillas ni a otros botones, y las empresas podrán seguir administrando las reservas desde Meta Business Suite.

Suspensió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, en versiones anteriores, dejará de estarlo al cabo de 90 días. Este cambio no afectará a otros tipos de anuncios de mensajes.

Recomendamos revisar las integraciones actuales y ajustar las aplicaciones según sea necesario para garantizar una transición fluida para los usuarios.

Supresión de intervalos de tiempo no esenciales para métricas demográficas de insights (mediante la API Graph de Instagram externa)

El 21 de mayo de 2024 implementamos la versión 20 de la API Graph de Instagram.

90 días después de este lanzamiento (19 de agosto de 2024), la API Graph dejará de compartir métricas demográficas sobre miembros de la audiencia a los que se ha llegado o con los que se ha interactuado dentro de intervalos de tiempo no esenciales para la API Graph de Instagram (por ejemplo, información sobre la distribución de países, ciudades, edad y sexo durante los últimos 14 y 90 días).

Sin embargo, la API Graph de Instagram seguirá devolviendo información demográfica del último mes (“this_month”) y de la última semana (“this_week”) similar a la de la aplicación de Instagram para garantizar la coherencia entre las diferentes plataformas.

Esta nueva actualización reduce las confusiones y aumenta la fiabilidad y la calidad de nuestros informes.

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

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

• 28 de mayo de 2024: la versión 13.0 de la API Graph se retirará y suprimirá de la plataforma.

• 17 de septiembre de 2024: la versión 14.0 de la API Graph se retirará y suprimirá de la plataforma.

• 20 de noviembre de 2024: la versión 15.0 de la API Graph se retirará y suprimirá de la plataforma.

API de marketing

• 13 de agosto de 2024: la versión 18.0 de la API de marketing se retirará y suprimirá de la plataforma.

• 4 de febrero de 2025: la versión 19.0 de la API de marketing 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.

Meta Business SDK

Lanzamiento de la versión 20 del Meta Business SDK

El lanzamiento de la versión 20 del Meta Business SDK se efectuará poco después del lanzamiento de la versión 20 de la API Graph. Esta versión incluirá la corrección de errores, mejoras de dependencia, nuevas funciones y, lo más importante, una interfaz de API actualizada para corresponderse con la versión 20 de la API Graph.

En este lanzamiento, también vamos a implementar compatibilidades adicionales para las API de Instagram. Estas son IGMediaForIGOnlyAPI, IGUserForIGOnlyAPI, IGRefreshAccessTokenForIGOnlyAPI y IGAccessTokenForIGOnlyAPI. Estas ofrecen más métodos aparte de las API de Instagram actuales que te permitirán recopilar el contenido multimedia directamente. Tenemos pensado incorporar más API que abarquen otros productos de Meta para enriquecer el ecosistema del Business SDK.

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:

• Mayo de 2024: la versión 13.0 y las versiones anteriores del SDK de la plataforma de Facebook dejarán de estar disponibles.