Solução de problemas de integração do SiteCatalyst

Como solucionar problemas quando você...?

• Vê este erro na interface do usuário ao conectar o AEM (CQ) ao SiteCatalyst:
  Não foi possível estabelecer a conexão com o SiteCatalyst.
  Consulte um administrador do SiteCatalyst para saber mais.
• Vê este erro no error.log: com.day.cq.analytics.sitecatalyst.impl.servlets.SitecatalystServlet A chamada para o método "Connect" do SiteCatalyst falhou com.day.cq.analytics.sitecatalyst.SitecatalystException: ["Login inválido especificado."]?

1. Verifique a empresa, o nome de usuário e a senha

Certifique-se de que você pode efetuar login em https://sc.omniture.com/login/ para garantir que a empresa, o nome de usuário e a senha estão corretos.

2. Certifique-se de que o usuário tenha o acesso necessário no lado do SiteCatalyst

Certifique-se de que o usuário seja adicionado ao grupo predefinido "Acesso aos serviços da Web" no lado do SiteCatalyst. Veja a documentação oficial de integração do SiteCatalyst aqui para saber mais.

3. Assegure-se de que as URLs do datacenter configuradas no cliente HTTP Day CQ Analytics (console Felix) estejam disponíveis.

Dependendo do datacenter em que sua conta está localizada, verifique se o ponto de extremidade das "URLs do datacenter" está definido corretamente.

URLs de datacenter do SiteCatalyst disponíveis:

• 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/ *Ambiente de área restrita*

Siga as etapas abaixo para usar o API Explorer do SiteCatalyst para fazer uma chamada de teste.  Isso testa se o datacenter está disponível/respondendo e qual datacenter deve ser usado.

Se você sabe que o usuário tem "Acesso ao serviço da Web" ativado, mas não sabe suas credenciais do serviço da Web:

1. Vá para https://sc.omniture.com e faça login como um usuário administrativo
2. Clique em "Gerenciamento de usuários"
3. Selecione o usuário que deseja usar para acessar a API de serviço da Web do SiteCatalyst no Adobe Experience Manager (CQ)
   
4. Role a página para baixo até a caixa que diz "Credenciais do serviço da Web" e copie as credenciais dessa caixa para um editor de texto

Agora que você sabe suas credenciais, é possível executar um teste rápido:

1. Vá aqui para acessar o API Explorer do SiteCatalyst para testar seu acesso ao serviço da Web
2. Digite as credenciais (veja acima como pesquisá-las). O nome de usuário está no formato nome-de-usuário:empresa e o segredo é o "Segredo compartilhado". O "Segredo compartilhado" não é o mesmo que a senha, veja acima para saber mais.
3. Certifique-se de que "API" esteja definido como "Empresa" e "Método" esteja definido como "GetEndPoint"
   
4. Na caixa de texto "Solicitar", digite o seguinte para a solicitação: {"empresa":"nome da empresa"}
   . Substitua "nome da empresa" pelo nome da empresa que você usa para acessar o SiteCatalyst.
5. Clique em "Obter resposta"
6. A caixa "Resposta" retorna a URL do datacenter em que sua conta está localizada.

Agora que você sabe em qual datacenter sua conta está, então:

1. Faça login no console Apache Felix da Web para a sua instância do AEM (CQ): http://<host>:<port>/system/console/configMgr
2. Localize "Cliente HTTP do Day CQ Analytics SiteCatalyst" e clique em "Editar"
3. A configuração padrão é "https://api.omniture.com/admin/1.3/rest/".  Se essa não é a URL do seu datacenter do SiteCatalyst, adicione-a clicando em "+".  Em seguida, reorganize-a para que sua URL esteja no topo da lista.
   

4. Verifique se o seu servidor do AEM pode acessar os servidores de API do SiteCatalyst

Se você seguiu a etapa 3 e ainda não consegue se conectar ao SiteCatalyst a partir do AEM, possivelmente há um problema de rede, firewall ou proxy.  Teste a conexão da API do servidor em que o AEM está instalado:

• Se o AEM estiver instalado no Windows, conecte-se ao seu servidor usando a Área de Trabalho Remota da Microsoft.  Em seguida, na sessão da Área de Trabalho Remota, siga a etapa 3 usando o navegador Internet Explorer em seu servidor.  Se você sabe que uma configuração de proxy HTTP é necessária, configure-a primeiro nas configurações do navegador.
  
• Se o AEM está instalado no Linux ou Unix, execute este comando no terminal do servidor (altere a URL para a do seu datacenter):
  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/
  
  Se seu servidor consegue acessar o servidor da API, você vê este resultado:
  {"errors":["404 Not Found"]}
  Caso contrário, você vê um erro como "Host inatingível", "Conexão recusada", nenhuma resposta no ou algum outro erro relacionado à rede.

Se a chamada à API falhar, a comunicação entre o servidor do AEM e o servidor da API do SiteCatalyst será bloqueada. Consulte o seu administrador de rede para ver se é preciso uma configuração de proxy HTTP ou se o firewall está bloqueando as conexões com o SiteCatalyst.  Alguns possíveis problemas relacionados à rede podem ser:

• Um firewall está bloqueando conexões de saída do servidor do AEM para os servidores do SiteCatalyst.  Veja uma lista dos endereços IP para os quais é preciso permitir conexões aqui.
• Se um proxy está em uso, um firewall pode estar bloqueando conexões de saída do servidor do AEM para o proxy HTTP.
• (Se um proxy está em uso) Um firewall ou o próprio proxy está bloqueando as conexões de saída do proxy HTTP para o SiteCatalyst.  Saiba mais aqui.
• Uma falha de rede está interrompendo a conectividade entre os servidores.

Se você está usando o Windows e a chamada à API foi bem sucedida, provavelmente há uma configuração de proxy HTTP em funcionamento nas configurações do seu navegador.  Verifique as configurações de proxy do navegador e siga as etapas na próxima seção para configurá-lo no AEM.

5. Certifique-se de que a configuração de proxy está correta

Se o seu administrador de rede o aconselhar a usar um proxy HTTP para se conectar ao SiteCatalyst, siga estas etapas:

1. Faça login no console Apache Felix da Web para a sua instância do AEM (CQ): http://<host>:<port>/system/console/configMgr
2. Encontre "Cliente HTTP Day Commons" e clique em "Editar"
3. Edite a configuração do proxy e salve

O AEM (CQ) não está enviando solicitações de rastreamento para o SiteCatalyst

Como solucionar problemas quando o AEM está corretamente configurado para se conectar ao SiteCatalyst, mas não se vê solicitações rastreadas (no Site Catalyst)?

**Se você está usando o SiteCatalyst 15, saiba que alguns dados podem não aparecer até 60 min. a 90 minutos após a solicitação de rastreament.

1. Use a ferramenta Depurador do Pulse

O primeiro passo para determinar por que nada está aparecendo no SiteCatalyst é verificar se o AEM está incluindo a solicitação de imagem/rastreamento que envia informações para o SiteCatalyst.

1. Veja aqui como baixar e usar o depurador.
   
2. Instale o depurador em seu navegador da Web e navegue até a URL do site do AEM de onde deseja que as solicitações de rastreamento sejam enviadas.  Por exemplo, http://www.geometrixx.com/content/geometrixx/en.html
   
3. Abra o depurador e valide se as solicitações estão sendo enviadas e se todos os valores de variável do SiteCatalyst estão corretos.  Se tudo estiver correto e ainda é possível ver que as chamadas não estão aparecendo ou os relatórios não estão preenchidos corretamente, entre em contato com suporte analítico.
   

Se o depurador mostra que nenhuma chamada está sendo feita, vá para a próxima etapa.

2. Valide a configuração do SiteCatalyst no AEM (CQ)

Se nenhuma chamada de rastreamento estiver sendo feita do seu site do AEM:

• Faça login na sua instância de criação e valide a configuração do Cloud Services.  Saiba mais aqui.

Assegure-se de:

• adicionar o código JSP de análise aos modelos do seu site. Saiba mais aqui.
• vincular seu site à configuração de nuvem do SiteCatalyst.  Saiba mais aqui.

Se as chamadas de rastreamento são feitas do seu ambiente de criação, mas não do site ativo, certifique-se de:

• ativar a configuração da estrutura a partir da instância de criação.  Na página Configuração da estrutura, clique no botão Ativar estrutura na guia Página do Sidekick.  Ao ativar a estrutura, a instância de criação é solicitada a enviar a configuração para as instâncias de publicação.  Saiba mais aqui.
  
• conjuntos de relatórios configurados para funcionar com o modo de execução "publicar" (saiba mais aqui).