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

Suscribirte a Noticias para desarrolladores

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, 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 relevantes para la integración de tus aplicaciones con nuestra plataforma.

Visita nuestro registro de cambios para obtener una lista completa de todos los cambios e información detallada al respecto.

Actualizaciones generales

La segmentación detallada Advantage ahora está disponible para todos los objetivos y las optimizaciones de campaña

Como parte de nuestras iniciativas continuas para ayudar a los anunciantes a impulsar el rendimiento, ahora nuestro producto de segmentación detallada Advantage está disponible para todos los objetivos y las optimizaciones de campaña.

La segmentación detallada Advantage forma parte de nuestro paquete de productos Advantage. Este tipo de segmentación hace uso de funciones de automatización avanzada y tecnología de aprendizaje automático para mejorar el rendimiento de las campañas de los anunciantes. En concreto, la segmentación detallada Advantage puede optimizar el rendimiento de una campaña, ya que permite a nuestro sistema llegar a un público objetivo más amplio que el definido en las opciones de segmentación detallada iniciales del anunciante, siempre y cuando nuestro sistema prevea que es probable que mejore el rendimiento.

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

Las campañas que están optimizadas para impresiones, reproducciones de video, alcance, interacción o mejora de recuerdo del anuncio ahora tendrán la opción de activar la segmentación detallada Advantage.
Las campañas que están optimizadas para generar clientes potenciales tendrán la opción de segmentación detallada Advantage aplicada con la opción de desactivarla.
- Ten en cuenta que la opción estará activada para las campañas o los conjuntos de anuncios nuevos y duplicados, pero puedes desactivarla cuando lo desees.
Las campañas que están optimizadas para clics en enlaces o visitas a la página de destino tendrán la opción de segmentación detallada Advantage aplicada automáticamente, sin la posibilidad de desactivarla.

Estas modificaciones presentarán un cambio radical para los anunciantes y socios que usan la API de Marketing. A partir del 23 de enero de 2024, los desarrolladores pueden empezar a implementar los cambios de código y tendrán hasta el 22 de abril de 2024 para implementar las actualizaciones. Este cambio se lanzará en la nueva versión 19 de la API.

<Impacted endpoints>

Tipo de solicitud	Punto de conexión	Cambios
GET	/act_{ad-account-id}/delivery_estimate /{adset-id}/delivery_estimate	El campo ‘targeting_optimization’ no se aceptará en las campañas optimizadas para generar clics en enlaces o visitas a la página de destino. Esto también se aplica a optimizaciones anteriores incluidas en la segmentación detallada Advantage sin la posibilidad de desactivarla, incluidas las conversiones, el valor o los eventos y conversiones de la app. El campo targeting_as_signal debería ser nulo o 0 para las campañas que están optimizadas para impresiones, reproducciones de video, alcance, interacción, mejora de recuerdo del anuncio o clientes potenciales, de lo contrario, se mostrará un error.
POST	/act_{ad_account_id}/{adsets} /{adset-id}	El campo ‘targeting_optimization’ no se aceptará en las campañas optimizadas para generar clics en enlaces o visitas a la página de destino. Esto también se aplica a optimizaciones anteriores incluidas en la segmentación detallada Advantage sin la opción de desactivarla, incluidas las conversiones, el valor o los eventos y conversiones de la app. Para todas las optimizaciones que participan de la segmentación detallada Advantage sin opción de desactivarla, configuraremos automáticamente el campo targeting_as_signal en 1 o 3 según el conjunto de objetivos + optimizaciones.

Tipo de solicitud

Punto de conexión

Cambios

GET

/act_{ad-account-id}/delivery_estimate

/{adset-id}/delivery_estimate

El campo ‘targeting_optimization’ no se aceptará en las campañas optimizadas para generar clics en enlaces o visitas a la página de destino. Esto también se aplica a optimizaciones anteriores incluidas en la segmentación detallada Advantage sin la posibilidad de desactivarla, incluidas las conversiones, el valor o los eventos y conversiones de la app.
El campo targeting_as_signal debería ser nulo o 0 para las campañas que están optimizadas para impresiones, reproducciones de video, alcance, interacción, mejora de recuerdo del anuncio o clientes potenciales, de lo contrario, se mostrará un error.

POST

/act_{ad_account_id}/{adsets}

/{adset-id}

El campo ‘targeting_optimization’ no se aceptará en las campañas optimizadas para generar clics en enlaces o visitas a la página de destino. Esto también se aplica a optimizaciones anteriores incluidas en la segmentación detallada Advantage sin la opción de desactivarla, incluidas las conversiones, el valor o los eventos y conversiones de la app.
Para todas las optimizaciones que participan de la segmentación detallada Advantage sin opción de desactivarla, configuraremos automáticamente el campo targeting_as_signal en 1 o 3 según el conjunto de objetivos + optimizaciones.

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

A partir de la versión 19.0 de la API de Marketing, ya no se podrán crear nuevos anuncios, conjuntos de anuncios y campañas con los objetivos originales (que se indican a continuación) en el texto del anuncio. Los objetivos de los anuncios deberán actualizarse para ajustarse a nuestros objetivos simplificados.

A partir de la versión 20 de la API de Marketing, ya no se podrá crear anuncios y conjuntos de anuncios en campañas con objetivos originales. Sin embargo, las versiones de la API anteriores a la 20 (es decir, la 19 y la 18) seguirán ofreciendo esta posibilidad. No es necesario realizar ninguna acción de forma inmediata para los anuncios preexistentes con objetivos originales.

Puntos de conexión POST alcanzados

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

Puntos de conexión POST alcanzados

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

A modo de referencia, puedes consultar la anterior publicación del blog para desarrolladores sobre los cambios de la API relacionados con la creación de campañas con objetivos originales aquí.

Preguntas frecuentes

P: ¿Con este cambio es necesario actualizar el código?

R: Sí, varias llamadas a la API de la versión 18 no funcionarán en la versión 19. En otras palabras, no será posible crear nuevos anuncios, conjuntos de anuncios y campañas con objetivos originales en el texto del anuncio.

P: ¿Cuál es el comportamiento esperado 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 se realizaban correctamente, ahora fallarán.

P: ¿Cuál es el plazo para aplicar los cambios de código?

R: Hasta que la versión 18.0 quede obsoleta, lo cual está previsto para septiembre de 2024.

Documentación adicional para desarrolladores

Artículos de ayuda

PPCA (permiso de acceso a contenido público de la página)

El caso de uso de los datos recopilados con el PPCA (permiso de acceso al contenido público de la página) cambió. Para obtener más información, visita el siguiente enlace.

Presentación de la API del público Advantage+

En octubre del año pasado, presentamos el público Advantage+, una experiencia de creación de público nueva y más sencilla que permite aumentar el rendimiento de las campañas al ampliar el público al que potencialmente se mostrará un anuncio, sin dejar de entregar anuncios a las personas a las que los anunciantes más desean llegar.

Ahora presentamos el público Advantage+ en la API de marketing.

Para activar esta opción, configura el parámetro targeting_automation en advantage_audience en 1.
Si no quieres usarla, configura el parámetro targeting_automation en advantage_audience en 0.

Elementos obsoletos y cambios radicales

La API de grupos de Facebook queda obsoleta

La API de grupos de Facebook está obsoleta en la versión 19 y, en 90 días, se eliminará de todas las versiones. Esto incluye todos los permisos (publish_to_groups, groups_access_member_info) y las funciones revisables (API de grupos) asociados a la API de grupos de Facebook.

Uno de los principales casos de uso de la API de grupos era la función de respuestas privadas en los grupos. En la versión 19, implementaremos otro cambio que permitirá este uso sin que los desarrolladores tengan la necesidad de utilizar la API de grupos. La mayoría de los desarrolladores de respuestas privadas no tendrán que realizar ningún cambio en la versión 19. En el caso de los desarrolladores que previamente utilizaban llamadas a los puntos de conexión POST de grupos por medio de la API de grupos luego de recibir un webhook de respuestas privadas, a partir de ahora, será necesario utilizar un token de acceso a la página para dichas solicitudes.

Los desarrolladores pueden probar los puntos de conexión en la versión 19.0 a fin de comprobar si sus puntos de conexión utilizan un permiso obsoleto.

Cambios en la API de estadísticas de la página: métricas obsoletas

A medida que migremos de la versión clásica de la página en Facebook a la nueva experiencia, algunas métricas de la API de estadísticas de la página dejarán de estar disponibles. Para obtener más información, visita este enlace.

Versiones de la API obsoletas:

Como parte del cronograma de lanzamiento de versiones de la API Graph y de la API de marketing, ten en cuenta los elementos que quedarán obsoletos próximamente:

API Graph

8 de febrero de 2024: la versión 12.0 de la API Graph quedará obsoleta y se eliminará de la plataforma.
28 de mayo de 2024: la versión 13.0 de la API Graph quedará obsoleta y se eliminará de la plataforma.
17 de septiembre de 2024: la versión 14.0 de la API Graph quedará obsoleta y se eliminará de la plataforma.

API de marketing

6 de febrero de 2024: la API de marketing versión 16.0 quedará obsoleta y se eliminará de la plataforma.
14 de mayo de 2024: la API de marketing versión 17.0 quedará obsoleta y se eliminará de la plataforma.

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

SDK de Meta para empresas

Presentación del la versión 19 del SDK de Facebook para empresas

La versión 19 del SDK de Meta para empresas se publicará poco después de la versión 19 de la API Graph. Esta versión incluirá correcciones de errores, actualizaciones de dependencias, nuevas funciones y, lo más importante, una interfaz de API actualizada para alinearse con la versión 19 de la API Graph. En el futuro, tenemos previsto lanzar el SDK con mayor frecuencia para que coincida con la cadencia de las actualizaciones de la API. Esto permitirá a los desarrolladores disponer de las últimas API, funciones y características.

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:

Febrero de 2024: se desactivará la versión 12.0 y las versiones anteriores del SDK de la plataforma de Facebook.

Etiquetas:

Herramientas empresariales Plataformas Facebook