Introducing Facebook Graph API v12.0 and Marketing API v12.0

Hoy lanzamos la versión 12.0 de la API Graph y de la API de marketing de Facebook. A continuación, destacamos los cambios que afectarán a parte de nuestra comunidad de desarrolladores. Estos cambios incluyen anuncios y actualizaciones de productos, recordatorios de lanzamientos anteriores y notificaciones de las obsolescencias a gran escala que pueden afectar la integración de las apps en nuestra plataforma.

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

Actualizaciones y anuncios generales

API de conversiones: expansión de la versión mínima a la que se puede llamar

Compatibilidad con versiones anteriores de la API Graph para las apps creadas con los tokens de acceso de un solo clic: A partir de la versión 12.0, los tokens de acceso nuevos generados en la pestaña de configuración de la API de conversiones en el administrador de eventos son compatibles con todas las versiones existentes de la API Graph (consulta aquí las versiones admitidas).

Ten en cuenta que las llamadas que se hagan con estos tokens a una versión de la API Graph obsoleta se resolverán enviándose automáticamente a la versión disponible más antigua. Este comportamiento solo se aplica a los puntos de conexión de la API Graph. Los puntos de conexión de la API de marketing, incluso la API de conversiones, no admiten el comportamiento de autoactualización y ocurrirá una excepción.

API de perfil de usuario para los mensajes de Instagram: nuevos campos

Implementamos mejoras a la API de perfil de usuario para los mensajes de Instagram. Anteriormente, la API de perfil de usuario para los mensajes de Instagram admitía dos campos: 1) nombre y 2) URL de la foto del perfil. A fin de que las empresas puedan personalizar y priorizar mejor los mensajes según la información de usuario que está disponible públicamente, actualizamos la API para que también incluya la siguiente información:

1. Conteo de seguidores
2. Insignia de cuenta verificada
3. La empresa sigue la cuenta de usuario [Sí/No]
4. La cuenta de usuario sigue la cuenta comercial [Sí/No]

Consulta la documentación para desarrolladores si quieres obtener información detallada.

Nuevas oportunidades de segmentación detallada

Con el fin de ayudar a los anunciantes a encontrar oportunidades adicionales que no hubieran estado a su disposición desde el inicio, se incluirán automáticamente en la expansión de la segmentación los eventos de valores o la app que usen objetivos de conversión cuando los anunciantes aprovechen la segmentación detallada y optimicen las conversiones. Consulta el artículo del servicio de ayuda sobre Expansión de la segmentación detallada para obtener más información.

API de video: nuevos campos

Agregamos al nodo [Video] dos campos más, "views" y "post_views". Consulta la documentación para desarrolladores sobre la API de video para obtener más información.

Elementos obsoletos y cambios radicales

Transparencia de errores

El comportamiento predeterminado de la API Graph y de la API de marketing es mostrar un error cuando una app solicita un campo o un perímetro en un nodo que devuelve un nodo o nodos asociados, pero al que le faltan los permisos correspondientes que solicitan los nodos asociados. Sin embargo, una determinada cantidad de estos campos o perímetros no seguían este protocolo y, en su lugar, se omitían en las respuestas de la API si la app que hacía la llamada no contaba con los permisos correspondientes.

A partir de la versión 12.0, estos campos y perímetros cumplirán con el comportamiento predeterminado. Este cambio se aplicará a todas las versiones a partir del 13 de diciembre de 2021.

• Perímetros de la API Graph afectados
• Perímetros de la API de marketing afectados

Usuarios del sistema y roles de la app

Vamos a retirar la posibilidad de que a los usuarios del sistema se les puedan otorgar roles en las apps, excepto cuando los usuarios y las apps pertenezcan a la misma empresa. Para evitar que la app y la empresa sufran interrupciones, recomendamos eliminar a estos usuarios del sistema de la app y usar en su lugar la API comercial "En nombre de". Estos cambios radicales entrarán en vigor el 13 de diciembre de 2021.

Video en vivo programado

Vamos a retirar el parámetro "planned_start_time" de la función de programación en la Live API. El cambio radical entrará en vigor el 13 de diciembre de 2021. Se anunciará en el futuro un nuevo parámetro.

Plataforma de Messenger: API de conversaciones

Vamos a retirar el campo "user_id" de los metadatos de conversaciones en la API de conversiones. Será necesario que todos los desarrolladores migren las referencias a "user_id" (IGID) y que se basen completamente en IGSID como identificador primario de una conversación entre el usuario y la empresa.

Este cambio radical entrará en vigor para las versiones anteriores de la API Graph el 13 de diciembre de 2021. Consulta la documentación para desarrolladores sobre la API de conversaciones para obtener más información.

Plataforma de Messenger: webhooks de Instagram

Actualizamos el webhook de reacción de la API de Messenger de Instagram con el fin de lograr una mejor compatibilidad con las reacciones con emojis. La versión actual devuelve el campo de emoji como cadena: con esta actualización, los webhooks de reacción devolverán un nuevo formato unicode. Ten en cuenta que el campo "reaction" solo se admite con los emojis predeterminados. Para todos los demás emojis, el campo "reaction" devolverá "other"; lo mismo que sucede con MSGR.

Este cambio radical entrará en vigor para las versiones anteriores de la API Graph a partir del 13 de diciembre de 2021. Para seguir admitiendo las reacciones con emojis, todos los desarrolladores deben migrar al nuevo unicode que devolveremos antes del 13 de diciembre de 2021. Consulta la documentación para desarrolladores sobre webhooks a fin de obtener información detallada.

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

• El 2 de noviembre de 2021, quedará obsoleta la versión 4.0 de la API Graph y se la eliminará de la plataforma.
• El 3 de febrero de 2022, quedará obsoleta la versión 5.0 de la API Graph y se la eliminará de la plataforma.
• El 22 de mayo de 2022, quedará obsoleta la versión 6.0 de la API Graph y se la 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.

API de marketing

• El 4 de octubre de 2021, quedará obsoleta la versión 10.0 de la API de marketing.
• El 23 de febrero de 2022, quedará obsoleta la versión 11.0 de la API de marketing.

Para evitar interrupciones en tu negocio, te recomendamos que migres todas las llamadas a la última versión de la API de marketing que lanzamos hoy. (Visita el registro de cambios para obtener más información).

SDK de la plataforma de Facebook

• El 19 de enero de 2021, anunciamos el cronograma de dos años de elementos obsoletos para la versión 8.x y anteriores del SDK de la plataforma de Facebook. Estas versiones se desactivarán en enero de 2023.
• El 8 de junio de 2021, lanzamos la versión 11.0 del SDK de la plataforma de Facebook, que comenzó la obsolescencia de la versión 9.0 del SDK de la plataforma de Facebook, que durará 2 años. Se desactivará la versión 9.0 del SDK en junio de 2023.

Elementos obsoletos generales

Obsolescencia del punto de conexión nativo de ofertas

El 8 de junio de 2021 anunciamos la obsolescencia de la API de anuncios sobre ofertas. Este cambio entrará en vigor de forma inmediata con el lanzamiento de la versión 12.0 de la API Graph.

Plataforma de Messenger: plantillas para aerolíneas

El 8 de junio de 2021, anunciamos la obsolescencia de las plantillas para aerolíneas. Este cambio entrará en vigor el 6 de diciembre de 2021.