Recopilar
Revisa un evento antes de enviarlo
Revisor de calidad de eventos de GA4. Nombres, parámetros, datos personales en una URL y los límites de tamaño de GA4. El texto pegado no se reenvía.
Entender el laboratorioCómo usarlo y por qué querrías hacerlo
Por qué querrías hacerlo
Pega un evento JSON y esta página lista hallazgos del nombre, los parámetros y los datos personales. Después de Aceptar encola el conteo de hallazgos, no el pegado.
Cómo usarlo
- Pega un objeto o un array. El análisis se queda en este navegador.
- Mira la comprobación del nombre y la del tamaño.
- Los datos personales y los campos que faltan se marcan en la página.
- Después de Aceptar se encola finding_count. El pegado no se envía.
Pega un evento
La comprobación se ejecuta en este navegador antes de enviar nada a Google. Mira el nombre del evento, los parámetros que faltan en algunos eventos conocidos, los datos personales en nombres o URL y los límites de GA4 de 40 caracteres para un nombre, 100 para un valor y 25 parámetros. Una propiedad también puede tener solo 500 nombres de evento distintos. Ese último límite no se ve en un solo pegado.
Hallazgos
Aún no se ha comprobado nada.
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 laboratorio de calidad de eventos analiza en el navegador un evento JSON pegado y lista hallazgos de nombre, parámetros y datos personales, y luego encola event_quality_view con finding_count después de Aceptar sin hacer push del pegado. El laboratorio no llama a Adobe.
Analizar un objeto o un array
parsePastedEvent exige JSON. Un array usa el nombre del evento en la primera o la segunda posición. Un objeto lee event, name, event_name o en, y luego params o event_params.
Comprobar el nombre y el tamaño
checkEvent exige una letra y luego letras, dígitos y guiones bajos, y como máximo 40 caracteres. Un nombre reservado de GA4 es un aviso. Más de 25 parámetros es un error. Un nombre de parámetro de más de 40 caracteres, o un valor de texto de más de 100, es un error.
Marcar datos personales y campos que faltan
Una clave de parámetro del conjunto de datos personales es un error. Un patrón de correo en un valor es un error. Una cadena larga de dígitos es un aviso, salvo si la clave es transaction_id. purchase, carrito, checkout, view_item y view_search_results avisan cuando falta una clave obligatoria. currency debe ser tres letras mayúsculas cuando está. items debe ser un array cuando está.
Encolar el conteo, no el pegado
Comprobar ejecuta primero el análisis y checkEvent. Si el consentimiento está concedido, trackLabEvent envía event_quality_view con finding_count igual al número de hallazgos. El objeto pegado no es un parámetro.
Del código
Solo JSON. Un array puede ser una tupla de evento al estilo gtag o un nombre más params.
export function parsePastedEvent(raw: string): { event: ParsedEvent | null; error: string } {
const text = raw.trim()
if (!text) return { event: null, error: "Paste an event or a dataLayer push." }
let value: unknown
try {
value = JSON.parse(text)
} catch {
return { event: null, error: "That text is not JSON." }
}
if (Array.isArray(value)) {
const name = value[0] === "event" ? value[1] : value[0]
const params = value[0] === "event" ? value[2] : value[1]
if (typeof name !== "string") return { event: null, error: "The array needs an event name." }
return { event: { name, params: isRecord(params) ? params : {} }, error: "" }
}
if (!isRecord(value)) return { event: null, error: "Use an object or an array." }Forma del nombre, nombres reservados, el tope de 25 parámetros y claves que parecen personales.
export function checkEvent(event: ParsedEvent): Finding[] {
const findings: Finding[] = []
const name = event.name.trim()
if (!/^[A-Za-z][A-Za-z0-9_]*$/.test(name)) {
findings.push({ level: "error", message: "Event names use letters, digits, and underscores, and start with a letter." })
}
if (name.length > 40) findings.push({ level: "error", message: "GA4 event names stop at 40 characters." })
if (RESERVED.has(name)) findings.push({ level: "warn", message: `${name} is a reserved GA4 name. A custom event should use another name.` })
const keys = Object.keys(event.params)
if (keys.length > 25) findings.push({ level: "error", message: "GA4 keeps 25 parameters on one event." })
for (const key of keys) {
if (key.length > 40) findings.push({ level: "error", message: `Parameter ${key} is longer than 40 characters.` })
if (PII_KEYS.has(key.toLowerCase())) findings.push({ level: "error", message: `Parameter ${key} looks like a personal field. Do not send it.` })
const value = event.params[key]
if (typeof value === "string") {
if (value.length > 100) findings.push({ level: "error", message: `Parameter ${key} is longer than 100 characters.` })
if (EMAIL.test(value)) findings.push({ level: "error", message: `Parameter ${key} contains an email address.` })
if (PHONE.test(value) && key.toLowerCase() !== "transaction_id") {Google y Adobe
Google encola event_quality_view después de Aceptar. Adobe es un ejemplo de los mismos campos.
Se encola solo después de Aceptar, y solo cuando Comprobar consigue analizar el texto. finding_count es el número de hallazgos. El nombre del evento pegado y sus parámetros no se envían. Registra finding_count como dimensión personalizada con alcance de evento. 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: "event_quality_view",
finding_count: 2,
})Implementación de ejemplo. Este sitio no llama a Adobe. eVar68, prop68 y event68 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 eVar68 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: {
findingCount: "2",
},
},
})Hit de ejemplo. eVar68 tiene alcance de hit en este ejemplo. prop68 muere en el mismo hit.
s.eVar68 = "2"
s.prop68 = "2"
s.events = "event68"
s.linkTrackVars = "eVar68,prop68,events"
s.linkTrackEvents = "event68"
s.tl(true, "o", "event_quality_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.
Conteo de hallazgos
GA4. Parámetro finding_count en event_quality_view.
Adobe. eVar68 de ejemplo, expira en el hit.
Alcance. Evento en el hit. No es una propiedad de usuario y no dura toda la visita.
Nombre del evento pegado
GA4. No se envía.
Adobe. prop68 de ejemplo. No se envía.
Alcance. Se comprueba en el navegador en este hit. No es una propiedad de usuario y no se guarda para la visita. Es un evento en el hit, no una propiedad de usuario, y no dura toda la visita.
Mensaje del hallazgo
GA4. No se envía. La lista se queda en la página.
Adobe. eVar68 de ejemplo. No se envía.
Alcance. Texto de la página en el hit. No lo copies al usuario ni lo conserves durante la visita. Es un evento en el hit, no una propiedad de usuario, y no dura toda la visita.
Nivel
GA4. No se envía. error y warn están en el objeto del hallazgo en el navegador.
Adobe. prop68 de ejemplo. No se envía.
Alcance. Una etiqueta de este hit. No es un parámetro de evento, ni una propiedad de usuario, ni un campo de la visita.
Recomendado a continuación
Por qué estas propuestasLeyendo las transiciones de recorrido…