Incorporación del Marketplace de FBE

La extensión de Facebook para empresas (FBE) permite a tus vendedores publicar anuncios fácilmente en toda la familia de aplicaciones de Facebook. Para ello, pueden conectar los activos de Facebook existentes, como una página de Facebook o una cuenta de Business Manager, o bien crear activos completamente nuevos. FBE se puede utilizar para incorporar fácilmente vendedores del Marketplace a las soluciones de Meta.

A continuación, se muestran los pasos clave específicos para el proceso de Marketplace. Te recomendamos utilizarlos junto con la documentación para desarrolladores principal.

Proceso de Marketplace de FBE

Socio = Marketplace

FBE = extensión de Facebook para empresas (IU propiedad de Facebook)

Antes de empezar

Tu aplicación debe pertenecer a un Business Manager de una empresa verificada. Obtén más información sobre cómo verificar tu empresa.
Se requiere una aplicación de Facebook con los permisos siguientes aprobados mediante la revisión de la aplicación:

Permiso privado
1. manage_business_extension: se trata de un permiso privado que requiere que tu representante de Meta añada la aplicación a la lista de autorizados.
Permisos públicos (el Marketplace debe solicitarlos mediante la revisión de la aplicación).
1. business_management: se requiere para recuperar el identificador de Business Manager creado mediante FBE, así como para utilizar la API de Business Manager a fin de administrar los activos de la empresa.
2. ads_management: se requiere para administrar anuncios de los vendedores en nombre del cliente.

Pasos clave para FBE y la API de anuncios colaborativos

El vendedor (marca) inicia una pantalla emergente de configuración de FBE a través del sitio web de Marketplace.
El vendedor se somete al proceso de incorporación de FBE y completa la configuración de los activos principales (Business Manager, la página, etc.).
FBE devuelve una notificación que indica que el vendedor configuró correctamente los identificadores de los activos (mediante la API o el webhook). Una vez que el Marketplace recibe los identificadores, el segmento del catálogo puede crearse o compartirse mediante la API o la IU (con la herramienta del Centro de colaboraciones de Business Manager).
El vendedor inicia la visualización de administración de FBE, en la que puede ver el estado del segmento del catálogo creado y aceptar las Condiciones del servicio (si es la primera vez que recibe una solicitud de segmento del catálogo del Marketplace).
El Marketplace redirige al vendedor al proceso de creación de anuncios (proceso de productor existente, Administrador de anuncios, etc.).

Configuraciones obligatorias

Elementos adicionales

Campo Tipo Descripción

Campo	Tipo	Descripción
`setup`	Configuración	Obligatorio Configuración de Facebook del vendedor, por ejemplo, su identificador único (`external_business_id`) o la divisa de su catálogo (`currency`). Consulta los detalles del objeto de configuración.
`business_config`	business_config	Obligatorio Objeto de configuración que utiliza la extensión de Facebook para empresas a fin de configurar el proceso de trabajo de dicha extensión. Consulta los detalles del objeto `business_config`.
`repeat`	Booleano	Obligatorio Establece este valor en `false`.

setup

Configuración

Obligatorio

Configuración de Facebook del vendedor, por ejemplo, su identificador único (external_business_id) o la divisa de su catálogo (currency). Consulta los detalles del objeto de configuración.

business_config

business_config

Obligatorio

Objeto de configuración que utiliza la extensión de Facebook para empresas a fin de configurar el proceso de trabajo de dicha extensión. Consulta los detalles del objeto business_config.

repeat

Booleano

Obligatorio

Establece este valor en false.

Configuración

Campo	Descripción
`external_business_id` Tipo: cadena	Obligatorio Identificador único de la empresa que representa la empresa de tu cliente. Lo utilizamos como identificador único. Por ejemplo, si la empresa del vendedor se denomina "Fubar", "fubar-123" podría ser su `external_business_id`.
`timezone` Tipo: cadena	Obligatorio Zona horaria en la que está ubicada la empresa. Consulta los valores posibles de zona horaria.
`currency` Tipo: cadena	Obligatorio. Código de divisa ISO de tres letras de la divisa predeterminada que utilizan los artículos del catálogo de la empresa. Consulta los códigos de divisa admitidos.
`business_vertical` Tipo: enumeración	Obligatorio. El sector asociado con la empresa del Marketplace es `ECOMMERCE`.
`merchant_settings_id` Tipo: cadena	Opcional. Se utiliza al realizar la actualización desde la versión 1 de la extensión de Facebook para empresas. Ponte en contacto con tu representante de Facebook si vas a realizar la migración de la versión 1 a la 2.
`channel` Tipo: enumeración	Obligatorio. Proporciona una forma de que el socio exprese la intención del usuario en relación con las funciones que requieren pasos adicionales o limitaciones: Nota: El elemento `channel` del proceso de FBE específico del Marketplace es `MARKETPLACE`. Asegúrate de que lo pasas en el campo `channel`.
`business_manager_id` Tipo: cadena	Opcional. Identificador de la cuenta de Business Manager existente del usuario que un socio puede introducir para seleccionarlo previamente para el usuario en el proceso de configuración.
`page_id` Tipo: cadena	Opcional. Identificador de la página de Facebook existente del usuario que el socio puede introducir para seleccionarlo previamente para el usuario en el proceso de configuración.

Configuración empresarial

Utiliza este objeto para establecer la configuración de la empresa para un usuario final; incluye Messenger, entre otras cosas. Cada campo incluye un “tipo” vinculado a las tablas correspondientes que hay a continuación.

Campo	Descripción
`business` FBEBusinessPropertiesConfigData	Obligatorio. Información de la empresa del usuario final.
`messenger_chat` FBEMessengerChatConfigData	Opcional. Funciones de chat de Messenger de la página de Facebook del usuario final, como `enabled` y `domains`.
`catalog_feed_scheduled` FBECatalogFeedConfigData	Opcional. Determina si la extensión de Facebook para empresas debe usar un enfoque de lista, que coge artículos del catálogo de un objeto `feed_url`.
`page_cta` FBEPageCtaConfigData	Opcional. Botón de llamada a la acción de la página del usuario final, como `cta_button_text`, `cta_button_url`, etc.
`ig_cta` FBEIGCtaConfigData	Opcional. Funciones de llamada a la acción de Instagram, como `enabled`, `cta_button_text`, `cta_button_url`, etc.
`messenger_menu` FBEMessengerMenuConfigData	Opcional. Funciones del menú persistente de Messenger, como `cta_button-text` y `cta_button_url`

Después de la instalación

Obtén los identificadores de activos y verifica las notificaciones de webhook y los eventos de píxel.
Una vez que se reciban los identificadores de activos, crea o comparte el segmento del catálogo a través de la API o la IU (mediante la herramienta del centro de colaboración de Business Manager).
Una vez que la llamada a la API de creación de segmentos del catálogo se realice correctamente, comprueba aquí los detalles sobre cómo iniciar una ventana emergente de la visualización de administración de FBE a fin de que el vendedor acepte los segmentos del catálogo compartidos y complete la incorporación.

Inicia la visualización de administración de FBE una vez que la configuración de FBE se complete y los identificadores de activos se devuelvan correctamente mediante Webhooks o API.