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 Meta Business (FBE) permite a los usuarios crear o seleccionar su administrador comercial, página y píxel de Meta. Este proceso se recomienda a los socios con capacidad para alojar sitios web. Mediante el uso del 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 de la API de conversiones. Este proceso no tiene capacidades de catálogo.

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.
Se requiere una app de Facebook con el siguiente nivel de acceso, función y permisos:
- 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 — Este es un permiso privado que requiere que tu representante de Facebook agregue tu app a la lista de permitidos.
- Token de acceso de usuario del sistema: Para enviar eventos a la API de conversiones es necesario un token de acceso. Para generar un token de acceso en nombre del cliente, usa el token de acceso devuelto a través de la FBE y conviértelo en un token de acceso de usuario del sistema haciendo una llamada adicional a la API.

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

Usa este objeto para definir los parámetros de la presencia en Facebook del usuario final

Campo	Descripción
`external_business_id` 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` cadena	Opcional La zona horaria donde está ubicada de la empresa. Consulta los valores posibles de zona horaria..
`currency` cadena	Opcional Código de divisa ISO de tres letras de la divisa predeterminada usada por los artículos del catálogo de la empresa. Consulta los códigos de divisas admitidos.
`business_vertical` enum	Obligatorio Sector asociado con la empresa. Valor:`ECOMMERCE`
`merchant_settings_id` cadena	Opcional Se usa cuando se actualiza desde la Extensión de Facebook para empresas, v1. Ponte en contacto con tu representante de Facebook si vas a migrar de la v1 a la v2.
`domain` cadena	Obligatorio para los canales COMMERCE y COMMERCE_OFFSITE Dominio usado para la aprobación manual de Instagram. Por ejemplo: `https://exampleshop.partnersite.com`.
`channel` enum	Obligatorio Permite a los socios configurar el proceso de la API de conversiones de la FBE. Para el proceso de la API de conversiones, este valor debe ser `CONVERSIONS_API`. `SIGNALS`: proceso que permite a los usuarios finales crear o seleccionar objetos del Administrador comercial, de la cuenta publicitaria y del píxel de Meta. 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 del Administrador comercial para el administrador comercial existente del usuario que un socio puede introducir para preseleccionar por el usuario en el proceso de configuración.
`ad_account_id` cadena	Opcional Identificador de cuenta publicitaria para la cuenta publicitaria existente del usuario que un socio puede introducir para preseleccionar por el usuario en el proceso de configuración.
`page_id` cadena	Opcional Identificador de "página" de la página de Facebook existente del usuario que un socio puede introducir para preseleccionar por el usuario en el proceso de configuración.
`ig_profile_id` cadena	Opcional Identificador del perfil empresarial de Instagram del usuario existente que un socio puede introducir para la preselección por el usuario en el proceso de configuración.
`pixel_id` cadena	Opcional Identificador del píxel existente de usuario que un socio puede introducir para la preselección por 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 preseleccionar por el usuario en el proceso de configuración.

Business Config

Usa este objeto para configurar los parámetros del negocio para un usuario final. Esto incluye llamadas a la acción (CTA) y otros. Cada campo incluye un "tipo" vinculado a las tablas correspondientes que aparecen a continuación.

Campo	Descripción
`business` Tipo: FBEBusinessPropertiesConfigData	Obligatorio Información para la empresa del usuario final
`messenger_chat` Tipo: FBEMessengerChatConfigData	Opcional Funciones de chat de Messenger en la página de Facebook del usuario final, como las `enabled` y `domains`.
`catalog_feed_scheduled` Tipo: FBECatalogFeedConfigData	Opcional Determina si la extensión Facebook para empresas debe utilizar un enfoque de lista, que toma los elementos del catálogo de una `feed_url`.
`page_cta` Tipo: FBEPageCtaConfigData	Opcional Botón "Llamada a la acción" (CTA) de la página del usuario final, como `cta_button_text`, `cta_button_url`, etc.
`ig_cta` Tipo: FBEIGCtaConfigData	Opcional Características de la función de llamada a la acción (CTA) de Instagram, tales como `enabled`, `cta_button_text`, `cta_button_url` y otros.
`messenger_menu` Tipo: FBEMessengerMenuConfigData	Opcional Características de la función "Menú persistente" de Messenger, como `cta_button-text` y `cta_button_url`