API de conversiones

Puerta de enlace de la API de conversiones: solución de errores y advertencias

Si observas que faltan eventos del servidor o que el volumen de eventos del servidor es inferior al de los eventos del navegador, recurre a esta documentación para solucionar el problema. Para obtener más información acerca de las herramientas de solución de problemas, consulta Puerta de enlace de la API de conversiones: herramientas de solución de problemas.

Recurre a los siguientes pasos de solución de problemas para identificar el problema:

  1. Navega hasta el Administrador de eventos.
  2. Abre el sitio web en el navegador.
  3. IU de administración de la puerta de enlace de la API de conversiones

El dominio no está configurado para enviar eventos

La puerta de enlace 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 menor que el de los eventos del navegador, puede deberse a que el píxel se está activando en dominios que aún no están conectados a Meta.

Diagnóstico

  • Inicia sesión en el Administrador de eventos.
  • Selecciona el evento que corresponda.
  • Haz clic en Ver detalles y selecciona Información general del evento.
  • En el desplegable de la izquierda, selecciona Dominios para buscar los dominios desde los que se están activando los eventos del navegador.
  • Si faltan estos dominios o son diferentes de los dominios configurados, no se prevé que se capturen.

Resolución

  • Añade los dominios necesarios a la conexión de la puerta de enlace de la API de conversiones siguiendo las disposiciones de esta guía.

DNS no configurado o asignación de DNS incorrecta

La puerta de enlace de la API de conversiones se encuentra alojada en AWS, que le asigna una dirección IP en el momento de su creación. Tienes que asignar un subdominio de tu dominio a esta dirección IP para que se pueda acceder al extremo de la puerta de enlace de la API de conversiones desde el navegador a través de una llamada de solicitud de origen.

Diagnóstico

  • Utiliza un verificador de DNS en internet como https://dnschecker.org/ para comprobar si se ha resuelto el dominio de la puerta de enlace de la API de conversiones en la dirección IP correcta y está totalmente propagado. Si el dominio no se resuelve en ninguna dirección IP, consulta la sección de resolución para conocer los pasos que debes seguir.
  • Obtén la dirección IP de tu servidor de la puerta de enlace de la API de conversiones en el panel de EC2 de AWS o solicita esta información a la persona de contacto de tu infraestructura de alojamiento en la nube.
  • Si las direcciones IP son diferentes, consulta la sección de resolución para conocer los pasos que debes seguir.

Resolución

  • Trabaja con un administrador del registrador del dominio.
  • Actualiza el registro DNS del registrador de dominios con la dirección IP del servidor de la puerta de enlace de la API de conversiones (la que aparece en el panel de EC2 de AWS).
    • Establece un registro DNS A que asigne el subdominio puerta de enlace de la API de conversiones a la dirección IP del servidor generada durante la configuración.

Certificado nunca emitido

Si Let's Encrypt nunca ha emitido un certificado para la puerta de enlace de la API de conversiones, incluso mucho tiempo después de que el DNS se haya configurado correctamente, significa que el dominio es tan popular que Let's Encrypt rechazó la emisión.

Resolución

  • Plantéate colocar un equilibrador de carga AWS (ALB) delante de la instancia de la puerta de enlace de la API de conversiones y utiliza el ALB para alojar el certificado que posees.

Certificado emitido pero caducado

Este problema se produce si has cerrado el puerto 80 después de instalar correctamente la puerta de enlace de la API de conversiones, o si se están ejecutando versiones antiguas.

Resolución

La IU de la puerta de enlace no está disponible

Este problema se produce si has cerrado el puerto 80 después de instalar correctamente la puerta de enlace de la API de conversiones, o si se están ejecutando versiones antiguas.

Resolución

  • Verifica que la dirección IP de la instancia de la puerta de enlace de la API de conversiones coincide con la configuración del DNS. Si no es así, consulta DNS no configurado o asignación de DNS incorrecta.
  • Si el servidor no responde, se puede deber a un error de red temporal y se puede resolver mediante el reinicio de la instancia. La puerta de enlace de la API de conversiones puede tardar unos minutos en iniciarse, de modo que debes esperar aproximadamente 10 minutos para volver a entrar.

Se requiere actualización de la versión de la puerta de enlace

Cabe la posibilidad de que la puerta de enlace de la API de conversiones de versiones anteriores a la versión 1.0.8 haya dejado de enviar eventos a Meta. Te sugerimos que la actualices, como mínimo, a la versión 1.0.8 para sacar el máximo partido a la configuración. De esta forma, se reanudará el envío de eventos y garantizarás las actualizaciones automáticas en el futuro.

Diagnóstico

  • Para comprobar la versión actual de la puerta de enlace de la API de conversiones:
    • Abre la IU de administración de la puerta de enlace de la API de conversiones:
https://<Conversions API Gateway Endpoint>/hub
  • Comprueba la versión actual del servidor de la puerta de enlace de la API de conversiones:
    • Menú del lado izquierdo > Configuración > Actualizaciones

Resolución

Para actualizar la puerta de enlace de la API de conversiones, haz lo siguiente:

Solución de problemas con registros de EKS

Si tienes algún problema al instalar la puerta de enlace de la API de conversiones para la versión de EKS de cuenta única o para la versión de varias cuentas, puedes consultar los registros para solucionar el problema.

El registro de instalación de EKS está disponible en AWS Cloudwatch con el nombre de grupo “ConversionsAPIGateway/cloud-init-output.log”. Puedes comprobar si hay algún mensaje de error. Los errores más comunes incluyen la superación del límite de recursos de AWS y la ausencia de permisos de AWS.



El registro DNS del tipo CAA no tiene amazonaws.com

Si el registro DNS que la puerta de enlace de la API de conversiones solicita configurar tiene un certificado TLS válido o no tiene un registro CAA, puedes ignorar esta sección.

Si tienes un registro CAA para el dominio, asegúrate de definir “amazonaws.com” como valor para el registro en caso de tener instalada la versión de AWS EKS de la puerta de enlace de la API de conversiones (para una única cuenta), o bien la versión 1.10.* o posteriores de la puerta de enlace de la API de conversiones (para varias cuentas), que usa el administrador de certificados AWS para la creación de dominios. A continuación, se muestra un ejemplo de registro CAA:

0 issue "amazonaws.com"

Si tienes instalada la versión 1.9.* o anteriores de la puerta de enlace de la API de conversiones para varias cuentas, asegúrate de definir “letsencrypt.org” como valor del registro CAA. Un ejemplo sería el siguiente:

0 issue "letsencrypt.org"

Más información