Volver a todas las integraciones
Ads & analytics

Meta Ads

Envío de conversiones del lado del servidor y eventos offline a Meta para que la entrega de anuncios se optimice según negocios cerrados reales.

En esta página
Qué conectaCómo conectarloQué datos se muevenEjemplo prácticoLímites y trampas comunes
¿Necesitas que lo conectemos?

Trae tus herramientas a una llamada: lo conectamos, probamos cada campo en ambas direcciones y te lo entregamos documentado.

Agenda una llamada
01

Qué conecta

Del lado de Meta están una cuenta publicitaria, sus campañas y los dos objetos que reciben tus datos de resultados: un píxel o conjunto de datos que acepta eventos del lado del servidor mediante la API de Conversiones, y el mecanismo de eventos offline que se usa para las ventas que ocurren fuera del navegador. El sistema de entrega de Meta optimiza hacia los eventos que recibe, cualesquiera que sean, y relaciona cada uno con una persona usando los identificadores que le das (un identificador de clic, un identificador de navegador o datos de contacto con hash). No sabe nada más de tu negocio.

Del lado de AppBO están el registro del contacto, el pipeline y los hechos: quién respondió, quién agendó, quién asistió, quién compró y por cuánto. Los anuncios de captación de prospectos y los formularios del sitio web le dicen a Meta que alguien mostró interés; solo tú sabes si ese interés se convirtió en dinero.

Conectar ambos lados cumple dos propósitos que conviene separar. El primero es la resiliencia: el seguimiento con píxel en el navegador pierde calidad por los bloqueadores de anuncios, las restricciones de rastreo y el consentimiento de cookies, así que enviar los mismos eventos del lado del servidor recupera la señal que el navegador pierde. El segundo es la optimización de circuito cerrado: enviar las etapas posteriores (calificado, agendado, comprado, con valor) le permite a Meta encontrar más personas que se comportan como tus compradores, en lugar de más personas que llenan formularios. El costo es que ahora envías datos de clientes a una plataforma de publicidad, lo que convierte el consentimiento, el hash y tu aviso de privacidad en parte de la implementación y no en algo que se piensa después.

02

Cómo conectarlo

  1. Define el modelo de eventos antes de tocar cualquier configuración. Decide qué eventos con nombre vas a enviar, cuál es el objetivo de optimización y cuáles solo se observan. Decide dónde se adjunta el valor y adjúntalo a exactamente un evento por recorrido del cliente.
  2. Confirma que la cuenta publicitaria, el píxel o conjunto de datos y la página estén todos bajo la cuenta de Meta Business del propio negocio, y que tengas el acceso necesario para configurar el conjunto de datos.
  3. Crea o identifica el píxel o conjunto de datos que va a recibir los eventos. Anota su identificador y genera el token de acceso que necesita la conexión del lado del servidor. Trata ese token como una credencial.
  4. Decide cómo van a convivir el píxel del navegador y los eventos del lado del servidor. Enviar ambos suele ser lo correcto, pero cada evento que envías dos veces necesita un identificador de evento compartido para que Meta pueda eliminar duplicados: si no, tus conversiones se duplican.
  5. Instala el píxel en tus funnels, landing pages y sitios web si todavía no está, y confirma que se dispara en las páginas que esperas.
  6. Crea un campo personalizado en el contacto para el identificador de clic que Meta agrega a las URL de destino de los anuncios, y configura cada formulario, widget de reservas y punto de entrada del chat para que lo capture de la URL en el primer contacto. Captura también el identificador de navegador donde la plataforma lo permita; juntos son las señales de coincidencia más fuertes disponibles.
  7. En la subcuenta, abre el área de integraciones y conecta Meta; después ingresa el identificador del píxel o conjunto de datos y el token de acceso donde la plataforma los pida.
  8. Asigna cada evento de la plataforma a un nombre de evento de Meta. Usa los nombres de evento estándar de Meta cuando alguno encaje, porque los objetivos de optimización están construidos alrededor de los eventos estándar, y reserva los eventos personalizados para cosas que ningún evento estándar describe.
  9. Decide qué identificadores acompañan a cada evento. El identificador de clic cuando lo tengas; el email con hash y el teléfono con hash como claves de coincidencia adicionales; y nada que no tenga hash, como exige la especificación de Meta.
  10. Confirma tu situación legal antes de enviar identificadores derivados del contacto. Revisa cómo se captura el consentimiento, confirma qué dice tu aviso de privacidad y aplica cualquier restricción regional. Si no se dio el consentimiento, no envíes los identificadores.
  11. Fija el valor y la moneda del evento de compra o de oportunidad ganada a partir del valor real del negocio en la oportunidad, con un valor de respaldo validado para que nunca salga un campo vacío.
  12. Arma los flujos de trabajo que envían los eventos, disparados por el cambio de etapa o el resultado de la cita que de verdad marca cada hito, cada uno protegido para que el mismo contacto no pueda enviar el mismo evento dos veces.
  13. Fija la hora del evento en el momento en que ocurrió la conversión, no en el momento de la carga, y toma nota de la antigüedad máxima que Meta acepta para un evento del lado del servidor u offline. Revisa la cifra actual en la documentación de Meta, porque un evento más antiguo que eso se descarta.
  14. Para las ventas sin ningún contacto digital, usa la vía de eventos offline y decide si será una carga programada o un envío evento por evento.
  15. Verifica en el Administrador de eventos de Meta. Usa la herramienta de eventos de prueba para confirmar que los eventos llegan con los datos (payload) que esperas y después revisa el indicador de calidad de coincidencia de cada evento. Una puntuación baja significa que tus identificadores son demasiado pobres para que Meta reconozca a la persona.
  16. Revisa la eliminación de duplicados: dispara un evento del píxel y su gemelo del lado del servidor para la misma acción y confirma que el Administrador de eventos reporte una conversión, no dos.
  17. Recorre el camino completo con una prueba real: haz clic en tu propio anuncio, envía un formulario, mueve el contacto por las etapas y confirma que cada evento aparezca atribuido a la campaña.
  18. Deja el evento nuevo como una señal secundaria observada durante unas semanas, confirma que los volúmenes y los valores tengan sentido y solo entonces apunta la optimización de una campaña hacia él.
03

Qué datos se mueven

De Meta a la plataforma

  • El identificador de clic que se agrega a las URL de destino de los anuncios, capturado en un campo del contacto en el primer contacto.
  • Los parámetros de campaña, conjunto de anuncios y anuncio, cuando las URL de tus anuncios los llevan.
  • El identificador de navegador que fija el píxel, cuando la plataforma lo captura.
  • Nada sobre quién es la persona. Meta no revela la identidad detrás de un clic.

De la plataforma a Meta

  • Eventos de conversión del lado del servidor: el nombre del evento, la hora del evento, un identificador único de evento para eliminar duplicados, el origen de la acción y el valor y la moneda cuando corresponda.
  • Identificadores de coincidencia con cada evento: el identificador de clic, el identificador de navegador y el email y el teléfono con hash cuando el consentimiento lo permite.
  • Eventos de conversión offline para las ventas que ocurren sin ningún navegador de por medio.
  • Propiedades personalizadas en un evento, como una categoría de servicio o un rango de calidad del prospecto, cuando quieres que Meta pueda distinguirlas.
  • Nada que modifique las campañas. Esta integración reporta resultados; no crea audiencias, no fija presupuestos ni pausa anuncios.

Lo que no se mueve

  • Las cifras de gasto, impresiones, alcance, frecuencia y costos hacia la plataforma. Los reportes de rendimiento de los anuncios son un tema aparte.
  • Los eventos de contactos sin ningún identificador útil. Sin identificador de clic, identificador de navegador o un dato con hash permitido, Meta no puede reconocer a la persona y el evento, en la práctica, se pierde.
  • Los eventos más antiguos que la ventana que acepta Meta, que se descartan en lugar de quedar en cola.
  • Los datos personales sin hash. La especificación de Meta exige aplicar hash a los identificadores de contacto, y enviar los valores en bruto es a la vez una violación de la política y un rechazo.
  • Los envíos de anuncios de captación de prospectos. Esos llegan por la conexión de páginas, no por esta.
  • El crédito de atribución. Meta decide cómo atribuir dentro de sus propias ventanas; tú entregas el evento, no el crédito.
  • La pertenencia a audiencias y audiencias personalizadas, y la creación de audiencias similares.
04

Ejemplo práctico

Escenario: una clínica estética que usa anuncios de captación de prospectos en Meta pasa de optimizar por prospectos a optimizar por tratamientos completados.

  1. Se confirma que la cuenta publicitaria, el píxel y la página de la clínica pertenecen a la cuenta de Meta Business de la propia clínica. Se genera un token de acceso del conjunto de datos para el envío del lado del servidor.
  2. Se acuerda el modelo de eventos: un evento de prospecto cuando se envía el formulario, un evento de agenda cuando se reserva una consulta y un evento de compra con el valor real del tratamiento cuando el tratamiento se paga. Con el tiempo, la compra será el objetivo de optimización.
  3. Se confirma que el píxel se dispara en las páginas del funnel, y se crea un campo personalizado en el contacto para el identificador de clic de Meta, que capturan el formulario del funnel, el widget de reservas y el widget de chat.
  4. La conexión de Meta en la plataforma se configura con el identificador del conjunto de datos y el token. Cada flujo de trabajo que envía un evento se configura para generar un identificador único de evento, de modo que el evento del propio píxel y el evento del lado del servidor se dedupliquen.
  5. Se revisa el consentimiento: se actualiza el texto de consentimiento del funnel y los flujos de trabajo se configuran para incluir el email y el teléfono con hash solo cuando el campo de consentimiento está marcado.
  6. Una persona interesada hace clic en un anuncio de captación y envía el formulario. Se guarda el identificador de clic. El píxel dispara un evento de prospecto en el navegador y la plataforma envía el evento de prospecto equivalente del lado del servidor con el mismo identificador de evento.
  7. El Administrador de eventos muestra un prospecto, no dos, y reporta una buena puntuación de calidad de coincidencia porque el evento llevó tanto el identificador de clic como el email con hash.
  8. Se reserva una consulta. Un flujo de trabajo envía el evento de agenda con el identificador de clic y la hora de la cita como hora del evento.
  9. Ella asiste, se decide por un tratamiento, paga un anticipo y agenda el procedimiento. Cuando se paga el saldo, la oportunidad se marca como ganada con el valor completo en el registro.
  10. Un flujo de trabajo envía el evento de compra con el valor real, la moneda, la hora del evento fijada en la fecha de pago y los identificadores guardados.
  11. Una segunda persona interesada que llegó de la misma campaña nunca contesta el teléfono. Para ella nunca se envía un evento de agenda ni de compra, que es exactamente la señal que Meta necesita.
  12. Después de un mes, la clínica compara los dos conjuntos de anuncios: uno produjo muchos prospectos baratos y casi ningún tratamiento; el otro produjo menos prospectos, más caros, y la mayor parte de los ingresos.
  13. La optimización de la campaña se cambia al evento de compra con optimización por valor, y el presupuesto se pasa al conjunto de anuncios que de verdad produjo tratamientos.
  14. Una clienta cancela y recibe un reembolso. El equipo envía el ajuste correspondiente para que el sistema de entrega no aprenda a perseguir ese resultado, y además registra la cancelación en los reportes propios de la clínica.
  15. Una revisión mensual del Administrador de eventos detecta que la puntuación de calidad de coincidencia del evento de agenda está bajando, y la causa resulta ser una página de reservas nueva que no capturaba el identificador de clic.
05

Límites y trampas comunes

Límites de uso

Meta aplica límites de uso a la API de Conversiones por conjunto de datos y por aplicación, y una carga masiva de datos históricos es la operación que choca con ellos. Agrupa los eventos en lotes en lugar de enviarlos uno por uno, dosifica una carga histórica y lee la información de limitación que Meta devuelve en los encabezados de respuesta, en lugar de adivinar un tope; los límites vigentes están publicados en la documentación para desarrolladores de Meta. Un envío limitado debe quedar en cola y reintentarse con espera progresiva en lugar de descartarse, porque un evento de compra perdido es una señal de optimización perdida.

Reintentos e idempotencia

El identificador de evento es el mecanismo de idempotencia y cumple una doble función: elimina el duplicado de un envío del lado del servidor que se reintentó y elimina el duplicado entre el evento del lado del servidor y su gemelo del píxel del navegador. Genéralo de forma determinista a partir de lo que pasó (el contacto y el hito), no al azar en cada intento, o un reintento contará dos veces. Meta elimina duplicados dentro de una ventana, no para siempre, así que un evento reenviado días después es una conversión nueva. Protege también el flujo de trabajo, para que un disparador repetido ni siquiera envíe.

Trampas en el mapeo de campos

Los nombres de evento estándar distinguen mayúsculas y ortografía, y uno casi correcto crea un evento personalizado que ningún objetivo de optimización está mirando. Todo parece funcionar mientras nada mejora. El hash debe seguir exactamente la especificación de Meta, incluida la normalización del valor antes de aplicarlo; un email con un hash correcto pero sin normalizar no coincide con nada. Los números de teléfono necesitan el formato internacional completo antes del hash. El valor y la moneda deben ser coherentes, y un valor enviado en la unidad de moneda equivocada distorsiona la optimización por valor. El campo de origen de la acción le dice a Meta dónde ocurrió el evento e influye en la atribución, así que llénalo con honestidad.

Creación de duplicados

Las conversiones contadas dos veces son la falla característica de esta integración: eventos del píxel y del lado del servidor enviados sin un identificador compartido, dos flujos de trabajo que se disparan con disparadores que se traslapan o una etapa del pipeline a la que se puede volver a entrar. Los contactos duplicados en el CRM producen eventos duplicados con los mismos identificadores, lo que además daña la calidad de coincidencia. Limpia los duplicados antes de juzgar los números y revisa el reporte de eliminación de duplicados del Administrador de eventos en lugar de confiar en la configuración.

Pruebas frente a producción

La herramienta de eventos de prueba del Administrador de eventos es el entorno de pruebas, y es buena: muestra los datos exactos recibidos, señala los campos mal formados y reporta la calidad de coincidencia sin afectar los reportes. Lo que no puede mostrar es cómo responde la entrega, y para eso hace falta volumen real. Sigue el mismo patrón que con cualquier cambio en una plataforma de anuncios. Envía primero como evento observado, confirma que tenga sentido y después optimiza con base en él.

Vencimiento de la autenticación

El token de acceso del conjunto de datos es la parte frágil. Se puede revocar, puede vencer según cómo se generó y muere junto con el acceso a la cuenta de negocio de la persona que lo creó. Los cambios de propietario de la cuenta de negocio y la eliminación de administradores lo rompen de la misma forma. El síntoma es que los eventos fallan en silencio mientras las campañas siguen gastando, así que vigila el volumen de eventos en el Administrador de eventos como señal de salud, en lugar del indicador de conexión de la plataforma, y ten más de un administrador en la cuenta de negocio.

Lo que suele fallar

  • Eventos del píxel y del lado del servidor que se disparan sin un identificador de evento compartido, lo que duplica cada conversión.
  • Un nombre de evento estándar mal escrito que se convierte, sin avisar, en un evento personalizado.
  • Un hash aplicado sin la normalización de Meta, que produce eventos que no coinciden con nadie.
  • La hora del evento fijada en la hora de la carga, lo que deja una conversión antigua fuera de la ventana aceptada.
  • El identificador de clic que nunca se captura, porque una landing page está fuera de la plataforma.
  • El consentimiento ignorado, con datos de contacto con hash enviados para personas que lo rechazaron. Es un problema de cumplimiento más que técnico.
  • El valor enviado en varios eventos de un mismo recorrido, lo que infla el retorno de la inversión publicitaria hasta que nadie confía en el panel.
  • La optimización apuntada a un evento de bajo volumen, así que las campañas nunca salen de la fase de aprendizaje.
  • Los reembolsos y las cancelaciones que nunca se ajustan.
  • El token del conjunto de datos guardado y después rotado por seguridad, sin que nadie actualice la integración.

Conéctalo con nosotros.

Conectamos la integración, mapeamos los campos, probamos ambas direcciones y te la entregamos con los procedimientos (SOP) que tu equipo necesita para operarla.

Agenda una llamada