Un objetivo es algo que merece la pena contar: un registro, una compra, una solicitud de demo. Tu sitio lo comunica y Analíticas web lo registra en la visita que lo produjo.
Registrar un objetivo
NotifuseAnalytics.trackGoal({ action: 'purchase', type: 'purchase', value: 49.9 })
| Campo | Obligatorio | Notas |
|---|---|---|
action | Sí | El nombre del objetivo, hasta 100 bytes (100 caracteres ASCII, menos si el texto lleva acentos o no usa el alfabeto latino). |
type | Sí | El tipo de conversión: purchase, subscription, lead, signup, booking, trial u other. |
value | No | Un número no negativo: ingresos, o lo que quieras sumar. |
properties | No | Hasta 50 valores propios, de 1024 bytes cada uno y 8 KB en total, claves incluidas. Se guardan como cadenas. |
type es obligatorio porque solo tu sitio sabe si una conversión es una venta o
un lead, y las condiciones de segmento basadas en objetivos filtran por él.
trackGoal rechaza la llamada cuando falta type o no es uno de estos valores, en
minúsculas, así que captura el error si esperas a trackGoal antes de redirigir.
Usa other cuando no encaje ninguno de los demás.
La ruta de la página actual y su posición en la visita se adjuntan automáticamente, así que un objetivo siempre sabe dónde ocurrió.
Nota
Los objetivos se envían de inmediato, sin esperar al siguiente latido, así que una conversión en una página que el visitante está a punto de abandonar llega igualmente.
Advertencia
Un value negativo invalida el objetivo entero: se descarta el objetivo completo, con su nombre, no solo el número. La API de eventos personalizados funciona de otra forma: acepta valores negativos a propósito, para reembolsos y contracargos.
No tienes que declarar los objetivos en ningún sitio antes. La pestaña Objetivos lista los nombres que ha enviado tu sitio, ordenados por conversiones, y muestra como máximo los 30 objetivos con más conversiones para el periodo y los filtros que hayas aplicado.
Valores desde un gestor de etiquetas o JavaScript simple
Un fragmento de código o un gestor de etiquetas suele pasar valores leídos de la página, así que trackGoal convierte por ti los tipos habituales:
- Un
valueen forma de cadena escrita como un número JSON, como'49.90'o'120', se guarda como número.'49,90','1,299.00','€49.90'y'.5'no lo son, y ese objetivo se descarta, como se explica más abajo. - Un
valueigual aNaN(lo que devuelveparseFloat('€49.90')), un número infinito,nullo una cadena vacía registra el objetivo sin valor y sin aviso. La pestaña Objetivos y los informes cuentan ese objetivo como 0 en los valores medio y mediano. - Los números y booleanos de
propertiesse guardan como cadenas, y unDatecomo su cadena ISO.null,NaN, un número infinito y unDateno válido se guardan como cadena vacía, y una entradaundefinedse omite. - Cuando
propertiesesfalse,''o0, como devuelvecoupon && { coupon }sin cupón, el objetivo se registra sin propiedades.
Un objetivo cuyos datos siguen sin poder registrarse se descarta con un aviso en la consola del navegador. La llamada se resuelve igualmente, así que una página que espera a trackGoal antes de redirigir sigue redirigiendo.
Esto se aplica a un action ausente, vacío, que no sea una cadena o que supere los 100 bytes; a un value que no sea un número o que esté fuera del rango de 0 a 1e12; y a unas properties que sean un array, una cadena no vacía, true o un número distinto de 0 y NaN, que contengan un objeto o un array, o que superen los límites de arriba. El resto de la visita se sigue registrando.
Un Map, un FormData o un URLSearchParams no tienen campos propios, así que un objetivo que recibe uno de ellos como properties se registra sin propiedades y sin aviso. Pasa en su lugar Object.fromEntries(…) del objeto, sin los campos de archivo, cuyo valor es un objeto.
Qué produce un objetivo
El icono del ojo en la tarjeta de un objetivo abre su panel a todo el ancho. Todas sus cifras cuentan solo las conversiones de ese objetivo.
- La barra vuelve a Objetivos, pasa al objetivo anterior o siguiente de la cuadrícula con las flechas o con K y J, y muestra el periodo y el periodo con el que se compara. Los dos se eligen en la pestaña Objetivos.
- Filtrado por lista los filtros aplicados, y cada uno se puede quitar. Son los filtros de toda la sección Analíticas web: al hacer clic en una fila o en un país del panel, también se añade allí un filtro.
- La franja de KPI muestra Recuento, Tasa de conv., Valor total y Valor mediano, frente al periodo de comparación. Al hacer clic en Recuento, Valor total o Valor mediano, se muestra su gráfico.
- Tasa de conv. es el número de conversiones del objetivo dividido entre las sesiones del periodo, como en la tarjeta del objetivo. Cuenta eventos de objetivo, no sesiones con conversión, así que un objetivo alcanzado dos veces en una sesión cuenta dos veces y la tasa puede superar el 100 %. Su tooltip avisa de que incluye todo el tráfico, sea cual sea el motivo de la visita.
- El gráfico usa la granularidad que elijas en él y muestra tus anotaciones, junto a un mapa de calor del objetivo por día y hora.
- Las tarjetas desglosan las conversiones y su valor: Fuentes principales (referentes, canales, grupos de canales), Campañas principales (campañas, fuentes, medios, sin las conversiones que no tienen campaña), Dispositivos (dispositivos, navegadores, SO), Países (mapa y lista), Páginas de destino (páginas de destino y páginas de objetivo) y una tarjeta para las dimensiones personalizadas que tengan nombre.
En los informes, los objetivos aportan las medidas Goals, Total Goal Value, Avg Goal Value, Median Goal Value y Converting Sessions, y las dimensiones Goal Name, Goal Path y Goal Value. A nivel de sesión, Sessions with Goals y Goal Value te permiten comparar canales por conversiones en lugar de por tráfico.
Para un visitante identificado, un objetivo también se convierte en un evento personalizado en la línea de tiempo de su contacto, lo que lo hace accesible desde segmentos y automatizaciones. Consulta Identificar visitantes.
Nombres de objetivo en la línea de tiempo del contacto
Un objetivo que llega a la línea de tiempo de un contacto se normaliza antes: se pasa a minúsculas, todo lo que no sea ASCII a–z, 0–9, . y / se reduce a un solo _, se quitan los _ del principio y del final, y el resultado se corta a 100 caracteres. Así, Trial Started llega como trial_started, y ese es el nombre con el que trabaja una automatización o un segmento.
Advertencia
El conjunto de caracteres que se conserva es solo ASCII, así que las letras acentuadas y las de otros alfabetos se eliminan en lugar de transliterarse: Café llega como caf. Un nombre sin ninguna letra ni dígito ASCII, como 購入, queda vacío al normalizarse y nunca llega a la línea de tiempo. El objetivo se sigue registrando y apareciendo en los informes; solo se omite la copia en la línea de tiempo. Usa nombres de objetivo en ASCII si segmentas o automatizas con ellos.
Esta regla también es más estricta que la de los eventos enviados a través de la API de eventos personalizados, que admite guiones: black-friday enviado desde un objetivo web se convierte en black_friday.
Usar objetivos web en segmentos
Un objetivo web lleva los mismos tres datos que un evento personalizado creado mediante la API: un nombre, un valor y un tipo.
- La condición Objetivo de eventos personalizados coincide con los objetivos web, de un tipo concreto o de Todos los tipos, y cuenta, suma y promedia su valor.
- Una automatización puede activarse con un evento personalizado que tenga el nombre normalizado del objetivo.
Nota
El tipo lo declara tu sitio y Notifuse no lo verifica, y es la misma página la que elige el nombre y el valor del objetivo. Tenlo en cuenta al leer los informes de ingresos, igual que con los eventos enviados a través de la API.
Límites
- Por cada lote de escritura se pasan a la línea de tiempo del contacto hasta 100 objetivos de una sesión. Los que superan ese número dentro del mismo lote se pierden para la línea de tiempo de forma permanente, y el contador se reinicia en cada lote, así que una visita larga que sigue convirtiendo puede acabar con más de 100 entradas en total en la línea de tiempo. La visita se sigue registrando; el límite solo afecta a la copia en la línea de tiempo.
- Un objetivo de más de 24 horas no se pasa a la línea de tiempo. Un visitante cuyo navegador estuvo sin conexión un día vuelve con su visita intacta, sin disparar automatizaciones de tipo “acabas de hacer esto” con un día de retraso.
- Se descarta un objetivo con un valor superior a 1e12, un nombre de más de 100 bytes, propiedades con más de 50 claves, más de 1024 bytes en un valor o más de 8 KB en total con sus claves, una propiedad que contenga un objeto o un array, o un carácter NUL (
\u0000) en su nombre o en sus propiedades. Solo se descarta el objetivo, nunca el resto de la visita.
Notas
- Los objetivos de visitantes anónimos se registran y aparecen en los informes con normalidad. Solo la copia en la línea de tiempo necesita una identidad.
- Los eventos que llegan a la línea de tiempo llevan como propiedades el contexto de la visita (ID de sesión, ruta, ruta de destino, origen, medio y campaña UTM, dispositivo y país) junto a las tuyas. Notifuse define esas claves y sobrescriben las propiedades con el mismo nombre.
- Una moneda, un ID de pedido o cualquier otro dato de la conversión va en
properties, que se envían y se guardan. No hay un campocurrencydedicado:goal_valuees un número sin más, así que si registras varias monedas, agrupa tus informes por la propiedad de moneda en lugar de sumar valores de monedas distintas. - Referencia de la API
