Risoluzione dei problemi di integrazione troubleshooting-integration-issues

Suggerimenti generali per la risoluzione dei problemi general-troubleshooting-tips

Verifica che non siano presenti errori JavaScript ensure-there-are-no-javascript-errors

Controlla se nella console JavaScript del browser sono visualizzati errori. Errori non gestiti potrebbero impedire la corretta esecuzione del codice successivo. In caso di errori, controlla lo script che causa l’errore e in quale area. Il percorso dello script potrebbe fornire un’indicazione della funzionalità a cui appartiene lo script.

Accesso a livello di componente logging-on-component-level

In alcuni casi, potrebbe essere utile aggiungere istruzioni aggiuntive a livello di componente. Poiché è stato eseguito il rendering del componente, è possibile aggiungere un markup temporaneo per visualizzare i valori delle variabili che potrebbero aiutare a identificare potenziali problemi. Ad esempio:

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

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

<!--
${ myHtlVariable }
-->

Per ulteriori dettagli sulla registrazione, vedere le pagine Registrazione e Utilizzo dei record di controllo e dei file di registro.

Problemi di integrazione di Analytics analytics-integration-issues

Importazione report causa un elevato utilizzo di CPU/memoria the-report-importer-causes-high-cpu-memory-usage

Importazione report causa un elevato utilizzo di CPU/memoria o OutOfMemoryError eccezioni.

Soluzione solution

Per risolvere il problema, provare a effettuare le seguenti operazioni:

Per ulteriori informazioni sulla creazione di servizi di importazione dati personalizzati in AEM, leggere l'articolo seguente https://helpx.adobe.com/experience-manager/using/polling.html.

L'arresto richiede molto tempo a causa di Importazione polling shutdown-takes-a-long-time-due-to-the-pollingimporter

Analytics è stato progettato pensando a un meccanismo di ereditarietà. In genere, per abilitare Analytics per un sito si aggiunge un riferimento a una configurazione Analytics nella scheda Cloud Service delle proprietà della pagina. La configurazione viene quindi ereditata automaticamente da tutte le sottopagine senza dover fare nuovamente riferimento ad essa, a meno che una pagina non richieda una configurazione diversa. L’aggiunta di un riferimento a un sito crea automaticamente anche diversi nodi (12 per AEM 6.3 e versioni precedenti o 6 per AEM 6.4 e versioni successive) del tipo cq;PollConfig che crea un'istanza di PollingImporters utilizzata per importare dati di Analytics in AEM. Di conseguenza:

Soluzione solution-1

In primo luogo, l'analisi di error.log potrebbe fornire informazioni approfondite sulla quantità di PollingImporters attivi o registrati. Ad esempio:

# 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

In secondo luogo, assicurati che solo le pagine superiori (in alto nella gerarchia) contengano un riferimento alla configurazione di Analytics.

Per ulteriori informazioni sulla creazione di servizi di importazione dati personalizzati in AEM, leggere l'articolo seguente https://helpx.adobe.com/experience-manager/using/polling.html.

Problemi DTM(Legacy) dtm-legacy-issues

Il tag dello script DTM non viene renderizzato nell’origine della pagina the-dtm-script-tag-is-not-rendered-in-the-page-source

Il tag di script DTM non è incluso correttamente nella pagina anche se nella scheda delle proprietà della pagina Cloud Service è stato fatto riferimento alla configurazione.

Soluzione solution-2

Per risolvere il problema, puoi provare a effettuare le seguenti operazioni:

Per ulteriori informazioni sulla gestione degli ACL, leggere la pagina Amministrazione utenti e sicurezza.

Problemi di integrazione di Target target-integration-issues

Contenuto mirato non visibile in modalità Anteprima quando si utilizzano componenti pagina personalizzati targeted-content-not-visible-in-preview-mode-when-using-custom-page-components

Questo problema si verifica perché i componenti pagina personalizzati non includono le librerie JSP o client corrette che gestiscono le integrazioni Target DTM.

Soluzione solution-3

Puoi provare le seguenti soluzioni:

<%@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/>

servicelibs.jsp aggiunge gli oggetti JavaScript di analisi richiesti e carica le librerie del servizio cloud associate al sito Web. Per il servizio Target, le librerie vengono caricate tramite /libs/cq/analytics/components/testandtarget/headlibs.jsp

Il set di librerie caricate dipende dal tipo di libreria client di destinazione ( mbox.js o at.js) utilizzata nella configurazione di destinazione.

Quando utilizzi DTM per distribuire mbox.js o at.js, accertati che le librerie siano caricate prima del rendering del contenuto. L’utilizzo di sistemi Tag Management per caricare queste librerie in modo asincrono potrebbe causare problemi nell’esecuzione del codice JavaScript specifico di destinazione.

Per ulteriori informazioni, leggere la pagina Sviluppo per contenuti di destinazione.

Nella console del browser viene visualizzato l’errore "Manca l’ID Report Suite nell’inizializzazione di AppMeasurement" the-error-missing-report-suite-id-in-appmeasurement-initialization-is-displayed-in-the-browser-console

Questo problema può verificarsi quando Adobe Analytics viene implementato sul sito web utilizzando DTM e utilizza un codice personalizzato. La causa sta utilizzando s = new AppMeasurement() per creare un'istanza dell'oggetto s.

Soluzione solution-4

Utilizzare s_gi al posto del metodo di creazione istanza new AppMeasurement. Ad esempio:

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

Un’offerta predefinita viene visualizzata in modo casuale al posto dell’offerta corretta a-default-offer-is-randomly-displayed-instead-of-the-correct-offer

Questo problema può avere diverse cause:

Soluzione solution-5

Puoi provare le seguenti soluzioni:

Viene sempre visualizzata un’offerta predefinita invece dell’offerta corretta quando si utilizza AT.js 1.3+ a-default-offer-is-always-displayed-instead-of-correct-offer-when-using-at-js

AEM 6.2 e 6.3 non sono compatibili con AT.js versione 1.3.0+. Con la versione 1.3.0 di AT.js che introduce la convalida dei parametri per le API, adobe.target.applyOffer() richiede un parametro "mbox" non fornito dal codice atjs-itegration.js.

Soluzione solution-6

Per risolvere il problema, modificare atjs-itegration.js e aggiungere il campo "mbox": mboxName nell'oggetto parametro per adobe.target.applyOffer() come segue:

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

La pagina Obiettivi e impostazioni non mostra la sezione Origini di reporting the-goals-settings-page-does-not-show-the-reporting-sources-section

Questo problema è probabilmente un problema di provisioning di Configurazione A4T Analytics Cloud.

Soluzione solution-7

Verifica che A4T sia abilitato correttamente per il tuo account Target emettendo la seguente richiesta di verifica all’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 la risposta contiene la riga a4tEnabled:false, contatta l'Assistenza clienti Adobe per il corretto provisioning dell'account.

API di Target utili helpful-target-apis

Di seguito sono presentate due API di Target che potrebbero essere utili per la risoluzione dei problemi di 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"
    ]
}