Errores de la API de conversión de Facebook y cómo solucionarlos

La configuración de la API de conversión de Facebook puede ser confusa. Pero después de hacer el tremendo trabajo de mover el seguimiento de FB al servidor y esperar que todo esté bien, puede que al día siguiente inicie sesión en su gestor de eventos y vea advertencias rojas y amarillas para los eventos enviados desde el servidor.

Me he enfrentado a este problema muchas veces mientras configuraba FB CAPI para clientes. Así que decidí crear un artículo con algunos consejos útiles. En esta entrada del blog, describiré los errores y advertencias más populares de la API de conversión de Facebook. Además, compartiré algunos consejos sobre cómo solucionarlos.

Cómo comprobar si hay errores en el píxel de Facebook o en la API de conversiónCopie el enlace a esta sección

La Herramienta de comprobación de eventos de Facebook (Facebook's Events Testing Tool) es una nueva y potente herramienta que le permite depurar y resolver problemas con sus píxeles de FB o eventos del servidor. Si hay errores, se mostrarán en la pestaña Diagnóstico de la barra de herramientas para que usted pueda revisarlos más de cerca.

Los errores marcados en rojo suelen requerir una reacción rápida y deben solucionarse de inmediato. Los errores marcados en amarillo son advertencias no críticas a las que se debe prestar atención y que deben ser revisadas eventualmente.

Facebook permite marcar los problemas como resueltos o ignorarlos. Si usted marca un error como resuelto y este error se repite, Facebook lo mostrará de nuevo en 3 días. En comparación, los problemas ignorados van a la sección de ignorados y se quedan allí.

Cuando usted arregle cualquier problema con su seguimiento de FB, le sugiero que lo marque como resuelto. De esta manera, usted notificará a Facebook que los problemas fueron solucionados, y usted tendrá noticias de la plataforma si estos problemas se repiten.

¿Cuáles son los errores más comunes del píxel de Facebook y de la API de conversión, y cómo solucionarlos?Copie el enlace a esta sección

1. Nuevos dominios que envían datosCopie el enlace a esta sección

Usted puede ver todos los dominios que están enviando datos a su píxel de Facebook. Si FB detecta tráfico desde un nuevo subdominio, la plataforma le enviará esta advertencia. Usted puede poner los dominios en la lista blanca o en la lista negra. Con la ayuda de esta función, usted puede bloquear el tráfico de sus sitios de prueba o URLs técnicas.

Lo más probable es que también vea el tráfico de gtm-msr.appspot.com. Puede ocurrir cuando usted ejecuta un contenedor de depuración/publicación o los usuarios llegan a su sitio con js deshabilitados (algunos bots).

Para crear las listas de dominios, abra la herramienta de eventos en el Business Manager -> Haga clic en la configuración -> Desplácese hacia abajo a los Permisos de Tráfico.

2. Eventos en el que faltan algunos parámetros de deduplicaciónCopie el enlace a esta sección

Este es el segundo error CAPI más popular de Facebook según mi experiencia. Este error significa que no está enviando algunas claves de deduplicación para sus eventos del servidor. Facebook utiliza estas claves de deduplicación: event name, event ID, _fbp and external ID.

Según mi experiencia, los parámetros de ID de evento causan este error el 80% de las veces. Compruebe si está enviando un ID de evento para el píxel de Facebook y la API de conversión de Facebook. Este ID de evento debe ser el mismo para el navegador y el evento del servidor. En este caso, FB verá el mismo nombre de evento y el mismo ID de evento e iniciará la deduplicación. 

Por ejemplo, para los eventos PageView, se debe enviar el mismo ID y nombre de evento de Facebook pixel y FB CAPI.

Para probar el ID del evento, abra la herramienta de prueba de eventos de Facebook. Si todo es correcto, usted debe ver algo similar a la captura de pantalla. Así es como FB muestra que registró eventos PageView tanto del navegador como del servidor. Estos eventos tenían el mismo ID de evento. Así que procesaron los eventos del navegador y deduplicaron los del servidor.

Pero puede haber otra situación en la que usted vea que los eventos del navegador y del servidor se disparan aleatoriamente. En este caso, compruebe el ID del evento FB. Lo más probable es que los ID de eventos no sean idénticos. Hablando de eso, usted puede usar nuestra variable personalizada para el contenedor web para establecer el ID del evento de Facebook. 

También tenemos un artículo sobre cómo configurar la deduplicación de eventos de Facebook.

A veces este error puede ser causado cuando no se eliminó el ID de prueba de Facebook y se publicaron las etiquetas FB CAPI en el entorno de producción. Recomiendo configurar el ID de prueba como una variable de tabla de búsqueda que funciona sólo cuando el modo de depuración es verdadero para solucionar este problema. 

3. El servidor envía parámetros de clave de coincidencia no válidos para el evento PageViewCopie el enlace a esta sección

Aquí, Facebook quiere notificarle que los valores que está enviando desde el servidor no son únicos o no están formateados correctamente. Por ejemplo, usted puede enviar la IP del usuario que incluye símbolos y no sólo números. O quizás simplemente ha seleccionado la variable incorrecta, como el envío de un número de teléfono en el campo de correo electrónico.

Para comprobar lo que está mal, abra el modo de vista previa del servidor y el contenedor web de Google Tag Manager (por supuesto, si ha utilizado GTM para configurar la API de conversión de Facebook). Usted debe ver qué parámetros de usuario se enviaron a Facebook y si fueron formateados correctamente. Pruebe el evento, haga clic en la etiqueta en el modo de depuración y seleccione los valores.

Este error también puede significar que se ha olvidado de incluir un parámetro o que está mal formateado.

Por ejemplo, tuve un cliente que quería enviar el condado y la ciudad del usuario basándose en la dirección IP. Facebook espera ver los detalles reales de la dirección del usuario que ingresa en el sitio y no los que usted extrajo automáticamente de la IP. Esta configuración también envió un error sobre parámetros clave no válidos.

O quizás haya intentado hacer trampa y enviar el mismo nombre de usuario para todos los eventos para aumentar la calidad.

4. Datos personales potencialmente violentos enviados a FacebookCopie el enlace a esta sección

Este error suele estar relacionado con los eventos del navegador y significa que Facebook detectó datos del usuario en la URL. Algunos CMS y otras herramientas como Calendly o PayPal envían los datos del usuario en la URL después de que se haya registrado o haya realizado una compra.

Este error es difícil de solucionar, y esa es una tarea para sus desarrolladores. Deberían mejorar los parámetros de consulta de la URL y eliminar toda la información del usuario de la URL. Como alternativa, puede seguir las instrucciones de este post de GitHub e intentar solucionar el problema dentro de GTM. Otra forma es cambiar al seguimiento de Facebook del lado del servidor únicamente. De este modo, puede modificar la URL antes de enviarla a Facebook.

5. Aumentar la Calidad de las coincidencias de eventosCopie el enlace a esta sección

Para cada evento del servidor que usted envíe a FB, habrá una сalidad de las coincidencias de eventos. Esta calificación depende del número de datos de usuario que envíe a FB.

Si usted utiliza un subdominio personalizado para su servidor de etiquetado, sólo la IP del usuario, el ID del navegador, _fbp, y _fbc son enviados a FB CAPI. Si sólo envía estos parámetros de usuario, la calidad de la coincidencia será de alrededor de 4 sobre 10.

Es muy importante enviar tantos parámetros como sea posible. FB utiliza estos datos para hacer coincidir los usuarios de su sitio con los de su base de datos. Intente enviar todos los parámetros del usuario que tenga.  Naturalmente, usted debe comprobar primero las normas de política de privacidad indicadas en su sitio. Pero técnicamente, es bueno enviar más parámetros. Significa que los datos de audiencia y conversión serán más precisos, los algoritmos de Facebook tendrán datos más específicos sobre sus usuarios y las campañas tendrán un mejor rendimiento.

¿Cómo se puede aumentar la calidad de las coincidencias de eventos? La respuesta es sencilla: hay que enviar más datos de los usuarios. Pero la implementación sigue siendo un proceso complejo. Así es como funciona: empiezo por comprobar si la capa de datos está implementada en su sitio y si tiene todos los datos del usuario. Por ejemplo, si el usuario puede iniciar sesión en su sitio, es necesario comprobar si los datos del usuario se envían a la capa de datos cuando los usuarios se conectan.

Si la capa de datos no está implementada, entonces asigne la tarea de configurarla a sus desarrolladores. 

Después, asegúrese de pasar todos los parámetros del usuario desde la web al contenedor del servidor.

Otra cosa que le ayudará a aumentar la calidad del partido es una nueva función del Data Tag. Hemos añadido la posibilidad de almacenar los datos del usuario. Por ejemplo, si el usuario envió un formulario de contacto en el sitio, puede utilizar la etiqueta Data Tag para almacenar los datos del usuario en el almacenamiento local y luego utilizarlo en otras páginas. Puede leer más sobre esta función aquí.

6. Se recibe el mismo ID de evento para muchas instancias de eventoCopie el enlace a esta sección

Si usted está rastreando eventos de Facebook tanto desde el navegador como desde el servidor, entonces Facebook requiere que usted envíe un ID de evento único para cada evento. Para que los eventos coincidan, el nombre del evento del píxel de Facebook debe ser exacto al nombre de los eventos del servidor. Lo mismo ocurre con el ID del evento, los mismos eventos del píxel de FB deben coincidir con los eventos del servidor de FB. Es entonces cuando se produce la deduplicación.

Este error ocurre cuando se envía el mismo ID de evento para muchos eventos. Por ejemplo, un usuario llegó a la página del producto. Esto significa que dos eventos deberían activarse en esta página: PageView y ViewContent. Debe enviar un ID de evento único para cada uno de los eventos. Esto significa que los eventos FB y los eventIDs deben tener el siguiente aspecto:

FB browser: PageView, eventID: ‘69’

FB server: PageView, eventID: '69'

FB browser: ViewContent, eventID: '79'

FB server: ViewContent, eventID: '79'

Aunque estos eventos se activan en la misma página y pueden utilizar el mismo activador en el contenedor web y del servidor de Google Tag Manager, debe enviar un ID de evento único para ambos.

El mismo ID de evento recibido para muchas instancias de evento ocurrirá si tiene esta situación:

FB browser: PageView, eventID: ‘69’

FB server: PageView, eventID: '69'

FB browser: ViewContent, eventID: '69'

FB server: ViewContent, eventID: '69'

En este ejemplo, estamos enviando el eventID 69 para los eventos PageView y ViewContent. Pero Facebook espera ver un eventID único para estos dos eventos.

Solución: añada el ID de prueba de Facebook, abra el modo de vista previa de los contenedores web y de servidor, y pruebe la configuración. Después de averiguar cuándo se produce este error, podemos hacer algo más para solucionar el problema.

Creamos una variable personalizada que genera un ID de evento único. Sugiero utilizar esta variable para configurar la deduplicación de eventos FB. Usted puede agregar un nombre de evento a esta variable para asegurar que el eventID sea único, tal como se ve en la captura de pantalla de abajo. En este caso, aunque sus eventos utilicen el mismo disparador, el eventID será único ya que se compone de event_name_eventID. Puede leer más sobre la deduplicación de eventos de Facebook en este artículo. 

ConclusiónCopie el enlace a esta sección

La configuración de la API de conversión de Facebook puede parecer complicada y, a veces, confusa. Pero vale la pena el tiempo y el esfuerzo. Después de haber hecho todo ese duro trabajo de trasladar el seguimiento de FB al servidor, la calidad del seguimiento y la audiencia mejorarán.

Sin embargo, usted podría enfrentar algunos problemas si hay errores dentro de este nuevo proceso de integración. Simplemente, usted podría ver advertencias rojas y amarillas en el administrador de eventos.

La buena noticia es que la mayoría de estos problemas no son tan complicados como parecen y no son caros de solucionar. Espero que este artículo le ayude a lidiar con los errores y advertencias más comunes de la API de conversión de Facebook.