Referencia de eventos

Eventos estándar

Profound Pixel reconoce los siguientes eventos estándar. Cada evento acepta un conjunto de campos opcionales. Consulta Conjuntos de campos para ver qué acepta cada conjunto.

Evento	Cuándo enviarlo	Conjunto de campos
`page_viewed`	Un visitante ve una página	`contents`
`contents_viewed`	Un visitante ve un producto, un listado, un artículo u otra unidad de contenido	`contents`
`items_added`	Un visitante agrega artículos a un carrito o selección	`contents`
`checkout_started`	Un visitante inicia el proceso de pago	`contents`
`order_created`	Se completa una compra	`contents`
`subscription_created`	Comienza una suscripción de pago	`plan_enrollment`
`trial_started`	Comienza una prueba gratuita	`plan_enrollment`
`lead_created`	Un visitante envía un formulario de contacto o solicita que lo contacten	`customer_action`
`registration_completed`	Un visitante termina el registro de una cuenta o un evento	`customer_action`
`appointment_scheduled`	Un visitante reserva una reunión, una demostración o una consulta	`customer_action`

Conjuntos de campos

Conjunto de campos	Campos reconocidos
`contents`	`amount`, `currency`, `contents[]`
`plan_enrollment`	`plan_id`, `amount`, `currency`, `contents[]`
`customer_action`	`amount`, `currency`

Propiedades del conjunto contents

Propiedad	Tipo	Obligatoria	Descripción
`amount`	number	no	Un número entero en unidades menores de la moneda indicada (centavos para dólares estadounidenses). Por ejemplo, $129.99 = `12999`. Úsalo siempre junto con `currency`
`currency`	string	sí, si `amount` está presente	Un código de moneda ISO 4217, como `USD`
`contents[]`	array	no	Una lista de los artículos involucrados en el evento. Cada entrada admite `id`, `name`, `content_type`, `quantity` (un número entero), `amount` y `currency`

Example event

  pfq('track', 'order_created', {
    amount: 12999, currency: 'USD',
    contents: [
      {
        id: 'SKU123',
        name: 'Widget',
        content_type: 'product',
        quantity: 1,
        amount: 12999,
        currency: 'USD'
      }
    ]
  });

Propiedades del conjunto plan_enrollment

Propiedad	Tipo	Obligatoria	Descripción
`plan_id`	string	no	Tu identificador interno del plan
`amount`	number	no	Un número entero en unidades menores de la moneda indicada (centavos para dólares estadounidenses). Por ejemplo, $129.99 = `12999`. Úsalo siempre junto con `currency`.
`currency`	string	sí, si `amount` está presente	Un código de moneda ISO 4217, como `USD`
`contents[]`	array	no	Una lista de los artículos involucrados en el evento. Cada entrada admite `id`, `name`, `content_type`, `quantity` (un número entero), `amount` y `currency`

Example event

  pfq('track', 'subscription_created', {
    plan_id: 'pro-monthly',
    amount: 4900,
    currency: 'USD',
    contents: [
      {
        id: 'pro-monthly',
        name: 'Pro plan, monthly billing',
        content_type: 'plan',
        quantity: 1,
        amount: 4900,
        currency: 'USD'
      }
    ]
  });

Propiedades del conjunto customer_action

Propiedad	Tipo	Obligatoria	Descripción
`amount`	number	no	Un número entero en unidades menores de la moneda indicada (centavos para dólares estadounidenses). Por ejemplo, $129.99 = `12999`. Úsalo siempre junto con `currency`.
`currency`	string	sí, si `amount` está presente	Un código de moneda ISO 4217, como `USD`.

Example event

  pfq('track', 'lead_created', {
    amount: 50000,
    currency: 'USD',
    form: 'contact-sales'
  });

Propiedades personalizadas

Agrega tus propias propiedades personalizadas (como order_id o product_id) junto a los campos reconocidos. Se aplican dos límites: hasta 128 propiedades por evento y hasta 64 KiB por cuerpo de solicitud. Un evento que supere cualquiera de los dos límites se rechaza con un error 400.

Eventos personalizados

Para cualquier cosa fuera del conjunto estándar, envía un evento personalizado: llama a pfq('trackCustom', …) con el nombre de evento y las propiedades que elijas.

  pfq('trackCustom', 'requested_demo', { plan: 'enterprise' });

La longitud máxima de los nombres de eventos es de 128 caracteres. La convención de nomenclatura sugerida es usar letras minúsculas, números, guiones bajos o guiones, y un nombre que no coincida con el de un evento estándar, para que tus eventos personalizados sean fáciles de distinguir en los informes.

Nunca envíes datos personales de tus clientes en los eventos. Esto incluye correos electrónicos, números de teléfono, nombres, documentos de identidad oficiales, datos de pago, direcciones postales y datos de categorías especiales, como información de salud, detalles de cuentas financieras o datos biométricos. Como medida de seguridad, Profound descarta las claves de datos personales y oculta los valores que parecen datos personales.

Vincula los eventos a tus propios ID de usuario

Si necesitas hacer coincidir las conversiones con registros de tus propios sistemas, haz una llamada identify con tus identificadores internos después de que el cliente inicie sesión y antes de enviar cualquier evento:

  pfq('identify', {
    external_user_id: 'u_123',
    external_account_id: 'acct_456'
  });

Se aceptan los siguientes campos:

Campo	Tipo	Obligatorio
`external_user_id`	string	no
`external_account_id`	string	no

Cualquier otro campo se ignora de forma silenciosa. El píxel conserva los ID en memoria hasta que tu señal de consentimiento permite el envío y, luego, los adjunta a los eventos siguientes.

Envía solo ID internos, nunca nombres, correos electrónicos, números de teléfono ni otros identificadores de tus clientes. Si hay datos personales en los campos de identify, se rechaza todo el evento con un error 400.

General

Agent Analytics

Bots

Renderizado dinámico para bots

Profound Pixel

Referencia de eventos

Eventos estándar

Conjuntos de campos

Propiedades personalizadas

Eventos personalizados

Vincula los eventos a tus propios ID de usuario

​Eventos estándar

​Conjuntos de campos

​Propiedades personalizadas

​Eventos personalizados

​Vincula los eventos a tus propios ID de usuario

Eventos estándar

Conjuntos de campos

Propiedades personalizadas

Eventos personalizados

Vincula los eventos a tus propios ID de usuario