API de conversiones

Gateway de la API de conversiones: solución problemas y advertencias

Si notas que faltan eventos del servidor o que el volumen de eventos del servidor es menor que los eventos del navegador, consulta esta documentación para solucionar el problema. Para obtener información sobre las herramientas de solución de problemas, consulta gateway de la API de conversiones: herramientas de solución de problemas.

Sigue los pasos relacionados con la solución de problemas que se indican a continuación, que te ayudarán a identificar el problema:

  1. Ir al administrador de eventos
  2. Abrir sitio web en el navegador
  3. UI de administración del gateway de la API de conversiones

El dominio no está configurado para enviar eventos

El gateway de la API de conversiones recibirá eventos de los dominios conectados que configures durante la configuración de la integración. Si el volumen de eventos del servidor parece ser menor en comparación con los eventos del navegador, se puede deber al hecho de que el píxel se activa en dominios que aún no están conectados a Meta.

Diagnóstico

  • Iniciar sesión en el administrador de eventos
  • Selecciona el evento correspondiente
  • Haz clic en Ver detalles y selecciona Información general del evento
  • En el menú desplegable de la izquierda, selecciona Dominios para encontrar los dominios desde los que se activan los eventos del navegador.
  • Si dichos dominios no están disponibles o difieren de los configurados, es probable que no se capturen los eventos del navegador.

Solución

  • Agrega los dominios requeridos a la conexión del gateway de la API de conversiones siguiendo la información de esta guía.

DNS no configurado o asignación del DNS incorrecta

El gateway de la API de conversiones se aloja en la AWS, que le asigna una dirección IP cuando se crea. Es necesario asignar un subdominio del dominio a la dirección IP de modo tal que se pueda acceder al punto de conexión del gateway de la API de conversiones desde el navegador mediante la solicitud de llamada de origen.

Diagnóstico

  • Utiliza un verificador de DNS en línea, como https://dnschecker.org/ para verificar si el dominio del gateway de la API de conversiones se asigna a la dirección IP correcta y se propaga completamente. Si el dominio no se asigna a ninguna dirección IP, consulta la sección sobre asignaciones para obtener información sobre los pasos que se deben seguir.
  • Obtén la dirección IP del servidor del gateway de la API de conversiones desde el panel de AWS EC2 o solicita información al punto de contacto de la infraestructura de la nube.
  • Si las dos direcciones IP son diferentes, consulta la sección de asignaciones para obtener información sobre los pasos que se deben seguir.

Solución

  • Trabaja en conjunto con un administrador en el registrador del dominio.
  • Actualiza el registro DNS del registrador del dominio con la dirección IP del servidor del gateway de la API de conversiones (el que se muestra en tu panel AWS EC2).
    • Establece un registro de DNS que asigne el subdominio del gateway de la API de conversiones a la dirección IP del servidor que se genera durante la configuración.

Certificado nunca emitido

Si Let's Encrypt nunca emitió un certificado referido al gateway de la API de conversiones, incluso mucho tiempo después de que se configuró correctamente el DNS, significa que tu dominio es tan popular que Let's encrypt se negó a emitir uno.

Solución

  • Considera poner un balanceador de carga de AWS (ALB) delante de la instancia del gateway de la API de conversiones y usa el ALB para alojar el certificado que posee.

Certificado emitido, pero caducado

Este problema ocurre si cierras el puerto 80 después de que el gateway de la API de conversiones se instalara correctamente, o si ejecutas versiones antiguas.

Solución

  • Abre el puerto 80 y actualiza a la última versión del gateway de la API de conversiones.

UI del gateway no disponible

Este problema ocurre si cierras el puerto 80 después de que el gateway de la API de conversiones se instaló correctamente, o si ejecutas versiones antiguas.

Solución

  • Verifica que la dirección IP del gateway de la API de conversiones coincida con la configuración del DNS. De no ser así, consulta DNS no configurado o asignación del DNS incorrecta.
  • Si el servidor no responde, puede deberse a un error temporal de la red y puede resolverse reiniciando la instancia. El gateway de la API de conversiones puede tardar unos minutos en iniciarse. Aguarda unos 10 minutos para volver a conectarte.

Gateway requiere actualización de versión

Al parecer, las versiones anteriores del gateway de la API de conversiones a la 1.0.8. dejaron de enviar eventos a Meta. Te sugerimos que lo actualices a la versión 1.0.8, como mínimo, para maximizar el beneficio de la configuración. Se reanudará el procedimiento de eventos. Asegúrate de incluir actualizaciones automáticas en el futuro.

Diagnóstico

  • Para verificar la versión actual del gateway de la API de conversiones:
    • Abre la UI de administración del gateway de la API de conversiones:
https://<Conversions API Gateway Endpoint>/hub
  • Verifica la versión actual del servidor del gateway de la API de conversiones:
    • Menú izquierdo > Configuración > Actualizaciones

Solución

Para actualizar el gateway de la API de conversiones, haz lo siguiente:

Solución de problemas con los registros de EKS

Si se produce algún problema al instalar el gateway de la API de conversiones de la versión de EKS de una sola cuenta o de la versión de varias cuentas, puedes consultar los registros dedicados a la solución de problemas.

El registro de instalación de EKS está disponible en AWS Cloudwatch con el nombre del grupo "ConversionsAPIGateway/cloud-init-output.log". Puedes verificar si hay mensajes de error. Entre los errores comunes, se incluyen la limitación de recursos de AWS y la falta de permisos de AWS.



El registro de DNS con el tipo CAA no tiene amazonaws.com

Si el registro de DNS que el gateway de la API de conversiones solicita configurar tiene un certificado TLS apropiado o no tiene un registro de CAA, puedes ignorar esta sección.

Si tienes un registro de CAA para el dominio, asegúrate de proporcionar amazonaws.com como el valor del registro de CAA si instalaste la versión de AWS EKS del gateway de la API de conversiones (para una cuenta única) o el gateway de la API de conversiones en el caso de la versión 1.10* o posterior para varias cuentas que usa el administrador de creación de dominios. Un ejemplo del registro de CAA se vería de la siguiente manera:

0 issue "amazonaws.com"

Si instalaste la versión 1.0* o anterior del gateway de la API de conversiones para varias cuentas, asegúrate de proporcionar letsencrypt.org como valor del registro de CAA. Un ejemplo se vería de la siguiente manera:

0 issue "letsencrypt.org"

Consulta también