Felsöka integreringsproblem troubleshooting-integration-issues

Allmänna felsökningstips general-troubleshooting-tips

Kontrollera att det inte finns några JavaScript-fel ensure-there-are-no-javascript-errors

Kontrollera om webbläsarens JavaScript-konsol visar några fel. Ohanterade fel kan förhindra att efterföljande kod körs korrekt. Om fel uppstår ska du kontrollera vilket skript som orsakar felet och i vilket område. Sökvägen till skriptet kan ge en indikation på vilken funktion skriptet tillhör.

Inloggning på komponentnivå logging-on-component-level

I vissa fall kan det vara praktiskt att lägga till ytterligare programsatser på komponentnivå. Eftersom komponenten återges kan du lägga till en temporär markering för att visa variabelvärden som kan hjälpa dig att identifiera potentiella problem. Till exempel:

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

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

<!--
${ myHtlVariable }
-->

Mer information om loggning finns på sidorna Loggning och Arbeta med Granskningsposter och Loggfiler.

Integreringsproblem med analyser analytics-integration-issues

Rapportimporteraren orsakar hög CPU-/minnesanvändning the-report-importer-causes-high-cpu-memory-usage

Rapportimporteraren orsakar hög CPU-/minnesanvändning eller orsakar OutOfMemoryError undantag.

Lösning solution

Du kan åtgärda problemet genom att prova följande:

Mer information om hur du skapar anpassade dataimporteringstjänster i AEM finns i följande artikel: https://helpx.adobe.com/experience-manager/using/polling.html.

Avstängningen tar lång tid på grund av PollingImporter shutdown-takes-a-long-time-due-to-the-pollingimporter

Analyserna har utformats med en arvsmekanism i åtanke. Vanligtvis aktiverar du Analytics för en webbplats genom att lägga till en referens till en Analytics-konfiguration på fliken Cloud Service i sidegenskaperna. Konfigurationen ärvs sedan automatiskt till alla undersidor utan att du behöver referera till den igen, såvida inte en sida kräver en annan konfiguration. När du lägger till en referens till en plats skapas också automatiskt flera noder (12 för AEM 6.3 och tidigare eller 6 för AEM 6.4) och senare) av typen cq;PollConfig som instansierar PollingImporters som används för att importera Analytics-data till AEM. Resultatet blir:

Lösning solution-1

För det första kan en analys av error.log ge dig insikt i mängden aktiva eller registrerade PollingImporters. Till exempel:

# 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

För det andra måste du se till att endast de översta sidorna (högst upp i hierarkin) har en analyskonfiguration som refereras.

Mer information om hur du skapar anpassade dataimporteringstjänster i AEM finns i följande artikel: https://helpx.adobe.com/experience-manager/using/polling.html.

DTM-problem (äldre) dtm-legacy-issues

DTM-skripttaggen återges inte i sidkällan the-dtm-script-tag-is-not-rendered-in-the-page-source

Skripttaggen DTM inkluderas inte korrekt på sidan trots att konfigurationen har refererats till på fliken Cloud Service i sidegenskaperna.

Lösning solution-2

Du kan försöka åtgärda problemet genom att göra följande:

Mer information om hur du hanterar åtkomstkontrollistor finns på sidan Användaradministration och -säkerhet.

Målintegreringsproblem target-integration-issues

Målinriktat innehåll som inte visas i förhandsgranskningsläget när anpassade sidkomponenter används targeted-content-not-visible-in-preview-mode-when-using-custom-page-components

Problemet inträffar eftersom anpassade sidkomponenter inte innehåller rätt JSP- eller klientbibliotek som hanterar DTM-målintegreringarna.

Lösning solution-3

Du kan testa följande lösningar:

<%@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 lägger till de nödvändiga analysobjekten för JavaScript och läser in molntjänstbiblioteken som är kopplade till webbplatsen. För måltjänsten läses biblioteken in via /libs/cq/analytics/components/testandtarget/headlibs.jsp

Vilken biblioteksuppsättning som läses in beror på vilken typ av målklientbibliotek ( mbox.js eller at.js) som används i målkonfigurationen.

När du använder DTM för att leverera mbox.js eller at.js måste du se till att biblioteken läses in innan innehållet återges. Om du använder Tag Management Systems som läser in dessa bibliotek asynkront kan det uppstå problem när du kör den målspecifika JavaScript-koden.

Mer information finns på sidan Utveckla för riktat innehåll.

Felmeddelandet"Report Suite ID saknas i AppMeasurementet initieras" visas i webbläsarkonsolen the-error-missing-report-suite-id-in-appmeasurement-initialization-is-displayed-in-the-browser-console

Problemet kan uppstå när Adobe Analytics implementeras på webbplatsen med DTM och använder anpassad kod. Orsaken är att s = new AppMeasurement() används för att instansiera s-objektet.

Lösning solution-4

Använd s_gi i stället för instansieringsmetoden new AppMeasurement. Till exempel:

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

Ett standarderbjudande visas slumpmässigt i stället för rätt erbjudande a-default-offer-is-randomly-displayed-instead-of-the-correct-offer

Det här problemet kan ha flera orsaker:

Lösning solution-5

Du kan testa följande lösningar:

Ett standarderbjudande visas alltid i stället för rätt erbjudande när AT.js 1.3+ används a-default-offer-is-always-displayed-instead-of-correct-offer-when-using-at-js

Ut ur kartongen AEM 6.2 och 6.3 är inte kompatibla med AT.js version 1.3.0+. Med AT.js version 1.3.0 som inför parametervalidering för sina API:er, kräver adobe.target.applyOffer() en mbox-parameter som inte anges av atjs-itegration.js-koden.

Lösning solution-6

Lös problemet genom att redigera atjs-itegration.js och lägga till fältet "mbox": mboxName i parameterobjektet för adobe.target.applyOffer() enligt följande:

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

Sidan Mål och inställningar visar inte avsnittet Rapporteringskällor the-goals-settings-page-does-not-show-the-reporting-sources-section

Det här problemet är troligen ett A4T Analytics Cloud Configuration -etableringsproblem.

Lösning solution-7

Du måste verifiera att A4T är korrekt aktiverat för ditt Target-konto genom att skicka följande verifieringsbegäran till 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"
}

Om svaret innehåller raden a4tEnabled:false kan du kontakta Adobe kundtjänst för att få ditt konto etablerat korrekt.

Användbara mål-API:er helpful-target-apis

Nedan visas två mål-API:er som kan vara användbara vid felsökning av Target-problem:

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