Incorporación del píxel y la API de conversiones de MBE

El proceso del píxel y la API de conversiones de la extensión de Meta para empresas (MBE) permite a los usuarios crear o seleccionar la cuenta de Business Manager, la página y el píxel de Meta. Este proceso se recomienda para socios con funciones de alojamiento de sitios web. Al usar el píxel devuelto después de completar este proceso, los socios pueden enviar eventos a Facebook en nombre de sus clientes a través del navegador o la API de conversiones. Este proceso no tiene funciones del catálogo..

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 el nivel de acceso, la función y los permisos siguientes:
- Nivel de acceso: acceso avanzado
- Función: acceso estándar a la administración de anuncios
- Permisos públicos: ads_management, pages_read_engagement y ads_read
- Permisos privados: manage_business_extension (se trata de un permiso privado que requiere que tu representante de Facebook añada la aplicación a la lista de autorizados).
- Identificador de acceso de usuario del sistema: el envío de eventos a la API de conversiones requiere un identificador de acceso. Para generar un identificador de acceso en nombre del cliente, utiliza el identificador de acceso que se devuelve a través de FBE y conviértelo en un identificador de acceso de usuario del sistema mediante una llamada a la API adicional.

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

Utiliza este objeto para definir la configuración para la presencia en Facebook del usuario final.

Campo	Descripción
`external_business_id` 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` Cadena	Opcional Zona horaria en la que está ubicada la empresa. Consulta los valores posibles de zona horaria.
`currency` Cadena	Opcional Código ISO de tres letras de la divisa predeterminada que se utiliza para los artículos del catálogo de la empresa. Consulta los códigos de divisa admitidos.
`business_vertical` Enumeración	Obligatorio Sector asociado a la empresa. Valor: `ECOMMERCE`
`merchant_settings_id` 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.
`domain` Cadena	Obligatorio para los canales COMMERCE y COMMERCE_OFFSITE Dominio utilizado para la aprobación manual de Instagram. Por ejemplo, `https://exampleshop.partnersite.com`.
`channel` Enumeración	Obligatorio Proporciona un método para que el socio configure el proceso de la API de conversiones de MBE. En el caso del flujo de la API de conversiones, este valor debe ser `CONVERSIONS_API`. `CONVERSIONS_API`: proceso que permite a los usuarios finales crear o seleccionar objetos del píxel de Meta, la cuenta publicitaria y la cuenta de Business Manager. La creación de estos objetos permite al usuario final enviar eventos desde su sitio web a Facebook a través de la API de conversiones o el píxel del navegador.
`business_manager_id` 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.
`ad_account_id` Configuración	Opcional Identificador de la cuenta publicitaria existente del usuario que un socio puede introducir para seleccionarlo previamente para el usuario en el proceso de configuración.
`page_id` Cadena	Opcional Identificador de la página de Facebook existente del usuario que un socio puede introducir para seleccionarlo previamente para el usuario en el proceso de configuración.
`ig_profile_id` Cadena	Opcional Identificador del perfil empresarial de Instagram existente del usuario que un socio puede introducir para seleccionarlo previamente para el usuario en el proceso de configuración.
`pixel_id` Cadena	Opcional Identificador del píxel existente del usuario que un socio puede introducir para seleccionarlo previamente para el usuario en el proceso de configuración.
`catalog_id` Cadena	Opcional Identificador del catálogo existente del usuario que un socio puede introducir para seleccionarlo previamente para el usuario en el proceso de configuración.

Configuración de la empresa

Utiliza este objeto para establecer la configuración de la empresa para un usuario final. Incluye llamadas a la acción y mucho más. Cada campo incluye un “tipo” vinculado a las tablas correspondientes que hay a continuación.

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