Atribución de clics en anuncios para WhatsApp #

Si publicas anuncios en Meta o Google que dirigen a una página de tu propio sitio web, y esa página tiene un botón de WhatsApp, DM Champ puede decirte de qué clic en el anuncio proviene cada conversación de WhatsApp. Solo tienes que pegar un pequeño script en tu sitio web. Cuando un visitante toca tu botón de WhatsApp, el clic se registra y se vincula al primer mensaje que te envían. El contacto muestra entonces la campaña de la que proviene, y los datos del clic viajan con el contacto a los webhooks, la API y, si lo deseas, de vuelta a Meta.

Esto funciona para cualquier página con un botón de WhatsApp: una página de destino (landing page), una página de reservas, una página de precios o un cuestionario que termina en “Enviar mis respuestas por WhatsApp”.

Esta página trata sobre anuncios que envían a las personas a tu sitio web primero. Si tus anuncios abren WhatsApp directamente (anuncios de “Clic a WhatsApp” de Meta), eso se cubre automáticamente, sin necesidad de un script, en Atribución de anuncios de Clic a WhatsApp.

Configuración #

1. Ve a Ajustes → Seguimiento de clics en anuncios (grupo de Integraciones).
2. Haz clic en Activar y obtener mi script. Tu cuenta obtendrá su propia clave de sitio y un script de una línea.
3. Copia el script y pégalo justo antes de la etiqueta de cierre </body> en cada página que tenga un botón de WhatsApp:

<script src="https://api.dmchamp.com/v1/ad-visit/YOUR_SITE_KEY.js" async></script>

4. Opcional: en Número de WhatsApp, escribe el número al que enlazan tus botones. Solo se rastrearán los enlaces a ese número. Déjalo vacío para rastrear todos los enlaces de WhatsApp en el sitio.
5. Elige la redacción del número de consulta (ver más abajo) y haz clic en Guardar. No necesitas cambiar el script en tu sitio web después de un cambio en los ajustes.
6. Pruébalo: abre tu página desde un enlace con una etiqueta de campaña, por ejemplo https://yoursite.com/?utm_source=test&utm_campaign=setup-check, toca tu propio botón de WhatsApp y envía el mensaje. Abre ese contacto en Chats: el panel de contacto mostrará Proviene de un clic en anuncio con la campaña.

La clave del sitio ya está dentro del script. No es una contraseña, por lo que es seguro tenerla en una página pública.

Qué hace el script #

• Cuando la página se carga, mantiene los identificadores de clic de anuncio y las etiquetas de campaña (los parámetros utm_) de la dirección de la página en el almacenamiento de sesión de la pestaña del navegador, por lo que siguen ahí si el visitante mira otra página primero. No establece ninguna cookie, no carga nada más y no envía nada.
• Cuando el visitante toca un enlace de WhatsApp (wa.me, api.whatsapp.com/send o whatsapp://send), añade el número de consulta al mensaje, registra la visita y permite que el toque continúe hacia WhatsApp con normalidad.

No se envía nada a DM Champ antes del toque.

El número de consulta #

Se añade un número corto, como la referencia que te da una tienda o clínica, al mensaje de WhatsApp del visitante. Es así como DM Champ sabe exactamente qué clic de anuncio pertenece a qué conversación. Un mensaje se ve así:

Hi, I would like to know more.
Enquiry no. 4827

• Redacción: “N.º de consulta” es la predeterminada. Puedes usar cualquier línea de texto que suene natural para tu negocio, como “Ref. reserva” o “Ref.”. Sin dígitos.
• Dónde: En su propia última línea (la predeterminada) o Al final del texto. La página de ajustes muestra una vista previa en tiempo real.
• Longitud: 4 dígitos, o 5 cuando tu sitio tiene mucho tráfico.
• Tu agente de IA nunca lo ve y nunca lo repite. La bandeja de entrada muestra el mensaje completo, número incluido.

Puede desactivar el número de consulta. En ese caso, la coincidencia solo funciona con el texto del mensaje, por lo que no se podrá distinguir a dos visitantes que envíen exactamente el mismo texto (por ejemplo, las mismas respuestas a un cuestionario) y algunos clics no se registrarán.

Su propio código de cuestionario o botón #

Si su página genera el mensaje de WhatsApp por sí misma (un cuestionario que incluye las respuestas en el texto o su propio código de botón), añada data-manual a la etiqueta script:

<script src="https://api.dmchamp.com/v1/ad-visit/YOUR_SITE_KEY.js" data-manual async></script>

Con data-manual, el script ya no modifica los enlaces de WhatsApp por sí solo. Su propio código lo invoca justo antes de abrir WhatsApp, de modo que cada visita se registra una sola vez:

• window.ChatAttribution.text(finalText, number) devuelve su texto con el número de consulta añadido y registra la visita. Utilice el texto devuelto en su enlace de WhatsApp.
• window.ChatAttribution.link(finalText, number) hace lo mismo y devuelve un enlace wa.me listo para usar con ese texto. Omita el número para utilizar el que aparece en Número de WhatsApp en la configuración.

<script>
  function sendAnswers(answers) {
    var text = "Hi, my answers: " + answers.join(", ");
    if (window.ChatAttribution) {
      window.location.href = window.ChatAttribution.link(text, "+15551234567");
    } else {
      window.location.href = "https://wa.me/15551234567?text=" + encodeURIComponent(text);
    }
  }
</script>

La rama else permite que el botón siga funcionando si el script no se ha cargado, por ejemplo, cuando una extensión del navegador lo bloquea. Un texto que ya contiene un número emitido por el script nunca se vuelve a modificar.

Qué se registra #

En el momento del toque, el registro de la visita contiene:

• los identificadores de clic de anuncio en la dirección de la página, como fbclid (Meta) y gclid (Google)
• las cookies _fbc y _fbp, si su propio píxel de Meta las configuró en su sitio (el script las lee, nunca las configura)
• las etiquetas de campaña (utm_source, utm_medium, utm_campaign, utm_content, utm_term)
• la página de destino, la página desde la que llegó el visitante, el navegador y el texto del mensaje
• la dirección IP y la hora, añadidas por DM Champ cuando llega la visita

Los registros de visitas se conservan durante 90 días. Cuando se encuentra una coincidencia, se guarda una copia de los datos del clic en el contacto y permanece con él hasta que usted la elimine.

Su aviso de privacidad: el script se ejecuta en su sitio web, por lo que el aviso de privacidad de su sitio debe mencionarlo: qué registra (la lista anterior) y que lo hace cuando un visitante toca un botón de WhatsApp.

Cómo funciona la coincidencia #

Cuando llega el primer mensaje de un contacto, DM Champ busca una visita de los 15 minutos anteriores:

1. Primero por número de consulta. Un mensaje que contiene un número emitido por el script se vincula a esa visita.
2. De lo contrario, por texto idéntico. Un mensaje con exactamente el mismo texto que una visita se vincula a ella. Cuando dos visitantes diferentes envían el mismo texto dentro del intervalo de tiempo, no se vincula ninguno, a propósito, para que un contacto nunca se asigne al anuncio incorrecto.

Un mensaje posterior que contenga el número de consulta también se vinculará, siempre y cuando el contacto aún no tenga una coincidencia.

Límites:

• La primera coincidencia gana. Una vez que un contacto tiene una coincidencia, nunca se sobrescribe.
• Solo WhatsApp: los canales de la API de WhatsApp Business y WhatsApp Web.
• 15 minutos: un visitante que toca el botón pero envía el mensaje mucho después no obtiene coincidencia.
• Solo hacia adelante: los contactos anteriores a la instalación del script no tienen coincidencia.

Dónde verlo #

• Panel de contacto: Proviene de un clic en un anuncio con la campaña o fuente y la fecha. Pasa el cursor para ver los detalles.
• Webhooks: contact.ad_attribution en los webhooks de etiquetas de agente y en cada evento de suscripción de webhook que contenga un contacto.
• API: ad_attribution en la lista de contactos y adAttribution en un contacto individual, en la sección de Contactos de la referencia de la API.
• Herramientas de MCP: el mismo objeto en cada contacto que devuelven.

El valor es null cuando el contacto no tiene coincidencia.

Enviar resultados a Meta (opcional) #

Puedes permitir que DM Champ informe los resultados a tu cuenta publicitaria de Meta, para que Meta aprenda qué anuncios generan clientes potenciales y ventas reales y se optimice en función de ellos. Esto utiliza tus propios detalles de la API de conversiones de Meta.

1. En el Administrador de eventos de Meta, busca el ID de tu píxel (también llamado conjunto de datos) en Fuentes de datos y crea un token de acceso en Configuración, API de conversiones, Generar token de acceso.
2. En Configuración → Seguimiento de clics en anuncios, bajo Enviar resultados a Meta (opcional), introduce el ID de píxel / conjunto de datos y el Token de acceso. Mientras realizas pruebas, puedes añadir el Código de evento de prueba desde la pestaña Eventos de prueba de Meta; bórralo cuando hayas terminado. Haz clic en Guardar detalles de Meta.
3. Abre el editor de agentes, ve a la pestaña Etiquetas y abre una etiqueta. En Enviar a Meta, elige el evento: Lead, Contact, Schedule, Purchase o un nombre personalizado. Opcionalmente, añade un valor y una moneda.

A partir de ese momento, cada vez que esa etiqueta se aplique a un contacto (por la IA, manualmente, a través de la API o mediante una automatización), DM Champ envía el evento a Meta con los datos de clic almacenados del contacto (fbc, fbp, dirección IP, navegador, página de destino) además de su teléfono, correo electrónico y nombre, cifrados, para que Meta pueda vincularlo al anuncio. Un contacto sin coincidencia sigue enviando el evento, solo con el teléfono, correo electrónico y nombre cifrados.

• Sin recuento doble: cada evento tiene un ID fijo compuesto por el ID del contacto y el nombre de la etiqueta. Si tu CRM envía el mismo evento a Meta con el mismo ID, Meta solo conserva uno.
• Ventana de atribución de Meta: Meta solo acredita un evento a un anuncio dentro de su ventana de atribución, que es de 7 días después del clic de forma predeterminada. Un trato que se cierra semanas después no contará por sí solo, así que envía también un evento anterior, por ejemplo, una etiqueta para la consulta reservada o pagada.

Preguntas frecuentes #

¿Esto funciona si mi anuncio abre WhatsApp directamente? Esos anuncios no pasan por tu sitio web, por lo que el script nunca se ejecuta. Meta envía los detalles del anuncio con el primer mensaje, consulta Atribución de anuncios de clic a WhatsApp.

¿El script ralentiza mi sitio web o establece cookies? Se carga en segundo plano (async), no establece cookies y no carga nada más. Solo envía información cuando un visitante toca un botón de WhatsApp.

¿Puedo realizar un seguimiento de Google Ads además de los anuncios de Meta? Sí. Los IDs de clic de Google (gclid, gbraid, wbraid) y cualquier etiqueta de campaña se registran y muestran en el contacto. El envío de resultados solo está disponible para Meta.

¿Por qué un contacto no obtuvo una coincidencia? Las razones más comunes: el mensaje llegó más de 15 minutos después del toque, el número de consulta se eliminó del mensaje, el número de consulta está desactivado y otro visitante envió el mismo texto, o la página no tiene el script.

Mi sitio web enlaza a dos números de WhatsApp. ¿Puedo realizar un seguimiento de solo uno? Sí. Escribe ese número en Número de WhatsApp en la configuración. Déjalo vacío para realizar un seguimiento de todos los enlaces de WhatsApp.

¿Puedo cambiar la redacción más tarde? Sí. Los cambios se aplican a su sitio web de inmediato; no necesita volver a pegar el script.