Recopilar
Recolección en el navegador y en el servidor
Navegador y lado servidor. Un evento, dos caminos. El navegador pregunta a Google directamente. El servidor recibe una copia de primera parte y la reenvía solo cuando hay un secreto de Measurement Protocol. Un webhook es al revés: el otro sistema te llama. El laboratorio de Webhooks firma ese POST.
Entender el laboratorioCómo usarlo y por qué querrías hacerlo
Por qué querrías hacerlo
El navegador hace push de server_side_test, y solo la marca de consentimiento se envía a este sitio, que hashea la cookie de visitante de primera parte y reenvía el evento cuando hay un secreto del Measurement Protocol. Después de Aceptar se encola el transporte, no el client id.
Cómo usarlo
- El consentimiento apagado rechaza la copia.
- El client id es un número armado desde la cookie de primera parte.
- Se llama a Google solo cuando el secreto del servidor está puesto.
- Después de Aceptar, server_side_view lleva el transporte, no el client id.
Navegador
gtag en esta página
dataLayer.push({ event: 'server_side_test' }) es el evento que la etiqueta de Google debe enviar por POST a google-analytics.com/g/collect. Ese host está en listas habituales de bloqueo. Intelligent Tracking Prevention también limita las cookies escritas desde JavaScript, así que el client id de ese hit puede caducar en unos siete días.
Servidor
Copia de primera parte
El mismo botón hace POST a /api/server-collect. El cuerpo es solo la marca de consentimiento. El servidor construye un client id numérico a partir de la cookie de visitante de primera parte y, cuando GA4_MP_API_SECRET está definido, reenvía un evento al Measurement Protocol. Si no, guarda una fila. Una lista que bloquee a Google no ve esta petición.
Enviar el evento de prueba
El servidor no recupera un hit que el navegador nunca hizo. Recupera el evento porque esta página envía una segunda copia a nuestro origen. El secreto se queda en el servidor. El registro guarda el nombre del evento, el transporte y el estado.
Measurement Protocol: Comprobando…
Qué descarta cada camino
| Condición | gtag del navegador | Copia del servidor |
|---|---|---|
| Consentimiento apagado | Ningún hit. Consent Mode sigue en denied. | Rechazado. No se guarda nada. |
| Bloqueador de anuncios en hosts de Google | La petición collect se descarta. | El POST de primera parte sigue llegando. |
| Tope de cookies de ITP | El client id de JavaScript puede caducar en días. | La cookie de visitante httpOnly dura 400 días y se hashea en el client id del Measurement Protocol. |
| Secreto sin definir | Sin cambio. El navegador sigue hablando con Google si puede. | El evento es una fila de la base de datos, no un hit de Google. |
Filas recientes del servidor
Aún no hay copias del servidor.
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 lado servidor hace push de server_side_test desde el navegador y envía por POST solo la marca de consentimiento a /api/server-collect, que hashea la cookie de visitante de primera parte y reenvía el evento cuando hay un secreto de Measurement Protocol. Después de Aceptar también encola server_side_view con server_transport, y el laboratorio no llama a Adobe.
Rechazar la copia cuando el consentimiento está apagado
El POST responde 403 cuando el consentimiento del cuerpo no está concedido, y también cuando la petición señala Global Privacy Control. En esos casos no se guarda nada.
Construir un client id numérico
La ruta lee la cookie de visitante de primera parte, o acuña una. measurementClientId hashea esa clave en dos enteros unidos por un punto, la forma que espera Measurement Protocol.
Reenviar solo cuando el secreto está definido
Si el secreto está definido, transport es measurement_protocol y el estado es lo que devuelva el reenvío, o request_failed. Si no está definido, transport sigue siendo database y el estado sigue siendo stored.
Guardar el resultado, no el client id
recordServerCollect escribe el nombre de evento server_side_test, el transporte y el estado. El registro que lee la página no incluye el client id.
Mirar el camino del navegador aparte
Después de Aceptar, el botón también llama a pushDataLayerEvent para server_side_test con transport browser, espera 1,2 segundos y cuenta los hits de Resource Timing a google-analytics.com. Con el consentimiento apagado, se salta ese push.
Del código
La copia del servidor. Si falta el secreto, la fila se queda en la base de datos.
const existing = readVisitorKey(request)
const visitorKey = existing ?? newVisitorKey()
const configured = measurementProtocolConfigured()
let transport: "measurement_protocol" | "database" = "database"
let status = "stored"
if (configured) {
transport = "measurement_protocol"
try {
const result = await forwardMeasurementProtocol(visitorKey)
status = result.status
} catch {
status = "request_failed"
}
}La copia del navegador. El push está dentro de la comprobación de consentimiento, y luego Resource Timing busca un host collect.
const started = performance.now()
const before = googleHitsSince(0).length
if (consent === "granted") {
pushDataLayerEvent("server_side_test", { transport: "browser" })
}
await new Promise((resolve) => window.setTimeout(resolve, 1200))
const after = googleHitsSince(started).length
const browser =
consent !== "granted"
? tr(locale, "Not sent", "No enviado")
: after > 0 || googleHitsSince(0).length > before
? tr(locale, "A collect request left this browser", "Una petición collect salió de este navegador")
: tr(locale, "No Google collect request appeared", "No apareció ninguna petición collect de Google")Google y Adobe
Google encola server_side_test después de Aceptar. Adobe es un ejemplo de los mismos campos.
El botón encola server_side_test con transport browser, y solo después de Aceptar. Abrir el laboratorio también encola server_side_view con server_transport en measurement_protocol o database. pushDataLayerEvent y trackLabEvent no hacen nada hasta que se concede el consentimiento. El POST de primera parte es otra petición y no es un evento del dataLayer. 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: "server_side_test",
transport: "browser",
})Implementación de ejemplo. Este sitio no llama a Adobe. eVar100, prop100 y event100 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 eVar100 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: {
serverTransport: "browser",
},
},
})Hit de ejemplo. eVar100 tiene alcance de hit en este ejemplo. prop100 muere en el mismo hit.
s.eVar100 = "browser"
s.prop100 = "browser"
s.events = "event100"
s.linkTrackVars = "eVar100,prop100,events"
s.linkTrackEvents = "event100"
s.tl(true, "o", "server_side_test")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.
Transporte del navegador
GA4. Parámetro transport en server_side_test. El botón envía browser.
Adobe. eVar100 de ejemplo, Most Recent, expira en el hit.
Alcance. Evento en el hit. Una propiedad de usuario conservaría browser cuando termine la visita.
Transporte del servidor
GA4. Parámetro server_transport en server_side_view. Los valores son measurement_protocol o database.
Adobe. prop100 de ejemplo, que muere en el hit.
Alcance. Evento. Describe esta vista de página, no al usuario.
Estado del reenvío
GA4. No se envía. La fila de la base guarda status. Los eventos del dataLayer no.
Adobe. eVar100 de ejemplo si mapearas la palabra de estado. No se envía.
Alcance. Una fila guardada, no una métrica de hit ni una propiedad de la visita.
Client id
GA4. No es un parámetro. El servidor hashea la cookie de visitante para Measurement Protocol y no pone ese id en el dataLayer.
Adobe. prop100 de ejemplo. No copies el id hasheado a una prop. No se envía.
Alcance. Una clave de unión en el servidor. No es un parámetro de evento ni una propiedad de usuario en este hit.
Recomendado a continuación
Por qué estas propuestasLeyendo las transiciones de recorrido…