addUtm
Paquete: @tiendana/ngx-core/pipes
Agrega parámetros UTM a URLs para tracking de campañas de marketing.
Características
✅ Agrega automáticamente utm_source, utm_medium y utm_campaign
✅ Usa valores por defecto: source: 'webapp', campaign: 'organic'
✅ Solo requiere especificar el medium
✅ Usa función generateUTMUrl de @tiendana/utils
API
Sintaxis
{{ url | addUtm:{ medium: 'email' } }}
Parámetros
| Parámetro | Tipo | Descripción | Requerido |
|---|---|---|---|
url | string | URL base a la que se agregarán los parámetros UTM | ✅ |
medium | { medium: string } | Objeto con la propiedad medium (email, social, cpc, etc.) | ✅ |
Retorno
URL con parámetros UTM agregados: ?utm_source=webapp&utm_medium={medium}&utm_campaign=organic
Ejemplos y Demos
Uso Básico
Ver código
Lista de Productos con Tracking
Ver código
Mediums Comunes
| Medium | Uso |
|---|---|
email | Enlaces en campañas de email marketing |
social | Enlaces compartidos en redes sociales |
cpc | Anuncios de pago por clic (Google Ads, etc.) |
banner | Banners publicitarios |
affiliate | Links de afiliados |
referral | Referencias de otros sitios |
catalog | Catálogos de productos |
Casos de Uso
- Tracking de campañas de email
- Enlaces en redes sociales
- Banners promocionales
- Catálogos de productos
- Links de afiliados
- Análisis de fuentes de tráfico
Notas
Los parámetros UTM generados son:
utm_source=webapp(fijo)utm_medium={medium}(el que especifiques)utm_campaign=organic(fijo)
Para mayor control sobre source y campaign, usa directamente generateUTMUrl de @tiendana/utils.
El pipe lee args[0].medium, así que llamarlo sin el objeto ({{ url | addUtm }}) lanza un error en tiempo de ejecución.
Estos parámetros UTM son estándar de Google Analytics y permiten rastrear de dónde vienen tus visitantes y qué campañas son más efectivas.