통합 문제 해결

일반 문제 해결 팁

JavaScript 오류 없음 확인

브라우저의 JavaScript 콘솔에 오류가 표시되는지 확인합니다. 처리되지 않은 오류로 인해 후속 코드가 제대로 실행되지 않을 수 있습니다. 오류가 있는 경우 오류가 발생하는 스크립트와 어떤 영역에서 스크립트를 확인하십시오. 스크립트 경로는 스크립트가 속한 기능에 대한 표시를 줄 수 있습니다.

구성 요소 수준에 로깅

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

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

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

<!--
${ myHtlVariable }
-->

로깅에 대한 자세한 내용은 로깅 및 감사 레코드 및 로그 파일 작업 페이지를 참조하십시오.

분석 통합 문제

보고서 가져오기 기능으로 인해 CPU/메모리 사용량이 높으며

보고서 가져오기 기능을 사용하면 CPU/메모리 사용량이 높거나 OutOfMemoryError 예외가 발생합니다.

솔루션

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

• 등록된 PollingImporter의 양이 많지 않은지 확인하십시오(아래의 "PollingImporter로 인해 종료에 시간이 오래 걸립니다" 섹션 참조).
• OSGi 콘솔에서 ManagedPollingImporter 구성에 대한 CRON 표현식을 사용하여 특정 시간에 보고서 가져오기 도구를 실행합니다.

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

PollingImporter 때문에 종료에 시간이 오래 걸립니다.

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

• Analytics를 참조하는 페이지가 많이 있으면 PollingImporter가 많이 발생합니다.
• 또한 Analytics 구성 참조를 사용하여 페이지를 복사하고 붙여넣으면 PollingImporters의 중복으로 이어집니다.

솔루션

먼저 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 스크립트 태그가 페이지 소스에서 렌더링되지 않습니다.

DTM 스크립트 태그는 페이지 속성 Cloud Services 탭에서 구성을 참조했지만 페이지에 제대로 포함되지 않습니다.

솔루션

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

• 암호화된 속성의 암호를 해독할 수 있는지 확인합니다. 각 AEM 인스턴스에서 암호화가 자동으로 생성된 다른 키를 사용할 수 있습니다. 자세한 내용은 구성 속성에 대한 암호화 지원을 참조하십시오.

• /etc/cloudservices/dynamictagmanagement에 있는 구성을 다시 게시합니다.

• /etc/cloudservices의 ACL을 확인합니다. ACL은 다음과 같아야 합니다.

  • allow;jcr:read;webservice-support-servicelibfinder
  • allow;jcr:read;everyone;rep:glob:*/defaults/&ast
  • allow;jcr:read;everyone;rep:glob:*/defaults
  • allow;jcr:read;everyone;rep:glob:*/public/&ast
  • allow;jcr:read;everyone;rep:glob:*/public

ACL 관리에 대한 자세한 내용은 사용자 관리 및 보안 페이지를 참조하십시오.

Target 통합 문제

사용자 지정 페이지 구성 요소 사용 시 미리 보기 모드에서 타깃팅된 컨텐츠가 표시되지 않습니다.

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

솔루션

다음 솔루션을 사용해 볼 수 있습니다.

• 사용자 지정 headlibs.jsp(/apps/<CUSTOM-COMPONENTS-PATH>/headlibs.jsp이 있는 경우)에 다음이 포함되어 있는지 확인합니다.

<%@include file="/libs/cq/cloudserviceconfigs/components/servicelibs/servicelibs.jsp?lang=ko" %>
<sly data-sly-resource="${'contexthub' @ resourceType='granite/contexthub/components/contexthub'}"/>

• 사용자 지정 head.html(/apps/<CUSTOM-COMPONENTS-PATH>/head.html) 이(가) 아래 예와 같이 특정 통합 헤더를 선택적으로 포함하지 않는지 확인하십시오.

<!-- DO NOT MANUALLY INCLUDE SPECIFIC CLOUD SERVICE HEADLIBS LIKE THIS -->
<meta data-sly-include="/libs/cq/dtm/components/dynamictagmanagement/headlibs.jsp?lang=ko" data-sly-unwrap/>

servicelibs.jsp은 필요한 분석 JavaScript 개체를 추가하고 웹 사이트와 연결된 클라우드 서비스 라이브러리를 로드합니다. Target 서비스의 경우 라이브러리는 /libs/cq/analytics/components/testandtarget/headlibs.jsp을 통해 로드됩니다.

로드된 라이브러리 집합은 Target 구성에 사용된 대상 클라이언트 라이브러리( mbox.js 또는 at.js)의 유형에 따라 달라집니다.

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

자세한 내용은 타깃팅된 컨텐츠용으로 개발 페이지를 참조하십시오.

"AppMeasurement 초기화에 보고서 세트 ID 누락" 오류가 브라우저 콘솔에 표시됩니다.

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

솔루션

new AppMeasurement 인스턴스화 방법 대신 s_gi을 사용합니다. 예:

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

올바른 오퍼 대신 기본 오퍼가 임의로 표시됩니다.

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

• 타사 태그 관리 시스템을 사용하여 비동기적으로 Target 클라이언트 라이브러리( mbox.js 또는 at.js)를 로드할 경우 임의로 타깃팅이 중단될 수 있습니다. Target 라이브러리는 페이지 헤드에 동기식으로 로드되어야 합니다. 라이브러리는 AEM에서 제공되면 항상 마찬가지입니다.

• 두 Target 클라이언트 라이브러리( at.js)를 동시에 로드합니다(예: DTM을 사용하는 라이브러리 및 AEM의 Target 구성을 사용하는 라이브러리 1개). 이 경우 at.js 버전이 다른 경우 adobe.target 정의에 충돌이 발생할 수 있습니다.

솔루션

다음 솔루션을 사용해 볼 수 있습니다.

• DTM과 같은 라이브러리를 로드하는 고객 코드(다시 로드되는 Target 라이브러리)가 페이지 헤드에서 동기식으로 실행되는지 확인하십시오.
• 사이트가 Target 라이브러리를 제공하기 위해 DTM을 사용하도록 구성된 경우, 사이트의 **Target 구성에서 DTM** 옵션이 선택되어 있는지 확인합니다.

AT.js 1.3+ 사용 시 올바른 오퍼 대신 기본 오퍼가 항상 표시됩니다.

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

솔루션

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

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

목표 및 설정 페이지에는 보고 소스 섹션이 표시되지 않습니다.

이 문제는 대부분 A4T Analytics Cloud 구성 프로비저닝 문제입니다.

솔루션

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

다음은 Target 문제를 해결할 때 유용할 수 있는 2개의 Target API입니다.

• 지정된 클라이언트 코드에 대한 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"
    ]
}