文件AEM 6.5使用手冊

疑難排解整合問題 troubleshooting-integration-issues

Last update: Sun Jul 14 2024 00:00:00 GMT+0000 (Coordinated Universal Time)
  • 主題：

建立對象：

  • undefined

一般疑難排解提示 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

Report Importer造成高CPU/記憶體使用率 the-report-importer-causes-high-cpu-memory-usage

Report Importer造成高CPU/記憶體使用率或造成OutOfMemoryError例外狀況。

解決方案 solution

若要修正此問題，請嘗試下列步驟：

  • 確認沒有大量的PollingImporters註冊（請參閱下方的「由於PollingImporter關機需花很長時間」一節）。
  • 在OSGi主控台中的ManagedPollingImporter設定使用CRON運算式，在一天中的特定時間執行報表匯入程式。

如需有關在AEM中建立自訂資料匯入工具服務的詳細資訊，請參閱下列文章https://helpx.adobe.com/experience-manager/using/polling.html。

由於PollingImporter，關機需要很長的時間 shutdown-takes-a-long-time-due-to-the-pollingimporter

Analytics在設計時已考慮繼承機制。 通常，您會在頁面屬性Cloud Service索引標籤中新增Analytics設定的參考，以啟用網站的Analytics。 然後，設定會自動繼承到所有子頁面，無需再次參考，除非頁面需要不同的設定。 新增對網站的參照也會自動建立數個節點(12適用於AEM 6.3和更早版本，或6適用於AEM 6.4) 型別cq;PollConfig的（及更新版本），它會具現化用來將Analytics資料匯入AEM的PollingImporters。 因此：

  • 有大量頁面參考Analytics會導致大量的PollingImporters。
  • 此外，複製和貼上參照Analytics設定的頁面會導致其PollingImporters重複。

解決方案 solution-1

首先，分析error.log可能會讓您深入瞭解作用中或註冊的PollingImporters數量。 例如：

# 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

若要修正此問題，請嘗試下列步驟：

  • 請確定加密的屬性可以解密(請注意，加密可能在每個AEM執行個體上使用不同的自動產生金鑰)。 如需其他詳細資料，請一併閱讀組態屬性的Encryption Support。

  • 重新發佈/etc/cloudservices/dynamictagmanagement中找到的組態

  • 檢查/etc/cloudservices上的ACL。 ACL應為：

    • 允許； jcr：read； webservice-support-servicelibfinder
    • 允許； jcr：read；每個人；rep:glob:&amp；ast；/defaults/&amp；ast；
    • 允許； jcr：read；每個人；rep:glob:&amp；ast；/defaults
    • 允許； jcr：read；每個人；rep:glob:&amp；ast；/public/&amp；ast；
    • 允許； jcr：read；每個人；rep:glob:&amp；ast；/public

如需有關管理ACL的詳細資訊，請閱讀使用者管理與安全性頁面。

Target整合問題 target-integration-issues

使用自訂頁面元件時，在預覽模式中看不到目標內容 targeted-content-not-visible-in-preview-mode-when-using-custom-page-components

自訂頁面元件未包含正確的JSP或使用者端資料庫（可處理Target DTM整合），因此會發生此問題。

解決方案 solution-3

您可以嘗試下列解決方案：

  • 請確定自訂headlibs.jsp （如果有的話/apps/<CUSTOM-COMPONENTS-PATH>/headlibs.jsp）包含下列專案：
<%@include file="/libs/cq/cloudserviceconfigs/components/servicelibs/servicelibs.jsp" %>
<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" data-sly-unwrap/>

servicelibs.jsp新增必要的Analytics JavaScript物件，並載入與網站關聯的雲端服務程式庫。 若為Target服務，會透過/libs/cq/analytics/components/testandtarget/headlibs.jsp載入資料庫

載入的資料庫組取決於Target組態上使用的目標使用者端資料庫（ mbox.js或at.js）型別。

使用DTM傳遞mbox.js或at.js時，請確保在轉譯內容之前載入程式庫。 使用以非同步方式載入這些程式庫的Tag Management系統，可能會在執行Target特定JavaScript程式碼時發生問題。

如需其他資訊，請閱讀針對目標內容開發頁面。

瀏覽器主控台中會顯示「AppMeasurement初始化期間缺少報表套裝ID」錯誤 the-error-missing-report-suite-id-in-appmeasurement-initialization-is-displayed-in-the-browser-console

透過DTM在網站上實作Adobe Analytics並使用自訂程式碼時，可能會出現此問題。 原因是使用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

此問題可能有多個原因：

  • 使用第三方Tag Management系統非同步載入Target使用者端資料庫（ mbox.js或at.js）可能會隨機中斷鎖定目標。 Target程式庫應在頁面標頭中同步載入。 從AEM傳遞程式庫時，一律會有此情況。

  • 同時載入兩個Target使用者端程式庫( at.js)，例如，一個使用DTM，另一個使用AEM中的Target設定。 如果at.js版本不同，這可能會導致adobe.target定義的衝突。

解決方案 solution-5

您可以嘗試下列解決方案：

  • 確定在頁面標題中同步執行載入類似DTM的程式庫（接著載入Target程式庫）的客戶程式碼。
  • 如果網站設定為使用DTM來傳遞Target資料庫，請確定已在Target組態中核取由DTM 傳遞的 Clientlib選項。

使用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()需要atjs-itegration.js程式碼未提供的「mbox」引數。

解決方案 solution-6

若要解決此問題，請編輯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
        })
    },

目標與設定頁面未顯示報告來源區段 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 API，它們在疑難排解Target問題時可能會很實用：

  • 擷取指定clientcode的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"
    ]
}
recommendation-more-help
19ffd973-7af2-44d0-84b5-d547b0dffee2