Solução de problemas de integração troubleshooting-integration-issues

Dicas gerais de solução de problemas general-troubleshooting-tips

Verifique se não há erros de JavaScript ensure-there-are-no-javascript-errors

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

Efetuando logon no nível do componente logging-on-component-level

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

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

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

<!--
${ myHtlVariable }
-->

Para obter detalhes adicionais sobre logs, consulte as páginas Logging e Working with Audit Records and Log Files.

Problemas de integração do Analytics analytics-integration-issues

O Importador de relatórios causa alto uso de CPU/memória the-report-importer-causes-high-cpu-memory-usage

O Importador de Relatórios causa alto uso de CPU/Memória ou causa OutOfMemoryError exceções.

Solução solution

Para corrigir esse problema, você pode tentar o seguinte:

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

O encerramento leva muito tempo devido ao Importador de buscas shutdown-takes-a-long-time-due-to-the-pollingimporter

O Analytics foi projetado tendo em mente um mecanismo de herança. Normalmente, você habilita o Analytics para um site adicionando uma referência a uma configuração do Analytics na guia Cloud Service das propriedades da página. A configuração é herdada para todas as subpáginas automaticamente, 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 e posterior) do tipo cq;PollConfig que instancia PollingImporters usados para importar dados do Analytics para AEM. Como resultado:

Solução solution-1

Primeiramente, analisar o error.log pode fornecer informações 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, verifique se apenas as páginas principais (no alto da hierarquia) têm uma configuração do Analytics referenciada.

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

Problemas do DTM (herdado) dtm-legacy-issues

A tag do script do DTM não é renderizada na origem da página the-dtm-script-tag-is-not-rendered-in-the-page-source

A marca de script do DTM não está incluída corretamente na página, embora a configuração tenha sido referenciada na guia de propriedades de página Cloud Service.

Solução solution-2

Para corrigir o problema, tente o seguinte:

Para obter mais informações sobre o gerenciamento de ACLs, leia a página Administração e Segurança do Usuário.

Problemas de integração do Target target-integration-issues

O conteúdo direcionado não fica visível no modo de Visualização ao usar componentes de página personalizados targeted-content-not-visible-in-preview-mode-when-using-custom-page-components

Esse problema ocorre porque os componentes de página personalizados não incluem as bibliotecas JSP ou de clientes corretas que lidam com as integrações do DTM do Target.

Solução solution-3

Você pode experimentar as seguintes soluções:

<%@include file="/libs/cq/cloudserviceconfigs/components/servicelibs/servicelibs.jsp" %>
<sly data-sly-resource="${'contexthub' @ resourceType='granite/contexthub/components/contexthub'}"/>

<!-- 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 de nuvem associadas ao site. Para o serviço do Target, 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 de cliente de destino ( mbox.js ou at.js) usada na configuração de Destino.

Ao usar o DTM para entregar mbox.js ou at.js, verifique se as bibliotecas são carregadas antes do conteúdo ser renderizado. O uso de sistemas Tag Management 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 mais informações, leia a página Desenvolvimento de Conteúdo Direcionado.

O erro "ID ausente do conjunto de relatórios na inicialização do AppMeasurement" é exibido no console do navegador the-error-missing-report-suite-id-in-appmeasurement-initialization-is-displayed-in-the-browser-console

Esse problema pode ocorrer quando o Adobe Analytics é implementado no site usando o DTM e o código personalizado. A causa é o uso de s = new AppMeasurement() para instanciar o objeto s.

Solução solution-4

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 a-default-offer-is-randomly-displayed-instead-of-the-correct-offer

Esse problema pode ter várias causas:

Solução solution-5

Você pode experimentar as seguintes soluções:

Uma oferta padrão é sempre exibida em vez da oferta correta ao usar AT.js 1.3+ a-default-offer-is-always-displayed-instead-of-correct-offer-when-using-at-js

O AEM 6.2 e 6.3 prontos para uso não é compatível com a AT.js versão 1.3.0+. Com a versão 1.3.0 da 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 solution-6

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 maneira:

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 the-goals-settings-page-does-not-show-the-reporting-sources-section

Este problema é provavelmente um problema de provisionamento da Configuração A4T do Analytics Cloud.

Solução solution-7

Você precisa verificar se o A4T está habilitado corretamente para sua conta Target, emitindo a seguinte solicitação de verificação para o 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 o Atendimento ao cliente do Adobe para obter a configuração correta da sua conta.

APIs úteis do Target helpful-target-apis

Abaixo estão duas APIs do Target que podem ser úteis ao solucionar problemas do Target:

https://admin.testandtarget.omniture.com/rest/v1/endpoint/<CLIENTCODE>.json

{"api":"https://admin<N>.testandtarget.omniture.com/admin/rest/v1"}

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"
    ]
}