Problemen met integratie oplossen troubleshooting-integration-issues
Algemene tips voor probleemoplossing general-troubleshooting-tips
Zorg ervoor dat er geen JavaScript-fouten zijn ensure-there-are-no-javascript-errors
Controleer of de JavaScript-console van de browser fouten weergeeft. Onverwerkte fouten kunnen voorkomen dat de volgende code correct wordt uitgevoerd. Als er fouten optreden, controleert u welk script de fout veroorzaakt en op welk gebied. Het pad naar het script kan aangeven tot welke functionaliteit het script behoort.
Aanmelden op componentniveau logging-on-component-level
In sommige gevallen is het handig om aanvullende instructies op componentniveau toe te voegen. Aangezien de component wordt teruggegeven, kunt u een tijdelijke prijsverhoging toevoegen om veranderlijke waarden te tonen die u zouden kunnen helpen potentiële problemen identificeren. Bijvoorbeeld:
<%
log.info("myVariable={}", myVariable);
%>
<!--
<%= myJspVariable %>
-->
<!--
${ myHtlVariable }
-->
Voor extra details over het registreren, zie het Registreren en het Werken met de Verslagen van de Controle en de pagina's van de Dossiers van het Logboek .
Problemen met analytische integratie analytics-integration-issues
De rapportimportmodule leidt tot een hoog CPU-/geheugengebruik the-report-importer-causes-high-cpu-memory-usage
De rapportimportmodule veroorzaakt een hoog CPU-/geheugengebruik of veroorzaakt OutOfMemoryError -uitzonderingen.
Oplossing solution
U kunt het volgende proberen om dit probleem op te lossen:
- Zorg ervoor dat er geen grote hoeveelheid geregistreerde PollingImporters is (zie de sectie "Sluiting duurt lang toe te schrijven aan PollingImporter" hieronder).
- De Importeurs van het Rapport van de looppas op een bepaald tijdstip van de dag door CRON uitdrukkingen voor de
ManagedPollingImporterconfiguraties in de console OSGi te gebruiken.
Voor extra details over het creëren van de diensten van de douanegegevensimporteur in AEM, lees het volgende artikel https://helpx.adobe.com/experience-manager/using/polling.html .
Het afsluiten duurt lang vanwege de PollingImporter shutdown-takes-a-long-time-due-to-the-pollingimporter
Analyses zijn ontworpen met het oog op een overervingsmechanisme. Gewoonlijk, laat u Analytics voor een plaats toe door een verwijzing naar een configuratie van Analytics binnen de pagina eigenschappen Cloud Servicen tabel toe te voegen. De configuratie wordt dan automatisch overgeërfd aan alle subpagina's zonder de behoefte om het opnieuw te verwijzen tenzij een pagina een verschillende configuratie vereist. Als u een verwijzing naar een site toevoegt, worden ook automatisch meerdere knooppunten gemaakt (12 voor AEM 6.3 en lager of 6 voor AEM 6.4) en hoger) van het type cq;PollConfig dat PollingImporters instantieert die worden gebruikt om analysegegevens in AEM te importeren. Dientengevolge:
- Veel pagina's die verwijzen naar Analytics leiden tot een grote hoeveelheid PollingImporters.
- Bovendien, leidt het kopiëren en het kleven van pagina's met een verwijzing naar een configuratie van Analytics tot een verdubbeling van zijn PollingImporters.
Oplossing solution-1
Ten eerste, zou het analyseren van error.log u wat inzicht over de hoeveelheid actieve of geregistreerde PollingImporters kunnen geven. Bijvoorbeeld:
# 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
Ten tweede, zorg ervoor dat slechts top-pagina's (hoog in de hiërarchie) een analytische configuratie hebben van verwijzingen voorzien.
Voor extra details over het creëren van de diensten van de douanegegevensimporteur in AEM, lees het volgende artikel https://helpx.adobe.com/experience-manager/using/polling.html .
DTM-problemen (verouderd) dtm-legacy-issues
De DTM-scripttag wordt niet weergegeven in de paginabron the-dtm-script-tag-is-not-rendered-in-the-page-source
De DTM manuscriptmarkering is niet behoorlijk inbegrepen in de pagina alhoewel de configuratie in de pagina eigenschappen Cloud Servicen tabel van van verwijzingen is voorzien.
Oplossing solution-2
U kunt het volgende proberen om het probleem op te lossen:
-
Zorg ervoor dat gecodeerde eigenschappen kunnen worden gedecodeerd (gebruik een andere automatisch gegenereerde sleutel voor elke AEM). Voor extra details, lees ook Steun van de Encryptie voor de Eigenschappen van de Configuratie .
-
De configuraties in
/etc/cloudservices/dynamictagmanagementopnieuw publiceren -
Controleer ACLs op
/etc/cloudservices. ACLs zou moeten zijn:- allow; jcr:read; webservice-support-servicelibfinder
- allow; jcr:read; all;
rep:glob:*/defaults/* - allow; jcr:read; all;
rep:glob:*/defaults - allow; jcr:read; all;
rep:glob:*/public/* - allow; jcr:read; all;
rep:glob:*/public
Voor meer informatie over het beheren van ACLs, lees het Beleid van de Gebruiker en de pagina van de Veiligheid .
Problemen met doelintegratie target-integration-issues
Gerichte inhoud niet zichtbaar in de modus Voorbeeld bij gebruik van aangepaste pagina-componenten targeted-content-not-visible-in-preview-mode-when-using-custom-page-components
Dit probleem treedt op omdat aangepaste paginacomponenten niet de juiste JSP- of clientbibliotheken bevatten die de DTM-integratie van het doel afhandelen.
Oplossing solution-3
U kunt de volgende oplossingen uitproberen:
- Zorg ervoor dat de aangepaste instructie
headlibs.jsp(indien van toepassing/apps/<CUSTOM-COMPONENTS-PATH>/headlibs.jsp) het volgende bevat:
<%@include file="/libs/cq/cloudserviceconfigs/components/servicelibs/servicelibs.jsp" %>
<sly data-sly-resource="${'contexthub' @ resourceType='granite/contexthub/components/contexthub'}"/>
- Zorg ervoor douane
head.html(als om het even welk/apps/<CUSTOM-COMPONENTS-PATH>/head.html) niet selectief specifieke integratiekoplampen zoals het hieronder voorbeeld omvat:
<!-- DO NOT MANUALLY INCLUDE SPECIFIC CLOUD SERVICE HEADLIBS LIKE THIS -->
<meta data-sly-include="/libs/cq/dtm/components/dynamictagmanagement/headlibs.jsp" data-sly-unwrap/>
In servicelibs.jsp worden de vereiste JavaScript-analyseobjecten toegevoegd en worden de aan de website gekoppelde cloudservicebibliotheken geladen. Voor de service Doel worden de bibliotheken geladen via de map /libs/cq/analytics/components/testandtarget/headlibs.jsp
De set bibliotheken die worden geladen, is afhankelijk van het type doelclientbibliotheek ( mbox.js of at.js ) dat in de doelconfiguratie wordt gebruikt.
Wanneer u DTM gebruikt voor levering mbox.js of at.js , moet u ervoor zorgen dat de bibliotheken zijn geladen voordat de inhoud wordt gerenderd. Het gebruik van Tag Management Systems dat deze bibliotheken asynchroon laadt, kan problemen veroorzaken bij het uitvoeren van de specifieke JavaScript-doelcode.
Voor extra informatie, lees het Ontwikkelen voor de gerichte inhoud pagina.
De fout "Ontbrekende ID van de Reeks van het Rapport in de initialisering van het AppMeasurement"wordt getoond in de browser console the-error-missing-report-suite-id-in-appmeasurement-initialization-is-displayed-in-the-browser-console
Dit probleem kan optreden wanneer Adobe Analytics op de website wordt geïmplementeerd met DTM en aangepaste code gebruikt. De oorzaak gebruikt s = new AppMeasurement() om het s -object te instantiëren.
Oplossing solution-4
Gebruik s_gi in plaats van de new AppMeasurement -instantiemethode. Bijvoorbeeld:
var s_account="INSERT-RSID-HERE"
var s=s_gi(s_account)
Er wordt willekeurig een standaardvoorstel weergegeven in plaats van de juiste aanbieding a-default-offer-is-randomly-displayed-instead-of-the-correct-offer
Dit probleem kan meerdere oorzaken hebben:
-
Het asynchroon laden van doelclientbibliotheken (
mbox.jsofat.js) met Tag Management Systems van derden kan willekeurig een doeleinde maken. De doelbibliotheken moeten synchroon in de paginakop worden geladen. Dit geldt altijd wanneer de bibliotheken worden geleverd vanuit AEM. -
Twee doelclientbibliotheken (
at.js) tegelijk laden, bijvoorbeeld één met DTM en één met de doelconfiguratie in AEM. Dit kan tot klassen voor deadobe.targetdefinitie leiden als deat.jsversies verschillen.
Oplossing solution-5
U kunt de volgende oplossingen uitproberen:
- Zorg ervoor de klantencode die de DTM-als bibliotheken laadt (die beurtelings de bibliotheken van het Doel laden) synchroon in het paginakop wordt uitgevoerd.
- als de plaats wordt gevormd om DTM te gebruiken om de bibliotheken van het Doel te leveren ervoor zorgen dat de Clientlib die door DTM optie wordt geleverd in de configuratie van het Doel voor de plaats wordt gecontroleerd.
Een standaardaanbieding wordt altijd getoond in plaats van correcte aanbieding wanneer het gebruiken van AT.js 1.3+ a-default-offer-is-always-displayed-instead-of-correct-offer-when-using-at-js
Uit het vak AEM 6.2 en 6.3 is niet compatibel met AT.js versie 1.3.0+. Met AT.js versie 1.3.0 die parameterbevestiging voor zijn APIs introduceert, adobe.target.applyOffer() vereist een "mbox"parameter die niet door de atjs-itegration.js code wordt verstrekt.
Oplossing solution-6
U lost dit probleem op door atjs-itegration.js te bewerken en het veld "mbox": mboxName in het parameterobject voor adobe.target.applyOffer() als volgt toe te voegen:
adobe.target.getOffer({
"mbox": mboxName,
"params": params,
"success": function (response) {
adobe.target.applyOffer({
"mbox": mboxName, //<--- ADDED PARAM
"selector": "#" + mboxName,
"offer": response
})
},
De pagina van Doelstellingen & van Montages toont niet de sectie van Rapporteringsbronnen the-goals-settings-page-does-not-show-the-reporting-sources-section
Deze kwestie is zeer waarschijnlijk een A4T Analytics Cloud 1} leveringskwestie van de Configuratie van de Configuratie.
Oplossing solution-7
U moet controleren of A4T correct is ingeschakeld voor uw Target-account door het volgende verificatieverzoek aan AEM uit te voeren:
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"
}
Als de reactie de lijn a4tEnabled:false bevat, de Zorg van de Klant van de Adobe 🔗 om uw rekening te krijgen die correct wordt voorzien.
Nuttige doel-API's helpful-target-apis
Hieronder ziet u twee doel-API's die nuttig kunnen zijn bij het oplossen van problemen met betrekking tot het doel:
- Wint het eindpunt van het Doel voor een bepaalde cliëntcode terug
https://admin.testandtarget.omniture.com/rest/v1/endpoint/<CLIENTCODE>.json
{"api":"https://admin<N>.testandtarget.omniture.com/admin/rest/v1"}
- Profiel van een client ophalen
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"
]
}