Volver a las novedades para desarrolladores

Presentación de la API Graph versión 17.0 y la API de marketing versión 17.0 de Facebook

23 de mayo de 2023DeAyyad Farah

Hoy lanzamos la API Graph 17.0 y la API de marketing 17.0 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 que consideramos 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.

Elementos obsoletos y cambios radicales

Retiro de Estrategias de anuncios

La versión beta del producto Estrategias de anuncios quedó obsoleta desde el 28 de octubre de 2022. Debido a esto, retiraremos los campos ad_strategy_id y ad_strategy_group_id del punto de conexión de campañas al lanzar la API de marketing 17.0.

Retiro de la API de conversiones offline

A partir de febrero de 2023, la API de conversiones es totalmente compatible con eventos offline. Esto garantiza funciones de paridad proporcionadas por el punto de conexión de la API de conversiones offline actual. Al consolidar nuestras API de eventos web y offline en una sola API, esperamos simplificar y mejorar la forma en que los anunciantes usan sus datos de marketing entre canales para perfeccionar la optimización, los públicos personalizados y la medición.

A partir de la versión 17 de la API Graph, lanzada el 23 de mayo de 2023, la API de conversiones offline dejará de ser compatible con eventos offline. Recomendamos que los anunciantes con integraciones de la API de conversiones offline conviertan su integración en una integración con la API de conversiones y no actualicen su API de conversiones offline hasta que lo hayan hecho correctamente.

Retiro de la creación de objetivos anteriores

Como se anunció en diciembre de 2021, rediseñamos la experiencia de selección de objetivos cuando se crean campañas nuevas. De esta manera, es posible acompañar a los anunciantes para que configuren campañas que les permitan cumplir mejor los objetivos de marketing. La nueva experiencia, Experiencias publicitarias basadas en resultados, produjo cambios en la API de marketing.

Iniciaremos el proceso de retiro de la experiencia y los objetivos anteriores a partir del lanzamiento de la API de marketing versión 17.0. Cuando se use la API de marketing versión 17.0, las campañas solo se podrán crear con los objetivos para las experiencias publicitarias basadas en resultados; las API de objetivos anteriores quedarán obsoletas. No obstante, en esta versión se continuarán admitiendo las campañas anteriores preexistentes y la duplicación de estas campañas, y no se verán afectadas. Se puede obtener más información en nuestra reciente publicación de blog para desarrolladores.

El campo de mejoras estándar en el contenido Advantage+ pasa a ser obligatorio

A principios de este año, lanzamos las mejoras estándar en el contenido Advantage+ en la API de marketing. A partir del 23 de mayo de 2023, los usuarios de la API de marketing deberán especificar la inscripción de un anuncio en las mejoras estándar del contenido Advantage+, incorporando "OPT_IN" u "OPT_OUT" en el campo "enroll_status". Si el campo se deja en blanco, el usuario recibirá un mensaje de error y se le indicará que lo complete. Para obtener más información sobre las mejoras estándar en el contenido Advantage+ de la API de marketing, consulta esta publicación de blog para desarrolladores.

Se verán afectados los siguientes puntos de conexión:

  • POST /{ad-account-id}/adcreatives
  • POST /{ad-account-id}/ads

Retiro de anuncios del catálogo Advantage+ para streaming

Con el lanzamiento de la API de marketing versión 17, retiraremos el uso de anuncios del catálogo Advantage+ para streaming (A+CA para Streaming). Los anuncios del catálogo de comercio son la alternativa recomendada de A+CA para streaming. A continuación, se ofrece una guía para configurar un catálogo de comercio. Quedarán obsoletos los siguientes puntos de conexión:

  • Crear un A+CA de catálogo de streaming: owned_product_catalogs de perímetro con media_titles vertical
  • Subir feeds de títulos de contenido: product_feeds de perímetro para un A+CA de catálogo de streaming
  • Crear un elemento de título de contenido: media_titles de perímetro para un A+CA de catálogo de streaming
  • Crear una campaña usando un A+CA de catálogo de streaming: campañas de perímetro con un catálogo DAS en L3, L2 o L1

El 21 de agosto de 2023 se aplicarán los siguientes cambios a todas las versiones de la API de marketing y pausaremos todas las campañas que tengan A+CA de catálogos de streaming incorporados en el nivel L3, L2 o L1.

Retiro de la API de artículos instantáneos

Debido a que el producto de artículos instantáneos quedó obsoleto el 20 de abril de 2023, ahora se retirará una API que permite a los editores administrar sus artículos instantáneos.

Aplicar permisos de administración comercial en cuentas de usuarios

Antes, las páginas adicionales administradas por empresas se devolvían sin el acceso que concede el permiso business_management. A partir del 23 de mayo de 2023, si deseas continuar recibiendo acceso a las páginas administradas por empresas, será necesario el permiso business_management. Para obtener más información relacionada con este permiso, puedes consultar la página business_management.

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

  • 8 de junio de 2023: la API Graph versión 9.0 quedará obsoleta y se eliminará de la plataforma.
  • 14 de septiembre de 2023: la API Graph versión 11.0 quedará obsoleta y se eliminará de la plataforma.
  • 8 de febrero de 2024: la API Graph versión 12.0 quedará obsoleta y se eliminará de la plataforma.

API de marketing

  • 15 de agosto de 2023: la API de marketing versión 14 quedará obsoleta y se eliminará de la plataforma.
  • 15 de agosto de 2023: la API de marketing versión 15.0 quedará obsoleta y se eliminará de la plataforma.

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

SDK de la plataforma de Facebook

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:

  • Junio de 2023: se desactivará el SDK de la plataforma de Facebook versión 9.0 o anteriores
  • Octubre de 2023: se desactivará el SDK de la plataforma de Facebook versión 11.0 o anteriores
  • Febrero de 2024: se desactivará el SDK de la plataforma de Facebook versión 12.0 o anteriores