Fehlerbehebung für Integrationsprobleme troubleshooting-integration-issues

Allgemeine Tipps zur Problembehebung general-troubleshooting-tips

Sicherstellen, dass es keine JavaScript-Fehler gibt ensure-there-are-no-javascript-errors

Überprüfen Sie, ob in der JavaScript-Konsole des Browsers Fehler angezeigt werden. Nicht behobene Fehler können verhindern, dass der nachfolgende Code ordnungsgemäß ausgeführt wird. Wenn Fehler angezeigt werden, überprüfen Sie, welches Skript den Fehler verursacht und in welchem Bereich. Der Pfad zum Skript weist möglicherweise darauf hin, zu welcher Funktion das Skript gehört.

Protokollierung auf Komponentenebene logging-on-component-level

In einigen Fällen kann es hilfreich sein, zusätzliche Anweisungen auf der Komponentenebene hinzuzufügen. Da die Komponente gerendert wird, können Sie ein temporäres Markup hinzufügen, um Variablenwerte anzuzeigen, die Ihnen bei der Erkennung potenzieller Probleme helfen können. Beispiel:

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

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

<!--
${ myHtlVariable }
-->

Weitere Informationen zu Protokollierung finden Sie auf den Seiten Protokollierung und Arbeiten mit Auditdatensätzen und Protokolldateien.

Probleme bei der Analytics-Integration analytics-integration-issues

Der Report Importer führt zu hoher CPU-/Speichernutzung the-report-importer-causes-high-cpu-memory-usage

Der Report Importer verursacht hohe CPU-/Speichernutzung oder OutOfMemoryError-Ausnahmefehler.

Lösung solution

Um dieses Problem zu beheben, können Sie Folgendes versuchen:

Weitere Informationen zum Erstellen benutzerdefinierter Datenimportdienste in AEM finden Sie im Artikel https://helpx.adobe.com/experience-manager/using/polling.html.

Herunterfahren dauert aufgrund von PollingImporter lange shutdown-takes-a-long-time-due-to-the-pollingimporter

Analytics wurde basierend auf einem Vererbungsmechanismus entwickelt. In der Regel aktivieren Sie Analytics für eine Site, indem Sie in den Seiteneigenschaften auf der Registerkarte Cloud-Services einen Verweis zu einer Analytics-Konfiguration hinzufügen. Die Konfiguration wird dann automatisch auf alle Unterseiten vererbt, ohne dass sie erneut referenziert werden muss, es sei denn, eine Seite erfordert eine andere Konfiguration. Durch Hinzufügen einer Referenz zu einer Website werden auch automatisch mehrere Knoten (12 für AEM 6.3 und früher bzw. 6 für AEM 6.4) des Typs cq;PollConfig erstellt, der PollingImporter-Instanzen generiert, mit denen Analytics-Daten in AEM importiert werden. Das Ergebnis ist:

Lösung solution-1

Zunächst einmal zeigt Ihnen die Analyse von error.log möglicherweise die Anzahl der aktiven oder registrierten PollingImporter-Instanzen. Beispiel:

# 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

Stellen Sie außerdem sicher, dass nur Seiten der obersten Ebene (oben in der Hierarchie) auf eine Analytics-Konfiguration verweisen.

Weitere Informationen zum Erstellen benutzerdefinierter Datenimportdienste in AEM finden Sie im Artikel https://helpx.adobe.com/experience-manager/using/polling.html.

Probleme mit DTM (Legacy) dtm-legacy-issues

Skript-Tag „DTM“ wird in der Seitenquelle nicht gerendert the-dtm-script-tag-is-not-rendered-in-the-page-source

Das Skript-Tag DTM wird nicht ordnungsgemäß auf der Seite eingefügt, obwohl auf der Registerkarte Cloud-Services der Seiteneigenschaften auf die Konfiguration verwiesen wurde.

Lösung solution-2

Um das Problem zu beheben, können Sie Folgendes versuchen:

Weitere Informationen zur Verwaltung von ACLs finden Sie auf der Seite Benutzerverwaltung und Sicherheit.

Probleme bei der Integration in Target target-integration-issues

Zielgerichtete Inhalte sind im Vorschaumodus nicht sichtbar, wenn benutzerdefinierte Seitenkomponenten verwendet werden targeted-content-not-visible-in-preview-mode-when-using-custom-page-components

Dieses Problem tritt auf, da benutzerdefinierte Seitenkomponenten nicht die richtigen JSP- oder Client-Bibliotheken zum Verarbeiten der Target-DTM-Integrationen enthalten.

Lösung solution-3

Sie können die folgenden Lösungen ausprobieren:

<%@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 fügt die erforderlichen JavaScript-Analyseobjekte hinzu und lädt die Cloud-Service-Bibliotheken, die mit der Website verbunden sind. Für den Target-Service werden die Bibliotheken über die /libs/cq/analytics/components/testandtarget/headlibs.jsp geladen.

Die geladenen Bibliotheken hängen von der Art der Ziel-Client-Bibliothek (mbox.js oder at.js) ab, die in der Target-Konfiguration verwendet wird.

Wenn Sie DTM zur Bereitstellung von mbox.js oder at.js verwenden, stellen Sie sicher, dass die Bibliotheken geladen werden, bevor der Inhalt gerendert wird. Die Verwendung von Tag-Management-Systemen, die diese Bibliotheken asynchron laden, kann zu Problemen bei der Ausführung des zielspezifischen JavaScript-Codes führen.

Weitere Informationen finden Sie auf der Seite Entwicklung für zielgerichtete Inhalte.

Fehler „Fehlende Report Suite-ID in AppMeasurement-Initialisierung“ in der Browser-Konsole the-error-missing-report-suite-id-in-appmeasurement-initialization-is-displayed-in-the-browser-console

Dieses Problem kann auftreten, wenn Adobe Analytics auf der Website mithilfe von DTM implementiert wird und benutzerdefinierten Code verwendet. Die Ursache dafür ist die Verwendung von s = new AppMeasurement() zum Instanziieren des s-Objekts.

Lösung solution-4

Verwenden Sie s_gi anstelle der Instanziierungsmethode new AppMeasurement. Beispiel:

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

Ein Standardangebot wird nach dem Zufallsprinzip anstelle des richtigen Angebots angezeigt a-default-offer-is-randomly-displayed-instead-of-the-correct-offer

Dieses Problem kann mehrere Ursachen haben:

Lösung solution-5

Sie können die folgenden Lösungen ausprobieren:

Bei Verwendung von AT.js ab Version 1.3 wird immer ein Standardangebot anstelle des richtigen Angebots angezeigt a-default-offer-is-always-displayed-instead-of-correct-offer-when-using-at-js

Standardmäßig sind AEM 6.2 und 6.3 nicht mit AT.js der Version 1.3.0 oder höher kompatibel. Ab AT.js Version 1.3.0 wird eine Parametervalidierung für die APIs eingeführt, d. h. adobe.target.applyOffer() muss einen „mbox“-Parameter enthalten, der vom atjs-itegration.js-Code nicht bereitgestellt wird.

Lösung solution-6

Um dieses Problem zu beheben, bearbeiten Sie atjs-itegration.js und fügen Sie das Feld "mbox": mboxName im Parameterobjekt für adobe.target.applyOffer() hinzu:

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

Auf der Seite „Ziele und Einstellungen“ wird der Abschnitt „Berichtsquellen“ nicht angezeigt the-goals-settings-page-does-not-show-the-reporting-sources-section

Dieses Problem ist höchstwahrscheinlich ein Bereitstellungsproblem mit der A4T-Analytics-Cloud-Konfiguration.

Lösung solution-7

Sie müssen sicherstellen, dass A4T für Ihr Target-Konto ordnungsgemäß aktiviert ist, indem Sie die folgende Überprüfungsanfrage an AEM senden:

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

Wenn die Antwort die Zeile a4tEnabled:false enthält, wenden Sie sich an die Adobe-Kundenunterstützung,, um die Bereitstellung Ihres Kontos zu korrigieren.

Nützliche Target-APIs helpful-target-apis

Nachfolgend werden zwei Target-APIs vorgestellt, die bei der Behebung von Target-Problemen hilfreich sein können:

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