Solução de problemas de integração

Dicas gerais de solução de problemas

Verifique se não há erros de JavaScript

Verifique se o JavaScript Console do navegador exibe quaisquer erros. Erros não processados podem impedir que o código subsequente seja executado corretamente. Caso haja erros, verifique qual script está causando o erro e em qual área. O caminho para o script pode fornecer uma indicação para a funcionalidade à qual o script pertence.

Logon no nível do componente

Em alguns casos, pode ser útil adicionar declarações adicionais no nível do componente. Como o componente é renderizado, é possível adicionar uma marcação temporária para mostrar valores variáveis que podem ajudar a identificar possíveis problemas. Por exemplo:

<%
log.info("myVariable={}", myVariable);
%>

<!--
<%= myJspVariable %>
-->

<!--
${ myHtlVariable }
-->

Para obter detalhes adicionais sobre o registro, consulte as páginas Registro e Trabalhar com Registros de Auditoria e Arquivos de Log.

Problemas de integração do Analytics

O Importador de relatórios causa alto uso de CPU/memória

O Importador de relatórios causa alto uso de CPU/memória ou gera OutOfMemoryError exceções.

Solução

Para corrigir esse problema, tente o seguinte:

  • Certifique-se de que não haja uma grande quantidade de pesquisadores registrados (consulte a seção "Desligamento leva muito tempo devido ao PollingImporter" abaixo).
  • Execute os Importadores de relatórios em um determinado momento do dia usando o CRON expressão para as configurações ManagedPollingImporter no console OSGi.

Para obter detalhes adicionais sobre como criar serviços personalizados de importação de dados no AEM, leia o seguinte artigo https://helpx.adobe.com/experience-manager/using/polling.html.

O encerramento leva muito tempo devido ao PollingImporter

O Analytics foi projetado tendo em mente um mecanismo de herança. Normalmente, você ativa o Analytics para um site adicionando uma referência a uma configuração do Analytics na guia Cloud Services de propriedades da página. A configuração é herdada automaticamente para todas as subpáginas, sem a necessidade de referenciá-la novamente, a menos que uma página exija uma configuração diferente. Adicionar uma referência a um site também cria automaticamente vários nós (12 para AEM 6.3 e anterior ou 6 para AEM 6.4) do tipo cq;PollConfig que instancia os PollingImporters usados para importar dados do Analytics para AEM. Como resultado:

  • Ter muitas páginas referenciando o Analytics resulta em uma grande quantidade de PollingImporters.
  • Além disso, copiar e colar páginas com uma referência a uma configuração do Analytics resulta em uma duplicação de seus Importadores de pesquisa.

Solução

Em primeiro lugar, analisar o error.log pode fornecer uma ideia sobre a quantidade de PollingImporters ativos ou registrados. Por exemplo:

# Count PollingImporter entries
$ sed -n "s/.*(aem-analytics-integration-.*).*target=\(.*\),interval.*/\1/p" error.log | wc -l
86415
# Count PollingImporter entries for last30days
$ sed -n "s/.*(aem-analytics-integration-last30Days).*target=\(.*\),interval.*/\1/p" error.log | wc -l
14531
# Count unique paths of PollingImporter registrations
sed -n "s/.*(aem-analytics-integration-.*).*target=\(.*\)\/jcr:content.*/\1/p" error.log | sort | uniq -c
28115

Em segundo lugar, certifique-se de que somente as principais páginas (acima na hierarquia) tenham uma configuração do Analytics referenciada.

Para obter detalhes adicionais sobre como criar serviços personalizados de importação de dados no AEM, leia o seguinte artigo https://helpx.adobe.com/experience-manager/using/polling.html.

Problemas do DTM (herdado)

A tag de script do DTM não é renderizada na fonte da página

A tag de script DTM não está incluída corretamente na página, mesmo que a configuração tenha sido referenciada na guia Cloud Services de propriedades da página.

Solução

Para corrigir o problema, tente o seguinte:

  • Verifique se as propriedades criptografadas podem ser descriptografadas (observe que a criptografia pode usar uma chave gerada automaticamente diferente em cada instância AEM). Para obter detalhes adicionais, leia também Suporte de criptografia para Propriedades de configuração.

  • Publicar novamente as configurações encontradas em /etc/cloudservices/dynamictagmanagement

  • Verifique as ACLs em /etc/cloudservices. As ACLs devem ser:

    • permitir; jcr:read; webservice-support-servicelibfinder
    • permitir; jcr:read; Todos; rep:global:*/defaults/*
    • permitir; jcr:read; Todos; rep:global:*/defaults
    • permitir; jcr:read; Todos; rep:global:*/public/*
    • permitir; jcr:read; Todos; rep:global:*/public

Para obter mais informações sobre como gerenciar ACLs, leia a página Administração e segurança do usuário.

Problemas de integração de público alvo

Conteúdo direcionado não visível no modo de Pré-visualização ao usar componentes de página personalizados

Esse problema ocorre porque os componentes de página personalizados não incluem as bibliotecas JSP ou cliente corretas que lidam com as integrações de DTM de Públicos alvos.

Solução

Você pode experimentar as seguintes soluções:

  • Verifique se o headlibs.jsp personalizado (se algum /apps/<CUSTOM-COMPONENTS-PATH>/headlibs.jsp) inclui o seguinte:
<%@include file="/libs/cq/cloudserviceconfigs/components/servicelibs/servicelibs.jsp" %>
<sly data-sly-resource="${'contexthub' @ resourceType='granite/contexthub/components/contexthub'}"/>
  • Certifique-se de que head.html (se algum /apps/<CUSTOM-COMPONENTS-PATH>/head.html) não inclua seletivamente cabeçalhos de integração específicos, como o exemplo abaixo:
<!-- DO NOT MANUALLY INCLUDE SPECIFIC CLOUD SERVICE HEADLIBS LIKE THIS -->
<meta data-sly-include="/libs/cq/dtm/components/dynamictagmanagement/headlibs.jsp" data-sly-unwrap/>

O servicelibs.jsp adiciona os objetos JavaScript de análise necessários e carrega as bibliotecas de serviços em nuvem associadas ao site. Para o serviço de Públicos alvos, as bibliotecas são carregadas por meio do /libs/cq/analytics/components/testandtarget/headlibs.jsp

O conjunto de bibliotecas que são carregadas depende do tipo de biblioteca do cliente do público alvo ( mbox.js ou at.js) usada na configuração do Público alvo.

Ao usar o DTM para fornecer mbox.js ou at.js, verifique se as bibliotecas estão carregadas antes da renderização do conteúdo. O uso de sistemas de gerenciamento de tags que carregam essas bibliotecas de forma assíncrona pode causar problemas na execução do código JavaScript específico do público alvo.

Para obter informações adicionais, leia a página Desenvolvimento de conteúdo direcionado.

O erro "ID de conjunto de relatórios ausente na inicialização do AppMeasurement" é exibido no console do navegador

Esse problema pode aparecer quando a Adobe Analytics é implementada no site usando o DTM e o Código personalizado. A causa é usar s = new AppMeasurement() para instanciar o objeto s.

Solução

Use s_gi em vez do método de instanciação new AppMeasurement. Por exemplo:

var s_account="INSERT-RSID-HERE"
var s=s_gi(s_account)

Uma oferta padrão é exibida aleatoriamente em vez da oferta correta

Esse problema pode ter várias causas:

  • O carregamento assíncrono de bibliotecas clientes de Públicos alvos ( mbox.js ou at.js) usando sistemas de gerenciamento de tags de terceiros pode quebrar aleatoriamente a definição de metas. As bibliotecas de Públicos alvos devem ser carregadas sincronicamente no cabeçalho da página. Isso é sempre verdadeiro quando as bibliotecas são entregues da AEM.

  • Carregando duas bibliotecas clientes de Públicos alvos ( at.js) simultaneamente, por exemplo, uma usando o DTM e outra usando a configuração de Público alvo no AEM. Isso pode causar conflitos para a definição adobe.target se as versões at.js forem diferentes.

Solução

Você pode experimentar as seguintes soluções:

  • Verifique se o código do cliente que carrega as bibliotecas semelhantes ao DTM (que por sua vez carregam as bibliotecas de Públicos alvos) está sendo executado sincronicamente em page head.
  • se o site estiver configurado para usar o DTM para fornecer bibliotecas de Públicos alvos, verifique se a opção Clientlib fornecida pelo DTM está marcada na configuração do Público alvo do site.

Uma oferta padrão é sempre exibida em vez da oferta correta ao usar AT.js 1.3+

A versão AEM 6.2 e 6.3 não é compatível com a versão 1.3.0+ do AT.js. Com a versão 1.3.0 do AT.js introduzindo a validação de parâmetro para suas APIs, adobe.target.applyOffer() requer um parâmetro "mbox" que não é fornecido pelo código atjs-itegration.js.

Solução

Para resolver esse problema, edite atjs-itegration.js e adicione o campo "mbox": mboxName no objeto de parâmetro para adobe.target.applyOffer() da seguinte forma:

adobe.target.getOffer({
    "mbox": mboxName,
    "params": params,
    "success": function (response) {
        adobe.target.applyOffer({
            "mbox": mboxName, //<--- ADDED PARAM
            "selector": "#" + mboxName,
            "offer": response
        })
    },

A página Metas e configurações não mostra a seção Fontes de Relatórios

Esse problema provavelmente é um problema de provisionamento A4T Analytics Cloud Configuration.

Solução

Você precisa verificar se o A4T está corretamente ativado para sua conta do Público alvo emitindo a seguinte solicitação de verificação para AEM:

http://localhost:4502/etc/cloudservices/testandtarget/<YOUR-CONFIG>/jcr:content.a4t.json

{
    "a4tEnabled": true,
    "sharedsecret": "SECRET",
    "proxyUrl": "/libs/cq/contentinsight/content/proxy.reportingservices.json",
    "active": "true",
    "pageName": "",
    "url": "https://api5.omniture.com/rs/0.5/",
    "username": "USER@DOMAIN"
}

Se a resposta contiver a linha a4tEnabled:false, entre em contato com Atendimento ao cliente do Adobe para obter a conta provisionada corretamente.

APIs de Público alvo úteis

Abaixo estão apresentadas duas APIs de Público alvo que podem ser úteis ao solucionar problemas de Público alvo:

  • Recuperar o terminal do Público alvo para um determinado clientcode
https://admin.testandtarget.omniture.com/rest/v1/endpoint/<CLIENTCODE>.json

{"api":"https://admin<N>.testandtarget.omniture.com/admin/rest/v1"}
  • Recuperar o perfil de um cliente
https://admin<N>.testandtarget.omniture.com/admin/rest/v1/clients/<CLIENT>?email=<EMAIL>&password=<PASSWORD>

Response for N=4, CLIENT-dayintegrationintern
{
    "clientCode": "dayintegrationintern",
    "companyName": "Day Integration - Internal",
    "omnitureCompanyId": "Day Integration Internal",
    "softTraxId": -1,
    "address1": "XYZ",
    "city": "San Francisco",
    "state": "ca",
    "zip": "94107",
    "country": "UNITED STATES",
    "locale": "de_DE",
    "timeZone": "Europe/Berlin",
    "phone": "XX-XX-XXXX",
    "serviceLevel": "Up to 100,000",
    "privileges": [
        "a4t",
        "hosts",
        "TnT-SC-integration",
        "mvt",
        "steps",
        "testing-campaigns",
        "view-snapshot",
        "on-site-editor",
        "optimizing-campaign",
        "third-party-id-support",
        "landing-page-campaigns",
        "segment",
        "rest-create-user",
        "advanced-targeting",
        "mobile-device-targeting",
        "beta",
        "geolocation"
    ]
}

Nesta página