Volver a las novedades para desarrolladores

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

15 de septiembre de 2022DeAchyuth Venkatesh

Hoy lanzamos la versión 15.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 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.

Actualizaciones y avisos generales

Criterios para simplificar la creación de conversiones personalizadas

Para que los anunciantes tengan un proceso de creación de campañas más simple , las conversiones personalizadas recién creadas requerirán al menos una regla asociada con el lanzamiento de la versión 15.0 de la API Graph. Las conversiones personalizadas que no requieren reglas deben utilizar una optimización de eventos personalizados, que permite que las campañas de anuncios se optimicen directamente en el evento personalizado. Estamos trabajando activamente para que las conversiones personalizadas actuales hagan una transición de una oferta única y todo en uno a varios productos de valor específico para satisfacer las necesidades y los casos de uso de los anunciantes de la mejor manera. Este cambio permitirá que los anunciantes hagan una transición de las conversiones personalizadas basadas en eventos personalizados a la optimización de eventos personalizados.

Actualizaciones de las Condiciones de la plataforma

Actualizaremos las Condiciones de la plataforma respecto de cuándo podemos eliminar el acceso de una app a las API, los permisos o las funciones de la plataforma que la app no haya usado o a los que no haya accedido durante cierto período. A partir del 15 de diciembre de 2022, las Condiciones de la plataforma requerirán actividad en un período de 28 días para que una app se considere activa.

Si se te notifica que tu app ha estado inactiva y quieres restablecerla, puedes hacerlo mediante el rol de administrador de tu app.

Puedes ver las Condiciones de la plataforma para obtener una vista previa completa de estos cambios aquí.

Elementos obsoletos y cambios radicales

Presentación del público personalizado Advantage

A partir del 19 de septiembre de 2022, empezaremos a implementar el público personalizado Advantage. El público personalizado Advantage utiliza un público personalizado del anunciante para guiar la entrega y ayudar a buscar a más personas que tienen más probabilidades de lograr el objetivo de optimización definido. Esto significa que entregaremos los anuncios más allá del público personalizado si es probable que mejore el rendimiento. El público personalizado Advantage es parte de nuestro conjunto de productos de la segmentación Advantage, incluidos la segmentación detallada Advantage y los públicos similares Advantage. Nuestros productos de segmentación Advantage aprovechan la tecnología avanzada de automatización y aprendizaje automático, que permite mejorar el rendimiento de la campaña del anunciante con menos esfuerzo manual.

Los anunciantes que aprovechan los públicos personalizados podrán seleccionar los públicos personalizados Advantage. Con los públicos personalizados Advantage, los anunciantes continuarán creando el público personalizado (de sitio web, de actividad de la app, de lista de clientes o de interacción), aplicando las inclusiones o exclusiones correspondientes y, a la vez, beneficiándose de nuestra tecnología avanzada de automatización y aprendizaje automático, que utiliza tu público personalizado como origen para que la entrega llegue a más usuarios con probabilidades de lograr los objetivos de optimización definidos.

Los públicos personalizados Advantage se activarán de manera automática cuando crees una campaña nueva que incluya un público personalizado de sitio web, de celulares o de interacción. Puedes elegir no usar este producto. Para hacerlo, desmarca la casilla "Públicos personalizados Advantage", que se encuentra en la sección "Público personalizado" de la herramienta de creación de anuncios.

Baja de públicos de anuncios especiales

Como parte de nuestro acuerdo con el Departamento de Vivienda y Desarrollo Urbano de los Estados Unidos (HUD), eliminaremos los públicos de anuncios especiales, una herramienta que permite a los anunciantes ampliar los públicos de los conjuntos de anuncios relacionados con oportunidades de vivienda, empleo y crédito. Eliminaremos la posibilidad de crear públicos de anuncios especiales mediante la API de marketing a partir del 15 de septiembre de 2022.

En el caso de los anunciantes y los socios, el bloqueo de la creación de nuevos públicos de anuncios especiales el 15 de septiembre de 2022 presentará un cambio de último momento, ya que, con este cambio sin versiones, quedaron obsoletos los valores anteriores. En 2019, además de eliminar determinadas opciones de segmentación de anuncios relacionados con oportunidades de vivienda, empleo y crédito, presentamos los públicos de anuncios especiales como alternativa a los públicos similares. Sin embargo, el campo de imparcialidad del aprendizaje automático es dinámico y está en evolución, y los públicos de anuncios especiales fueron una primera manera de abordar las preocupaciones. Nuestro enfoque cambiará para mejorar la imparcialidad, incluido el método anunciado antes.

A continuación, consulta la lista de los puntos de conexión afectados por este cambio:

Público de lectura:

  • endpoint gr:get:AdAccount/customaudiences
  • field operation_status

En el caso de creación de un conjunto de anuncios:

  • endpoint gr:post:AdAccount/adsets
  • field subtype

Edición de un conjunto de anuncios:

  • endpoint gr:post:AdCampaign
  • field subtype

Creación de un público personalizado:

  • endpoint gr:post:AdAccount/customaudiences
  • field subtype

Edición de un público personalizado:

  • endpoint gr:post:CustomAudience

Consulta la entrada del blog anterior y la documentación para desarrolladores a fin de obtener más información sobre la implementación del código.

Paridad de segmentación detallada Advantage y público similar Advantage

Con este proyecto, se brinda la paridad de la segmentación detallada como señal (segmentación detallada Advantage) a los usuarios de la API mediante conjuntos de anuncios con mensajes/instalaciones de app como objetivos (luego del lanzamiento del administrador de anuncios). Anteriormente, lanzamos la segmentación detallada Advantage de la API para usar conjuntos de anuncios con las conversiones como objetivo y con las conversiones/valor como objetivos de optimización (conjuntos de anuncios de VO/OC).

Ahora, cuando los anunciantes crean conjuntos de anuncios mediante la API con mensajes o instalaciones de app como objetivo, pasan dos elementos como parte de los criterios de segmentación (N2). Pasan una lista de entradas de segmentación detalladas (por ejemplo, críquet, fútbol, perros) y un marcador que indica si quieren ampliar más allá de estas entradas (llamadas segmentación detallada Advantage). Si el marcador está activado, nuestros sistemas entregan más allá de las selecciones de segmentación detallada si es probable que mejore el rendimiento. Si está desactivado, nuestros sistemas limitan la entrega a la lista de selecciones que proporcionaron los anunciantes.

En adelante, (luego del lanzamiento del administrador de anuncios), cuando los anunciantes creen nuevas campañas con mensajes o instalación de app para celulares como objetivos, las inclusiones de segmentación detallada se utilizarán como entrada (no es una restricción) para guiar la entrega de los anuncios. Como tal, quedará obsoleto el marcador "DTE" de estos objetivos y se marcará la expansión de la segmentación como comportamiento predeterminado de las selecciones de la segmentación detallada. De este modo, podemos ir más allá de las inclusiones de segmentación detallada si es probable que mejore el rendimiento. El resto de las selecciones y exclusiones de segmentación no se verán afectadas. Este cambio no se aplicará a las categorías especiales.

Cómo funciona:

Antes, los anunciantes pasaban el marcador targeting_optimization con un valor de expansion_all o ninguno para activar o desactivar la expansión de la segmentación detallada. Debido al cambio en la semántica del funcionamiento de la segmentación detallada de estos conjuntos de anuncios, los anunciantes no necesitan pasar este marcador cuando crean conjuntos de anuncios con mensajes o instalaciones de app como objetivo, ya que no afectará los conjuntos de anuncios recién creados. Todos estos conjuntos de anuncios recién creados utilizarán siempre las inclusiones de la segmentación detallada como señal a nuestros sistemas de backend, que pueden decidir entregar los anuncios más allá de estas selecciones si implica un mejor rendimiento de los anunciantes.

Debido a que el marcador targeting_optimization no tendrá ningún efecto en los conjuntos de anuncios recién creados, en adelante, planeamos dejar obsoleto este campo para nuevas campañas con mensajes o instalaciones de app como objetivo.

  • A tales fines, si los anunciantes pasan el marcador targeting_optimization cuando crean nuevos conjuntos de anuncios de MAI/mensajes o cuando consultan los datos estimados de entrega de estos conjuntos de anuncios recién creados, se arrojará un mensaje de error en el cual se les pedirá no volver a enviar este parámetro.
  • Se configurará un nuevo campo llamado targeting_as_signal en el backend durante las nuevas creaciones de conjuntos de anuncios de instalaciones o mensajes. Este campo está disponible en los comandos GET solo para ayudar a los anunciantes a verificar si los conjuntos de anuncios están más allá de las inclusiones de la segmentación detallada.

NOTA: Los cambios realizados en la segmentación detallada como señal solo se aplicarán a los conjuntos de anuncios recién creados con mensajes o instalaciones de app como objetivo.

Alcance de los puntos de conexión de la API:

  • gr:post:/act_XXXX/ adsets
  • gr:get:/<adset_id>/delivery_estimate

Baja de las pestañas de páginas

Anunciaremos que las funciones de la API de las pestañas personalizadas de las páginas no seguirán disponibles mediante la API Graph. A medida que implementemos la nueva experiencia de las páginas, hay algunas funciones de la API de páginas que en adelante quedarán obsoletas. Las funciones de las pestañas personalizadas de las páginas no estarán disponibles en la nueva experiencia de las páginas, por lo tanto, quedará obsoleta la compatibilidad con la API de estas funciones. Compartimos estas funciones ahora para ofrecer a los desarrolladores y sus clientes el tiempo suficiente para comunicar la obsolescencia de estas funciones de las páginas y realizar los cambios necesarios en ellas. Esta función quedará completamente obsoleta para el 14/12/2022.

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

  • 1 de noviembre de 2022: la versión 8.0 de la API Graph quedará obsoleta y se eliminará de la plataforma
  • 23 de febrero de 2023: la versión 9.0 de la API Graph quedará obsoleta y se eliminará de la plataforma
  • 8 de junio de 2023: la versión 10.0 de la API Graph quedará obsoleta y se eliminará de la plataforma

Para evitar interrupciones en tu negocio, 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:

  • Enero de 2023: se desactivarán la versión 8.0 o anteriores del SDK de la plataforma de Facebook
  • Junio de 2023: se desactivarán la versión 9.0 o anteriores del SDK de la plataforma de Facebook
  • Octubre de 2023: se desactivarán la versión 11.0 o anteriores del SDK de la plataforma de Facebook