Versión 11.0

API Graph

Lanzamiento: 8 de junio de 2021 | Disponible hasta: 14 de septiembre de 2023 | Publicación en el blog

Aplicaciones de consumidor

Niveles de acceso

Se aplica a todas las versiones.

En las próximas semanas, se aplicarán los niveles de acceso a todas las aplicaciones de consumidor existentes. En el caso de estas aplicaciones, los permisos y las funciones que ya se hayan aprobado mediante el proceso de revisión de la aplicación recibirán automáticamente una aprobación para Advanced Access. Los demás permisos y funciones recibirán automáticamente una aprobación para Standard Access.

En las próximas semanas, también se aprobarán los niveles de acceso en todas las aplicaciones creadas recientemente. Las aplicaciones creadas recientemente recibirán de manera automática una aprobación para Advanced Access para los permisos email y public_profile. No obstante, ambos permisos se establecerán de manera predeterminada en Standard Access y deberán establecerse manualmente en Advanced Access para que los usuarios de las aplicaciones que no tienen ningún rol en estas puedan solicitarlos.

Asistencia para desarrolladores

Hemos lanzado la herramienta de estado de Facebook para empresas a fin de supervisar el estado de la plataforma y de los productos empresariales, como el Administrador de anuncios, WhatsApp Business y la plataforma para desarrolladores de Facebook.

Facebook Analytics

Retirada

Se aplica a todas las versiones.

Facebook Analytics dejará de estar disponible a partir del 30 de junio de 2021. Además, retiraremos el plugin del panel de aplicaciones para la API de marketing. Para obtener más información, visita el Servicio de ayuda para empresas.

Ya no están disponibles los campos del nodo de aplicación siguientes:

analytics_config
analytics_platform_metrics_config
permissible_ad_accounts

Ya no están disponibles los extremos siguientes:

GET Application/analytics_cohort_query
GET Application/analytics_entity_user_config
GET Application/analytics_event_types
GET Application/analytics_funnel_query
GET Application/analytics_query
GET Application/analytics_segments

API de visualización básica de Instagram

Depurador del identificador de acceso

Se aplica a todas las versiones.

El depurador del identificador de acceso ahora solo devuelve un identificador de usuario específico de la aplicación cuando se depura un identificador.

Control de versiones de la API

Se aplica a todas las versiones.

Ahora la API admite las llamadas con versión. Para consultar una versión de la API concreta, incluye el número de versión en la ruta de la consulta después de la URL base. Por ejemplo:

https://graph.instagram.com/v11.0/{node-id}/{edge-name}

Las solicitudes sin versión (las que no tienen ningún número de versión) se resuelven según la versión especificada en la configuración definida en el Panel de aplicaciones > Configuración > Opciones avanzadas > Actualizar la versión de la API de la aplicación que realiza la llamada.

Identificadores de usuario específicos de la aplicación

Se aplica a la versión 11.0 y posteriores.

Se han incorporado los identificadores de usuario específicos de la aplicación (ASID). Los ASID reemplazarán los identificadores de usuario sin formato dentro de dos años aproximadamente, cuando se retire la versión 10.0. Por este motivo, te recomendamos que empieces a asignar los identificadores sin formato de los usuarios de la aplicación a sus ASID equivalentes.

Todas las versiones admiten consultas basadas en el identificador de usuario sin formato.
Solo las llamadas de la versión 11.0 y posteriores admiten las consultas basadas en ASID.
Las llamadas de la versión 11.0 y posteriores recibirán ASID en las respuestas, incluso cuando se consulten identificadores de usuario sin formato.

Paginación basada en el tiempo

Se aplica a la versión 11.0 y las posteriores.

Se añadieron los parámetros since y until al extremo GET /{user-id}/media para admitir la paginación basada en el tiempo.

API Graph de Instagram

Recuentos de Me gusta

Se aplica a la versión 11.0 y las posteriores. Se aplicará a todas las versiones a partir del 7 de septiembre de 2021.

Si consultas un contenido multimedia de Instagram indirectamente a través de otro extremo o expansión de campo, el campo like_count se omitirá de las respuestas de la API si el propietario del contenido multimedia ha ocultado su recuento de Me gusta. Al consultar directamente el contenido multimedia de Instagram (solo puede hacerlo su propietario), se devolverá el recuento real de Me gusta, aunque se haya ocultado.

Paginación basada en el tiempo

Se aplica a la versión 11.0 y posteriores.

Se añadieron los parámetros since y until al extremo GET /{ig-user-id}/media para admitir la paginación basada en el tiempo.

Experiencias instantáneas

Plantillas

Se aplica a la versión 11.0 y posteriores.

Las plantillas de experiencia instantánea ya no se ofrecen en versión beta y ahora están disponibles para todos los desarrolladores.

Plataforma de Messenger

Webhook de postbacks de mensajes

Se aplica a la versión 11.0 y las posteriores.

El campo mid se ha añadido al webhook messaging_postbacks para que las aplicaciones puedan obtener el identificador del mensaje.

Retirada de las plantillas de aerolínea

Se aplica a la versión 11.0 y posteriores. Se aplicará a todas las versiones a partir del 6 de diciembre de 2021.

Se producirá un error en las llamadas POST /{page-id}/messages que incluyan las plantillas de aerolínea (template_type de los tipos airline_boardingpass, airline_checkin, airline_itinerary y airline_update).

oEmbed

Nueva función oEmbed Read

Se aplica a todas las versiones.

El producto oEmbed se ha reemplazado por la nueva función oEmbed Read. Si implementaste el producto oEmbed antes del 8 de junio de 2021, tienes hasta el 7 de septiembre de 2021 para completar la revisión de la aplicación de la función oEmbed Read. Si no recibes la aprobación para la función oEmbed Read antes del 7 de septiembre de 2021, no podrás cargar las implementaciones de oEmbed.

API de páginas

Identificadores de los comentarios

Se aplica a la versión 11.0 y posteriores. Se aplicará a todas las versiones a partir del 7 de septiembre de 2021.

El campo id de los comentarios no se devolverá para las aplicaciones que solo utilicen la función de acceso al contenido público de la página para consultar los extremos de las páginas. Este es el caso, por ejemplo, de los campos id/PAGEPOST-ID/comments o /COMMENT-ID/comments. Para obtener los campos id de los comentarios de las publicaciones de la página, el usuario de la aplicación debe poder realizar la tarea MODERATE en la página que consulta.

Nueva experiencia para páginas

A lo largo de los meses siguientes, todas las páginas clásicas se migrarán a la nueva experiencia para páginas. Utiliza el campo de página has_transitioned_to_new_page_experience para determinar si se ha migrado una página. Una vez que se hayan migrado todas las páginas, la experiencia de páginas clásica dejará de estar disponible.

La mayoría de los extremos de la API de páginas admiten las páginas clásicas y de NPE. Los extremos que admiten las páginas de NPE muestran la sección "Nueva experiencia para páginas" en sus referencias.

Los extremos siguientes no admiten las páginas de NPE:

/PAGE-ID/likes
/PAGE-ID/global_brand_children
/PAGE-ID/locations
/PAGE-ID/tabs
/PAGE-ID/visitor_posts

Hay varios campos de página que no están disponibles para NPE y, cuando se realice una llamada a estos, devolverán null, un conjunto de datos distinto o un error. Visita la información general de la nueva experiencia para páginas para obtener una lista de estos campos de páginas.

Permisos

user_likes

Se aplica a todas las versiones.

El uso permitido del permiso user_likes se ha actualizado. A partir del 7 de septiembre de 2021, se revocará la aprobación a aquellas aplicaciones que ya la hayan recibido para este permiso, pero que infrinjan su nueva descripción de uso.

Uso permitido anterior: mejora de forma significativa la calidad de la experiencia de usuario de la aplicación (se debe explicar con claridad al usuario cómo se utilizarán sus datos para ofrecerle esa experiencia).
Nuevo uso permitido: correlaciona o muestra el contenido relacionado con los Me gusta de la persona a fin de ofrecer una experiencia personalizada. Incluye contenido seleccionado a gran escala para personalizar las aplicaciones con grandes cantidades de contenido y permitir que las personas compartan sus Me gusta con otros usuarios, como en el caso de las aplicaciones de citas y música.

user_posts

Se aplica a todas las versiones.

El uso permitido del permiso user_posts se ha actualizado. A partir del 7 de septiembre de 2021, se revocará la aprobación a aquellas aplicaciones que ya la hayan recibido para este permiso, pero que infrinjan su nueva descripción de uso.

Uso permitido anterior: mejora de forma significativa la calidad de la experiencia de usuario de la aplicación (se debe explicar con claridad al usuario cómo se utilizarán sus datos para ofrecerle esa experiencia).
Nuevo uso permitido: permite que las personas creen libros físicos o digitales o álbumes de sus biografías, así como que compartan recuerdos de su biografía en Facebook y otras aplicaciones sociales.

SDK

Consulta el registro de cambios del SDK para iOS, el registro de cambios del Android SDK y el registro de cambios del SDK para Unity a fin de obtener información sobre los próximos cambios importantes en estos SDK.

API de marketing

Lanzamiento: 8 de junio de 2021 | Disponible hasta: 23 de febrero de 2022 | Publicación en el blog

Audiencias

Eliminación de las audiencias personalizadas, similares y guardadas

Se aplica a todas las versiones.

A partir del 8 de junio de 2021, se añadirá la marca "Audiencia a punto de caducar" a todas las audiencias personalizadas, similares y guardadas que no se hayan utilizado en ningún conjunto de anuncios activo durante más de dos años. A continuación, se programará la eliminación de las audiencias correspondientes para que tenga lugar 90 días después de que se hayan marcado como "Audiencia a punto de caducar".

Los desarrolladores podrán filtrar las audiencias por el estado "Audiencia a punto de caducar" con el campo operation_status y ver su hora estimada de eliminación en el sistema con el campo delete_time. Los desarrolladores podrán elegir entre eliminar de manera proactiva la audiencia o utilizarla en un conjunto de anuncios activo para evitar su eliminación. Cuando se elimine una audiencia, los anunciantes no podrán volverla a activar.

En el caso de las audiencias personalizadas (excepto las audiencias personalizadas de la lista de clientes), las audiencias similares o las audiencias guardadas:

Si los anunciantes quieren que se eliminen automáticamente a partir del 6 de septiembre de 2021, no deberán realizar ninguna acción. No obstante, si lo desean, también podrán eliminarlas de manera proactiva antes de su fecha de eliminación automática.
En cuanto a las audiencias marcadas que los anunciantes quieran mantener, deberán planificar su uso en un conjunto de anuncios activo antes del 6 de septiembre de 2021 a fin de que no se eliminen.

En cuanto a las audiencias personalizadas de la lista de clientes:

Las almacenamos en nombre de los anunciantes de acuerdo con sus instrucciones. Si los anunciantes no realizan ninguna acción para utilizar las audiencias marcadas en un conjunto de anuncios activo antes del 6 de septiembre de 2021, consideraremos que quieren que las eliminemos.

Se verán afectados los extremos y campos siguientes:

GET /{custom-audience-id}
GET /act_{ad-account-id}/customaudiences?filtering
GET /act_{ad-account-id}/saved_audiences?filtering
GET /{saved-audience-id}

Consulta Información general de las audiencias: Cambios en la eliminación de las audiencias personalizadas para obtener más información sobre estas actualizaciones.

API de empresa

Se aplica a todas las versiones.

Limitaremos temporalmente el acceso a los extremos siguientes. Solo las aplicaciones que hayan llamado correctamente a estos extremos en los últimos 30 días seguirán teniendo acceso a ellos.

Las demás aplicaciones recibirán un error cuando realicen llamadas a estos extremos.

API de catálogo

Retirada del campo de inventario de productos

Se aplica a la versión 11.0 y posteriores.

El campo inventory se retirará y se reemplazará por el nuevo campo quantity_to_sell_on_facebook. Aunque seguiremos admitiendo el campo inventory, te recomendamos que utilices el nuevo campo quantity_to_sell_on_facebook en su lugar.

Se verán afectados los extremos siguientes:

Consulta la documentación Cantidad que se puede vender y Campos admitidos para los productos: anuncios dinámicos y comercio para obtener más información sobre esta actualización.

Eliminación de los grupos de productos no vacíos

Se aplica a la versión 11.0 y posteriores. Se aplicará a todas las versiones a partir del 7 de septiembre de 2021.

Ya no permitiremos la eliminación de los grupos de productos no vacíos de manera predeterminada. Para eliminar los grupos de productos no vacíos, se puede aplicar deletion_method=delete_items en la solicitud de eliminación. De este modo, se eliminará el grupo de productos y sus elementos.

Se verá afectado el extremo siguiente:

DELETE /<product_group_id>

Eliminación de los conjuntos de productos publicados

Se aplica a la versión 11.0 y posteriores. Se aplicará a todas las versiones a partir del 7 de septiembre de 2021.

Ya no permitiremos la eliminación de un catálogo con los conjuntos de productos publicados de manera predeterminada. Para permitir la eliminación de un catálogo que contenga un conjunto de productos publicado, establece el parámetro allow_delete_catalog_with_live_product_set del catálogo en true.

Este cambio afecta al extremo siguiente:

DELETE /<product_catalog_id>

Nuevo extremo de diagnóstico

Se aplica a la versión 11.0 y las posteriores.

Hemos añadido el nuevo extremo GET /{product_catalog_id}/diagnostics. Este puede utilizarse para recuperar datos de diagnóstico de un catálogo específico, como, por ejemplo, problemas que impiden que se muestren los productos en canales y oportunidades que podrían mejorar la visibilidad de los productos.

API de comercio

Detalles del pago total estimado del pedido

Se aplica a la versión 11.0 y posteriores. Se aplicará a todas las versiones a partir del 7 de septiembre de 2021.

Cambiaremos la forma en la que se notifican los detalles de los pagos estimados en el total de los pedidos de las llamadas al extremo {commerce-order-id}/?fields=estimated_payment_details. Anteriormente, si un pedido no se completaba, se aplicaba un impuesto estimado, mientras que, en el caso de los pedidos realizados, se aplicaba el impuesto completo. A partir de la versión 11.0, este extremo siempre utilizará el impuesto estimado. Para acceder a los detalles sobre el impuesto completo, puedes utilizar {commerce-order-id}/items?fields=tax_details.

Lift en conversiones

Cambios en las métricas

Se aplica a la versión 11.0 y posteriores. Se aplicará a todas las versiones a partir del 7 de septiembre de 2021.

Han cambiado las métricas que devuelve el campo GET /{objective-id}/?fields=result.

Se han añadido las métricas siguientes:

conversions_incremental_share
conversions_CPiC
conversions_multicell_confidence
conversions_multicell_rank
sales_incremental_share
sales_multicell_confidence
sales_multicell_rank
buyers_incremental_share
buyers_CPiB
buyers_multicell_confidence
buyers_multicell_rank

Se han eliminado las métricas siguientes:

advancedBuyers.control
ancedBuyers.informativeMultiCellBayesianConfidence
advancedBuyers.lift
advancedBuyers.test
advancedConversions.control
advancedConversions.informativeMultiCellBayesianConfidence
advancedConversions.lift
advancedConversions.test
advancedSales.control
advancedSales.informativeMultiCellBayesianConfidence
advancedSales.lift
advancedSales.test
buyers.baseline
buyers.bayesianCILower
buyers.bayesianCIUpper
buyers.control
buyers.delta
buyers.incremental
buyers.isStatSig
buyers.lift
buyers.multiCellBayesianConfidence
buyers.reachedPercent
buyers.singleCellBayesianConfidence
conversions.baseline
conversions.bayesianCILower
conversions.bayesianCIUpper
conversions.control
conversions.delta
conversions.incremental
conversions.isStatSig
conversions.lift
conversions.multiCellBayesianConfidence
conversions.reachedPercent
conversions.singleCellBayesianConfidence
frequency
incrementalROAS
sales.baseline
sales.bayesianCILower
sales.bayesianCIUpper
sales.control
sales.delta
sales.incremental
sales.isStatSig
sales.lift
sales.multiCellBayesianConfidence
sales.singleCellBayesianConfidence

Se ha cambiado el nombre de las métricas siguientes:

Nombre antiguo	Nombre nuevo
`advancedBuyers.baseline`	`buyers_not_exposed`
`advancedBuyers.bayesianCILower`	`buyers_incremental_lower`
`advancedBuyers.bayesianCIUpper`	`buyers_incremental_upper`
`advancedBuyers.incremental`	`buyers_incremental`
`advancedBuyers.informativeMultiCellPairwiseBayesianConfidence`	`buyers_multicell_confidence`
`advancedBuyers.informativeSingleCellBayesianConfidence`	`buyers_confidence`
`advancedBuyers.scaled`	`buyers_control_scaled`
`advancedConversions.baseline`	`conversions_not_exposed`
`advancedConversions.bayesianCILower`	`conversions_incremental_lower`
`advancedConversions.bayesianCIUpper`	`conversions_incremental_upper`
`advancedConversions.incremental`	`conversions_incremental`
`advancedConversions.informativeMultiCellPairwiseBayesianConfidence`	`conversions_multicell_confidence`
`advancedConversions.informativeSingleCellBayesianConfidence`	`conversions_confidence`
`advancedConversions.scaled`	`conversions_control_scaled`
`advancedSales.baseline`	`sales_not_exposed`
`advancedSales.bayesianCILower`	`sales_incremental_lower`
`advancedSales.bayesianCIUpper`	`sales_incremental_upper`
`advancedSales.incremental`	`sales_incremental`
`advancedSales.informativeMultiCellPairwiseBayesianConfidence`	`sales_multicell_confidence`
`advancedSales.informativeSingleCellBayesianConfidence`	`sales_confidence`
`advancedSales.scaled`	`sales_control_scaled`
`buyers.pValue`	`buyers_raw_pValue`
`buyers.reached`	`buyers_exposed`
`buyers.scaled`	`buyers_control_raw_scaled`
`buyers.test`	`buyers_test`
`conversions.pValue`	`conversions_raw_pValue`
`conversions.reached`	`conversions_exposed`
`conversions.scaled`	`conversions_control_raw_scaled`
`conversions.test`	`conversions_test`
`IncrementalROAS`	`sales_ROAS`
`sales.pValue`	`sales_raw_pValue`
`sales.reached`	`sales_exposed`
`sales.scaled`	`sales_control_raw_scaled`
`sales.test`	`sales_test`

Puedes ver una lista completa de las métricas disponibles en el Glosario de métricas de lift de Facebook.

API de insights

Retirada de las métricas de visitas en el negocio

Se aplica a la versión 11.0 y posteriores. Se aplicará a todas las versiones a partir del 6 de septiembre de 2021.

Se han retirado las métricas store_visits_actions y cost_per_store_visit_actions.

Se ven afectados los extremos siguientes:

API de anuncios sobre ofertas

Retirada de los extremos de la API de anuncios sobre ofertas

Se aplica a la versión 11.0 y posteriores. Se aplicará a todas las versiones a partir del 7 de septiembre de 2021.

Como parte de nuestra iniciativa continua por aumentar la estabilidad del producto, Facebook finalizará el soporte para el producto de anuncios sobre ofertas el 8 de junio de 2021. Los anuncios de Facebook estándar son el sustituto recomendado para distribuir tus descuentos en la tienda y en internet. Se aconseja colocar la información sobre descuentos, ubicaciones de canje, fecha de caducidad y códigos promocionales directamente en el contenido de nivel de anuncio.

Se han retirado los extremos siguientes:

GET /{page-id}/nativeoffers
POST /[page-id}/nativeoffers
GET /pagename/nativeoffers
GET /{native-offer-id}
GET /{native-offer-id}/views
POST /{native-offer-id}/codes
POST /{native-offer-id}/nativeofferviews
GET /{offer-id}/comments
GET /{offer-id}/sharedposts
GET /{offer-id}/likes