Parámetros UTM de VTEX: guía completa de utmi_cp, utmi_pc y utmi_p
utmi_cp, utmi_pc y utmi_p son los parámetros de tracking internos de VTEX: utmi_cp identifica la campaña, utmi_pc la pieza o banner específico que recibió el clic y utmi_p la página donde estaba esa pieza. A diferencia de los utm_ de Google, GA4 no los interpreta: los captura la propia tienda VTEX y quedan grabados en cada orden, listos para atribuir ventas y condicionar promociones.
Sobre los UTMs estándar se ha escrito muchísimo — si todavía no los dominas, empieza por qué son los parámetros UTM —, pero sobre los utmi_ casi no hay nada en español. El resultado: la mayoría de los equipos que operan tiendas VTEX en Perú y LatAm los copia de una URL vieja "porque siempre estuvieron ahí", sin saber qué hace cada uno ni dónde termina esa data. Esta guía cierra ese hueco.
¿Qué significa cada parámetro utmi_?
Los tres parámetros describen un clic con tres niveles de detalle, de lo general a lo específico:
- utmi_cp — la campaña interna. Es el equivalente VTEX de utm_campaign: un nombre que agrupa todas las piezas de una misma acción comercial, por ejemplo fiestas_patrias_2026.
- utmi_pc — la pieza de la campaña. Identifica qué elemento concreto recibió el clic: el banner principal de la home, el botón de un mailing, la tarjeta de un carrusel. Algunos equipos lo usan también para identificar un partner o canal interno; lo importante es definir una convención y sostenerla.
- utmi_p — la página de origen. Indica dónde estaba la pieza: home, categoria_zapatillas, busqueda_interna.
Estos parámetros vienen del ecosistema de campañas internas de VTEX y siguen en uso: la plataforma los captura durante la compra y los guarda en los datos de marketing de cada orden.
¿En qué se diferencian de los utm_ de Google?
La diferencia central es quién los lee. Los utm_ son un estándar de facto que entienden GA4 y prácticamente cualquier herramienta de analítica. Los utmi_ solo los entiende VTEX: viajan en la URL, la plataforma los asocia a la sesión de compra y, si esa sesión termina en una orden, quedan registrados en ella.
| Aspecto | utm_ (estándar) | utmi_ (VTEX) |
|---|---|---|
| Quién los lee | GA4 y otras herramientas de analítica | Solo VTEX |
| Dónde se ven | Reportes de adquisición de GA4 | Datos de marketing de cada orden |
| Tráfico típico | Campañas externas (ads, email, social) | Campañas internas y atribución a nivel de orden |
| ¿Afectan la atribución de GA4? | Sí, la definen | No, GA4 los ignora |
| ¿Sirven para condicionar promociones VTEX? | Sí | Sí (utmi_cp) |
| Nivel de análisis | Sesiones y conversiones | Órdenes y facturación |
Esa última fila importa: GA4 te dice qué campaña generó sesiones y conversiones según su modelo de atribución; los utmi_ te dicen qué campaña quedó escrita en la orden real, con su monto exacto, dentro del sistema donde vive la verdad transaccional de tu tienda.
¿Dónde aparecen los utmi_ dentro de VTEX?
A nivel funcional el flujo es este: alguien entra a tu tienda con utmi_ en la URL, VTEX asocia esos valores a su sesión de compra y, cuando la orden se confirma, los guarda como parte de los datos de marketing de esa orden. Desde ahí puedes consultarlos en tres lugares:
- El detalle de cada orden en la gestión de pedidos (OMS), junto a los utm_ estándar y el cupón si lo hubo.
- La API de órdenes, dentro del objeto marketingData — al momento de escribir (julio 2026), con campos como utmiCampaign, utmiPart y utmipage; verifica los nombres exactos en la documentación para desarrolladores de VTEX.
- Las promociones: VTEX permite condicionar una promoción a valores de UTM, incluida la campaña interna (utmi_cp). Así puedes crear un descuento que solo se active para quien llegó desde un link específico.
Si además administras colecciones de productos para estas campañas, el Gestor de colecciones VTEX de Clico te deja auditar cuántos productos tiene cada una antes de lanzar.
¿Cuándo usar cada parámetro utmi_?
Tres escenarios cubren casi todos los casos:
- Banner o pieza interna de tu propia tienda (home, categoría, buscador): usa solo utmi_cp, utmi_pc y utmi_p. Nada de utm_: etiquetar links internos con utm_ rompe la atribución de GA4, porque la sesión pasa a atribuirse al "canal" interno en vez de a la fuente real que trajo al visitante.
- Campaña externa que quieres ver en las órdenes: usa los utm_ completos para GA4 y agrega utmi_cp con el mismo valor que utm_campaign. Así la campaña queda legible en ambos mundos.
- Promoción condicionada a una campaña: define el utmi_cp del link con el mismo valor configurado en la condición de la promoción, y ese descuento solo aplicará a quien entre por ese link.
¿Cómo combinar utm_ y utmi_ sin romper GA4?
Las reglas prácticas:
- En tráfico externo, los utm_ mandan. Los utmi_ van de acompañamiento; GA4 los ignora para atribución, así que no compiten entre sí.
- En links internos, jamás utm_. Los utmi_ sí puedes usarlos con libertad: para GA4 son parámetros desconocidos y no alteran la fuente de la sesión.
- Espeja utm_campaign y utmi_cp. Usar el mismo valor te permite cruzar los reportes de GA4 con las órdenes de VTEX sin tablas de equivalencia.
- Sanitiza igual que con los utm_: minúsculas, guiones bajos en vez de espacios, sin tildes. VTEX guarda el valor tal cual llega en la URL, y "Fiestas Patrias" con mayúsculas y espacios se convierte en un dato sucio imposible de agrupar después.
- Cuida el largo de la URL. Seis parámetros generan links kilométricos; pásalos por un acortador de URLs antes de publicarlos en redes o WhatsApp.
Si después quieres leer los resultados del lado de Google, la guía de cómo medir campañas en GA4 explica en qué reportes aparece cada utm_.
Ejemplos: campaña de Fiestas Patrias para una tienda peruana
Supón que tu tienda corre en VTEX y lanzas la campaña de Fiestas Patrias con anuncios en Facebook, un mailing y un banner en la home.
Anuncio de Facebook (tráfico externo):
https://www.mitienda.com.pe/ofertas?utm_source=facebook&utm_medium=cpc&utm_campaign=fiestas_patrias_2026&utmi_cp=fiestas_patrias_2026GA4 atribuye la sesión a facebook/cpc y la orden queda marcada con la campaña interna.
Mailing (tráfico externo, con pieza identificada):
https://www.mitienda.com.pe/ofertas?utm_source=email&utm_medium=email&utm_campaign=fiestas_patrias_2026&utm_content=boton_hero&utmi_cp=fiestas_patrias_2026&utmi_pc=boton_heroutm_content y utmi_pc cumplen el mismo rol en cada mundo: identificar la pieza exacta que generó el clic.
Banner en la home (link interno, sin utm_):
https://www.mitienda.com.pe/ofertas?utmi_cp=fiestas_patrias_2026&utmi_p=home&utmi_pc=banner_heroGA4 no se entera y la atribución original del visitante queda intacta, pero cada orden que nazca de ese banner llevará grabadas la campaña, la página y la pieza.
¿Cómo generar estos links sin errores?
Escribir seis parámetros a mano en cada URL es la receta perfecta para typos que fragmentan tu data. El UTM Builder de Clico soporta los utmi_ de VTEX como parámetros custom de primera clase: agregas utmi_cp, utmi_pc y utmi_p junto a los cinco UTMs estándar (y utm_id), y la sanitización automática aplica las mismas reglas a todos — minúsculas, sin espacios, sin tildes. Puedes guardar plantillas por tipo de campaña, revisar el historial de links generados y exportarlo a CSV. En el plan Pro, además, puedes definir listas cerradas de valores para que nadie del equipo invente un utmi_cp nuevo por su cuenta. Todo es gratis durante la Beta.
Preguntas frecuentes
¿GA4 lee los parámetros utmi_ de VTEX?
No. GA4 solo interpreta los parámetros utm_ estándar (source, medium, campaign, term, content e id) para construir su atribución. Los utmi_cp, utmi_pc y utmi_p pasan como parámetros desconocidos: no crean campañas en los reportes ni alteran la fuente de la sesión. Por eso son la opción segura para etiquetar links internos de una tienda VTEX. Si necesitas las dos vistas, combínalos en la misma URL — utm_ para Google, utmi_ para VTEX — y revisa la guía de cómo medir campañas en GA4 para leer los reportes del lado de Google.
¿Debo usar utm_ o utmi_ en los banners internos de mi tienda VTEX?
utmi_ siempre. Un link interno con utm_ sobrescribe la atribución de la sesión en GA4: el visitante que llegó desde Facebook pasa a figurar como si viniera de tu propio banner, y pierdes la fuente real de la venta. Con utmi_cp, utmi_p y utmi_pc obtienes el dato que buscas — qué banner interno genera órdenes y cuánto facturan — sin tocar la atribución, porque GA4 ignora esos parámetros. Es la solución nativa de VTEX al clásico problema de no poder etiquetar links internos.
¿Puedo condicionar promociones de VTEX a un utmi_cp?
Sí. A nivel funcional, VTEX permite que una promoción solo se active cuando la sesión de compra llegó con determinados valores de UTM, incluida la campaña interna utmi_cp. Es útil para descuentos exclusivos de un canal: un precio especial que solo ve quien entró por el link del mailing o del banner de campaña. Configura la condición en el módulo de promociones con el mismo valor que usas en el link, haz una orden de prueba antes de lanzar y verifica los detalles en la documentación oficial de VTEX, porque las opciones exactas pueden variar.
¿Dónde veo los utmi_ de una orden en VTEX?
En el detalle de cada orden dentro de la gestión de pedidos (OMS), junto al resto de los datos de marketing: utm_ estándar y cupón si lo hubo. Por API aparecen en el objeto marketingData de la orden — al momento de escribir (julio 2026), con campos como utmiCampaign, utmiPart y utmipage; verifica los nombres exactos en la documentación para desarrolladores de VTEX. Para análisis agregado, extrae tus órdenes vía API o reportes y agrupa la facturación por campaña interna.
Genera tus links VTEX sin errores
El UTM Builder de Clico soporta utmi_cp, utmi_pc y utmi_p como parámetros custom, con sanitización automática, plantillas, historial y export a CSV. Gratis durante la Beta.
Probar el UTM Builder