Registrar eventos con la API de eventos para mensajes para empresas

En esta guía se describe cómo registrar eventos de la aplicación y de la página de Facebook para analizar cómo interactúan los usuarios con su experiencia de Messenger.

Antes de empezar

Necesitarás lo siguiente:

• El permiso page_events.

  • Se concederá automáticamente acceso avanzado para este permiso al enviar la aplicación a revisión si ya se ha concedido este tipo de acceso a dicha aplicación para el permiso pages_messaging y la aplicación no ha infringido ninguna política en los últimos 90 días.
• Un identificador de acceso a la página solicitado por una persona que pueda realizar la tarea ANALYZE en la página que se consulta.

Limitaciones

Esta API no está disponible en este momento para empresas o clientes de Europa o Japón.

Política y condiciones

• Condiciones de las herramientas empresariales de Facebook
• Políticas de páginas, grupos y eventos

Registrar eventos

Los eventos se registran mediante el envío de una solicitud POST al perímetro page_activities de una aplicación:

https://graph.facebook.com/

Ejemplo de solicitud:

curl -X POST -H "Content-Type: application/json" -d '{
  "custom_events": [
    {
      "_eventName": "fb_mobile_purchase",
      "_valueToSum": 57.23,
      "fb_currency": "USD"
    }
  ],
  "advertiser_tracking_enabled": 1,
  "application_tracking_enabled": 1,
  "page_id": <PAGE_ID>,
  "page_scoped_user_id": <PSID>,
  "logging_source": "messenger_bot",
  "logging_target": "page"
}' https://graph.facebook.com/v21.0/<APP_ID>/page_activities?access_token=<PAGE_ACCESS_TOKEN>

En la tabla siguiente se describen las propiedades y los valores que se deben proporcionar al extremo para el registro de eventos de Messenger:

Informar de clientes potenciales mediante la API de eventos de mensajes

Las aplicaciones ahora pueden empezar a informar de envíos de clientes potenciales en las conversaciones. El evento lead_submitted permite a las aplicaciones automatizar la función de informar de las conversaciones que se consideran un cliente potencial de una venta (p. ej., el usuario ha compartido su información de contacto y ha pedido que se pongan en contacto con él en relación con la venta).

El evento es ideal para distinguir usuarios concretos como clientes potenciales, lo que debería ayudar a las empresas a priorizar las conversaciones con ellos. Por ejemplo, una empresa puede configurar un proceso automatizado que califique a un usuario como cliente potencial y activar este evento cuando el usuario complete dicho proceso para indicarle a un agente en directo que se trata de una conversación con un alto potencial.

Por el momento, esta función está disponible en una versión beta abierta. La función de informar en el administrador de anuncios está integrada, por lo que los informes sobre los datos de los clientes potenciales se presentan en la IU del administrador de anuncios.

Ejemplo de una llamada a la API para informar de un evento de cliente potencial que se produce en una conversación:

curl -X POST -H "Content-Type: application/json" -d '{
  "custom_events": [
    {
      "_eventName": "lead_submitted"
    }
  ],
  "advertiser_tracking_enabled": 1,
  "application_tracking_enabled": 1,
  "page_id": <PAGE_ID>,
  "page_scoped_user_id": <PSID>,
  "logging_source": "messenger_bot",
  "logging_target": "page"
}' https://graph.facebook.com/v21.0/<APP_ID>/page_activities?access_token=<PAGE_ACCESS_TOKEN>

Informar de clientes potenciales mediante la API de insights de anuncios

Los informes sobre los eventos de clientes potenciales se pueden visualizar mediante la API de insights de anuncios. Con esta API, puedes crear un panel de análisis detallado que te ayude a visualizar los clientes potenciales atribuidos a las campañas de clic para enviar mensajes.

Requisitos previos

Antes de usar la API, asegúrate de que la aplicación ha completado el proceso de revisión de la aplicación para el permiso ads_read y ha obtenido acceso avanzado.

Ejecución

Las llamadas de estadísticas a nivel de campaña tienen el aspecto siguiente:

curl -G \
-d "date_preset=last_7d" \
-d "access_token=<ACCESS_TOKEN>" \
"https://graph.facebook.com/<API_VERSION>/<AD_CAMPAIGN_ID>/insights"
    

Las llamadas a la API de insights pueden realizarse a nivel de cuenta publicitaria, campaña o conjunto de anuncios en función del nivel de detalle deseado.

A continuación, se muestra la llamada para obtener los clientes potenciales:

• Clientes potenciales (atribuidos)

  • /<OBJECT_ID>/insights?fields=actions
  • En el resultado, action_type=onsite_converstion.lead_grouped.

Para obtener una definición detallada de los tipos de acciones anteriores, consulta la referencia de las estadísticas de acciones de los anuncios.

Prácticas recomendadas para clasificar los clientes potenciales

1. El anunciante está en uno de los sectores clásicos de generación de clientes potenciales (automóviles, servicios profesionales, servicios financieros, B2B, educación, salud).
2. El anunciante solicita información de contacto, como el número de teléfono o la dirección de correo electrónico, y el usuario se la da.
3. Las preguntas sobre el teléfono o la dirección de correo electrónico van precedidas de algún tipo de calificación (p. ej., 1-2 preguntas adicionales).
4. Si ofreces plantillas para la generación de clientes potenciales en tu aplicación, añade este aviso al final de los procesos de generación de clientes potenciales de forma predeterminada.

Verificar el registro de eventos

Si eres administrador de páginas o aplicaciones, puedes buscar los eventos en el Administrador de anuncios para validar si tu configuración es correcta.

Consideraciones especiales del análisis para Messenger

• Una sola aplicación puede registrar interacciones de varias páginas. En estos casos, los eventos de interacciones con todas las páginas son visibles en la misma aplicación.
• Se pueden vincular varias aplicaciones a una sola página. En este caso, si la página está bloqueada, todas las aplicaciones vinculadas a la página recibirán un evento fb_messenger_bot_stopped.
• El número de Conversación con el bot de Messenger eliminada puede ser mayor que el número de Nueva actividad de usuarios. Conversación con el bot de Messenger eliminada indica el número de veces que un usuario elimina un hilo de mensajes. La página puede iniciar conversaciones adicionales después de que un usuario elimine un hilo de mensajes. Los usuarios pueden eliminar los hilos de mensajes adicionales, lo que incrementa el número de Conversación con el bot de Messenger eliminada.

Uso para proveedores de plataformas

Destino del registro

Las plataformas que permiten crear experiencias de Messenger mediante interfaces visuales normalmente usan una aplicación central para dar servicio a todas las páginas conectadas. Para permitir a los clientes ver sus propios eventos, tienes que registrarlos en las páginas de los clientes mediante la definición del valor de logging_target en page o app_and_page.

Interfaz de usuario

En el contexto de un editor visual, puedes ofrecer un bloque que se pueda arrastrar y que permita a los usuarios elegir un evento y definir parámetros adicionales. De esta forma, los administradores de páginas pueden planear el proceso de Messenger con eventos adecuados. Lo ideal sería que los usuarios pudiesen seleccionar el nombre de un evento estándar en una lista desplegable, ya que en el Administrador de anuncios únicamente se informa de estos eventos, los cuales están disponibles para la optimización y la segmentación de anuncios (en caso de estar disponibles). Si ningún nombre de evento estándar se corresponde con la acción del usuario y no se necesitan informes de anuncios, es posible que prefieras ofrecer un campo de formato libre para permitir a los usuarios introducir el nombre y los parámetros de un evento personalizado.

Permisos

El permiso page_events obligatorio se debe obtener durante el proceso del inicio de sesión con Facebook de tu aplicación. Tienes que añadirlo al ámbito del permiso solicitado del botón “Iniciar sesión”, la llamada del SDK de Facebook para JavaScript o el proceso de inicio de sesión creado manualmente, como se describe en esta guía.

Recursos adicionales

• Guía de prácticas recomendadas sobre los eventos de la aplicación: se incluyen recomendaciones relacionadas con los eventos que deberían utilizarse en diversos tipos de aplicaciones.