Guía de migración: Instagram (IX) a extensión de Meta para empresas, v2

Como socio en los botones de llamada a la acción de Instagram, con tecnología de la integración de experiencias instantáneas (IX), deberías compilar los siguientes requisitos de la extensión de Meta para empresas (MBE), v2, para conservar tus botones de llamada a la acción Pedir comida y la funcionalidad de sticker de Historias Pedidos de comida.

URL de autenticación: para permitir a tus empresas registrarse en la MBE desde Facebook o Instagram.
Webhook: para recibir notificaciones oportunas cada vez que una de tus empresas instala o desinstala la MBE.
Activar eventos de píxel: para ayudar a tus empresas a llegar mejor a nuevos clientes, aumentar las transacciones en tus sitios web y medir directamente cómo la integración de la MBE ayuda a mejorar sus resultados.

Una vez que hayas completado el desarrollo y las pruebas de la MBE, Meta revisará y verificará la integración. Cuando se apruebe, tu app estará disponible para los usuarios públicos.

Antes de empezar

Si todavía no lo hiciste, regístrate como desarrollador de Meta para acceder a nuestras herramientas para desarrolladores y crear apps de Meta.
Si todavía no lo hiciste, crea una app de Facebook.
Crea una app de prueba desde tu app en modo activo/de producción y úsala para realizar todos los nuevos desarrollos y pruebas.
Es necesario que las apps (activas, de producción o de prueba) sean apps de tipo de negocios y de propiedad de un administrador comercial que sea una empresa verificada. Obtén más información sobre cómo verificar tu empresa y cómo agregar tus apps.
Ponte en contacto con tu socio de Meta y comparte los identificadores de tu app para que pueda otorgarte acceso a la función manage_business_extension de la MBE y, una vez que se te haya aprobado, puedas comenzar con el trabajo de implementación.

El nombre de tu app en producción o activa debería representar la marca de tu empresa (el nombre de la app y el logotipo se usarán cuando se muestre en nuestras plataformas).

Configurar tu integración desde el panel para desarrolladores

El panel para desarrolladores de la extensión de Meta para empresas es un producto que se encuentra en tu panel de apps para desarrolladores. Una vez que tus apps reciben la función de la MBE, deberías usar el panel para desarrolladores para configurar y validar tu integración (incluida la URL de autenticación y el punto de conexión del webhook).

Paso 1: Agrega el panel para desarrolladores de la MBE a tus apps para desarrolladores de Facebook.

Paso 2: En la pestaña "Configuración", selecciona Food and Drink como único sector, selecciona Instagram Call to Action Button y Page Surface Call To Action Button como funciones e incluye todos los dominios que tu app muestra en la tarjeta de dominios de Wildcard.

Paso 3: Después de compilar la URL de autenticación, usa la plataforma de apps de negocios en la pestaña "Configuración" para que se valide tu URL (si hay errores, se mostrarán allí). Una vez que veas la marca de verificación verde, podrás ir a "Apps de negocios de Meta" para hacer pruebas de extremo a extremo.

Paso 4: después de compilar el webhook, configúralo en el producto Webhooks. Si la configuración se hace como se esperaba, verás una marca de verificación verde en la pestaña "Resumen" del elemento validado del webhook.

Paso 5: Después de activar los eventos de píxel obligatorios, completa el cuestionario del Píxel (e incluye un video para validar tu implementación del píxel).

Paso 6: Ayuda a nuestro equipo a verificar y aprobar tu integración. Para ello, proporciona detalles en la tarjeta Revisión de la integración en la pestaña "Revisión de la integración". Deberías incluir las credenciales de inicio de sesión de tu plataforma para iniciar sesión en la URL de autenticación. Agrega una captura de video que muestre la experiencia de registro de extremo a extremo y las funciones que habilitaste.

Paso 7: Una vez que hayas finalizado la implementación de la MBE, completa la lista de verificación en la pestaña "Resumen" del panel para desarrolladores. Completa los formularios de detalles de la app y revisión de la integración en la pestaña "Revisión de la integración". Un clic en el botón "Enviar" comenzará el proceso de revisión. Una vez que se apruebe tu integración, podrás lanzar la app para ponerla a disposición de los usuarios públicos en la pestaña "Iniciar". Obtén más información sobre el proceso de revisión de la integración y cómo recibir comentarios y el estado actual de nuestro equipo.

Compilar la URL de autenticación

Apps de negocios, disponible en plataformas de Meta, es el espacio en el que las pequeñas empresas pueden hallar apps empresariales de terceros y conectarse a ellas para equiparse de herramientas empresariales a un bajo costo tecnológico, a fin de crecer y alcanzar sus metas de negocios.

MBE, v2 usa una URL de autenticación como canal de confianza para compartir la configuración comercial del usuario (el nombre, la URL para llamada a la acción, etc.) entre tu plataforma e Instagram o Facebook.

La URL de autenticación debe aceptar un parámetro de consulta GET redirect_uri. Con esta URL, te recomendamos lo siguiente:

Permite a tus usuarios iniciar sesión en la plataforma y ofrece también una opción para registrar una cuenta nueva en la plataforma (es decir, "registrarse").
Si en la plataforma admites múltiples empresas por cuenta, muestra una UI para que el usuario seleccione con qué empresa de la plataforma desea asociar su presencia en Facebook.
Obtén el parámetro de consulta redirect_uri y agrégalo en el objeto extras codificado como parámetro de consulta.
Redirige a los usuarios a la URL resultante (solo si el elemento redirect_uri recibido coincide con nuestra expresión regular).

Ejemplo: usa el objeto extras para configurar una empresa y habilita la llamada a la acción en el perfil de Instagram y la llamada a la acción en la página de Facebook

{
  "setup": {
    "external_business_id": "<YOUR_ID_FOR_THE_BUSINESS>", //e.g. "foo-123"
    "timezone": "<BUSINESS_TIMEZONE>", //e.g. "America/Los_Angeles"
    "currency": "<BUSINESS_CURRENCY>", //e.g. "USD"
    "business_vertical": "FOOD_AND_DRINK"
  },
  "business_config": {
    "business": {
      "name": "<BUSINESS_NAME>"  //e.g. "Foo Business"
    },
    "ig_cta": {
      "enabled": true,
      "cta_button_text": "Order Food",
      "cta_button_url": "<BUSINESS_URL_FOR_CTA>"  //e.g. "https://partner-site.com/foo-business/order"
    },
     "page_cta": {
         "enabled": true,
         "cta_button_text": "Order Food",
         "cta_button_url": "<BUSINESS_URL_FOR_CTA>", // e.g. "https://partner-site.com/foo-business/order"
         "below_button_text": "Powered by <YOU>"
     }
  },
  "repeat": false 
}

No es necesario incluir el sticker "Pedidos de alimentos" de Instagram Stories en la configuración extras, ya que esta función está activada de forma predeterminada si la función de llamada a la acción de Instagram (ig_cta) está habilitada para tus negocios.

Para obtener información sobre la implementación completa y las pruebas, consulta Apps de negocios.

Compilar el webhook

Después de que un usuario instale, actualice o desinstale tu app mediante Apps de negocios, recibirás los detalles de esa acción a través del webhook.

Para configurar un webhook, debes hacer lo siguiente:

Crea un punto de conexión en un servidor seguro que pueda procesar solicitudes POST de Facebook.
Configura los webhooks del producto en el Panel de apps de tu app para suscribirte al campo fbe_install del objeto User.

Cuando recibes un evento del webhook de una instalación nueva o actualizada, debes mantener un mapeo de business_id para su pixel_id, ya que el identificador del píxel es único para esa empresa y tú deberías usarlo para activar los eventos de píxel obligatorios.

Para obtener información sobre la implementación completa y la configuración, consulta Webhook.

Activar eventos de píxel

El píxel de Meta es una parte integral de la extensión de Meta para empresas, v2. Requerimos que actives correctamente el píxel de los siguientes eventos estándar de cada empresa integrada con la MBE en tu plataforma.

Eventos obligatorios

Para todas las páginas involucradas en el proceso de pedido de comida: activa PageView
Una vez realizado el pedido: activa Purchase

Eventos opcionales

Activa AddToCart cuando se agregue un elemento al pedido.

Todos los eventos estándar se pueden activar llamando a la función fbq('track') del píxel, con el nombre del evento y, opcionalmente, un objeto JSON como parámetro. Por ejemplo, el evento de compra requiere la divisa y el valor incluidos como parámetros:

fbq('track', 'Purchase', {currency: "USD", value: 30.00});

Para obtener información sobre la implementación completa, consulta Activar eventos de píxel.

Asistente para píxeles

Te recomendamos instalar nuestra extensión de Chrome Asistente para píxeles. El asistente para píxeles brinda comentarios muy valiosos que pueden ayudarte a verificar si tu píxel está funcionando correctamente, en especial, cuando comienzas a hacer seguimiento de las conversiones, que es cuando puedes encontrar errores de formato fácilmente.

Revisión y lanzamiento de la integración

Una vez que hayas finalizado la implementación de la MBE, completa la lista de verificación en la pestaña "Resumen" del panel para desarrolladores. Completa los formularios de detalles de la app y revisión de la integración en la pestaña "Revisión de la integración". Un clic en el botón "Enviar" comenzará el proceso de revisión.

El proceso de revisión de la integración es donde Meta verifica la integración de la extensión de Meta para empresas. Una vez que se apruebe tu integración, podrás lanzar la app para ponerla a disposición de los usuarios públicos en la pestaña "Iniciar". Obtén más información sobre este proceso.

Después de enviar tu integración en la pestaña "Revisión de la integración", ubicada en el panel para desarrolladores, podrás ver el estado, las actualizaciones y los comentarios de nuestros revisores en la sección de historial de envíos de la tarjeta "Revisión de la integración".

Nuestros revisores proporcionarán comentarios detallados. Si se rechaza tu app, completa todos los pasos obligatorios antes de comenzar un nuevo proceso de revisión. Para ello, puedes hacer clic en el botón para volver a enviar en la pestaña "Revisión de la integración".