Recopilar
Constructor de enlaces de campaña (UTM)
Un enlace de campaña a medida es la URL de una página más utm_source, utm_medium y utm_campaign. Escribe esos tres campos, comprueba las reglas de nombres y copia la URL. GA4 los guarda como session source, medium y campaign. El laboratorio de fuente lee los mismos parámetros, y atribución muestra cómo una campaña con nombre recibe el crédito.
Entender el laboratorioCómo usarlo y por qué querrías hacerlo
Por qué querrías hacerlo
Una ruta y tres slugs obligatorios se vuelven utm_source, utm_medium y utm_campaign en una URL que se queda en este origen. Después de Aceptar la vista se encola sin parámetros.
Cómo usarlo
- Un valor que no es un slug se rechaza.
- La ruta se queda en este sitio.
- Se ponen los tres parámetros obligatorios y luego los dos opcionales.
- Después de Aceptar, utm_builder_view se encola sin campos.
Nombres
- Slugs en minúsculas. Guiones entre palabras. Sin espacios, sin direcciones de correo, sin frases enteras.
- Source es el lugar. Medium es el canal. Campaign es la promoción, compartida por cada enlace de ese esfuerzo.
- Term y content son opcionales. Úsalos cuando una campaña tiene varias palabras clave o creatividades.
- GA4 los lee como session source, session medium y session campaign. Si cualquiera de los tres está presente, la regla de campaña del laboratorio de fuente gana al referrer.
Construir un enlace
Corrige las notas de arriba para construir el enlace.
Cómo se atribuye esta visita
GA4 asigna los parámetros de la URL de aterrizaje. El laboratorio de fuente usa los mismos tres campos e ignora el referrer cuando cualquiera de ellos está puesto.
| Parámetro | Campo de GA4 | Esta URL |
|---|---|---|
| utm_source | Session source | … |
| utm_medium | Session medium | … |
| utm_campaign | Session campaign | … |
| utm_term | Manual term | … |
| utm_content | Manual ad content | … |
Leyendo esta URL…
RecorridoCómo lo hicimosMostrarOcultar
El ajuste de proveedor de ejemplo está marcado abajo. Los números de eVar y de event son ejemplos. Este laboratorio no llama a Adobe.
El constructor de UTM comprueba una ruta y tres slugs obligatorios, y luego escribe utm_source, utm_medium y utm_campaign en una URL de este origen. Después de Aceptar encola utm_builder_view sin parámetros, y el laboratorio no llama a Adobe.
Rechazar lo que no sea un slug
tokenError pasa a minúsculas y recorta. Vacío es un error cuando el campo es obligatorio. Un arroba o un espacio es un error. El token debe empezar por una letra o un número y quedarse en 41 caracteres.
Dejar la ruta en este sitio
pathError exige una sola barra inicial y rechaza un signo de interrogación o un hash. Los parámetros de campaña se añaden después, no se escriben en la ruta.
Fijar los tres parámetros y luego los dos opcionales
buildUtmUrl devuelve null mientras quede algún error. Si no, fija utm_source, utm_medium y utm_campaign, y fija utm_term y utm_content solo cuando esos campos no están vacíos.
Encolar una vista sin parámetros
Después de Aceptar, utm_builder_view se envía con un objeto vacío. Los slugs del enlace construido no son parámetros de ese evento. El laboratorio de fuente lee los mismos tres campos de la URL de aterrizaje.
Del código
Un campo de campaña es un slug corto. Las direcciones de correo y los espacios fallan.
export function tokenError(value: string, required: boolean) {
const text = normalizeToken(value)
if (!text) return required ? "Required." : ""
if (text.includes("@") || text.includes(" ")) return "Use a slug. Do not put an email address or spaces in a campaign parameter."
if (!TOKEN.test(text)) return "Lowercase letters, numbers, hyphens, and underscores. Start with a letter or number. 41 characters max."
return ""
}Tres parámetros se fijan siempre. Term y content se fijan solo cuando están presentes.
export function buildUtmUrl(origin: string, fields: UtmFields) {
const errors = utmErrors(fields)
if (Object.values(errors).some(Boolean)) return null
const path = fields.path.trim() || "/"
const url = new URL(path, origin)
url.searchParams.set("utm_source", normalizeToken(fields.source))
url.searchParams.set("utm_medium", normalizeToken(fields.medium))
url.searchParams.set("utm_campaign", normalizeToken(fields.campaign))
const term = normalizeToken(fields.term)
const content = normalizeToken(fields.content)
if (term) url.searchParams.set("utm_term", term)
if (content) url.searchParams.set("utm_content", content)
return url
}Google y Adobe
Google encola utm_builder_view después de Aceptar. Adobe es un ejemplo de los mismos campos.
Después de Aceptar, este laboratorio encola utm_builder_view sin parámetros. Los slugs construidos no van en ese evento. Esto se encola solo después de Aceptar. Este sitio no llama a Adobe.
Forma simplificada del objeto encolado después de Aceptar. Registra cualquier parámetro nuevo como dimensión personalizada con alcance de evento. Este sitio no llama a gtag('set').
dataLayer.push({
event: "utm_builder_view",
,
})Implementación de ejemplo. Este sitio no llama a Adobe. eVar112, prop112 y event112 son números de variable de ejemplo. En Launch, un elemento de datos lee el valor y una regla lo envía cuando el valor cambia. En el report suite, habilita eVar112 con asignación Most Recent y haz que expire en el hit. Una processing rule no hace falta si el elemento de datos se mapea directo a esa eVar.
Payload de alloy de ejemplo. _example es un esquema de relleno, no un inquilino real.
alloy("sendEvent", {
xdm: {
eventType: "web.webinteraction.linkClicks",
_example: {
utmSource: "newsletter",
},
},
})Hit de ejemplo. eVar112 tiene alcance de hit en este ejemplo. prop112 muere en el mismo hit.
s.eVar112 = "newsletter"
s.prop112 = "newsletter"
s.events = "event112"
s.linkTrackVars = "eVar112,prop112,events"
s.linkTrackEvents = "event112"
s.tl(true, "o", "utm_builder_view")Traducción
Cada campo del laboratorio, el nombre en GA4 y la variable de Adobe de ejemplo. El alcance es la parte que suele perderse en la traducción.
Vista
GA4. utm_builder_view no tiene parámetros.
Adobe. eVar112 de ejemplo, expira en el hit, si contaras la vista. El evento en sí es el registro de GA4.
Alcance. Evento. No hay una propiedad de usuario en este hit.
Slug de source
GA4. No está en utm_builder_view. GA4 puede leer utm_source de una URL de aterrizaje posterior como session source.
Adobe. prop112 de ejemplo, que muere en el hit. Este laboratorio no lo envía.
Alcance. Hit en la visita de aterrizaje, si se abre el enlace. El constructor no fija una propiedad de usuario.
Medium
GA4. No está en utm_builder_view. Se vuelve session medium cuando la URL de aterrizaje tiene utm_medium.
Adobe. eVar112 de ejemplo. Este laboratorio no lo envía.
Alcance. Hit en el aterrizaje. No es una propiedad de usuario.
Campaign
GA4. No está en utm_builder_view. Se vuelve session campaign cuando la URL de aterrizaje tiene utm_campaign.
Adobe. prop112 de ejemplo. Este laboratorio no lo envía.
Alcance. Hit en la visita de aterrizaje. No persiste como propiedad de usuario desde esta página.
Recomendado a continuación
Por qué estas propuestasLeyendo las transiciones de recorrido…