API de conversiones

Especificación de la carga útil

La integración del sistema de CRM con la API de conversiones de Meta y el uso del objetivo de optimización para conseguir conversiones de clientes potenciales de los anuncios para clientes potenciales podría ofrecer resultados de mayor calidad. Actualmente, esta optimización solo es compatible con los anuncios para clientes potenciales nativos (formularios instantáneos) generados en Facebook o Instagram.

Esta guía proporciona la especificación de la carga útil para los eventos CRM cargados solo para la optimización para la conversión de clientes potenciales. No utilices esta especificación para eventos no relacionados con esta optimización.

Consulta la documentación de la API de conversiones para obtener más información sobre cómo empezar a utilizar la API y otros recursos útiles.

Carga útil de eventos

Parámetros

NombreDescripción

lead_id

Entero

Obligatorio
Identificador generado por Facebook para cada cliente potencial. Es un número de 15 o 16 dígitos que se obtiene del campo leadgen_id en el webhook de generación de clientes potenciales y se incluye en el parámetro user_data. Consulta Buscar el identificador de cliente potencial para obtener más información.
Es obligatorio usar los identificadores de clientes potenciales en lugar de la información de los clientes para establecer coincidencias. Utiliza una variable para pasar los valores de los identificadores desde el sistema de CRM.
Nota: No apliques algoritmos hash.

event_name

Cadena

Obligatorio
Campo de formato libre para capturar las fases que utilizas en el sistema de CRM.
Asegúrate de enviar todas las fases a medida que se actualizan, incluida la fase de cliente potencial inicial.
Por ejemplo, las fases pueden incluir los siguientes tipos. Si un cliente potencial alcanza la fase final “Convertido”, todas las fases anteriores deben haberse enviado previamente.

  1. Cliente potencial inicial de Facebook
  2. Cliente potencial cualificado en marketing
  3. Oportunidad de ventas
  4. Convertido

Utiliza una variable para pasar las fases desde el sistema de CRM. También puedes crear una llamada a la API independiente para cada fase.

event_time

Entero

Obligatorio
Marca de tiempo Unix expresada en segundos que indica cuándo actualiza el sistema de CRM el evento de actualización de la fase de clientes potenciales.
Utiliza una variable para pasar los valores de la marca de tiempo Unix desde la base de datos.
Nota: El valor del parámetro event_time puede ser de hasta siete días antes de que envíes un evento a Meta. Además, la marca de tiempo debe tener lugar después de la hora de generación de clientes potenciales; de lo contrario, el evento puede descartarse.

action_source

Cadena

Obligatorio.
Establece este parámetro en el valor system_generated para todos los eventos de conversión de clientes potenciales.
En el caso de las integraciones para conseguir conversiones de clientes potenciales, especifica si las conversiones se generan mediante un sistema.

lead_event_source

Cadena

Obligatorio.
Establece este parámetro en el nombre de la herramienta de la que provienen los clientes potenciales (p. ej., Hubspot, SAP, Oracle, Dynamics, CRM interno, etc.), que se incluye en el parámetro custom_data.

event_source

Cadena

Obligatorio.
Establece este parámetro en el valor crm para todos los eventos de conversión de clientes potenciales.
En el caso de la integración para conseguir conversiones de clientes potenciales, especifica tu sistema de CRM como origen del evento en el parámetro custom_data.

Ejemplo

En este ejemplo se muestra el formato de la carga útil de eventos enviada en la llamada a la API.

{
    "event_name": "my lead stage",
    "event_time": 1617693833,
    "user_data": {
        "lead_id": 1234567890123456
    },
    "action_source": "system_generated",
    "custom_data": {
        "lead_event_source": "Salesforce",
        "event_source": "crm"
    }
}

Más información