Versión 11.0

API Graph

Lanzamiento: 8 de junio de 2021 | Disponible hasta: 14 de septiembre de 2023 | Entrada de blog

Apps para consumidores

Niveles de acceso

Se aplica a todas las versiones.

En las próximas semanas, se aplicarán niveles de acceso a todas las apps para consumidores existentes. Para estas apps, los permisos y las funciones que ya se aprobaron a través del proceso de revisión de apps quedarán automáticamente aprobados para el acceso avanzado. Los demás permisos y las demás funciones se aprobarán automáticamente para el acceso avanzado.

En las próximas semanas, los niveles de acceso también se aplicarán a las apps recientemente creadas. Estas apps recibirán automáticamente la aprobación para el acceso avanzado a los permisos de email y public_profile. Sin embargo, ambos permisos se establecerán de manera predeterminada en "acceso estándar" y deben configurarse manualmente en "acceso avanzado" antes de que puedan consultarse desde los usuarios de la app que no tienen roles en las apps.

Ayuda para desarrolladores

Lanzamos la herramienta de estado de Facebook para empresas para supervisar el estado de la plataforma y los productos comerciales, como el administrador de anuncios, WhatsApp Business y la plataforma de desarrolladores de Facebook.

Facebook Analytics

Obsolescencia

Se aplica a todas las versiones.

Facebook Analytics dejará de estar disponible después del 30 de junio de 2021. Asimismo, el complemento del panel de apps para la API de marketing quedará obsoleto. Para obtener más información, visita el servicio de ayuda para empresas.

Los siguientes campos de nodos de aplicación ya no están disponibles:

• analytics_config
• analytics_platform_metrics_config
• permissible_ad_accounts

Los siguientes puntos de conexión ya no están disponibles:

• 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 de token de acceso

Se aplica a todas las versiones.

El depurador de tokens de acceso ahora solo devuelve un identificador específico de la app cuando se depura un token.

Versión de la API

Se aplica a todas las versiones.

La API admite ahora llamadas con versión. Para consultar una versión específica de una API, 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 (sin el número de versión) usarán la versión especificada en la configuración Panel de apps > Configuración > Avanzado > Actualizar versión de la API de la app de llamadas.

Identificadores de usuario específicos de la app

Se aplica a la versión 11.0 y posteriores.

Se introdujeron identificadores de usuario específicos de la app (ASID). Los ASID reemplazarán a los identificadores de usuario sin procesar en unos dos años, cuando la versión 10.0 quede obsoleta. Por este motivo, te recomendamos que empieces a asignar los identificadores de usuario sin procesar a sus equivalentes ASID.

• Todas las versiones admiten las consultas basadas en identificadores de usuario sin procesar.
• Solo las llamadas de la versión 11.0 o posteriores admiten las consultas basadas en ASID.
• Las llamadas de la versión 11.0 o posteriores recibirán ASID en las respuestas, aunque se consulten identificadores de usuario sin procesar.

Paginación basada en el tiempo

Se aplica a partir de la versión 11.0.

Parámetros since y until agregados al punto de conexión GET /{user-id}/media para admitir paginación basada en el tiempo.

API Graph de Instagram

Conteos de Me gusta

Se aplica a partir de la versión 11.0 Se implementará en todas las versiones a partir del 7 de septiembre de 2021.

Si se consulta de forma indirecta un contenido multimedia de IG a través de otro punto de conexión o expansión de campo, el campo like_count se omitirá de las respuestas de la API, siempre que el propietario del contenido multimedia haya ocultado los Me gusta en él. Solicitar de manera directa el contenido multimedia de IG (algo que solo el propietario del contenido multimedia de IG puede hacer) devolverá el conteo real de Me gusta, incluso si se ocultó este conteo.

Paginación basada en el tiempo

Se aplica a partir de la versión 11.0.

Parámetros since y until agregados al punto de conexión GET /{ig-user-id}/media para admitir paginación basada en el tiempo.

Experiencias instantáneas

Plantillas

Se aplica a la versión 11.0 y posteriores.

Las plantillas de experiencias instantáneas salieron de la 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 posteriores.

El campo mid se agregó al webhook messaging_postbacks para permitir que las apps obtengan el identificador de mensaje.

Plantillas para aerolíneas obsoletas

Se aplica a partir de la versión 11.0 Se implementará en todas las versiones el 6 de diciembre de 2021.

No se podrán realizar las llamadas a POST /{page-id}/messages que incluyan alguna plantilla para aerolíneas (template_type del tipo airline_boardingpass, airline_checkin, airline_itinerary, airline_update).

oEmbed

Nueva función oEmbed Read

Se aplica a todas las versiones.

Se reemplazó el producto oEmbed con una nueva función oEmbed Read. Si implementaste el producto oEmbed antes del 8 de junio de 2021, tienes tiempo hasta el 7 de septiembre de 2021 para completar la revisión de apps para la función oEmbed Read. Si no cuentas con la función oEmbed Read aprobada antes del 7 de septiembre de 2021, no se cargarán tus implementaciones de oEmbed.

API de páginas

Identificadores de comentarios

Se aplica a partir de la versión 11.0 Se implementará en todas las versiones a partir del 7 de septiembre de 2021.

No se devolverá el campo id de los comentarios de ninguna app que solo use la función de acceso al contenido público de la página para consultar los puntos de conexión de las páginas. Estos incluyen los campos id/PAGEPOST-ID/comments o /COMMENT-ID/comments. A fin de obtener los campos id de los comentarios en las publicaciones de la página, el usuario de la app debe poder realizar la tarea "MODERATE" en la página sobre la que se realiza la consulta.

Nueva experiencia para páginas

En los próximos meses, todas las páginas clásicas se migrarán a la nueva experiencia para páginas. Usa el el campo de la página has_transitioned_to_new_page_experience para determinar si se migró la página. Después de que todas las páginas hayan migrado, dejará de estar disponible la experiencia para páginas clásica.

La mayoría de los puntos de conexión de la API de páginas admite las páginas clásicas y las que usan la nueva experiencia para páginas (NPE). Los puntos de conexión que admiten las páginas NPE muestran una sección "nueva experiencia para páginas" en sus referencias.

Los siguientes puntos de conexión no admiten las páginas NPE:

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

Varios campos de página no están disponibles en las páginas NPE y devolverán null, un conjunto de datos distinto o un error cuando sean llamadas. Consulta nuestra información general sobre las funciones de la nueva experiencia para páginas a fin de obtener una lista de estos campos de página.

Permisos

user_likes

Se aplica a todas las versiones.

Se actualizó el uso permitido del permiso user_likes. Desde el 7 de septiembre de 2021, a las apps que ya recibieron la aprobación para este permiso, pero que no cumplen con la nueva descripción de uso, se les revocará la aprobación.

• Uso autorizado anterior: mejora significativamente la calidad de la experiencia del usuario en tu app. Se le debe explicar con claridad al usuario cómo se usarán sus datos para ofrecerle esa experiencia.
• Nuevo uso permitido: ofrece una experiencia personalizada al correlacionar o mostrar contenido vinculado con los Me gusta de la persona. Esto incluye seleccionar contenido a gran escala para personalizar las apps con grandes volúmenes de contenido y permitir a las personas compartir los Me gusta con otras, por ejemplo, en apps de citas o música.

user_posts

Se aplica a todas las versiones.

Se actualizó el uso permitido para el permiso user_posts. Desde el 7 de septiembre de 2021, a las apps que ya recibieron la aprobación para este permiso, pero que no cumplen con la nueva descripción de uso, se les revocará la aprobación.

• Uso autorizado anterior: mejora significativamente la calidad de la experiencia del usuario en tu app. Se le debe explicar con claridad al usuario cómo se usarán sus datos para ofrecerle esa experiencia.
• Nuevo uso permitido: permite a las personas crear álbumes o libros digitales o físicos de su biografía, y compartir las memorias de sus biografías en Facebook y en otras apps sociales.

SDK

Consulta el registro de cambios de SDK para iOS, registro de cambios de SDK para Android y Registro de cambios de 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 | Entrada de blog

Públicos

Eliminación de públicos personalizados; públicos similares y públicos guardados

Se aplica a todas las versiones.

A partir del 8 de junio de 2021, se marcarán como "Expiring Audience" ("Público a punto de caducar") todos los públicos personalizados, similares o guardados que no se hayan utilizado en un conjunto de anuncios activos en más de dos años. Luego, se programará la eliminación de dicho público en 90 días.

Los desarrolladores podrán filtrar el estado "Expiring Audience" con el campo operation_status y ver en el sistema cuál es el tiempo estimado de eliminación del público mediante el campo delete_time. Los desarrolladores pueden elegir eliminar de manera proactiva el público o usarlo en un conjunto de anuncios activos para evitar que se elimine. Cuando un público se elimina, los anunciantes no pueden reactivarlo.

En relación con los públicos personalizados (excepto los públicos personalizados de listas de clientes), los públicos similares o los públicos guardados:

• Si los anunciantes desean que los públicos marcados se eliminen de manera automática a partir del 6 de septiembre de 2021, no es necesario que hagan nada. Sin embargo, si los anunciantes lo desean, también pueden eliminar los públicos antes de la fecha de eliminación automática.
• En cambio, si los anunciantes desean conservar los públicos marcados, deberían planificar usarlos en un conjunto de anuncios activos antes del 6 de septiembre de 2021 para evitar que se eliminen.

En relación con los públicos personalizados de listas de clientes:

• Los almacenamos en nombre de los anunciantes y de conformidad con sus instrucciones. Si los anunciantes no realizan ninguna acción para usar los públicos marcados en un conjunto de anuncios activo antes del 6 de septiembre de 2021, interpretaremos que nos están indicando que desean que eliminemos al público marcado.

Se verán afectados los siguientes puntos de conexión y campos:

• 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 sobre públicos: cambios en la eliminación de los públicos personalizados para obtener más información sobre estas actualizaciones.

API de negocios

Se aplica a todas las versiones.

En estos momentos, limitamos el acceso a los siguientes puntos de conexión: Solo las apps que llamaron correctamente a estos puntos de conexión en los últimos 30 días seguirán teniendo acceso.

• POST /BUSINESS-ID/client_ad_accounts
• POST /ADACCOUNT-ID/agencies

A todas las demás apps se les mostrará un error cuando realicen la llamada a estos puntos de conexión.

API de catálogo

Campo de inventario de producto obsoleto

Se aplica a la versión 11.0 y posterior.

El campo inventory quedará obsoleto y se reemplazará por el nuevo campo quantity_to_sell_on_facebook. Aunque seguiremos admitiendo el campo inventory en el futuro inmediato, recomendamos que, en su lugar, uses el nuevo campo quantity_to_sell_on_facebook.

Se verán afectados los siguientes puntos de conexión:

• GET /{product-item-id}
• GET /{catalog-id}/products
• POST /{product-item-id}
• POST /{catalog-id}/items_batch

Consulta la cantidad para vender y Campos de productos admitidos: anuncios dinámicos y comercio para obtener más información sobre esta actualización.

Eliminación de grupos de productos no vacíos

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

No permitiremos que se eliminen de forma predeterminada los grupos de productos no vacíos. Solo se podrán eliminar los grupos de productos no vacíos aplicando el código deletion_method=delete_items a la solicitud de eliminación. Esto eliminará el grupo de productos y sus elementos.

Se verá afectado el siguiente punto de conexión:

• DELETE /<product_group_id>

Eliminación de conjuntos de productos en vivo

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

No permitiremos que se eliminen de forma predeterminada catálogos de productos en vivo. Para permitir la eliminación de un catálogo que contiene un conjunto de productos en vivo, configura el parámetro allow_delete_catalog_with_live_product_set del catálogo en true.

Esto afecta al siguiente punto de conexión:

• DELETE /<product_catalog_id>

Nuevo punto de conexión de diagnóstico

Se aplica a la versión 11.0 y posterior.

Agregamos un nuevo punto de conexión GET /{product_catalog_id}/diagnostics. Este punto de conexión puede usarse para recuperar los datos de diagnóstico de un determinado catálogo como, por ejemplo, los problemas que impiden que los productos se muestren en canales y las oportunidades que podrían mejorar la visibilidad de los productos.

API de comercio

Detalles del pago estimado total del pedido

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

Cambiamos la forma en que se reportan los detalles del pago estimado en los totales de los pedidos para las llamadas al punto de conexión {commerce-order-id}/?fields=estimated_payment_details. Anteriormente, si no se cumplía un pedido, se utilizaba un impuesto estimado y, en el caso de los pedidos cumplidos, se aplicaba el impuesto correspondiente. A partir de la versión 11.0, este punto de conexión siempre utilizará el impuesto estimado. Ten en cuenta que se puede acceder a la Información detallada sobre el impuesto final con {commerce-order-id}/items?fields=tax_details.

Aumento de conversiones

Cambios en las métricas

Se aplica a partir de la versión 11.0 Se implementará en todas las versiones a partir del 7 de septiembre de 2021.

Cambiaron las métricas que se devuelven en el campo GET /{objective-id}/?fields=result.

Se agregaron las siguientes métricas:

• 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 eliminaron las siguientes métricas:

• 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 cambió el nombre de las siguientes métricas:

Se puede consultar la lista completa de métricas disponibles en el glosario de métricas de estudios de aumento de Facebook.

API de estadísticas

Métricas de visitas al negocio obsoletas

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

Quedarán obsoletas las métricas store_visits_actions y cost_per_store_visit_actions.

Se verán afectados los siguientes puntos de conexión:

• GET /{adaccount-id}/insights
• GET /{campaign-id}/insights
• GET /{adset-id}/insights
• GET /{ad-id}/insights
• POST /{adaccount-id}/insights
• POST /{campaign-id}/insights
• POST /{adset-id}/insights
• POST /{ad-id}/insights

API de anuncios sobre ofertas

Puntos de conexión de la API de anuncios sobre ofertas obsoletos

Se aplica a partir de la versión 11.0 Se implementará en todas las versiones a partir del 7 de septiembre de 2021.

Como parte de nuestras continuas iniciativas para mejorar la estabilidad de los productos, Facebook dejará de admitir nuestro producto de anuncios sobre ofertas el 8 de junio de 2021. Se recomienda utilizar los anuncios de Facebook estándares como reemplazo para distribuir los descuentos online y en la tienda. Se recomienda colocar la información sobre descuentos, ubicaciones de canje, fecha de caducidad y códigos promocionales directamente en el contenido del nivel del anuncio.

Los siguientes puntos de conexión quedarán obsoletos:

• 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