統合に関する問題のトラブルシューティング 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

レポートインポーターが原因で CPU／メモリの使用量が多くなる、または OutOfMemoryError 例外となる。

解決策 solution

この問題を解決するには、次の方法を試してください。

AEM でカスタムデータインポーターサービスを作成について詳しくは、以下の記事を参照してください。https://helpx.adobe.com/jp/experience-manager/using/polling.html

PollingImporter が原因でシャットダウンに時間がかかる shutdown-takes-a-long-time-due-to-the-pollingimporter

Analytics は継承メカニズムを念頭に置いて設計されています。通常、ページプロパティの「クラウドサービス」タブ内の Analytics 設定への参照を追加することで、サイトの Analytics を有効にします。ページで別の設定が必要な場合を除き、設定は再度参照する必要はなく、自動的にすべてのサブページに継承されます。サイトへの参照を追加すると、タイプ cq;PollConfig の複数のノード（AEM 6.3 以前の場合は 12、AEM 6.4 以降の場合は 6）も自動的に作成されます。これは、Analytics データを AEM にインポートするために使用される 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/jp/experience-manager/using/polling.html

DTM（レガシー）の問題 dtm-legacy-issues

DTM スクリプトタグがページソースにレンダリングされません。 the-dtm-script-tag-is-not-rendered-in-the-page-source

設定がページプロパティの「クラウドサービス」タブで参照されているにもかかわらず、DTM スクリプトタグがページに正しく含まれていません。

解決策 solution-2

この問題を解決するには、次の方法を試してください。

ACL 管理について詳しくは、ユーザー管理とセキュリティページを参照してください。

Target 統合の問題 target-integration-issues

カスタムページコンポーネントを使用しているときに Target コンテンツがプレビューモードで表示されない 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 によって、必要な分析用 Javascript オブジェクトが追加され、Web サイトに関連付けられているクラウドサービスライブラリが読み込まれます。Target サービスでは、ライブラリは /libs/cq/analytics/components/testandtarget/headlibs.jsp で読み込まれます。

読み込まれるライブラリのセットは、Target の設定で使用されているターゲットクライアントライブラリのタイプ（mbox.js または at.js）によって異なります。

mbox.js または at.js 送信に DTM を使用する場合、コンテンツがレンダリングされる前にライブラリがロードされていることを確認してください。これらのライブラリを非同期的にロードするタグ管理システムを使用すると、ターゲット固有の JavaScript コードの実行に問題が生じる可能性があります。

追加情報については、ターゲットコンテンツ向けの開発ページを参照してください。

「AppMeasurement の初期化でレポートスイート ID が見つかりません」というエラーがブラウザーコンソールに表示される the-error-missing-report-suite-id-in-appmeasurement-initialization-is-displayed-in-the-browser-console

この問題は、Adobe Analytics が DTM を使用して web サイトに実装され、カスタムコードを使用している場合に発生することがあります。原因は、s = new AppMeasurement() を使用して s オブジェクトをインスタンス化しているためです。

解決策 solution-4

インスタンス化メソッドに new AppMeasurement ではなく s_gi を使用します。次に例を示します。

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 以降と互換性がありません。API のパラメータ検証が導入された AT.js バージョン 1.3.0 では、adobe.target.applyOffer() が要求する「mbox」パラメーターが atjs-itegration.js コードで提供されません。

解決策 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 クラウド設定のプロビジョニングの問題であると思われます。

解決策 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 という行が含まれている場合、アドビカスタマーケアに連絡して、アカウントを正しくプロビジョニングするようご依頼ください。

役立つ Target API helpful-target-apis

Target の問題をトラブルシューティングするときに、以下の 2 つの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"
    ]
}