API de conversiones
Notifique sus objetivos a Meta, LinkedIn, TikTok y Google Ads desde nuestro servidor en lugar del navegador, con una correspondencia basada únicamente en el identificador de clic establecido por la propia red.
1. ¿Por qué desde el servidor?
Un píxel del navegador debe superar tres obstáculos para notificar una conversión: un bloqueador de anuncios, una opción de prevención de seguimiento y el cierre de la pestaña antes de activarse. Una llamada desde el servidor supera los tres porque no ocurre en el navegador.
MousePlayer ya sabe cuándo se alcanza uno de sus objetivos: para eso sirven. Las API de conversiones simplemente transmiten ese dato a la red publicitaria desde nuestro servidor.
Esto no sustituye a su píxel. Consérvelo. Cada red elimina duplicados entre ambas fuentes y enviamos los identificadores necesarios para ello.
2. Qué enviamos y qué nunca enviamos
Lo único que identifica al visitante en estas llamadas es la cookie o el identificador de clic establecido por la propia red. Ningún otro dato de la persona sale de nuestro servidor.
| Red | Identificador usado | Origen |
|---|---|---|
| Meta | _fbp, _fbc | Cookies propias establecidas por el píxel de Meta |
li_fat_id | Cookie propia establecida por LinkedIn Insight Tag | |
| TikTok | _ttp, ttclid | _ttp es una cookie, ttclid procede de la URL del clic publicitario |
| Google Ads | gclid, wbraid, gbraid | De la URL del clic publicitario o de la cookie _gcl_aw posteriormente |
| Microsoft Advertising | msclkid | De la URL del clic publicitario o de la cookie _uetmsclkid que escribe la etiqueta UET |
Nunca se envían: correo electrónico, teléfono, nombre ni dirección IP, ni siquiera con hash. Si un visitante no tiene identificador de clic, no se envía nada. Una conversión sin atribución le aporta menos que un recuento exacto.
Solo con consentimiento
Todas estas llamadas están sujetas al mismo control de consentimiento que la grabación. Una sesión sin consentimiento no produce ninguna notificación de conversión, independientemente del interruptor de los ajustes del proyecto.
3. Google Ads tiene tres identificadores, no uno
Esto suele sorprender, así que conviene aclararlo. Google usa gclid para un clic publicitario individual. Cuando la prevención de seguimiento de Apple impide atribuir un clic individual, Google envía wbraid o gbraid en su lugar, que representan un grupo de clics.
Los tres son mutuamente excluyentes: Google rechaza una conversión que contenga dos. Enviamos exactamente uno y gclid tiene prioridad cuando hay varios, por ser el más preciso.
Solo aparecen una vez en la URL
El identificador aparece en la dirección únicamente en la primera página tras el clic publicitario. La etiqueta de Google lo guarda después en la cookie _gcl_aw . Leemos la cookie como alternativa: sin ella, una conversión en la tercera página de la visita no encontraría ningún identificador.
4. Configuración
Meta, LinkedIn y TikTok
Dos campos por red: el ID del píxel o de la regla de conversión, y un token de acceso creado en la interfaz de la red. Ambos se almacenan cifrados con AES-256-GCM y no vuelven a mostrarse tras guardarlos.
Google Ads necesita seis
Google es la excepción, y conviene conocer el motivo antes de empezar: a diferencia de las otras tres redes, no emite un simple token de acceso. El acceso utiliza OAuth con un token de actualización y la Ads API exige además un token de desarrollador.
| Campo | Dónde encontrarlo |
|---|---|
| ID de cliente | Arriba a la derecha en Google Ads. Solo dígitos, sin guiones. |
| ID de acción de conversión | Objetivos y conversiones, y después la acción a la que desea atribuirla. |
| Token de desarrollador | En su cuenta de administrador de Google Ads, Centro de API. |
| ID de cliente y secreto OAuth | Google Cloud Console, Credenciales, cliente OAuth de tipo «Aplicación de escritorio». |
| Token de actualización | Lo genera usted una sola vez para el ámbito adwords. |
LinkedIn tiene dos vías; elija la corta
En Campaign Manager: Datos, Administrador de señales, API directa, Generar token de acceso. Es la vía para anunciantes que envían sus propios datos, sin aplicación de desarrollador ni revisión. El token no caduca y Campaign Manager no lo volverá a mostrar, así que cópielo de inmediato.
La otra vía, una aplicación solicitada mediante el portal de desarrolladores de LinkedIn, existe para plataformas que envían datos por muchos anunciantes. Exige verificar la página de empresa y aprobar un caso de uso; aquí no necesita nada de eso.
Microsoft Advertising es la opción sencilla
Después de Google Ads esperaría los mismos trámites: OAuth, un token de desarrollador y una aprobación. Es lo contrario: dos campos. El ID de la etiqueta UET que ya usa en el navegador y un token que copia en Microsoft Advertising, bajo la etiqueta UET, «Usar API de conversiones», «Copiar token». No hay que solicitar nada.
Utilice el mismo ID de etiqueta que en el navegador. Esto permite a Microsoft reconocer el evento del servidor y el del navegador como una sola conversión en lugar de dos.
El token de desarrollador requiere la aprobación de Google («Acceso básico»), lo que tarda unos días. Es el único paso que no puede terminar en un minuto, así que empiece por él. Nunca vemos su contraseña de Google, solo el token de actualización, que puede revocar en cualquier momento.
5. Cuándo se notifica una conversión
Exactamente una vez por objetivo y sesión. MousePlayer elimina duplicados antes de enviar la llamada y los datos incluyen un ID para que la red pueda repetir la comprobación. Un visitante que añade cinco artículos al carrito produce una conversión, no cinco.
Qué verá en su cuenta publicitaria
La conversión contiene el nombre del objetivo, su valor y moneda si los definió, y el momento en que ocurrió. En condiciones normales llega en menos de un minuto.
Si no llega nada
- Sin identificador de clic. El visitante no llegó mediante un anuncio de esa red o llegó antes de que el píxel estableciera su cookie. No se envía nada: es el comportamiento esperado, no un error.
- Sin consentimiento. El control de consentimiento actuó primero.
- La red aceptó la llamada, pero rechazó la conversión. Google, TikTok y otras redes responden con HTTP 200 y un error en el cuerpo. Leemos el cuerpo, no solo el estado, y el motivo aparece en el registro de entregas.
Todas las marcas mencionadas pertenecen a sus respectivos propietarios. MousePlayer no mantiene ninguna relación comercial con estos proveedores.