Extensión de Meta para empresas

Guía de migración: de Instagram (IX) a la versión 2 de la extensión de Meta para empresas

Como uno de nuestros socios en los botones de llamada a la acción de Instagram, que cuentan con la tecnología de la integración de las experiencias instantáneas (IX), si quieres conservar los botones de llamada a la acción de Pedir comida y la función del sticker de las historias Pedidos de comida, deberás cumplir los siguientes requisitos de la versión 2 de la extensión de Meta para empresas (MBE):

  1. URL de autenticación: para permitir que tus negocios se incorporen a la MBE desde Facebook o Instagram.
  2. Webhook: para recibir notificaciones puntuales cada vez que uno de tus negocios instale o desinstale la MBE.
  3. Activar eventos del píxel: para ayudar a tus negocios a dirigirse mejor a nuevos clientes, aumentar las transacciones en tus sitios web y medir directamente cómo ayuda la integración de la MBE a mejorar los resultados.

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

Antes de empezar

  • Si aún no lo has hecho, regístrate como desarrollador de Meta para acceder a nuestras herramientas para desarrolladores y crear aplicaciones de Meta.
  • Si aún no lo has hecho, crea una aplicación de Meta.
  • Crea una aplicación de prueba desde la aplicación activa o de producción y utilízala para completar todos los nuevos procesos de desarrollo y pruebas.
  • Tus aplicaciones (activas, de producción y de pruebas) deben ser de tipo Empresa y pertenecer a un Business Manager de una empresa verificada. Obtén más información sobre cómo verificar tu empresa y cómo añadirle tus aplicaciones.
  • Contacta con tu socio de Meta y comparte los identificadores de tu aplicación para que pueda concederte acceso a la función manage_business_extension de la MBE. Una vez aprobada, podrás comenzar el proceso de implementación.

El nombre de la aplicación activa o de producción debe representar la marca de tu negocio, ya que el nombre y el logotipo de la aplicación se utilizarán cuando esta se muestre en nuestras plataformas.

Configurar la integración desde la ventana para desarrolladores

La ventana para desarrolladores de la extensión de Meta para empresas es un producto del panel de aplicaciones para desarrolladores. Una vez que a las aplicaciones se les haya concedido la función de la MBE, deberás usar la ventana para desarrolladores para configurar y validar la integración (incluidos la URL de autenticación y el extremo de webhooks).

Paso 1: Añade la ventana para desarrolladores de la MBE a tus aplicaciones de Facebook para desarrolladores.

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

Paso 3: Una vez creada la URL de autenticación, utiliza la plataforma de aplicaciones empresariales en la pestaña “Configuración” para que se valide la URL (si hay algún error, se mostrará allí). Cuando hayas obtenido la marca de verificación verde, ve a las aplicaciones empresariales de Meta para realizar pruebas integrales.

Paso 4: Una vez creado el webhook, configúralo en el producto Webhooks. Si la configuración se realiza correctamente, obtendrás una marca de verificación verde en la pestaña “Información general” para el elemento de webhook validado.

Paso 5: Una vez activados los eventos del píxel obligatorios, completa el cuestionario del píxel (que incluye un vídeo para validar la implementation del píxel).

Paso 6: Ayuda a nuestro equipo a verificar y aprobar la integración. Para ello, proporciona detalles en la tarjeta “Revisión de la integración” de la pestaña “Revisión de la integración”. Incluye las credenciales de inicio de sesión de tu plataforma para iniciar sesión en la URL de autenticación. Añade un enlace a una captura de vídeo que muestre la experiencia de incorporación completa y las funciones activadas.

Paso 7: Una vez que hayas finalizado la implementación de la MBE, completa la lista de comprobación de la pestaña “Información general” en la ventana para desarrolladores. Rellena los formularios de detalles de la aplicación y de revisión de la integración en la pestaña “Revisión de la integración”. Haz clic en el botón “Enviar” para comenzar el proceso de revisión. Una vez que se apruebe la integración, podrás lanzar tu aplicación 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 conocer el estado actual por parte de nuestro equipo.

Crear la URL de autenticación

Las aplicaciones empresariales, disponibles en las plataformas de Meta, son el lugar al que las empresas pueden dirigirse para descubrir aplicaciones empresariales de terceros y conectarse a ellas para empezar a utilizar fácilmente las herramientas para empresas con un coste técnico reducido a fin de crecer y lograr sus objetivos empresariales.

La versión 2 de la extensión de Meta para empresas utiliza una URL de autenticación como canal de confianza para compartir la configuración de empresa del usuario (nombre, URL para las llamadas a la acción, etc.) entre tu plataforma e Instagram y Facebook.

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

  1. Permite a los usuarios iniciar sesión en tu plataforma y ofrece la opción de registrar una nueva cuenta en la plataforma (es decir, “Registro”).
  2. Si admites varias empresas por cuenta en tu plataforma, muestra una IU que permita al usuario seleccionar qué empresa de tu plataforma quiere asociar a su presencia de Facebook.
  3. Obtén el parámetro de consulta redirect_uri recibido y añádele el objeto codificado extras como parámetro de consulta.
  4. Redirige a los usuarios a la URL resultante (solo si el valor de redirect_uri recibido coincide con nuestra expresión regular).

Ejemplo: utiliza el objeto extras para configurar una empresa y activar las llamadas a la acción del perfil de Instagram y de 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 de las historias “Pedidos de comida” de Instagram en la configuración de 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á activada para las empresas.

Para obtener más información sobre la implementación completa y las pruebas, consulta Aplicaciones empresariales.

Crear el webhook

Cuando un usuario descargue, actualice o desinstale tu aplicación desde las aplicaciones empresariales, recibirás los detalles sobre dicha acción mediante un webhook.

Para configurar el webhook, debes realizar las acciones siguientes:

  1. Crear un extremo en un servidor seguro que pueda procesar solicitudes POST de Facebook.
  2. Configurar el producto Webhooks en el panel de aplicaciones de tu aplicación para suscribirte al campo fbe_install del objeto User.

Cuando recibas un evento del webhook para una descarga nueva o actualizada, debes mantener una asignación de cada business_id a su pixel_id, ya que cada identificador de píxel es único para cada empresa y deberás utilizarlo para activar los eventos del píxel necesarios.

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

Activar eventos del píxel

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

Eventos obligatorios

  • Para las páginas involucradas en el proceso de pedido de comida, activa PageView
  • Cuando el pedido se haya realizado, activa Purchase

Eventos opcionales

  • Activa AddToCart cuando se añada un elemento al pedido.

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

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

Para obtener más información sobre la implementación completa, consulta Activar eventos del píxel.

Pixel Helper

Te recomendamos encarecidamente descargar nuestra extensión Pixel Helper de Chrome. Pixel Helper proporciona comentarios muy valiosos que pueden ayudarte a verificar que el píxel funciona correctamente, sobre todo al empezar a realizar el seguimiento de las conversiones, donde puedes encontrar errores de formato fácilmente.

Revisión y lanzamiento de la integración

Una vez hayas finalizado la implementación de la MBE, completa la lista de comprobación de la pestaña “Información general” en la ventana para desarrolladores. Rellena los formularios de detalles de la aplicación y de revisión de la integración en la pestaña “Revisión de la integración”. Haz clic en el botón “Enviar” para comenzar el proceso de revisión.

La revisión de la integración es el proceso mediante el que Meta verifica la integración de la extensión de Meta para empresas. Una vez que se apruebe la integración, podrás lanzar tu aplicación 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 la integración en la pestaña “Revisión de la integración” de la ventana para desarrolladores, podrás ver el estado, las actualizaciones y los comentarios de nuestros revisores en la sección del historial de envíos en la tarjeta “Revisión de la integración”.

Nuestros revisores proporcionarán comentarios detallados. En caso de que tu aplicación se rechace, completa los pasos necesarios antes de iniciar un nuevo proceso de revisión. Para ello, haz clic en el botón “Volver a enviar” en la pestaña “Revisión de la integración”.