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 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 logging-on-component-level

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

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

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

<!--
${ myHtlVariable }
-->

Para obter mais detalhes sobre o registro, consulte o Registro e Trabalhar com registros de auditoria e arquivos de registro páginas.

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 personalizados de importador de dados no AEM, leia o seguinte artigo https://helpx.adobe.com/experience-manager/using/polling.html.

O encerramento demora muito tempo devido ao PollingImporter shutdown-takes-a-long-time-due-to-the-pollingimporter

O Analytics foi projetado tendo em mente um mecanismo de herança. Normalmente, você ativa o Analytics para um site ao adicionar uma referência a uma configuração do Analytics nas propriedades da página Cloud Services guia . 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 o AEM 6.3 e anterior ou 6 para o AEM 6.4) do tipo cq;PollConfig que instancia os PollingImportporters usados para importar os dados do Analytics para o AEM. Como resultado:

Solução solution-1

Primeiro, analisar o error.log O pode fornecer-lhe algumas informações sobre a quantidade de PollingImporters ativos ou registrados. Por exemplo:

# Count PollingImporter entries

>[!CAUTION]
>
>AEM 6.4 has reached the end of extended support and this documentation is no longer updated. For further details, see our [technical support periods](https://helpx.adobe.com/br/support/programs/eol-matrix.html). Find the supported versions [here](https://experienceleague.adobe.com/docs/?lang=pt-BR).
$ sed -n "s/.*(aem-analytics-integration-.*).*target=\(.*\),interval.*/\1/p" error.log | wc -l
86415
# Count PollingImporter entries for last30days

>[!CAUTION]
>
>AEM 6.4 has reached the end of extended support and this documentation is no longer updated. For further details, see our [technical support periods](https://helpx.adobe.com/br/support/programs/eol-matrix.html). Find the supported versions [here](https://experienceleague.adobe.com/docs/?lang=pt-BR).
$ sed -n "s/.*(aem-analytics-integration-last30Days).*target=\(.*\),interval.*/\1/p" error.log | wc -l
14531
# Count unique paths of PollingImporter registrations

>[!CAUTION]
>
>AEM 6.4 has reached the end of extended support and this documentation is no longer updated. For further details, see our [technical support periods](https://helpx.adobe.com/br/support/programs/eol-matrix.html). Find the supported versions [here](https://experienceleague.adobe.com/docs/?lang=pt-BR).
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 superiores (altas na hierarquia) têm uma configuração do Analytics referenciada.

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

Problemas do DTM (herdado) dtm-legacy-issues

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

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

Solução solution-2

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

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

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

O conteúdo direcionado não é 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 cliente corretas que manipulam 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 do analytics necessários e carrega as bibliotecas do cloud service associadas ao site. Para o serviço do Target, as bibliotecas são carregadas por meio da variável /libs/cq/analytics/components/testandtarget/headlibs.jsp

O conjunto de bibliotecas que são carregadas depende do tipo de biblioteca do cliente de destino ( mbox.js ou at.js) usada na configuração do Target.

Ao usar o DTM para entregar mbox.js ou at.js verifique se as bibliotecas estão carregadas antes da renderização do conteúdo. 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 Target.

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

O erro "ID de conjunto de relatórios ausente 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 aparecer quando o Adobe Analytics é implementado no site usando o DTM e usa o Código personalizado. A causa é usar a variável s = new AppMeasurement() para instanciar o s objeto.

Solução solution-4

Use s_gi em vez de new AppMeasurement método de instanciação. 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 a 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 pronto para uso não é compatível com o AT.js versão 1.3.0+. Com a at.js versão 1.3.0 introduzindo a validação de parâmetros para suas APIs, adobe.target.applyOffer() requer um parâmetro "mbox" que não é fornecido pelo atjs-itegration.js código.

Solução solution-6

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

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

Esse problema provavelmente é Configuração do A4T Analytics Cloud problema de provisionamento.

Solução solution-7

Você precisa verificar se o A4T está ativado corretamente para sua conta do Target, 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, contance Atendimento ao cliente do Adobe para provisionar a conta corretamente.

APIs úteis do Target helpful-target-apis

Abaixo estão apresentadas duas APIs do Target que podem ser úteis na solução de 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"
    ]
}