Atribución de anuncios

Un visitante hace clic en tu anuncio, lee un par de páginas, abre el chat y deja una solicitud. Tu CRM recibe el trato, pero sin nada que diga qué campaña pagó esa visita. Ahora Happ lleva el clic por toda la cadena: página → chat → trato → de vuelta a la red publicitaria.

No hay nada que activar. Cualquier widget cargado con el snippet de inserción actual empieza a recopilar en su siguiente vista de página.

Qué se recopila

En la primera página del visitante, el script de inserción lee los parámetros del anuncio de la URL y los guarda en tu propio dominio:

También guarda la página de aterrizaje y el referrer.

Se guardan dos contactos, no uno:

• primer contacto: la campaña que presentó a esta persona;
• último contacto: en qué hizo clic al volver, que es a lo que las redes publicitarias atribuyen una conversión.

Los parámetros sobreviven a la navegación: un visitante puede llegar por la URL del anuncio, recorrer cinco páginas con la barra de direcciones limpia y abrir el chat una hora después, y la campaña sigue ahí. Una visita sin parámetros de anuncio nunca sobrescribe lo guardado, así que un cliente que vuelve directamente para convertir sigue atribuido a la campaña que lo captó.

Las conversaciones que llegan desde un anuncio Click-to-Messenger o Click-to-Instagram llevan su contexto de anuncio de la misma forma, con el id del anuncio y el título del creativo en lugar de un click id.

Dónde acaba

En el registro del CRM

Toda integración de CRM que crea leads o tratos escribe el origen en el comentario del registro:

--- Happ attribution ---
channel: widget
gclid: Cj0KCQjw...
utm_source: google
utm_medium: cpc
utm_campaign: raiden-brand
landing: /catalog
captured: 2026-09-19T08:12:44.000Z

Líneas clave-valor a propósito: un gestor las lee, y un script, una fórmula de hoja de cálculo o un flujo de n8n las analiza sin pedirnos una exportación.

Nunca se le pide al agente que pase nada de esto. Un click id son cien caracteres opacos, y un modelo al que se le pide copiarlo lo recortará o inventará uno verosímil; un click id erróneo es peor que ninguno, porque se sube como la conversión de otra persona. La plataforma lo adjunta en el servidor, totalmente fuera de la conversación.

NetHunt además expone cada campo como un parámetro asignable (attribution_gclid, attribution_utm_campaign, attribution_note y el resto), para que puedas dirigir cada uno a una columna de tu propia carpeta en la configuración de la integración.

En tu webhook

Si tienes conectada la integración Chat webhook, el cuerpo de cada mensaje lleva un objeto attribution, y se dispara un evento nuevo cuando realmente se crea una solicitud:

{
  "event": "lead.created",
  "eventId": "6f2a...:8821",
  "chatId": "6f2a1c84-...",
  "companyId": "8fb075ae-...",
  "toolName": "keepincrm_create",
  "entityId": "8821",
  "entityType": "leads",
  "phone": "+380731234567",
  "createdAt": "2026-09-19T08:14:02.000Z",
  "attribution": {
    "channel": "widget",
    "clickId": "Cj0KCQjw...",
    "clickNetwork": "google",
    "utmSource": "google",
    "utmMedium": "cpc",
    "utmCampaign": "raiden-brand",
    "landingPage": "/catalog",
    "referrer": "https://www.google.com/",
    "capturedAt": "2026-09-19T08:12:44.000Z",
    "note": "--- Happ attribution ---\nchannel: widget\ngclid: Cj0KCQjw..."
  }
}

eventId es estable entre reintentos: deduplica por él. Cuando el visitante convirtió en una campaña posterior a la que lo presentó, el primer contacto viaja en attribution.first.

phone está para Enhanced Conversions for Leads, que hacen coincidir por un número de teléfono hasheado y no necesitan click id: la alternativa para visitantes cuyo gclid nunca llegó a la URL.

Los cuerpos sin campo event son mensajes normales, como antes.

En la página, para GTM y GA4

Cuando se crea una solicitud, el widget envía un evento a dataLayer en la página anfitriona:

{
  event: "happ_lead_created",
  happ_event_id: "6f2a...:8821",
  happ_chat_id: "6f2a1c84-...",
  happ_entity_id: "8821",
  happ_entity_type: "leads",
  happ_widget_id: "wgt_..."
}

Esto cuenta la solicitud, no la apertura del chat: todo visitante curioso abre el chat, y una conversión definida así no le enseña nada a la puja. El evento se deduplica en el navegador, y happ_event_id coincide con el eventId del webhook, así que una copia de la misma conversión desde el servidor se concilia con él.

En GTM: crea un activador Custom Event sobre happ_lead_created, úsalo para tu evento de GA4 o tu etiqueta de conversión de Google Ads, y pasa happ_event_id como id de transacción/evento para que las dos fuentes se cuenten una sola vez.

Cerrar el ciclo con Google Ads

1. Toma los tratos que tu CRM marca como ganados.
2. Para cada uno, lee gclid de la nota de atribución (o de la columna a la que lo asignaste).
3. Súbelos como conversiones offline con el valor y la hora de la conversión.

Para tratos sin click id (un visitante de búsqueda orgánica, un visitante de iOS cuyo gclid nunca apareció), usa en su lugar Enhanced Conversions for Leads con el número de teléfono.

Límites

• Los parámetros se guardan en el localStorage del navegador en tu dominio. Un visitante que borra los datos del sitio, cambia de dispositivo o navega en una ventana privada llega como una visita nueva; el primer contacto ya registrado en su conversación no se sobrescribe.
• Una llamada de voz iniciada desde el widget todavía no lleva la atribución al CRM; el chat sí.
• La atribución refleja lo que había en la URL. Si tus anuncios llevan a una página que redirige y pierde la query string, no hay nada que capturar; comprueba que tus redirecciones la conservan.