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	No
`path.to.node`	Path al nodo donde escribir el valor (formato JSON path)	No
`process_headers`	Boolean. Enriquece evento con datos de headers HTTP: Referrer y Cookies	No
`cookie_domain`	Cuando `process_headers=true`, configura Anonymous Id cookie (`__eventn_id`) para el dominio especificado	No

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>

<!-- 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	❌	✅
Cookies	❌	✅
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.