통합 문제 해결 troubleshooting-integration-issues

일반 문제 해결 팁 general-troubleshooting-tips

JavaScript 오류가 없는지 확인합니다. ensure-there-are-no-javascript-errors

브라우저의 JavaScript 콘솔에 오류가 표시되는지 확인합니다. 처리되지 않은 오류로 인해 후속 코드가 제대로 실행되지 않을 수 있습니다. 오류가 있는 경우 오류를 일으키는 스크립트와 영역을 확인합니다. 스크립트 경로는 스크립트가 속한 기능을 나타낼 수 있습니다.

구성 요소 수준 로그온 logging-on-component-level

경우에 따라 구성 요소 수준에서 문을 추가하는 것이 도움이 될 수 있습니다. 구성 요소가 렌더링되므로 잠재적인 문제를 식별하는 데 도움이 될 수 있는 변수 값을 표시하는 임시 마크업을 추가할 수 있습니다. 예:

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

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

<!--
${ myHtlVariable }
-->

로깅에 대한 자세한 내용은 로깅 및 감사 레코드 및 로그 파일 작업 페이지.

Analytics 통합 문제 analytics-integration-issues

보고서 임포터로 인해 CPU/메모리 사용량이 많음 the-report-importer-causes-high-cpu-memory-usage

Report Importer로 인해 CPU/메모리 사용량이 많거나 OutOfMemoryError 예외입니다.

솔루션 solution

이 문제를 해결하려면 다음을 시도해 보십시오.

AEM에서 사용자 지정 데이터 가져오기 서비스를 만드는 방법에 대한 자세한 내용은 다음 문서를 참조하십시오 https://helpx.adobe.com/experience-manager/using/polling.html.

PollingImporter로 인해 종료가 오래 걸립니다. shutdown-takes-a-long-time-due-to-the-pollingimporter

Analytics는 상속 메커니즘을 고려하여 설계되었습니다. 일반적으로 페이지 속성 내에 Analytics 구성에 대한 참조를 추가하여 사이트에 대한 Analytics를 활성화합니다 Cloud Service 탭. 그런 다음 페이지에 다른 구성이 필요하지 않으면 다시 참조할 필요 없이 구성이 모든 하위 페이지에 자동으로 상속됩니다. 사이트에 참조를 추가하면 유형의 여러 노드(AEM 6.3 및 이전 버전에서는 12개, AEM 6.4 이상에서는 6개)도 자동으로 만들어집니다 cq;PollConfig Analytics 데이터를 AEM으로 가져오는 데 사용되는 PollingImporters를 인스턴스화합니다. 그 결과는 다음과 같습니다.

솔루션 solution-1

첫 번째, 분석 error.log 은 활성 또는 등록된 PollingImporter 양에 대한 통찰력을 제공할 수 있습니다. 예:

# 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

두 번째로, 최상위 페이지(계층 구조 상단에 있음)에만 Analytics 구성이 참조되었는지 확인합니다.

AEM에서 사용자 지정 데이터 가져오기 서비스를 만드는 방법에 대한 자세한 내용은 다음 문서를 참조하십시오 https://helpx.adobe.com/experience-manager/using/polling.html.

DTM(이전) 문제 dtm-legacy-issues

DTM 스크립트 태그가 페이지 소스에서 렌더링되지 않습니다 the-dtm-script-tag-is-not-rendered-in-the-page-source

다음 DTM 페이지 속성에서 구성을 참조했더라도 스크립트 태그가 페이지에 제대로 포함되지 않았습니다. Cloud Service 탭.

솔루션 solution-2

문제를 해결하려면 다음을 시도해 보십시오.

ACL 관리에 대한 자세한 내용은 사용자 관리 및 보안 페이지를 가리키도록 업데이트하는 중입니다.

Target 통합 문제 target-integration-issues

사용자 지정 페이지 구성 요소를 사용할 때 타겟팅된 콘텐츠가 미리보기 모드에 표시되지 않음 targeted-content-not-visible-in-preview-mode-when-using-custom-page-components

이 문제는 사용자 지정 페이지 구성 요소에 Target DTM 통합을 처리하는 올바른 JSP 또는 클라이언트 라이브러리가 포함되지 않기 때문에 발생합니다.

솔루션 solution-3

다음 솔루션을 시도할 수 있습니다.

<%@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 필요한 analytics JavaScript 개체를 추가하고 웹 사이트와 연결된 클라우드 서비스 라이브러리를 로드합니다. Target 서비스의 경우 라이브러리는 /libs/cq/analytics/components/testandtarget/headlibs.jsp

로드되는 라이브러리 세트는 타겟 클라이언트 라이브러리( )의 유형에 따라 다릅니다. mbox.js 또는 at.js) Target 구성에 사용됩니다.

DTM을 사용하여 게재 시 mbox.js 또는 at.js 컨텐츠가 렌더링되기 전에 라이브러리가 로드되었는지 확인합니다. 이러한 라이브러리를 비동기적으로 로드하는 Tag Management 시스템을 사용하면 타겟 특정 JavaScript 코드를 실행하는 데 문제가 발생할 수 있습니다.

자세한 내용은 타깃팅된 컨텐츠를 위한 개발 페이지를 가리키도록 업데이트하는 중입니다.

브라우저 콘솔에 "AppMeasurement 초기화에서 보고서 세트 ID 누락" 오류가 표시됩니다 the-error-missing-report-suite-id-in-appmeasurement-initialization-is-displayed-in-the-browser-console

이 문제는 Adobe Analytics이 DTM을 사용하여 웹 사이트에서 구현되고 사용자 지정 코드를 사용할 때 나타날 수 있습니다. 원인은 s = new AppMeasurement() 를 인스턴스화하려면 s 개체.

솔루션 solution-4

사용 s_gi 대신 new AppMeasurement 인스턴스화 메서드입니다. 예:

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

올바른 오퍼 대신 기본 오퍼가 임의로 표시됩니다 a-default-offer-is-randomly-displayed-instead-of-the-correct-offer

이 문제는 다음과 같은 여러 가지 원인이 있을 수 있습니다.

솔루션 solution-5

다음 솔루션을 시도할 수 있습니다.

AT.js 1.3+를 사용할 때 올바른 오퍼 대신 항상 기본 오퍼가 표시됩니다 a-default-offer-is-always-displayed-instead-of-correct-offer-when-using-at-js

즉시 사용 가능한 AEM 6.2 및 6.3은 AT.js 버전 1.3.0+와 호환되지 않습니다. AT.js 버전 1.3.0에서 해당 API에 대한 매개 변수 유효성 검사를 도입하면 adobe.target.applyOffer() 에서 제공하지 않는 "mbox" 매개 변수가 필요합니다. atjs-itegration.js 코드.

솔루션 solution-6

이 문제를 해결하려면 다음을 편집하십시오. atjs-itegration.js 및 추가 "mbox": mboxName 다음에 대한 매개 변수 개체의 필드 adobe.target.applyOffer() 다음과 같이:

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

목표 및 설정 페이지에 보고 소스 섹션이 표시되지 않습니다 the-goals-settings-page-does-not-show-the-reporting-sources-section

이 문제는 다음과 같을 수 있습니다. A4T Analytics Cloud 구성 프로비저닝 문제입니다.

솔루션 solution-7

AEM에 다음 확인 요청을 실행하여 Target 계정에 대해 A4T가 제대로 활성화되었는지 확인해야 합니다.

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

응답에 줄이 포함된 경우 a4tEnabled:false, 연락처 Adobe 고객 지원 센터 을 클릭하여 계정이 올바르게 프로비저닝되도록 하십시오.

유용한 Target API helpful-target-apis

다음은 Target 문제를 해결할 때 유용할 수 있는 두 가지 Target API입니다.

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