Recopilar
Conversiones offline, explicadas
Conversiones offline, explicadas. El lead es una demostración. El envío con Measurement Protocol solo se ejecuta si el secreto de la API está configurado. Si no, la página muestra el cuerpo y se detiene.
Entender el laboratorioCómo usarlo y por qué querrías hacerlo
Por qué querrías hacerlo
Un lead de demostración se puede cerrar por el Measurement Protocol cuando ese secreto del servidor está puesto, y si no la página muestra el cuerpo sin llamar a Google. Después de Aceptar encola el transporte, no el lead.
Cómo usarlo
- Registra un lead de demostración. El id se crea en esta página.
- Un envío se rechaza mientras el consentimiento está apagado.
- Se llama a Google solo cuando el secreto del servidor está puesto.
- Después de Aceptar, offline_conversion_view lleva el transporte.
Un lead y luego un cierre
El clic ocurrió antes. El acuerdo se cierra después, a menudo fuera del navegador. El Measurement Protocol envía ese resultado con el client id original, para que GA4 pueda unirlos. Esta página usa un lead de demostración. No envía el formulario de contacto ni el formulario del informe. Cuando GA4_MP_API_SECRET no está definido, se muestra el cuerpo y el hit no se envía a Google. Esa llamada eres tú llegando a Google. El laboratorio de webhooks es la forma de un sistema que te llama.
1. Registrar un lead de demostración
2. Cerrar el acuerdo
3. Enviarlo de vuelta
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 offline registra un lead de demostración y luego envía close_convert por el Measurement Protocol cuando ese secreto del servidor está definido, y si no muestra el cuerpo sin llamar a Google. Después de Aceptar la página encola offline_conversion_view con el transporte, y no llama a Adobe.
Crear un id de lead de demostración
Registrar lead pone lead_id en lead- más una marca de tiempo. El campo de valor es un número que el visitante puede editar. No se escribe nada hasta Enviar.
Rechazar un envío sin consentimiento
La API devuelve consent_required si el cuerpo no dice granted. Global Privacy Control devuelve 403 antes de esa comprobación.
Reenviar solo cuando está configurado
measurementProtocolConfigured decide la rama. Cuando está encendido, forwardMeasurementEvent envía close_convert con lead_id, value y currency USD. Cuando está apagado, transport sigue simulated y no se llama a Google.
Registrar el intento en este sitio
recordServerCollect escribe el nombre de evento offline_conversion. Un envío simulado se guarda como transport database. La respuesta sigue mostrando el payload que se habría enviado.
Encolar el transporte
Después de una respuesta correcta, y solo cuando el consentimiento está concedido, trackLabEvent envía offline_conversion_view. transport es measurement_protocol o simulated. El client id, el lead id y el valor no son parámetros.
Del código
Un servidor configurado envía close_convert. Si no, el transporte sigue simulated.
const existing = readVisitorKey(request)
const visitorKey = existing ?? newVisitorKey()
const clientId = typeof body.client_id === "string" && CLIENT.test(body.client_id) ? body.client_id : measurementClientId(visitorKey)
const configured = measurementProtocolConfigured()
let transport: "measurement_protocol" | "simulated" = "simulated"
let status = "simulated"
if (configured) {
transport = "measurement_protocol"
try {
const result = await forwardMeasurementEvent(
visitorKey,
"close_convert",
{
lead_id: leadId,
value,
currency: "USD",
},
clientId,El botón envía el lead de demostración. offline_conversion_view espera a Aceptar.
async function send() {
if (!leadId || pending) return
setPending(true)
setError("")
try {
const response = await fetch("/api/offline-conversion", {
method: "POST",
headers: { "content-type": "application/json" },
body: JSON.stringify({ consent, lead_id: leadId, value }),
})
const body = (await response.json()) as Result & { error?: string }
if (!response.ok) {
setError(body.error === "consent_required" ? tr(locale, "Consent is off, so the send was refused.", "El consentimiento está apagado, así que el envío se rechazó.") : tr(locale, "The send did not finish.", "El envío no terminó."))
setResult(null)
return
}
setResult(body)
if (consent === "granted") trackLabEvent("offline_conversion_view", { transport: body.transport === "measurement_protocol" ? "measurement_protocol" : "simulated" })Google y Adobe
Google encola offline_conversion_view después de Aceptar. Adobe es un ejemplo de los mismos campos.
offline_conversion_view se encola solo después de Aceptar, y solo después de que el envío vuelve. transport es measurement_protocol o simulated. El client id, el lead id y el valor no son parámetros. Registra transport 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: "offline_conversion_view",
transport: "simulated",
})Implementación de ejemplo. Este sitio no llama a Adobe. eVar87, prop87 y event87 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 eVar87 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: {
offlineTransport: "simulated",
},
},
})Hit de ejemplo. eVar87 tiene alcance de hit en este ejemplo. prop87 muere en el mismo hit.
s.eVar87 = "simulated"
s.prop87 = "simulated"
s.events = "event87"
s.linkTrackVars = "eVar87,prop87,events"
s.linkTrackEvents = "event87"
s.tl(true, "o", "offline_conversion_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.
Transporte
GA4. Parámetro transport en offline_conversion_view. Los valores son measurement_protocol o simulated.
Adobe. eVar87 de ejemplo, expira en el hit.
Alcance. Evento. Una propiedad de usuario recordaría simulated después de un envío real posterior.
close_convert
GA4. Se envía a GA4 solo cuando el Measurement Protocol está configurado. No es el evento del dataLayer. El evento del dataLayer es offline_conversion_view.
Adobe. prop87 de ejemplo, que muere en el hit. Este sitio no lo envía a Adobe.
Alcance. Evento, en el hit del Measurement Protocol cuando esa llamada está configurada.
Id del lead
GA4. No está en offline_conversion_view. Está dentro del payload del servidor.
Adobe. Ejemplo: no copies el id de lead de demostración en eVar87.
Alcance. No es un usuario de analítica. El id es una cadena de demostración.
Valor
GA4. No está en offline_conversion_view. Puede ser un parámetro de close_convert cuando se llama a Google.
Adobe. event87 de ejemplo si contaras el cierre de demostración. No lo trates como ingreso del report suite, y no lo guardes en eVar87.
Alcance. Evento, y solo en la llamada configurada del Measurement Protocol.
Recomendado a continuación
Por qué estas propuestasLeyendo las transiciones de recorrido…