Incorporación de Marketplace de la FBE

La extensión de Facebook para empresas (FBE) permite a tus vendedores publicar fácilmente anuncios en toda la familia de apps de Facebook mediante la conexión de activos existentes de Facebook, como una página de Facebook o un administrador comercial, o mediante la creación de recursos totalmente nuevos. Puedes usar la FBE para incorporar vendedores de Marketplace a las soluciones de Meta de forma fluida.

A continuación se indican los pasos clave específicos del proceso de Marketplace. Te recomendamos que apliques estos pasos en paralelo con el uso de la documentación principal para desarrolladores.

Flujo de Marketplace de la FBE

Socio = Marketplace

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

Antes de empezar

Tu app debe ser propiedad de un administrador comercial que sea un negocio verificado. Obtén más Información sobre cómo verificar tu negocio.
Es necesaria una app de Facebook con los siguientes permisos aprobados a través de Revisión de apps:

Permiso privado
1. manage_business_extension: es un permiso privado que requiere que tu representante de Meta agregue tu app a la lista de permitidos. Para obtener ayuda, ponte en contacto con tu representante de Meta.
Permisos públicos (Marketplace debe solicitarlos a través de la revisión de apps).
1. business_management — necesario para recuperar el ID del administrador comercial creado a través de FBE y para usar la API del administrador comercial con el fin de administrar los activos comerciales.
2. ads_management — necesario para administrar los anuncios de los vendedores en nombre del cliente.

Pasos clave para FBE y la API de anuncios colaborativos

El vendedor (marca) inicia la pantalla emergente de configuración de la FBE a través del sitio web de Marketplace
El vendedor pasa por el proceso de incorporación a la FBE y completa la configuración de los activos fundamentales (Administrador comercial, página, etc.)
La FBE muestra que el vendedor ha configurado correctamente los identificadores de los activos (a través de la API o del Webhook). Una vez que Marketplace recibe los ID, se puede crear o compartir el segmento del catálogo a través de la API o de la IU (utilizando la herramienta del centro de colaboraciones del Administrador comercial).
El vendedor inicia la vista de la administración de la FBE, donde puede ver el estado del segmento de catálogo que se creó y aceptar las Condiciones del servicio, si es la primera vez que el vendedor recibe una solicitud de segmento de catálogo de marketplace.
Marketplace redirige al vendedor al proceso de creación de anuncios (proceso del productor existente - Administrador de anuncios, etc.)

Configuraciones necesarias

Extras

Campo Tipo Descripción

Campo	Tipo	Descripción
`setup`	configuración	Obligatorio La configuración del vendedor en Facebook, como su identificador único (`external_business_id`) o la divisa de su catálogo (`currency`). Consulta detalles del objeto de configuración.
`business_config`	business_config	Obligatorio Objeto de configuración que usa la extensión de Facebook para empresas para configurar el proceso de trabajo de la extensión de Facebook para empresas. Consulta `business_config` detalles del objeto.
`repeat`	booleano	Obligatorio Configura esta valor como `false`.

setup

configuración

Obligatorio

La configuración del vendedor en Facebook, como su identificador único (external_business_id) o la divisa de su catálogo (currency). Consulta detalles del objeto de configuración.

business_config

business_config

Obligatorio

Objeto de configuración que usa la extensión de Facebook para empresas para configurar el proceso de trabajo de la extensión de Facebook para empresas. Consulta business_config detalles del objeto.

repeat

booleano

Obligatorio

Configura esta valor como false.

Configuración

Campo	Descripción
`external_business_id` Tipo: cadena	Obligatorio. Identificador único del negocio que representa la empresa de tu cliente. Se usa como un identificador único. Por ejemplo, si la empresa del vendedor se llama "Fubar", "fubar-123" podría ser el `external_business_id`.
`timezone` Tipo: cadena	Obligatorio. La zona horaria donde está ubicada de la empresa. Consulta los valores posibles de zona horaria.
`currency` Tipo: cadena	Obligatorio. Código ISO de tres letras de la divisa predeterminada que usan los artículos del catálogo de la empresa. Consulta los códigos de divisas admitidos.
`business_vertical` Tipo: enumeración	Obligatorio. El sector asociado a la empresa para Marketplace es `ECOMMERCE`
`merchant_settings_id` Tipo: cadena	Opcional. Se usa cuando se actualiza desde la extensión Facebook para empresas, v1. Ponte en contacto con tu representante de Facebook si vas a migrar de la v1 a la v2.
`channel` Tipo: enumeración	Obligatorio. Proporciona una vía para que el socio exprese su intención respecto del usuario sobre las características que requieren pasos adicionales o restricciones: Nota: El `channel` para el proceso de la FBE específico de Marketplace es `MARKETPLACE`. Asegúrate de pasar esto en el campo. `channel`.
`business_manager_id` Tipo: cadena	Opcional. Identificador del Administrador comercial para el administrador comercial existente del usuario que un socio puede introducir para la preselección por parte del usuario durante el proceso de configuración.
`page_id` Tipo: cadena	Opcional. Identificador de página de la página de Facebook existente del usuario que un socio puede introducir para la preselección por parte del usuario durante el proceso de configuración.

Business Config

Usa este objeto para configurar los parámetros de empresa de un usuario final. Incluye Messenger y más. Cada campo incluye un "tipo" vinculado a las tablas correspondientes que aparecen a continuación.

Campo	Descripción
`business` FBEBusinessPropertiesConfigData	Obligatorio. Información para la empresa del usuario final.
`messenger_chat` FBEMessengerChatConfigData	Opcional. Funciones de chat de Messenger en 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 toma los artículos del catálogo de una `feed_url`
`page_cta` FBEPageCtaConfigData	Opcional. Botón "Llamada a la acción" (CTA) de la página del usuario final, como `cta_button_text`, `cta_button_url` y otros.
`ig_cta` FBEIGCtaConfigData	Opcional- Características de la función "Llamada a la acción" de Instagram, como `enabled`, `cta_button_text`, `cta_button_url`, y otras.
`messenger_menu` FBEMessengerMenuConfigData	Opcional. Características de la función "Menú persistente" de Messenger, como `cta_button-text` y `cta_button_url`

Después de la instalación

Obtener identificadores de activos, verificar notificaciones Webhook y eventos de Pixel.
Una vez que se reciben los identificadores de activos, crea/comparte el segmento del catálogo a través de la API o de la IU (mediante el uso de la herramienta del Centro de Colaboración del Administrador comercial).
Una vez que la llamada a la API de creación de segmentos de catálogo sea satisfactoria, consulta aquí los detalles sobre el lanzamiento de la ventana emergente de la vista de administración de la FBE para que el vendedor acepte los segmentos de catálogo compartidos y complete la incorporación.

Inicia la vista de administración de la FBE después de completar la configuración de la FBE y de que los identificadores de activos se hayan devuelto satisfactoriamente a través de Webhooks o API.