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

O AEM (CQ) não consegue se conectar ao 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. 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.
Observação:

Uma maneira de verificar quais URLs do datacenter devem ser usadas: tente fazer login via https://sc.omniture.com/login/ e veja para onde redireciona. Tal como https://sc2.omniture.com. Observe que "sc2" aqui significa outro data center 2 - "https://api2.omniture.com/admin/1.3/rest/". Isso pode não funcionar sempre (já que há diferentes redirecionamentos), portanto, entre em contato com o suporte do SiteCatalyst para obter informações mais precisas sobre a URL do seu datacenter designado.

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).
Logotipo da Adobe

Fazer logon em sua conta