Arquitectura avanzada
Etiquetado en servidor
Un evento puede salir del navegador, llegar a tu servidor y solo entonces tomar forma para GA4. Esta página envía a una ruta de este origen. La ruta redacta una marca de correo, añade la hora del servidor y muestra el payload que reenviaría. No llama a Google.
Datos de ejemplo, no tráfico real.
Un reenvío en vivo necesita un secreto de Measurement Protocol y un lugar donde guardar el resultado. Esta ruta devuelve el payload y no lo guarda.
Entender el laboratorioCómo usarlo y por qué querrías hacerlo
Por qué querrías hacerlo
Quieres que el hit se forme en tu servidor antes de que lo vea un proveedor. Después de Aceptar, la página puede encolar un evento de vista y la ruta sigue sin reenviar.
Cómo usarlo
- Elige un evento y marca si había un correo.
- Envíalo. Lee la lista redactada y la hora del servidor.
- Mira forwarded false en el payload de GA4.
Loading the lab…
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 etiquetado envía un evento con nombre a /api/advanced/collect. La ruta rechaza la llamada si el consentimiento no está concedido, quita claves personales y devuelve un payload con forma de GA4 con forwarded false.
Rechazar la llamada sin consentimiento
collectServerSide devuelve consent_required y un payload de GA4 nulo cuando el consentimiento está denegado. La ruta responde 403.
Quitar claves personales
email, phone, name y address se listan en redacted y quedan fuera del objeto enriquecido.
Armar el payload y parar
El resultado añade server_time y transport first_party. forwarded es false porque no hay una cuenta de proveedor.
Del código
Sin consentimiento no hay cuerpo de GA4.
if (input.consent !== "granted") {
return { accepted: false, reason: "consent_required", redacted, enriched: {}, ga4: null }
}La ruta usa la misma función y no guarda el cuerpo.
const result = collectServerSide({ name, params, consent, now })
return NextResponse.json(result, { status: result.accepted ? 200 : 403 })Google y Adobe
Google encola advanced_lab_view después de Aceptar. Adobe es un ejemplo de los mismos campos.
Después de Aceptar, este laboratorio encola advanced_lab_view. El payload de la demo se queda en la página. Este sitio no llama a Adobe.
Forma simplificada del objeto encolado después de Aceptar.
dataLayer.push({
event: "advanced_lab_view",
lab_id: "server-side-tagging",
})Implementación de ejemplo. Este sitio no llama a Adobe. eVar160, prop160 y event160 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 eVar160 con asignación Most Recent y haz que expire en el hit.
Payload de alloy de ejemplo. _example es un esquema de relleno, no un inquilino real.
alloy("sendEvent", {
xdm: {
eventType: "web.webinteraction.linkClicks",
_example: {
collectForwarded: "false",
},
},
})Hit de ejemplo. eVar160 tiene alcance de hit en este ejemplo.
s.eVar160 = "false"
s.prop160 = "false"
s.events = "event160"
s.tl(true, "o", "advanced_lab_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.
Id del laboratorio
GA4. Parámetro lab_id en advanced_lab_view.
Adobe. eVar de ejemplo, expira en el hit.
Alcance. Evento. Nombra este laboratorio, no al usuario.
Valor de la demo
GA4. No se envía. Puntuaciones, pruebas y payloads se quedan en la página.
Adobe. prop de ejemplo. No copies el valor de la demo.
Alcance. Estado local. No es una propiedad de usuario.
Conteos de ejemplo
GA4. No se envía. Los datos de ejemplo etiquetados no son una métrica.
Adobe. event de ejemplo. No se envía.
Alcance. Una cifra en la página, no un hit.
Consentimiento
GA4. El evento de vista se salta hasta Aceptar.
Adobe. Ejemplo: sáltate el hit mientras el consentimiento está apagado.
Alcance. Una compuerta del hit.
Recomendado a continuación
Por qué estas propuestasLeyendo las transiciones de recorrido…