Cómo enviar eventos a Pixel desde el bot

Para transferir eventos desde el flujo de trabajo del bot, necesitas tener una cuenta comercial. Puedes registrarte aquí.

Cómo crear un nuevo pixel

Elige API de Conversiones.

¡Atención! Si se abre la siguiente ventana durante la configuración de la API de Conversiones, es mejor salir de la configuración y comenzar de nuevo.

Si se abre la siguiente ventana durante la configuración de la API de Conversiones, es mejor salir de la configuración y comenzar de nuevo.

Elige el Pixel que necesitas.

Genera un token de acceso y guárdalo en un lugar seguro.

Cómo transferir eventos a Facebook

Para transferir eventos a Facebook, debes tener tu propio dominio configurado en la mini-landing. Debe estar aprobado en Facebook, y Guardar valores de cookies en variables de cliente debe estar activado para Facebook en la configuración de la mini-landing:

Ahora, habrá una variable _fbp automáticamente completada en la tarjeta del cliente que vino de la mini-landing. Esta variable se puede transferir a Pixel con el evento.

Debes configurar los siguientes ajustes en el bloque a través del cual deseas transferir el evento:

URL de la función:

https://store.mavibot.ai/function/fb_pixel

Parámetros de ejemplo:

{
  "pixel_id": "#{pixel_id}",
  "access_token": "#{access_token}",
  "event_name": "Entró al bot",
  "event_source_url": "https://my_best_site.com",
  "action_source": "chat",
  "fbp": "#{_fbp}",
  "fbc": "#{_fbc}"
}

Parámetros obligatorios

pixel_id — ID del pixel.

access_token — el token para acceder a la API.

event_name — el nombre del evento. Puedes usar nombres estándar como Lead, PageView, Purchase, etc. (ver más aquí), así como tus propios nombres, como Entró al bot.

event_source_url — el dominio aprobado en Facebook.

fbp — el ID del navegador del cliente.

Parámetros opcionales

action_source — (other por defecto) este campo te permite especificar dónde ocurrió exactamente la conversión. La información sobre dónde ocurrieron los eventos ayuda a asegurar que tus anuncios se muestren a la audiencia correcta.

Puedes establecer los siguientes valores en el campo action_source:

Valor Descripción
email La conversión ocurrió a través de correo electrónico
website La conversión ocurrió en un sitio web
phone_call La conversión ocurrió a través de teléfono
chat La conversión ocurrió a través de mensajería, SMS o chat en línea
physical_store La conversión ocurrió en una tienda física
system_generated La conversión ocurrió automáticamente, es decir, como resultado de una renovación de suscripción mensual
business_messaging La conversión ocurrió en una conversación después de que el cliente hiciera clic en un anuncio Click-to-WhatsApp
other La conversión ocurrió de otra manera

Cómo probar eventos

Para probar eventos, agrega el parámetro test_event_code con el texto almacenado en la pestaña Mensajes de prueba al cuerpo de la solicitud.

{
  "pixel_id": "#{pixel_id}",
  "access_token": "#{access_token}",
  "event_name": "Entró al bot",
  "event_source_url": "https://my_best_site.com",
  "fbp": "#{_fbp}",
  "fbc": "#{_fbc}",
  "test_event_code": "TEST11421"
}

¡Atención! No olvides eliminar el parámetro test_event_code de la solicitud al lanzar la versión de producción.

Parámetros opcionales adicionales

fn — nombre.

ln — apellido.

email — el correo electrónico del cliente.

phone — el número de teléfono del cliente.

fbc — ID de clic.

gender — el género del cliente (f — femenino, m — masculino).

country — país.

state — estado.

city — ciudad.

index — el índice postal del cliente (código ZIP).

external_id — cualquier ID de cliente único, por ejemplo, ID de usuario o ID de archivos de cookies de terceros.

client_ip_address — la dirección IP del cliente.

client_user_agent — agente de usuario del navegador del cliente.

También puedes transferir tus propios parámetros a Pixel. Para hacerlo, agrega el parámetro opcional my_params y especifica tus propios campos en él.

Ejemplo:

{
  "my_params": {
    "value1": "Hola",
    "val2": "Hola"
  }
}

Ejemplo completo

{
  "pixel_id": "#{pixel_id}",
  "access_token": "#{access_token}",
  "event_name": "Entró al bot",
  "event_source_url": "https://my_best_site.com",
  "email": "[email protected]",
  "phone": "1234567890",
  "currency": "USD",
  "value": "142.52",
  "test_event_code": "TEST11421",
  "external_id": "#{client_id}",
  "fn": "#{name}",
  "gender": "m",
  "post_index": "12345",
  "my_params": {
    "value1": "Hola",
    "val2": "Hola"
  }
}

¡Atención! No olvides eliminar el parámetro test_event_code de la solicitud al lanzar la versión de producción.

Cómo agregar una cuenta promocional

Primero, necesitas abrir el acceso a tu cuenta.

Guarda y ve a la pestaña Objetos relacionados → Agregar objetos.

Luego agrega tu cuenta promocional.

Conversiones de anuncios Click-to-WhatsApp

Una adición a la documentación para la función fb_pixel_event().

Meta* marca cada clic de un anuncio Click-to-WhatsApp con un identificador de clic ctwa_clid. Se recibe junto con el primer mensaje de WhatsApp del cliente y se usa para atribuir una conversión de la conversación a un anuncio específico, similar a cómo los eventos de pixel se atribuyen a un clic en el sitio web.

Firma

fb_pixel_event(
    event_name,
    pixel_id,
    access_token,
    event_source_url,
    action_source,
    fbc,
    test_event_code,
    data,
    ctwa_clid,
    messaging_channel
)

Nuevos parámetros

Parámetro Descripción
ctwa_clid Identificador de clic para un anuncio Click-to-WhatsApp. Si este parámetro no se proporciona, se usa la variable de cliente ctwa_clid, que el bot guarda automáticamente. Opcional.
messaging_channel El canal de mensajería donde ocurrió la conversión. Por defecto es whatsapp. Opcional.

Nuevo valor para action_source

El siguiente valor está disponible para action_source:

Valor Descripción
business_messaging La conversión ocurrió en una conversación después de que el cliente hiciera clic en un anuncio Click-to-WhatsApp.

Un evento se envía como una conversión de mensajería si se cumple al menos una de las siguientes condiciones:

  • Se proporciona action_source="business_messaging";
  • Se proporciona ctwa_clid;
  • Se proporciona messaging_channel.

En este caso, Meta* recibe la combinación action_source + messaging_channel + ctwa_clid. Sin esta combinación, el clic en el anuncio no se atribuirá a la conversión.

El valor website no debe usarse para conversiones de mensajería: el evento llegará al pixel, pero no se atribuirá al anuncio.

Variables de cliente

Cuando un cliente envía un mensaje de WhatsApp después de hacer clic en un anuncio, el bot guarda los datos del clic en las variables de cliente del cliente. No necesitas completar estas variables manualmente.

Variable Descripción
ctwa_clid Identificador de clic. Se agrega automáticamente al evento.
ctwa_clid_time Hora en que se recibió el identificador, en formato de tiempo Unix. Se puede usar para determinar cuánto tiempo ha pasado desde el clic.
wa_ads_data Datos del anuncio en formato JSON: URL del anuncio, ID del anuncio (source_id), título, descripción, tipo de creativo y URL del creativo.

El identificador de clic se toma automáticamente de la variable de cliente, por lo que no necesitas pasarlo explícitamente a la función.

El número de teléfono del cliente se agrega automáticamente al evento si no se proporciona en data.

El parámetro event_source_url no se usa para conversiones de mensajería.

Limitaciones

El identificador de clic se recibe solo con el primer mensaje del cliente después de que haga clic en el botón del anuncio. No se incluye en mensajes posteriores. Por lo tanto, el evento se puede enviar en cualquier punto de la conversación, pero solo si el primer mensaje se originó desde el anuncio.

Meta proporciona ctwa_clid para clics desde las aplicaciones de Facebook e Instagram en Android e iOS.

El identificador no se proporciona cuando el cliente hace clic desde un navegador o hace clic en una publicación normal en lugar del botón del anuncio. Las conversiones de tales interacciones no se pueden atribuir al anuncio.

Si el cliente hace clic en otro anuncio más tarde, las variables se sobrescriben. La conversión se atribuye al anuncio más reciente del que provino el cliente.

Si el identificador de clic falta tanto en los parámetros de la función como en las variables de cliente, la función devuelve el siguiente error y el evento no se envía:

No ctwa_clid variable in client variables