Cerca
Quién está cerca ahora
Quién está cerca ahora. Solo quien acepta, y solo como una celda de una milla. El mapa nunca dibuja a una persona. Una celda con menos de tres personas se queda oculta y la fila caduca.
Entender el laboratorioCómo usarlo y por qué querrías hacerlo
Por qué querrías hacerlo
Un punto con consentimiento se ajusta a una celda de una milla, y una celda se publica solo cuando al menos tres personas la comparten. Las filas caducan a los 30 minutos.
Cómo usarlo
- Acepta antes de que un punto se ajuste a una celda.
- Una celda con menos de tres personas sigue oculta.
- Tu propio conteo oculto aún se te puede mostrar.
- Una fila desaparece 30 minutos después de escribirse.
Datos del mapa © colaboradores de OpenStreetMap. Los círculos son celdas de una milla, no personas. Un círculo tenue está más cerca de caducar.
Dentro de esta distancia
—
Personas en vivo en celdas publicadas en un radio de 10 millas. Las celdas con menos de 3 no entran.
Personas de muestra en 10 millas: 24. La celda de muestra con 2 está oculta y no cuenta.
Contarme
La lectura precisa elige una celda de una milla y luego se descarta. Este navegador envía el centro de la celda, un token aleatorio y nada más. La fila caduca 30 minutos después del último aviso.
El mapa empieza en el lugar aproximado de esta petición: Columbus, OH, US. No estás en él hasta que aceptes.
Cómo funciona
- Marcas la casilla. El navegador pide entonces un punto.
- La página ajusta ese punto a una celda de una milla y descarta la lectura precisa.
- Un token aleatorio en este navegador es la única identidad. No es la cookie de visitante.
- La fila caduca 30 minutos después del último aviso. Quitarme la borra ahora.
- Una celda aparece en el mapa solo cuando tres personas la comparten. El conteo por radio usa esas mismas celdas.
Las filas en vivo necesitan la tabla nearby_presence. Aplica drizzle/0015_nearby_presence.sql. Hasta entonces la página lo dice y mantiene la muestra etiquetada.
Ajustar y olvidar el punto
La celda es lo que se guarda. El punto no.
// Snap to a one-mile cell. Keep the cell. Drop the point.
const MILES = 69
function snap(lat, lng) {
const latStep = 1 / MILES
const latIndex = Math.round(lat / latStep)
const snappedLat = latIndex * latStep
const lngStep = latStep / Math.max(0.2, Math.abs(Math.cos((snappedLat * Math.PI) / 180)))
const lngIndex = Math.round(lng / lngStep)
return { cell: latIndex + ":" + lngIndex, lat: snappedLat, lng: lngIndex * lngStep }
}Publicar una celda a partir de tres
El conteo por radio usa el mismo filtro, así que una celda oculta no se deduce del total.
// A cell is a place on the map only when three people share it.
const visible = cells.filter((cell) => cell.count >= 3)
const within = visible
.filter((cell) => milesBetween(center, cell) <= miles)
.reduce((sum, cell) => sum + cell.count, 0)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 cercanía ajusta un punto con consentimiento a una celda de una milla y publica una celda solo cuando al menos tres personas la comparten. Las filas caducan a los 30 minutos, y el laboratorio no llama a Adobe.
Ajustar el punto a una celda
snapToCell redondea la latitud a un paso de una milla y la longitud con el coseno de esa latitud. El navegador envía la celda, no el punto crudo.
Exigir el consentimiento
El POST se rechaza si el consentimiento no es opt-in. Global Privacy Control devuelve 403 y la página borra el token local.
Ocultar una celda con menos de tres personas
summarizeNearby agrupa las filas por celda. Un grupo con menos personas que K_ANONYMITY se omite del mapa y del conteo del radio. Tu propio conteo oculto aún se te puede mostrar.
Caducar la fila
Una fila de presencia dura 30 minutos. La página consulta cada 20 segundos y refresca una celda con consentimiento cada dos minutos mientras la pestaña está visible.
Dibujar una muestra etiquetada
sampleNearby rellena el mapa cuando las celdas en vivo están ocultas. El componente del laboratorio no llama a trackLabEvent.
Del código
El punto crudo se convierte en una celda de una milla. Los pasos de longitud se encogen hacia los polos.
export function snapToCell(latitude: number, longitude: number): Cell {
if (!coordinatesInRange(latitude, longitude)) throw new Error("coordinates")
const latStep = CELL_MILES / MILES_PER_DEGREE
const latIndex = Math.round(latitude / latStep)
const snappedLat = round5(latIndex * latStep)
const cos = Math.cos((snappedLat * Math.PI) / 180)
const lngStep = latStep / Math.max(0.2, Math.abs(cos))
const lngIndex = Math.round(longitude / lngStep)
return cellFromIndex(latIndex, lngIndex, snappedLat, lngStep)
}Una celda con menos de tres personas se omite. El conteo del radio usa solo las celdas publicadas.
for (const group of groups.values()) {
const remaining = group.updatedAt + PRESENCE_TTL_MS - now
const minutesLeft = Math.max(0, Math.round(remaining / 60000))
const hidden = group.count < K_ANONYMITY
if (selfToken && group.tokens.includes(selfToken)) {
you = { count: group.count, hidden, expiresAt: group.expiresAt, minutesLeft }
}
if (hidden) continue
cells.push({
latitude: group.latitude,
longitude: group.longitude,
count: group.count,
fade: clamp01(remaining / PRESENCE_TTL_MS),
minutesLeft,
})Google y Adobe
Este laboratorio no encola un evento propio. El bloque de Google muestra un ejemplo de cómo rastrearías la interacción. Adobe también es un ejemplo.
Este laboratorio no encola un evento de analítica propio. Después de Aceptar, el sitio sigue encolando virtual_page_view de la página, con page_path y page_title. Los clics dentro de una región data-track-ignore no se registran. El push de abajo es un ejemplo, no una llamada de esta página. Este sitio no llama a gtag('set') ni a Adobe.
Solo ejemplo. Esta página no hace push de este objeto.
// Example only. This lab does not queue this event.
dataLayer.push({
event: "nearby_cell_example",
cell_count: 3,
})Implementación de ejemplo. Este sitio no llama a Adobe. eVar85, prop85 y event85 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 eVar85 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: {
cellCount: "3",
},
},
})Hit de ejemplo. eVar85 tiene alcance de hit en este ejemplo. prop85 muere en el mismo hit.
s.eVar85 = "3"
s.prop85 = "3"
s.events = "event85"
s.linkTrackVars = "eVar85,prop85,events"
s.linkTrackEvents = "event85"
s.tl(true, "o", "nearby_cell_example")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 la celda
GA4. No se envía. El mapa muestra un conteo solo cuando la celda tiene al menos tres personas.
Adobe. eVar85 de ejemplo, expira en el hit.
Alcance. Hit. Una propiedad de usuario conservaría un conteo después de que la fila caduque.
Millas de radio
GA4. No se envía. El control cambia la consulta.
Adobe. prop85 de ejemplo, que muere en el hit.
Alcance. Hit. El radio es un control de la vista, no un rasgo de la visita.
Token de consentimiento
GA4. No se envía. El token se queda en localStorage y solo se envía a /api/lab/nearby.
Adobe. Ejemplo: no copies el token en eVar85.
Alcance. No es un usuario de analítica. El token identifica una fila en este sitio.
Celda oculta
GA4. No se envía.
Adobe. prop85 de ejemplo si registraras que tu propia celda estaba oculta.
Alcance. Evento. Ocultar una celda es un resultado de esta lectura, no una propiedad de usuario.
Recomendado a continuación
Por qué estas propuestasLeyendo las transiciones de recorrido…