Guía de implementación genérica del plan de taggin web server-side de Eulerian



1. Introducción

Eulerian Measurement Protocol permite enviar datos analíticos directamente desde tu contenedor Server-Side (sGTM, sTealium) hacia Eulerian Analytics ( ¿Cuáles son las ventajas de una implementación server-side?⁠ ).
Antes de pasar al taggin server-side, asegúrate de que no necesitas funcionalidades client-side (sincronización de identidad, heatmap, etc.), ya que las llamadas desde servidor no permiten ejecutar scripts del lado cliente.


2. Configuración del protocolo de medición

2.1 Estructura de las peticiones

Los datos se envían mediante peticiones HTTP POST o GET al servidor de recopilación de Eulerian.
El formato de la URL es el siguiente:
https://TRACKING_HOSTNAME/TYPE/WEBSITE_NAME/
Ejemplo para un sitio llamado demo-site con servidor de tracking dem.eulerian.net:
<https://dem.eulerian.net/collector/demo-site/>

  • Recomendado

  • : usar POST (permite enviar más datos).
  • Alternativa: usar GET si POST no es posible.

Ejemplo de petición POST

User-Agent: Mozilla/5.0

POST <https://dem.eulerian.net/collector/demo-site/>

Body: key1=val1&key2=val2

Ejemplo de petición GET

GET /collector/demo-site?key1=val1&key2=val2 HTTP/1.1

Host: <dem.eulerian.net>

User-Agent: Mozilla/5.0
Si usas una librería personalizada que pueda ser identificada como un bot (como cURL o wget), la llamada no se registrará. Proporciona un user-agent específico o estándar para que la llamada pueda efectuarse. (ej.: Mozilla/5.0 (X11; Ubuntu; Linux x86_64; rv:71.0) Gecko/20100101 Firefox/71.0)

2.2 Códigos de respuesta

  • 2xx: Solicitud recibida con éxito.
  • Otros: Verifica y corrige el error antes de reintentar.


3. Datos a enviar

Los datos enviados a Eulerian deben estar en UTF-8 y codificados en URL, con formato de pares clave-valor (param1=val1&param2=val2).
Por ejemplo, para enviar la clave urlp con el valor /my page €, debes asegurarte de codificarlo primero en UTF-8 y luego en URL:
urlp=%2Fmy%20page%20%E2%82%AC

3.1 Identificación de usuarios

Eulerian Analytics permite usar varios tipos de identificadores para mantener la identidad en la plataforma y asegurar la correcta agregación de datos.
Es necesario proporcionar parámetros de identidad específicos en cada hit para mantener la identidad del usuario durante la navegación actual (y futuras).
Nombre
Parámetro
Descripción
Valor por defecto
Obligatorio
Ejemplo
Device ID
euidl
Identificador anónimo del usuario
n/a
Sí
d213be2e-053f-4bfb-9c32-1bd6efb5687e
Customer ID
uid
Identificador cliente conocido
n/a
No
customer123

3.2 Parámetros de Replay

Permiten sobrescribir ciertos valores por defecto para insertar datos proporcionados por el cliente.
Nombre
Parámetro
Descripción
Valor por defecto
Obligatorio
Ejemplo
Timestamp del hit
ereplay-time
Timestamp (Unix) del momento en que se registró el hit
Hora actual del servidor
Sí
1599210524
IP del cliente
ereplay-ip
IP del cliente que generó el hit. Afecta a la geolocalización si no se proporciona.
IP del servidor que genera el hit
Sí
12.236.2.65
User-Agent del cliente
ereplay-ua
Si no se proporciona, afecta a la resolución de dispositivos
n/a
No, si se da ereplay-mdevicetype
Mozilla/5.0 ...
Tipo de dispositivo
ereplay-mdevicetype
Alternativa si no se puede proporcionar ereplay-ua
n/a
No, si se da ereplay-ua
Desktop, Phone, Tablet, etc.

3.3 Gestión del consentimiento

Los parámetros de consentimiento deben estar presentes en el 100% de las llamadas a Eulerian.
Verifica que el gestor de consentimiento seleccionado y configurado sea el correcto para el sitio destino.
Nombre
Parámetro
Descripción
Valor por defecto
Obligatorio
Ejemplo
Desactivar gestión de consentimiento
enoepm
Si se establece en 1, se desactiva la gestión de consentimiento
n/a
No
1
Consentimiento TCFv2
gdpr_consent
Cadena TCFv2 completa según el marco del TCF
n/a
Sí, salvo si se da pmcat
CPjTJ1aPjTJ1aOhAAAENCZCgAAAAAAAAAAAADOwAQDOgAAAA.YAAAAAAAAAA
Categorías prohibidas
pmcat
IDs de categorías desactivadas por el usuario (como en la interfaz de usuario)
n/a
Sí, salvo si se da gdpr_consent
89-5-3
Autorizar todas las categorías
pmcat=-
Establece - para permitir todas las categorías disponibles
n/a
No
-

4. Implementación del plan de taggin

4.1 Seguimiento genérico para todas las páginas

Estos parámetros pueden incluirse en todas las peticiones enviadas a Eulerian.
Nombre
Parámetro
Descripción
Valor por defecto
Obligatorio
Ejemplo
URL de la página
url
URL completa (document location) de la página
n/a
Sí
https://www.eulerian.com/page/to/awesome/content
Nombre de página
urlp
Nombre específico de página si la URL no es suficientemente clara o necesita limpieza
n/a
No
/page/to/awesome/content
Grupo de páginas
pagegroup
Agrupación de páginas (definible desde la plataforma de Eulerian)
n/a
No
FAQ
Etiqueta de página
pglbl
Hasta 5 etiquetas por página, separadas por comas. El orden indica el ID de cada etiqueta y debe mantenerse consistente en todo el sitio
n/a
No
content, faq, attribution, meta
Todos los parámetros de las secciones 4.2, 4.3, 4.4 y 4.5 deben incluirse en la misma llamada junto con los parámetros genéricos.


4.2 Seguimiento de fuentes de tráfico

Las fuentes deben enviarse mediante los parámetros en la URL de destino (campañas publicitarias).
Nombre
Parámetro
Descripción
Valor por defecto
Obligatorio
Ejemplo
Parámetros de campaña
param1, param2, ...
Parámetros publicitarios de Eulerian, Google, otros
n/a
Sí
http://maboutique.com/?param1=abc&param2=xyz...
Referente (referrer)
rf
URL de referencia (SEO)
n/a
Sí
https://www.bing.com/query?kw=eulerian


4.3 Seguimiento de conversiones

Los parámetros order, estimate, scart son mutuamente excluyentes. Solo uno puede tener el valor 1 por cada petición.
Nombre
Parámetro
Descripción
Valor por defecto
Obligatorio
Ejemplo
ID de transacción
ref
Identificador único de la transacción
None
Sí (order o estimate)
518fbb68-707e-4baa-ab46-de3499786751
Monto total
amount
Importe total (incluye impuestos y envío)
0
Sí (order o estimate)
321.32
Venta
order
Valor 1 para indicar venta
0
Sí (order)
1
Estimación / Lead
estimate
Valor 1 para indicar estimación o lead
0
Sí (estimate)
1
Carrito
scart
Valor 1 para carrito de compra
Sí (scart)
1
Cumulación carrito
sccumul
Valor 0 para nuevo resumen de carrito
Sí (scart)
0
Estado de la conversión
status
Estado de la transacción
PENDING
Sí (order o estimate)
VALID / PENDING / INVALID
Tipo de transacción
type
Tipo de pedido o presupuesto
None
No
code-promo
Método de pago
payment
Medio de pago usado
None
No
Paypal
Margen
margin
Valor del margen (beneficio)
None
No
29.00
Productos
Ver 4.4
Detalles más abajo
Ver 4.4
Ver 4.4
Ver 4.4
Check Mark Button Solo uno de order, estimate, scart debe valer 1Check Mark Button El ref debe ser únicoCheck Mark Button Incluir payment si aplicaCheck Mark Button Incluir productos relacionados


4.4 Seguimiento de productos

Si se envía una sola referencia de producto sin parámetros de conversión, se interpreta como una página de producto.
Nombre
Parámetro
Descripción
Valor por defecto
Obligatorio
Ejemplo
Nombre del producto
prdn<productIndex>
Nombre cuando se trata de una página de producto
n/a
Sí
my-blue-shoes
SKU (referencia del producto)
prdr<productIndex>
Referencia SKU
n/a
Sí
123456
Grupo del producto
prdg<productIndex>
Agrupaciones de productos (útil para márgenes)
n/a
No
shoes
Precio del producto
prda<productIndex>
Requerido para scart, estimate, order si se indica prdr
n/a
Sí
199.00
Cantidad
prdq<productIndex>
Idem anterior
n/a
Sí
2
Clave de parámetro personalizado
prdp<productIndex>k<productParamIndex>
Clave de metadato adicional
n/a
No
marca
Valor del parámetro personalizado
prdp<productIndex>d<productParamIndex>
Valor correspondiente
n/a
No
jordan


4.5 Seguimiento avanzado de navegación

Nombre
Parámetro
Descripción
Valor por defecto
Obligatorio
Ejemplo
Subkey2
custom_param
Clave principal de segmentación de tráfico
n/a
No
audiencia consultiva

4.6 Búsqueda interna

Nombre
Parámetro
Descripción
Valor por defecto
Obligatorio
Ejemplo
Motor de búsqueda interno
eise
Nombre del buscador
n/a
Sí
mi motor interno
Número de resultados
eisr
Número total devuelto por la consulta actual
n/a
No
13
Clave del parámetro de búsqueda #x
eisk<index>
Clave de parámetro de búsqueda
n/a
Sí
destino
Valor del parámetro de búsqueda #x
eisd<index>
Valor asociado a la clave
n/a
Sí
sevilla


4.7 Seguimiento avanzado

Dimensiones personalizadas & Segmentos de usuario

Para cada página vista puedes añadir parámetros personalizados con el formato clave=valor.Estos parámetros pueden declararse como Dimensiones Personalizadas o Segmentos de Usuario desde la plataforma.

4.8 Seguimiento de eventos

Estos parámetros deben incluirse en todas las peticiones de eventos:
Nombre
Parámetro
Descripción
Valor por defecto
Obligatorio
Ejemplo
Nombre de la acción
actn<index>
Nombre del evento. El índice empieza en 0
n/a
Sí
usuario conectado
Modo de la acción
actm<index>
Construcción de embudos cerrados (in, out) o simple (-)
n/a
No
in, out o vacío
Etiqueta de la acción
actl<index>
Puede incluir etiquetas múltiples para caracterizar la acción
n/a
No
descarga
Referencia única de la acción
actr<index>
Para registrar una referencia única en Datamining
n/a
No
Clave del parámetro de la acción
actp<index>n<index>
Clave de metadato adicional del evento
n/a
No
documento
Valor del parámetro
actp<index>v<index>
Valor del metadato
n/a
No
formación financiera
Tipo de parámetro
actp<index>f<index>
Si el valor tiene un número limitado de opciones (para guardar en Eulerian)
1
No