Solución de problemas de integración de SiteCatalyst

¿Solucionar los problemas cuando...?

• Ver este error en la interfaz de usuario al conectar AEM (CQ) a SiteCatalyst:
  No se pudo establecer la conexión con SiteCatalyst.
  Consulte a un administrador de SiteCatalyst para obtener más detalles.
• Ver este rastreo de errores en el error.log: com.day.cq.analytics.sitecatalyst.impl.servlets.SitecatalystServlet hace una llamada a SiteCatalyst el método “Connect” falla com.day.cq.analytics.sitecatalyst.SitecatalystException: [“Inicio de sesión no válido.”]?

1. Verificar la empresa, el nombre de usuario y la contraseña

Asegúrese de que puede iniciar sesión en https://sc.omniture.com/login/ para asegurarse de que la empresa, el nombre de usuario y la contraseña son correctos.

2. Asegúrese de que el usuario tenga el acceso necesario en el lado de SiteCatalyst

Asegúrese de que el usuario se agregue al grupo predefinido “Acceso a los servicios web” en el lado de SiteCatalyst. Para más información de la integración de SiteCatalyst, consulte aquí.

3. Asegúrese de que las URL del centro de datos configuradas en Day CQ Analytics SiteCatalyst HTTP Client (consola Felix) estén disponibles.

Dependiendo del centro de datos en el que se encuentre su cuenta, asegúrese de que el punto final para las “URL del centro de datos” esté definido correctamente.

Las URL disponibles del centro de datos de SiteCatalyst:

• https://api.omniture.com/admin/1.4/rest/
• https://api2.omniture.com/admin/1.4/rest/
• https://api3.omniture.com/admin/1.4/rest/
• https://api4.omniture.com/admin/1.4/rest/
• https://api5.omniture.com/admin/1.4/rest/
• https://api-sbx1.omniture.com/admin/1.4/rest/ *Entorno de Sandbox*

Siga los pasos que se indican a continuación para utilizar el Explorador de la API de SiteCatalyst para realizar una llamada de prueba.  Esto comprueba si el centro de datos está disponible/respondiendo y qué centro de datos utilizar.

Si sabe que su usuario tiene habilitado el “Acceso a servicios web”, pero no conoce sus credenciales de servicio web:

1. Vaya a https://sc.omniture.com e inicie sesión como usuario administrativo
2. Hacer clic en “Gestión de usuarios”
3. Seleccione el usuario que desea utilizar para Adobe Experience Manager (CQ) para acceder a la API de servicios web de SiteCatalyst
   
4. Desplácese hacia abajo por la página hasta el cuadro que dice “Credenciales de servicio web” y copie las credenciales de este cuadro a un editor de texto

Ahora que conoce sus credenciales, puede realizar una prueba rápida:

1. Vaya aquí al Explorador de la API de SiteCatalyst para probar el acceso a su servicio web
2. Introduzca las credenciales (ver arriba para ver cómo buscarlas). El nombre de usuario está en el formato user-name:company y el secreto es “Secreto compartido”. El “Secreto compartido” no es lo mismo que su contraseña, ver arriba para más detalles.
3. Asegúrarse de que “API” está en “Empresa” y “Método” en “GetEndPoint”
   
4. En el cuadro de texto “Solicitar”, escribir lo siguiente para la solicitud: {“empresa”:“Nombre de la empresa”}
   Sustituir “Nombre de la empresa” por el nombre de la empresa que utiliza para acceder a SiteCatalyst.
5. Hacer clic en “Obtener respuesta”
6. El cuadro “Respuesta” devuelve la URL del centro de datos en el que se encuentra su cuenta.

Ahora que sabe en qué centro de datos está su cuenta:

1. Iniciar sesión en la Consola Web Apache Felix de su instancia de AEM (CQ): http://<host>:<port>/system/console/configMgr
2. Buscar “Day CQ Analytics SiteCatalyst HTTP Client” y hacer clic en “Editar”
3. La configuración por defecto es “https://api.omniture.com/admin/1.3/rest/”.  Si esa no es la URL de su Centro de Datos de SiteCatalyst, añadir la suya haciendo clic en “+”.  Luego reordénalo para que la URL esté en la parte superior de la lista.
   

4. Asegúrese de que su servidor AEM pueda llegar a los servidores de la API de Site Catalyst

Si ha seguido el paso 3 y aún así no puede conectarse a SiteCatalyst desde AEM, es posible que tenga un problema de red, firewall o proxy.  Compruebe que la conexión a la API desde el servidor en el que está instalado el AEM:

• Si AEM está instalado en Windows, conéctese a su servidor mediante Microsoft Remote Desktop.  A continuación, en la sesión de Escritorio remoto, siga el paso 3 utilizando el navegador Internet Explorer de su servidor.  Si sabe que se necesita una configuración de proxy HTTP, configúrela primero en los ajustes del navegador.
  
• Si AEM está instalado en Linux o Unix, ejecute este comando en la terminal de su servidor (cambie la URL a su Centro de datos:
  curl https://api.omniture.com/admin/1.3/rest/
  
  Use this command instead if a proxy is needed (replace <[protocol://][user:password@]proxyhost[:port]> with your proxy configuration):
  curl --proxy <[protocol://][user:password@]proxyhost[:port]> https://api.omniture.com/admin/1.3/rest/
  
  Si su servidor alcanza el servidor API, entonces verá este resultado:
  {"errors":["404 Not Found"]}
  De lo contrario, verá un error como "Host Unreachable", "Connection Refused", sin respuesta, o algún otro error relacionado con la red.

Si la llamada a la API falla, se bloquea la comunicación entre el servidor AEM y el servidor de la API de SiteCatalyst. Consulte con su administrador de red para ver si necesita una configuración de proxy HTTP o si el firewall está bloqueando las conexiones a SiteCatalyst.  Algunos de los posibles problemas relacionados con la red podrían ser:

• Un firewall bloquea las conexiones salientes del servidor AEM a los servidores de SiteCatalyst.  Consultar aquí una lista de direcciones IP a las que se pueden conectar las conexiones salientes.
• (Si un proxy está en uso) un firewall podría estar bloqueando las conexiones salientes del servidor AEM al proxy HTTP.
• (Si se está utilizando un proxy) Un firewall o el propio proxy está bloqueando las conexiones salientes del proxy HTTP a SiteCatalyst.  Ver aquí.
• Un fallo en la red interrumpe la conectividad entre los servidores.

Si está utilizando Windows y la llamada a la API se ha realizado correctamente, es probable que tenga una configuración de proxy HTTP en funcionamiento en la configuración de su navegador.  Compruebe la configuración del proxy del navegador y siga los pasos de la siguiente sección para configurarlo en AEM.

5. Asegúrese de que su configuración de proxy sea correcta

Si su administrador de red le aconseja que utilice un proxy HTTP para conectarse a SiteCatalyst, siga estos pasos para hacerlo:

1. Iniciar sesión en la Consola Web Apache Felix de su instancia de AEM (CQ): http://<host>:<port>/system/console/configMgr
2. Buscar “Day Commons HTTP Client” y hacer clic en “Editar”
3. Editar la configuración del proxy y guardar

AEM (CQ) no está enviando solicitudes de seguimiento a Site Catalyst

¿Solucionar los problemas cuando ha configurado correctamente el AEM para que se conecte a SiteCatalyst, pero no ve que se esté realizando un seguimiento de las solicitudes (en Site Catalyst)?

** Si está utilizando SiteCatalyst 15, tenga en cuenta que algunos datos pueden no aparecer hasta 60-90 minutos después de la solicitud de seguimiento. 

1. Utilizar la herramienta de depuración de impulsos

El primer paso para determinar por qué no aparece nada en SiteCatalyst es comprobar si AEM está incluyendo la solicitud de imagen/seguimiento que envía información a SiteCatalyst.

1. Ver aquí cómo descargar y utilizar el depurador.
   
2. Instalar el depurador en el navegador web y navegue hasta la URL del sitio AEM desde donde desea que se envíen las solicitudes de seguimiento.  Por ejemplo, http://www.geometrixx.com/content/geometrixx/en.html
   
3. Abrir el depurador y validar que las peticiones se están enviando y que todos los valores de las variables de SiteCatalyst son correctos.  Si todo va bien y aún así te das cuenta de que las llamadas no se muestran o los informes no se rellenan correctamente, entonces ponte en contacto con el servicio de asistencia analytics.
   

Si el depurador muestra que no se está realizando ninguna llamada, continúe con el siguiente paso.

2. Validar la configuración del catalizador de sitio en AEM (CQ)

Si no se están haciendo llamadas de seguimiento desde su sitio AEM:

• Iniciar sesión en la instancia de autor y valide la configuración de los servicios cloud.  Ver aquí.

Asegúrese de que:

• añadido el código jsp analítico a las plantillas de su sitio. Ver aquí.
• enlazó su sitio a la configuración en nube de Site Catalyst.  Ver aquí.

Si las llamadas de seguimiento se realizan desde su entorno Autor, pero no desde el sitio en vivo, asegúrese de que usted:

• ha activado la configuración del framework desde la instancia de autor.  En la página Configuración de la estructura, haga clic en el botón Activar estructura en la ficha Página del Sidekick.  Activar el framework le dice a la instancia de Autor que empuje la configuración a las instancias de Publicación.  Ver aquí.
  
• configuradas para trabajar con el modo de ejecución “publicar” (ver aquí).