Registrar eventos con la API de eventos para mensajes comerciales

En esta guía, se explica cómo puedes registrar eventos de la app y de la página de Facebook para analizar cómo los usuarios interactúan con la experiencia en Messenger.

Antes de empezar

Necesitarás lo siguiente:

• El permiso page_events

  • Se concederá automáticamente acceso avanzado a este permiso si la app ya cuenta con acceso avanzado para el permiso pages_messaging cuando la envías a revisión de apps. Asimismo, es necesario que tu app no haya infringido ninguna política en los últimos 90 días.
• Un token de acceso a la página solicitado por una persona que pueda realizar la tarea ANALYZE en la página que se consulta.

Limitaciones

Por el momento, esta API no está disponible para empresas o clientes de Europa o Japón.

Política y condiciones

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

Registrar eventos

Para registrar eventos, se debe enviar una solicitud POST al perímetro page_activities de una app:

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 siguiente tabla, se describen las propiedades y los valores que se deben proporcionar en el punto de conexión para registrar eventos de Messenger:

Informar sobre clientes potenciales mediante la API de eventos para mensajes

Las apps podrán ahora comenzar a informar las respuestas de los clientes potenciales en las conversaciones. El evento lead_submitted permite a las apps realizar informes automáticos de las conversaciones que se consideran clientes potenciales para ventas (por ejemplo, el usuario compartió la información de contacto y solicitó que se lo contacte en relación con la venta).

Es mejor usar el evento para distinguir los usuarios específicos que se consideran clientes potenciales y que ayudarán a las empresas a priorizar las conversaciones que se tengan con ellos. Por ejemplo, un negocio puede configurar un proceso automático que califique a los usuarios como clientes potenciales y que active un evento cuando completen dicho proceso para marcarlo y que un agente en vivo entienda 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. El administrador de anuncios está integrado, por lo que los datos de los clientes potenciales se informarán en la UI del administrador de anuncios.

Ejemplo de una llamada a la API para informar un evento de clientes potenciales que tiene lugar 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 sobre clientes potenciales mediante la API de estadísticas de anuncios

Se puede visualizar el evento de clientes potenciales informado mediante la API de estadísticas de anuncios. Con esta API, puedes crear un panel de análisis avanzado para ayudar a visualizar el cliente potencial atribuido a las campañas de CTX.

Requisitos previos

Antes de usar la API, asegúrate de que la app se haya sometido al proceso de revisión de apps en relación con el permiso ads_read y que haya obtenido el acceso avanzado.

Ejecución

Un ejemplo de llamada de estadísticas en el nivel de la campaña publicitaria tiene el siguiente aspecto:

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

Se puede llamar a la API de estadísticas en el nivel de la cuenta publicitaria, de la campaña o del conjunto de anuncios en función del nivel de granularidad deseado.

La siguiente es la llamada para obtener el cliente potencial:

• 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 acción anteriores, consulta la referencia de las estadísticas de acciones de anuncios.

Prácticas recomendadas para clasificar clientes potenciales

1. El anunciante está en uno de los sectores clásicos de generación de clientes potenciales (automotor, servicios profesionales, servicios financieros, B2B, educación y salud).
2. El anunciante pide información de contacto, como teléfono o correo electrónico, y el usuario la proporciona.
3. Las preguntas referidas al teléfono o al correo electrónico van precedidas de algún tipo de calificación (por ejemplo, 1 o 2 preguntas adicionales).
4. Si ofreces plantillas de generación de clientes potenciales en tu app, agrega de forma predeterminada esta señal al final de los procesos de generación de clientes potenciales.

Verificar el registro de eventos

Si eres administrador de páginas o de apps, puedes verificar que la configuración esté correcta buscando los eventos en el administrador de anuncios.

Consideraciones especiales para Analytics para Messenger

• Una app individual puede registrar interacciones de varias páginas. En estos casos, se pueden ver en la misma app los eventos que resultan de las interacciones con todas las páginas.
• Es posible vincular varias apps a una única página. En este caso, cuando la página se bloquea, todas las apps vinculadas a la página reciben un evento fb_messenger_bot_stopped.
• El número de conversaciones del bot de Messenger eliminadas puede ser mayor que el número de actividades de nuevos usuarios. El número de conversaciones del bot de Messenger eliminadas indica la cantidad de veces que un usuario borra una conversación. La página puede iniciar conversaciones adicionales después de que un usuario borra una conversación. Los usuarios pueden eliminar las conversaciones adicionales, lo que aumenta el número de conversaciones del bot de Messenger eliminadas.

Uso de los proveedores de plataformas

Registrar objetivo

Las plataformas que permiten a las personas crear experiencias en Messenger con interfaces visuales suelen usar una app central para potenciar todas las páginas conectadas. Para brindar a los clientes la posibilidad de ver sus propios eventos, es necesario configurar logging_target en page o en app_and_page y así registrarlos en las páginas de tus clientes.

Interfaz de usuario

Si se utiliza un editor visual, es posible proporcionar un bloque que se puede arrastrar y que permite a las personas elegir el evento y definir parámetros adicionales. De esta manera, los administradores de la página pueden planificar el flujo de Messenger con los eventos pertinentes. Lo ideal es que los usuarios puedan seleccionar un nombre de evento estándar de una lista desplegable, dado que solo los eventos estándar se registran en el administrador de anuncios y están disponibles para la optimización y segmentación de anuncios (si corresponde). Si el nombre del evento estándar no coincide con la acción del usuario y no se requieren informes publicitarios, puedes ofrecer a los usuarios un campo de texto libre para que ingresen el nombre de un evento y parámetros personalizados.

Permisos

Se debe obtener el permiso page_events solicitado durante el proceso de inicio de sesión con Facebook de la app. Es necesario que lo agregues al ámbito del permiso solicitado del botón "Iniciar sesión", a la llamada al SDK de Facebook para JavaScript o al proceso de inicio de sesión que se integró de manera manual según lo que se establece en esta guía.

Recursos adicionales

• Guía de prácticas recomendadas para eventos de la app: incluye recomendaciones sobre qué eventos usar en distintos tipos de apps.