Volver a las novedades para desarrolladores

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

23 de mayo de 2023DeAyyad Farah

Hoy lanzamos la versión 17.0 de la API Graph y de 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 que creemos que son pertinentes para la integración de tus aplicaciones con nuestra plataforma.

Puedes consultar una lista completa de todos los cambios y los detalles correspondientes en nuestro registro de cambios.

Retiradas y cambios de última hora

Retirada de Estrategias publicitarias

El producto en fase beta Estrategias publicitarias se retiró el 28 de octubre de 2022. Por este motivo, con el lanzamiento de la versión 17.0 de la API de marketing vamos a retirar los campos “ad_strategy_id” y “ad_strategy_group_id” del extremo de las campañas.

Retirada de la API de conversiones offline

Desde febrero de 2023, la API de conversiones admite completamente los eventos offline, lo que garantiza las funciones de paridad que ofrece el extremo actual de la API de conversiones offline. Al consolidar nuestras API de eventos web y offline en una sola API, esperamos simplificar y mejorar la forma en que los anunciantes utilizan los datos de marketing multicanal para mejorar la optimización de anuncios, las audiencias personalizadas y las mediciones.

A partir de la versión 17 de la API Graph, publicada el 23 de mayo de 2023, la API de conversiones offline ya no admitirá los eventos offline. Recomendamos que los anunciantes con integraciones existentes de la API de conversiones offline conviertan su integración en una integración de la API de conversiones y que no actualicen la API de conversiones offline hasta que hayan completado la conversión correctamente.

Retirada de la creación de objetivos obsoleta

Como anunciamos en diciembre de 2021, rediseñamos la experiencia de selección de objetivos al crear nuevas campañas para guiar de forma eficaz a los anunciantes hacia configuraciones de campaña que ayudan a lograr mejor sus objetivos de marketing. Como resultado de la nueva experiencia, “experiencias publicitarias orientadas a los resultados”, se produjeron cambios en la API de marketing.

Empezaremos el proceso de retirada de la experiencia y los objetivos obsoletos con el lanzamiento de la versión 17.0 de la API de marketing. Al usar la versión 17.0 de la API de marketing, las campañas solo se pueden crear con objetivos de experiencias publicitarias orientadas a los resultados. Además, las API de objetivos obsoletas se retirarán. Las campañas heredadas existentes y la duplicación de las campañas heredadas existentes se seguirán admitiendo y no se verán afectadas en esta versión. Para obtener más detalles, consulta nuestra reciente publicación en el blog para desarrolladores.

Obligatoriedad del campo de mejoras estándar del contenido de Advantage+

A principios de año, lanzamos las mejoras estándar del contenido de Advantage+ en la API de marketing. A partir del 23 de mayo de 2023, se exigirá a los usuarios de la API de marketing que especifiquen el estado de inscripción de un anuncio a las mejoras estándar del contenido de Advantage+; para ello, deberán incluir “OPT_IN” u “OPT_OUT” en el campo “enroll_status”. Si el campo se deja en blanco, el usuario recibirá un aviso de error y se le redirigirá par que lo complete. Para obtener más información sobre las mejoras estándar del contenido de Advantage+ en la API de marketing, consulta esta publicación en el blog para desarrolladores.

Se ven afectados los extremos siguientes:

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

Retirada de los anuncios de catálogo de Advantage+ para las transmisiones

Con el lanzamiento de la versión 17.0 de la API de marketing, retiramos el uso del catálogo de los anuncios de catálogo de Advantage+ para transmisiones. La alternativa que se recomienda en el caso de los anuncios de catálogo de Advantage+ para transmisiones son los anuncios del catálogo comercial. A continuación, se ofrece una guía para configurar un catálogo comercial. Se retirarán los extremos siguientes:

  • Creación de catálogos de anuncios de catálogo de Advantage+ para transmisiones: perímetro “owned_product_catalogs” con “media_titles” en vertical.
  • Subida de listas de títulos multimedia: perímetro “product_feeds” de los catálogos de anuncios de catálogo de Advantage+ para transmisiones.
  • Creación de elementos de título multimedia: perímetro “media_titles” de los catálogos de anuncios de catálogo de Advantage+ para transmisiones.
  • Creación de campañas con catálogos de anuncios de catálogo de Advantage+ para transmisiones: perímetro de campañas con catálogos DAS en los niveles 3, 2 o 1.

Los cambios anteriores se aplicarán a todas las versiones de la API de marketing el 21 de agosto de 2023 y pausaremos todas las campañas que tengan catálogos de anuncios de catálogo de Advantage+ para transmisiones adjuntos en los niveles 3, 2 o 1.

Retirada de la API de artículos instantáneos

Como el producto de artículos instantáneos se retiró el 20 de abril de 2023, también se retirará la API que permite a los editores administrar los artículos instantáneos.

Aplicación del permiso de administración de negocios en las cuentas de los usuarios

Anteriormente, las páginas administradas por negocios adicionales se devolvían sin el permiso de acceso “business_management”. A partir del 23 de mayo de 2023, si quieres continuar recibiendo acceso a las páginas administradas por negocios, se requerirá el permiso “business_management”. Para obtener más detalles sobre este permiso, consulta la página de business_management.

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 siguientes retiradas:

API Graph

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

API de marketing

  • 15 de agosto de 2023: la versión 14.0 de la API de marketing se retirará y se eliminará de la plataforma.
  • 15 de agosto de 2023: la versión 15.0 de la API de marketing se retirará y se eliminará de la plataforma.

Para evitar cualquier interrupción en el negocio, te recomendamos que migres todas las llamadas a la versión de la API más reciente que hemos lanzado hoy.

SDK de la plataforma de Facebook

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:

  • Junio de 2023: las versiones 9.0 o anteriores del SDK de la plataforma de Facebook desaparecerán.
  • Octubre de 2023: las versiones 11.0 o anteriores del SDK de la plataforma de Facebook desaparecerán.
  • Febrero de 2024: las versiones 12.0 o anteriores del SDK de la plataforma de Facebook desaparecerán.