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

Avisos y actualizaciones generales

Simplificación de los criterios de creación de conversiones personalizadas

Con el objetivo de simplificar el proceso de creación de campañas para los anunciantes, las conversiones personalizadas recién creadas necesitarán al menos una regla asociada con el lanzamiento de la versión 15.0 de la API Graph. Las conversiones personalizadas que no necesitan reglas deben usar la optimización de eventos personalizados, que permite que las campañas publicitarias se optimicen directamente en el evento personalizado. Estamos trabajando de forma activa para migrar las conversiones personalizadas existentes de una única oferta todo en uno a varios productos con valor específico para satisfacer mejor las necesidades y los casos de uso de nuestros anunciantes. Este cambio hará que los anunciantes pasen de las conversiones personalizadas basadas en eventos personalizados a la optimización de eventos personalizados.

Actualizaciones de las Condiciones de la plataforma

Vamos a actualizar las Condiciones de la plataforma en relación con cuándo podemos eliminar el acceso de una aplicación a las API de la plataforma, los permisos o las funciones que no haya utilizado o a los que no haya accedido en un determinado periodo de tiempo. A partir del 15 de diciembre de 2022, las Condiciones de la plataforma exigirán algún tipo de actividad en las aplicaciones en un periodo de 28 días para que se consideren activas.

Si se te notifica que tu aplicación ha estado inactiva, puedes reactivarla desde tu rol de administrador.

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

Retiradas y cambios de última hora

Presentación de la audiencia personalizada de Advantage

A partir del 19 de septiembre de 2022, empezaremos a implementar la audiencia personalizada de Advantage. La audiencia personalizada de Advantage utiliza una audiencia personalizada de un anunciante para dirigir la entrega y ayudar a encontrar a más usuarios con probabilidades de lograr el objetivo de optimización indicado. Esto quiere decir que entregaremos anuncios más allá de la audiencia personalizada si es probable que eso mejore el rendimiento. La audiencia personalizada de Advantage forma parte de nuestro conjunto de productos de segmentación de Advantage, incluidas las audiencias similares de Advantage y la segmentación detallada de Advantage. Los productos de segmentación de Advantage aprovechan la tecnología avanzada de automatización y aprendizaje automático que ayuda a mejorar el rendimiento de las campañas de los anunciantes con un menor esfuerzo manual.

Los anunciantes que utilicen las audiencias personalizadas podrán seleccionar audiencias personalizadas de Advantage. Con las audiencias personalizadas de Advantage, los anunciantes seguirán creando audiencias personalizadas (sitio web, actividad de la aplicación, lista de clientes o interacción) y aplicando las inclusiones o exclusiones pertinentes, al mismo tiempo que se benefician de nuestra tecnología avanzada de automatización y aprendizaje automático que usa la audiencia personalizada como origen para orientar la entrega y, de esta forma, llegar a más usuarios con probabilidades de lograr el objetivo de optimización indicado.

Las audiencias personalizadas de Advantage se activarán automáticamente cuando crees una campaña nueva que incluya una audiencia personalizada de interacción, móviles o sitios web. Para dejar de usar este producto, desmarca la casilla “Audiencias personalizadas de Advantage” en la sección “Audiencia personalizada” de la herramienta de creación de anuncios.

Retirada de audiencias de anuncios especiales

Como parte de nuestro acuerdo con el Departamento de Vivienda y Desarrollo Urbano (HUD) de EE. UU., vamos a retirar las audiencias de anuncios especiales, una herramienta que permite a los anunciantes ampliar sus audiencias para conjuntos de anuncios relacionados con oportunidades de vivienda, empleo y crédito. Vamos a eliminar la posibilidad de crear audiencias de anuncios especiales mediante la API de marketing a partir del 15 de septiembre de 2022.

El bloqueo de la creación de nuevas audiencias de anuncios especiales el 15 de septiembre de 2022 supondrá un cambio de última hora para los anunciantes y los socios, ya que los valores anteriores se retirarán con este cambio sin versión. En 2019, además de eliminar determinadas opciones de segmentación para los anuncios relacionados con oportunidades de vivienda, empleo y crédito, introdujimos las audiencias de anuncios especiales como alternativa a las audiencias similares. No obstante, el ámbito de la equidad en el aprendizaje automático es dinámico y evolutivo, y las audiencias de anuncios especiales fueron una forma inicial de abordar los problemas. Ahora nos centraremos en nuevos enfoques para mejorar la equidad, incluido el método anunciado previamente.

A continuación, puedes consultar la lista de extremos afectados en relación con esta retirada:

En el caso de la lectura de una audiencia:

  • Extremo gr:get:AdAccount/customaudiences
  • Campo operation_status

En el caso de la creación de conjuntos de anuncios:

  • Extremo gr:post:AdAccount/adsets
  • Campo subtype

En el caso de la edición de conjuntos de anuncios:

  • Extremo gr:post:AdCampaign
  • Campo subtype

En el caso de la creación de audiencias personalizadas:

  • Extremo gr:post:AdAccount/customaudiences
  • Campo subtype

En el caso de la edición de audiencias personalizadas:

  • Extremo gr:post:CustomAudience

Si quieres obtener más información para respaldar la implementación del código, consulta la anterior publicación en el blog y la documentación para desarrolladores.

Paridad de las audiencias similares de Advantage o la segmentación detallada de Advantage

Este proyecto aporta paridad a la segmentación detallada como señal (segmentación detallada de Advantage) para los usuarios de la API que utilizan conjuntos de anuncios con “Mensajes” o “Descargas de aplicaciones” como objetivos (después del lanzamiento del Administrador de anuncios). Anteriormente, lanzamos la segmentación detallada de Advantage de la API para los conjuntos de anuncios con “Conversiones” como objetivo y “Conversiones” o “Valor” como objetivos de optimización (conjuntos de anuncios VO/OC).

Actualmente, cuando los anunciantes crean conjuntos de anuncios mediante la API con “Mensajes” o “Descargas de aplicaciones” como objetivo, pasan dos cosas como parte de los criterios de segmentación (L2). En concreto, pasan una lista de entradas de segmentación detallada (p. ej., críquet, fútbol, perros, etc.) y una marca para indicar si quieren expandirse más allá de dichas entradas (esto se denomina segmentación detallada de Advantage). Si la marca está activada, nuestros sistemas entregan los anuncios más allá de las selecciones de la segmentación detallada si es probable que eso mejore el rendimiento. En cambio, si está desactivada, nuestros sistemas limitan la entrega a la lista de selecciones proporcionada por los anunciantes.

Más adelante (después del lanzamiento del Administrador de anuncios), cuando los anunciantes creen campañas nuevas con “Mensajes” o “Descargas de aplicaciones para móviles” como objetivos, las inclusiones de la segmentación detallada se usarán como entrada (no como restricción) para orientar la entrega de anuncios. Por ello, vamos a retirar la marca DTE de estos objetivos y vamos a hacer que la expansión de la segmentación sea un comportamiento predeterminado de las selecciones de la segmentación detallada. De esta forma, podremos ir más allá de las inclusiones de la segmentación detallada si es probable que eso mejore el rendimiento. El resto de las exclusiones y selecciones de la segmentación no se verán afectadas por esta modificación. Este cambio no se aplicará a las categorías especiales.

Funcionamiento

Anteriormente, los anunciantes pasaban la marca targeting_optimization con el valor expansion_all o none para activar o desactivar la expansión de la segmentación detallada. Debido al cambio en la semántica de cómo funcionará la segmentación detallada para estos conjuntos de anuncios, los anunciantes no tienen que pasar esta marca al crear conjuntos de anuncios con “Mensajes” o “Descargas de aplicaciones” como objetivo, ya que no repercutirá en los conjuntos de anuncios recién creados. Todos estos conjuntos de anuncios recién creados usarán siempre las inclusiones de la segmentación detallada como señal para nuestros sistemas de back-end, que pueden decidir entregar anuncios más allá estas selecciones si eso implica conseguir un mejor rendimiento para los anunciantes.

Como la marca targeting_optimization no repercutirá en los conjuntos de anuncios recién creados, planeamos retirar este campo de las nuevas campañas con “Mensajes” o “Descargas de aplicaciones” como objetivo en el futuro.

  • Para ello, si los anunciantes pasan la marca targeting_optimization al crear nuevos conjuntos de anuncios con “Mensajes” o “Descargas de aplicaciones para móviles” como objetivo o al consultar las estimaciones de entrega de dichos conjuntos de anuncios recién creados, mostraremos un mensaje de error en el que se les pedirá que no vuelvan a enviar este parámetro.
  • Se establecerá un nuevo campo denominado targeting_as_signal en el back-end durante las creaciones de nuevos conjuntos de anuncios con “Mensajes” o “Descargas de aplicaciones” como objetivo. Este campo está disponible en los comandos GET solo para ayudar a los anunciantes a verificar si los conjuntos de anuncios van más allá de las inclusiones de la segmentación detallada.

NOTA: Estos cambios en la segmentación detallada como señal solo se aplicarán a los conjuntos de anuncios recién creados con “Mensajes” o “Descargas de aplicaciones” como objetivo.

Extremos de la API que se encuentran dentro del ámbito de aplicación:

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

Retirada de las pestañas de las páginas

Anunciamos que las funciones de la API de pestañas personalizadas de páginas dejarán de estar disponibles mediante la API Graph. Con el avance de la implementación de la nueva experiencia de páginas, se retirarán algunas funciones de la API de páginas. Las funciones de las pestañas personalizadas de las páginas no estarán disponibles en la nueva experiencia de páginas, por lo que retiraremos la compatibilidad de la API con estas funciones. Compartimos estas actualizaciones en este momento para que los desarrolladores y sus clientes tengan tiempo suficiente para informar de la retirada de dichas funciones de las páginas y hacer los cambios necesarios en ellas. Esta función se retirará de forma íntegra el 14/12/2022.

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

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

Para evitar cualquier interrupción en tu empresa, te recomendamos que migres todas las llamadas a la versión de la API más reciente que lanzamos 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:

  • Enero de 2023: las versiones 8.0 o anteriores del SDK de la plataforma de Facebook desaparecerán.
  • 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.