Volver a las novedades para desarrolladores

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

23 de enero de 2024DeMohamed Amr Abouelhassan

Hoy lanzamos la versión 19.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 pertinentes sobre las integraciones de tus aplicaciones con nuestra plataforma.

Para ver una lista completa de todos los cambios y sus detalles, consulta nuestro registro de cambios.

Actualizaciones generales

Ofrecemos la segmentación detallada de Advantage para todos los objetivos y las optimizaciones de campaña

Como parte de nuestros continuos esfuerzos por ayudar a los anunciantes a impulsar su rendimiento, vamos a expandir la disponibilidad de nuestro producto de segmentación detallada de Advantage a todos los objetivos y las optimizaciones de campaña.

La segmentación detallada de Advantage forma parte de nuestro conjunto de productos Advantage, que utiliza la automatización avanzada y la tecnología de aprendizaje automático para ayudar a mejorar el rendimiento de las campañas de los anunciantes. En concreto, la segmentación detallada de Advantage puede contribuir a mejorar el rendimiento de las campañas porque permite que nuestro sistema llegue a un grupo más amplio de personas que el que se define en las selecciones de segmentación detallada iniciales del anunciante, en caso de que nuestro sistema prediga que es probable que se mejore el rendimiento.

El 23 de enero de 2024 implementaremos los siguientes cambios para los anunciantes y partners que usan la API de marketing:

  • Las campañas que se optimizan para generar impresiones, visualizaciones de vídeo, alcance, interacciones o un lift en recuerdo publicitario ya ofrecen la opción de activar la segmentación detallada de Advantage.
  • Las campañas que se optimizan para generar clientes potenciales tendrán la segmentación detallada de Advantage aplicada de forma automática, pero será posible desactivarla.
    • Ten en cuenta que esta opción estará activada para las campañas y los conjuntos de anuncios nuevos y duplicados, pero podrás desactivarla si quieres.
  • Las campañas que se optimizan para generar visitas en la página de destino tendrán la segmentación detallada de Advantage aplicada de forma automática y no será posible desactivarla.

Para los anunciantes y partners que usen la API de marketing, estas actualizaciones supondrán un gran cambio. A partir del 23 de enero de 2024, los desarrolladores podrán empezar a implementar cambios en el código y tendrán hasta el 22 de abril de 2024 para completarlos. Este cambio se hará efectivo con la versión 19 de la API.

<Impacted endpoints>

Tipo de solicitud

Extremo

Cambios

GET

/act_{ad-account-id}/delivery_estimate

/{adset-id}/delivery_estimate

  • El campo ‘targeting_optimization’ no se aceptará para campañas que se optimicen para generar clics en el enlace o visitas a la página de destino. Esto también se aplica a las anteriores optimizaciones que se incluían en la segmentación detallada de Advantage sin la opción de desactivarla, como las conversiones, el valor, las descargas de aplicaciones, los eventos de la aplicación y las conversaciones.
  • El campo targeting_as_signal debería ser “null” o “0” para campañas que se optimizan para generar impresiones, visualizaciones de vídeo, alcance, interacciones, lift en recuerdo publicitario o clientes potenciales. De no ser así, se emitirá un error.

POST

/act_{ad_account_id}/{adsets}

/{adset-id}

  • El campo ‘targeting_optimization’ no se aceptará para campañas que se optimicen para generar clics en el enlace o visitas a la página de destino. Esto también se aplica a las optimizaciones anteriores que se incluían en la segmentación detallada de Advantage sin la opción de desactivarla, como las conversiones, el valor, las descargas de aplicaciones, los eventos de la aplicación y las conversaciones.
  • En el caso de las optimizaciones que tengan activada la segmentación detallada de Advantage sin la opción de desactivarla, configuraremos automáticamente el campo targeting_as_signal como “1” o “3” en función del conjunto de objetivos y optimizaciones.

Nuevos anuncios, conjuntos de anuncios y campañas de la API de marketing con objetivos originales

A partir de la versión 19.0 de la API de marketing, los nuevos anuncios, conjuntos de anuncios y campañas que usen los objetivos originales (descritos a continuación) no se podrán crear copiando y pegando. Los objetivos del anuncio tienen que actualizarse para reflejar nuestros objetivos simplificados.

A partir de la versión 20 de la API de marketing, no se podrán crear anuncios y conjuntos de anuncios con los objetivos de campaña originales. Sin embargo, las versiones anteriores (como la 18 y la 19) seguirán permitiendo esta función. No es necesario tomar medidas inmediatas en los anuncios existentes que usen los objetivos originales.

Objetivos originales afectados

  • BRAND_AWARENESS
  • CONVERSIONS
  • EVENT_RESPONSES
  • LEAD_GENERATION
  • LINK_CLICKS
  • LOCAL_AWARENESS
  • MESSAGES
  • OFFER_CLAIMS
  • PAGE_LIKES
  • POST_ENGAGEMENT
  • REACH
  • STORE_VISITS
  • VIDEO_VIEWS

Extremos POST afectados

  • /{ad_id}/copies
  • /{campaign_id}/copies
  • /{adset_id}/copies

Como referencia, puedes acceder a la anterior publicación para desarrolladores sobre los cambios de la API relacionados con la creación de campañas que usen los objetivos originales aquí.

Preguntas frecuentes

P.: ¿Será necesario hacer una actualización del código a raíz de este cambio?

R.: Sí, varias llamadas a la API de la versión 18 no funcionarán en la versión 19. Por ejemplo, los nuevos anuncios, conjuntos de anuncios y campañas que usen los objetivos originales no se podrán crear copiando y pegando.

P.: ¿Qué comportamientos se deben esperar antes y después del cambio?

R.: Antes, las llamadas a la API para duplicar un anuncio, conjunto de anuncios o campaña con los objetivos originales funcionaban, pero en esta versión no.

P.: ¿Cuál es el plazo para implementar los cambios en el código?

R.: Hasta que se retire la versión 18, que provisionalmente se hará en septiembre de 2024.

Documentación adicional para desarrolladores

Artículos de ayuda

Acceso al contenido público de la página (PPCA)

El caso de uso de los datos recopilados mediante el acceso al contenido público de la página (PPCA) ha cambiado. Para obtener más información, accede al siguiente enlace.

Presentación de la API de audiencia de Advantage+

En octubre del año pasado, lanzamos la audiencia de Advantage+, una nueva experiencia de creación de audiencias simplificada que ayuda a aumentar el rendimiento de las campañas ampliando la audiencia a la que se puede entregar un anuncio, sin dejar de entregárselo a las personas a las que más le interesa llegar al anunciante.

Ahora vamos a lanzar la audiencia de Advantage+ en la API de marketing.

  • Para activarla, establece el parámetro “targeting_automation” con el valor “advantage_audience” definido en “1”.
  • Para desactivarla, establece el parámetro “targeting_automation” con el valor “advantage_audience” definido en “0”.

Retiradas y cambios de última hora

Retirada de la API de grupos de Facebook

La API de grupos de Facebook se retirará en la versión 19 y dentro de 90 días se suprimirá de todas las versiones. Esta retirada incluye todos los permisos (publish_to_groups, groups_access_member_info) y las funciones revisables (API de grupos) asociados con la API de grupos de Facebook.

Un caso de uso importante de la API de grupos eran las respuestas privadas en grupos. Vamos a implementar otro cambio en la versión 19 que activará este caso de uso sin que los desarrolladores necesiten usar la API de grupos. Para la mayoría de los desarrolladores de respuestas privadas, no será necesario hacer cambios en la versión 19. Los desarrolladores que usaban las llamadas a los extremos de publicaciones de grupos a través de la API de grupos, después de recibir un webhook de respuestas privadas, tendrán que asegurarse de usar un identificador de acceso a la página para estas solicitudes.

Los desarrolladores que no tengan claro si sus extremos usan un permiso retirado, pueden verificarlo probando los extremos en la versión 19.0.

Cambios de la API de insights de página: retirada de métricas

A medida que hagamos la transición de las páginas clásicas a la nueva experiencia de páginas en Facebook, retiraremos varias métricas de la API de insights de página. Para obtener más información, visita este enlace.

Retiradas de versiones de la API

Como parte de la programación de las versiones de Facebook para la API Graph y la API de marketing, ten en cuenta las próximas retiradas:

API Graph

  • 8 de febrero de 2024: la versión 12.0 de la API Graph se retirará y se suprimirá de la plataforma.
  • 28 de mayo de 2024: la versión 13.0 de la API Graph se retirará y se suprimirá de la plataforma.
  • 17 de septiembre de 2024: la versión 14.0 de la API Graph se retirará y se suprimirá de la plataforma.

API de marketing

  • 6 de febrero de 2024: la versión 16.0 de la API de marketing se retirará y se suprimirá de la plataforma.
  • 14 de mayo de 2024: la versión 17.0 de la API de marketing se retirará y se suprimirá 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.

Meta Business SDK

Lanzamiento de la versión 19 del Meta Business SDK

El lanzamiento de la versión 19 del Meta Business SDK se efectuará poco después del lanzamiento de la versión 19 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 19 de la API Graph. En el futuro, planeamos lanzar versiones del SDK con más frecuencia para que se alineen con la cadencia de actualizaciones de la API. Esto permitirá que los desarrolladores se mantengan al día de las últimas API, funciones y características.

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:

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