Geocerca
Dibuja una zona y arrastra un pin
Dibuja una zona y arrastra un pin. Entrada, salida y permanencia cambian la oferta en esta pestaña. Una geocerca en una app es la misma prueba, normalmente en un teléfono en vez de un pin.
Entender el laboratorioCómo usarlo y por qué querrías hacerlo
Por qué querrías hacerlo
Un anillo y un pin que se arrastra muestran la entrada, la salida y la permanencia, escritas solo en esta pestaña. No se envía nada, y el laboratorio no encola un evento propio.
Cómo usarlo
- Arrastra el pin y mira la prueba del anillo.
- La entrada, la salida y la permanencia se escriben en esta pestaña.
- La prueba no llama a la red.
La zona de muestra está centrada en el lugar aproximado de esta petición: Columbus, OH, US. Arrastra el pin. Nada sale de este navegador.
Contenido activado
Fuera de la zona
Página por defecto. La oferta local está apagada.
Dibujar
Haz clic en el mapa para añadir esquinas y luego cierra la zona. O vuelve a cargar la muestra.
Fuera
Eventos
Arrastra el pin hacia la zona. La entrada se dispara en el borde. La permanencia, a los ocho segundos.
Cómo funciona
- Una zona es un anillo de puntos. Cerrar el anillo la convierte en una cerca.
- El pin de prueba se arrastra. Cada movimiento comprueba si el pin está dentro del anillo.
- Cruzar el borde escribe entrada o salida. Quedarse dentro ocho segundos escribe permanencia.
- La tarjeta es el contenido activado: por defecto, oferta local y luego una oferta de permanencia.
- La zona, el pin y el registro se quedan en este navegador. No se envía nada.
Dentro del anillo
Un cruce de rayo. Sin librería y sin red.
function insideZone(point, ring) {
let inside = false
for (let i = 0, j = ring.length - 1; i < ring.length; j = i++) {
const a = ring[i]
const b = ring[j]
const crosses = a.lat > point.lat !== b.lat > point.lat
if (!crosses) continue
const x = ((b.lng - a.lng) * (point.lat - a.lat)) / (b.lat - a.lat) + a.lng
if (point.lng < x) inside = !inside
}
return inside
}
// Enter, exit, and an 8 second dwell stay in this tab.
if (inside && !wasInside) log("enter")
if (!inside && wasInside) log("exit")
if (inside && stayedMs >= 8000) log("dwell")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 geocerca dibuja un anillo, prueba un pin que se arrastra y escribe entrada, salida y permanencia en esta pestaña, sin enviar nada ni encolar un evento propio. El laboratorio no llama a Adobe.
Construir un anillo
ringAround recorre rumbos alrededor de un centro y llama a destination para una distancia en millas. El anillo de muestra usa ocho lados y dos millas. El centro es el lugar aproximado de la petición, o Chicago cuando ese lugar no tiene punto.
Probar el pin con un cruce de rayo
pointInPolygon devuelve false para un anillo con menos de tres puntos. Si no, cuenta los cruces de arista y cambia inside. El pin empieza al este del centro, fuera de la muestra de dos millas.
Escribir entrada, salida y permanencia en local
Cuando cambia la marca de dentro del anillo cerrado, el efecto antepone enter o exit y conserva doce filas. Entrar inicia un temporizador de ocho segundos. Si el pin sigue en esa entrada, antepone dwell. El registro es estado del componente.
Dejar la red en paz
El widget está marcado data-track-ignore. La página dice que la zona, el pin y el registro se quedan en este navegador. Este componente no llama a trackLabEvent.
Del código
Dentro es un cruce de rayo. Un anillo corto está fuera.
/** Ray cast. A ring with fewer than three points is outside. */
export function pointInPolygon(point: LatLng, ring: LatLng[]) {
if (ring.length < 3) return false
let inside = false
for (let index = 0, previous = ring.length - 1; index < ring.length; previous = index, index += 1) {
const yi = ring[index].latitude
const xi = ring[index].longitude
const yj = ring[previous].latitude
const xj = ring[previous].longitude
const crosses = yi > point.latitude !== yj > point.latitude
if (!crosses) continue
const x = ((xj - xi) * (point.latitude - yi)) / (yj - yi) + xi
if (point.longitude < x) inside = !inside
}
return inside
}Un cruce escribe enter o exit. Ocho segundos dentro escriben dwell.
useEffect(() => {
if (!closed) return
if (wasInside.current === inside) return
wasInside.current = inside
entry.current += 1
const token = entry.current
setDwell(false)
const kind: FenceEvent["kind"] = inside ? "enter" : "exit"
setEvents((current) => [{ id: crypto.randomUUID(), kind, at: new Date().toISOString() }, ...current].slice(0, 12))
if (!inside) return
const timer = window.setTimeout(() => {
if (token !== entry.current) return
setDwell(true)
const dwellKind: FenceEvent["kind"] = "dwell"
setEvents((current) => [{ id: crypto.randomUUID(), kind: dwellKind, at: new Date().toISOString() }, ...current].slice(0, 12))
}, 8000)
return () => window.clearTimeout(timer)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: "fence_enter_example",
kind: "enter",
})Implementación de ejemplo. Este sitio no llama a Adobe. eVar75, prop75 y event75 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 eVar75 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: {
fenceKind: "enter",
},
},
})Hit de ejemplo. eVar75 tiene alcance de hit en este ejemplo. prop75 muere en el mismo hit.
s.eVar75 = "enter"
s.prop75 = "enter"
s.events = "event75"
s.linkTrackVars = "eVar75,prop75,events"
s.linkTrackEvents = "event75"
s.tl(true, "o", "fence_enter_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.
Tipo
GA4. No se envía. fence_enter_example es un nombre falso. enter, exit y dwell son filas de esta pestaña.
Adobe. eVar75 de ejemplo, expira en el hit. No se envía.
Alcance. Un registro local de este hit. No es una propiedad de usuario y no es un evento de la visita.
Dentro
GA4. No se envía. El booleano de pointInPolygon se queda en el widget.
Adobe. prop75 de ejemplo. No se envía.
Alcance. Un estado de la vista en el hit. No es una propiedad de usuario y termina con la pestaña, no con una visita almacenada. Es un evento en el hit, no una propiedad de usuario, y no dura toda la visita.
Anillo
GA4. No se envía.
Adobe. eVar75 de ejemplo. No se envía.
Alcance. Puntos en el estado del componente. No son un evento, ni una propiedad de usuario, ni un campo de hit o de visita.
Oferta de permanencia
GA4. No se envía. El texto de la tarjeta cambia después de ocho segundos.
Adobe. prop75 de ejemplo. No se envía.
Alcance. Se muestra en el hit. No es una propiedad de usuario y no se conserva durante la visita. Es un evento en el hit, no una propiedad de usuario, y no dura toda la visita.
Recomendado a continuación
Por qué estas propuestasLeyendo las transiciones de recorrido…