Pixel Tracking

Trackea eventos usando una imagen invisible 1x1, ideal para entornos donde JavaScript no está disponible.

¿Cuándo usar Pixel Tracking?

El pixel tracking es perfecto para:

✅ Emails HTML - Trackear aperturas de correos
✅ Newsletters - Medir engagement
✅ Ambientes sin JavaScript - Donde JS está bloqueado o restringido
✅ Ads / Banners - Trackear impresiones
✅ Solo HTTP GET - Cuando solo se permiten requests GET
✅ Solo imágenes - Cuando solo se permite embed de imágenes

⚠️ Limitación: Solo soporta HTTP GET, por lo que los datos deben ir en la URL.

Cómo Funciona

Insertas una imagen invisible en tu HTML usando tag <src> o <img>
La URL de la imagen contiene los datos del evento
Cuando se carga la imagen, el CDP registra el evento
El servidor devuelve un GIF transparente de 1x1 pixel

Pixel Endpoint

https://cdp.companydomain.m1das.app/api/px/[event-type]

Ejemplo completo:

https://cdp.companydomain.m1das.app/api/px/email_opened

Query Parameters

Parámetro

Descripción

Requerido

writekey

Write Key de tu Midas CDP Stream configurado

✅ Sí

data

JSON payload codificado en base64

path.to.node

Path al nodo donde escribir el valor (formato JSON path)

process_headers

Boolean. Enriquece evento con datos de headers HTTP: Referrer y Cookies

cookie_domain

Cuando process_headers=true, configura Anonymous Id cookie (__eventn_id) para el dominio especificado

Método 1: Event Properties como Query Parameters

La forma más simple es pasar las propiedades del evento directamente como parámetros en la URL:

<img 
  src="https://cdp.companydomain.m1das.app/api/px/email_opened?writekey=TU_WRITE_KEY&user_id=user_123&campaign=newsletter_enero"
  width="1" 
  height="1" 
  style="display:none;"
/>

Ejemplo con más propiedades:

<img 
  src="https://cdp.companydomain.m1das.appapi/px/button_clicked?writekey=TU_WRITE_KEY&user_id=user_123&button_name=Get%20Started&page=/landing"
  width="1" 
  height="1" 
  style="display:none;"
/>

Método 2: Datos en Base64

Para eventos más complejos, codifica el JSON payload en base64 usando el parámetro data:

<img 
  src="https://cdp.companydomain.m1das.app/api/px/email_opened?writekey=TU_WRITE_KEY&data=eyJ1c2VyX2lkIjoidXNlcl8xMjMiLCJjYW1wYWlnbiI6Im5ld3NsZXR0ZXJfZW5lcm8iLCJzdWJqZWN0IjoiT2ZlcnRhcyBkZSBFbmVybyJ9"
  width="1" 
  height="1" 
  style="display:none;"
/>

JSON original (antes de codificar):

{
  "user_id": "user_123",
  "campaign": "newsletter_enero",
  "subject": "Ofertas de Enero"
}

Nota: El writekey va como query parameter, NO dentro del JSON payload codificado.

Casos de Uso

1. Trackear Apertura de Email

<!-- En tu email HTML -->
<html>
<body>
  <h1>Hola {{ user.name }}!</h1>
  <p>Contenido del email...</p>
  
  <!-- Pixel de tracking al final -->
  <img 
    src="https://cdp.companydomain.m1das.app/api/px/email_opened?writekey=TU_WRITE_KEY&user_id={{ user.id }}&campaign=promo_verano&email_id={{ email.id }}"
    width="1" 
    height="1" 
    style="display:none;"
  />
</body>
</html>

2. Click en Link de Email

<a href="https://tutienda.com/promo?utm_source=email&utm_campaign=verano">
  <img 
    src="https://cdp.companydomain.m1das.app/api/px/email_link_clicked?writekey=TU_WRITE_KEY&user_id={{ user.id }}&link_name=promo_verano&destination=tienda" 
    width="1" 
    height="1" 
    style="display:none;"
  />
  Ver Promoción
</a>

3. Impresión de Banner

<!-- Banner publicitario -->
<div class="banner">
  <img src="banner.jpg" alt="Promo">
  
  <!-- Pixel de tracking de impresión -->
  <img 
    src="https://cdp.companydomain.m1das.app/api/px/banner_viewed?writekey=TU_WRITE_KEY&campaign=display_q1&placement=homepage&banner_id=summer_sale"
    width="1" 
    height="1" 
    style="display:none;"
  />
</div>

<html>
<body>
  <!-- Pixel de apertura -->
  <img 
    src="https://cdp.companydomain.m1das.app/api/px/newsletter_opened?writekey=TU_KEY&user_id=123&newsletter_id=enero_2026" 
    width="1" 
    height="1" 
    style="display:none;"
  />
  
  <h1>Newsletter Enero 2026</h1>
  
  <!-- Link 1 con tracking -->
  <a href="https://tienda.com/producto-a">
    <img 
      src="https://cdp.companydomain.m1das.app/api/px/link_clicked?writekey=TU_KEY&user_id=123&link_id=producto_a&position=1" 
      width="1" 
      height="1" 
      style="display:none;"
    />
    Producto A
  </a>
  
  <!-- Link 2 con tracking -->
  <a href="https://tienda.com/producto-b">
    <img 
      src="https://cdp.companydomain.m1das.app/api/px/link_clicked?writekey=TU_KEY&user_id=123&link_id=producto_b&position=2" 
      width="1" 
      height="1" 
      style="display:none;"
    />
    Producto B
  </a>
</body>
</html>

Consideraciones de Privacidad

⚠️ IMPORTANTE:

Consentimiento: Informa a usuarios que usas tracking pixels
GDPR: Respeta regulaciones de privacidad
Datos Sensibles: No envíes PII en URLs
Opt-out: Permite a usuarios desactivar tracking

Limitaciones

Aspecto

Limitación

Método HTTP

Solo GET

Tamaño URL

~2000 caracteres

JavaScript

No ejecuta código

Context automático

No captura user-agent, etc.

Adblockers

Pueden bloquear el pixel

Comparación: Pixel vs JavaScript SDK

Feature

Pixel

JavaScript SDK

Ambientes sin JS

✅

❌

Emails HTML

✅

❌

Context automático

❌

✅

Datos complejos

⚠️ Limitado

✅

User Agent

❌

✅

❌

✅

Pageviews automáticos

❌

✅

Testing

Verificar en Navegador

Abre tu HTML en el navegador
Abre DevTools → Network
Busca request a /api/px/
Verifica status 200
Revisa query parameters (writekey, propiedades del evento)

Verificar en Email

Envía email de prueba a ti mismo
Abre el email
Verifica en DevTools → Network (si aplica)
Consulta tu warehouse para confirmar que el evento llegó

cURL Test

# Test simple con query parameters
curl "https://cdp.companydomain.m1das.app/api/px/test_pixel?writekey=TU_WRITE_KEY&test=true&user_id=test_123"

# Test con data en base64
curl "https://cdp.companydomain.m1das.app/api/px/test_pixel?writekey=TU_WRITE_KEY&data=eyJ1c2VyX2lkIjoidGVzdF8xMjMiLCJ0ZXN0Ijp0cnVlfQ=="

# Test con process_headers
curl -H "Referer: https://google.com" \
     "https://cdp.companydomain.m1das.app/api/px/test_pixel?writekey=TU_WRITE_KEY&process_headers=true"

Eventos Típicos para Email

// Apertura
email_opened

// Click en link
email_link_clicked

// Desuscripción
email_unsubscribed

// Reenvío
email_forwarded

// Impresión de imagen
email_image_loaded

Nota: El pixel tracking es útil pero limitado. Para tracking completo con captura automática de contexto, usa el JavaScript SDK.

AnteriorJavaScript (HTML)SiguienteBackend

Última actualización hace 5 días

Buenos días

hashtag¿Cuándo usar Pixel Tracking?

hashtagCómo Funciona

hashtagPixel Endpoint

hashtagQuery Parameters

hashtagMétodo 1: Event Properties como Query Parameters

hashtagMétodo 2: Datos en Base64

hashtagCasos de Uso

hashtag1. Trackear Apertura de Email

hashtag2. Click en Link de Email

hashtag3. Impresión de Banner

hashtag4. Newsletter con Múltiples Links

hashtagConsideraciones de Privacidad

hashtagLimitaciones

hashtagComparación: Pixel vs JavaScript SDK

hashtagTesting

hashtagVerificar en Navegador

hashtagVerificar en Email

hashtagcURL Test

hashtagEventos Típicos para Email