AEM には、Adobe Analytics および Adobe Target との統合に役立つオプトイン手順が用意されています。これは、管理者ユーザーグループに割り当てられた、事前に読み込まれたタスクとして、標準で使用できます。
管理者としてログインすると、このタスク(Analytics & Targeting を設定)をインボックスから使用できます。指定された資格情報に基づいて、これらのサービスを設定および統合できます。
統合の設定には、次のオプションがあります。
タスクによる統合の設定。
これは、即座に、または後でおこなうことができ、何らかのアクションがおこなわれるまで、タスクはインボックスに残ります。どちらの場合も、設定は UI で直接おこなうことも、事前定義された .properties
ファイル。
統合のオプトアウト。
手動で統合を設定する場合は、このオプションを検討してください。DTM を使用した AEM と Adobe Target および Adobe Analytics の統合(英語)も参照してください。
スクリプトを使用してセットアップとプロビジョニングを設定します。
次との統合をオプトインします。
どちらのオプションでも、ユーザーアカウント情報を設定して、追跡するページを指定する必要があります。
オプションで、サーバーの起動時に読み込まれるプロパティファイルを使用して、Analytics および Target のアカウント情報を設定できます。プロパティファイルを使用したアカウント情報の設定を参照してください。
統合をオプトインすると、AEM が次のタスクを実行します。
AT.js は、デフォルトのクライアントライブラリです。これは、Target のクラウドサービス設定で設定されています。
AT.js をクライアントライブラリとして使用することをお勧めします。
事前に読み込まれた標準タスクからオプトインするには:
インボックスから、Analytics & Targeting を設定タスクを選択して開きます。
Analytics の場合:
Target の場合:
「次へ」を選択します。
Analytics および Target で使用する必要のあるサイトを選択します。
「完了」を選択して完了します。
設定をオプトインしたら、その変更内容をパブリッシュインスタンスにレプリケーションするために、影響を受けるサイト/ページを公開する必要があります。
次の場合に、Analytics および Target との統合をオプトアウトします。
これらの製品と統合したくない。
手動で統合を設定したい。
手動での統合の設定については、Adobe Analytics との統合および Adobe Target との統合を参照してください。
オプトアウトするには、事前に読み込まれたタスクを完了する必要があります。
Analytics および Target との統合用のアカウントプロパティを設定するために AEM がサーバーの起動時に読み込むプロパティファイルをインストールします。プロパティファイルを使用すると、オプトインウィザードにファイルのプロパティが自動的に設定され、それに従ってクラウド設定が作成されます。
プロパティファイルは marketingcloud.properties という名前のテキストファイルで、AEM プロセスが使用する作業ディレクトリ(通常は JAR ファイルと同じディレクトリ)に保存します。このファイルには次のプロパティが含まれます。
プロパティと値は等号(=)で区切ります。 プロパティの先頭には analytics
analytics が付き、 プロパティの先頭には target
target が付きます。サービスを設定するには、そのサービスのすべてのプロパティの値を設定します。サービスを設定しない場合は、そのサービスの値を設定しないでください。
次の例 .properties
ファイルには、Analytics 用のクラウド設定を作成するための次のプロパティ値が含まれます。
analytics.server=https://test.omniture.com/login/
analytics.company=MyCompany
analytics.username=sbroders
analytics.secret=12345678
analytics.reportsuite=myreportsuite
target.clientcode=
target.email=
target.password=
プロパティファイルを使用して統合をオプトインする手順を以下に示します。
AEM プロセスが使用する作業ディレクトリ(オーサーインスタンス)に marketingcloud.properties
ファイルを作成します。
作業ディレクトリは、通常、jar または license.properties
ファイルを保持するディレクトリです。
ただし、システムプロパティによる絶対パスとして定義することもできます。
mac.provisioning.file.container
Analytics または Target のアカウントに従って、プロパティ値を追加します。
サーバーを起動または再起動し、管理者アカウントを使用してログインします。
統合の設定で説明されているように、Analytics & Targeting を設定タスクを開きます。アカウント情報を要求する代わりに、ウィザードでは .properties
ファイル。
選択 追加 該当するサービスの場合は、ウィザードを続行します。
Analytics および Target との統合を設定すると、必要なクラウド設定とフレームワークを AEM が自動的に作成します。例えば、Analytics のクラウド設定は Provisioned Analytics Account という名前です。
このクラウド設定を変更する必要はありません。ただし、必要に応じてフレームワークを設定できます( コンポーネントデータとAdobe Analyticsプロパティのマッピング および Target フレームワークを追加.)
デフォルトでは、Adobe Target 設定ウィザードをオプトインすると、正確なターゲット設定が有効になります。
正確なターゲット設定を有効にすると、クラウドサービス設定はコンテンツが読み込まれるまでコンテキストの読み込みを待機します。結果として、正確なターゲット設定を有効にすると、パフォーマンスの面ではコンテンツの読み込みに数ミリ秒の遅延が発生することがあります。
正確なターゲット設定はオーサーインスタンスでは常に有効になっています。ただし、パブリッシュインスタンスではクラウドサービス設定(http://localhost:4502/etc/cloudservices.html)の正確なターゲット設定の横にあるチェックマークをオフにすることで、正確なターゲット設定をグローバルにオフにできます。また、クラウドサービス設定の設定に関係なく、個々のコンポーネントの正確なターゲット設定のオンとオフを切り替えることもできます。
この設定を変更しても、作成済み******の対象コンポーネントには影響しません。これらのコンポーネントには直接変更を加える必要があります。
Analytics 設定をオプトインして特定の reportsuite
が選択されると、フレームワークがパブリッシュ実行モードに制限されます。これは、パブリッシュインスタンスに対してのみ追跡が機能することを意味します。
追跡がオーサーインスタンスでも必要な場合は、値を all
に変更する必要があります。
管理者の場合、ウィザードの手順に従って手動でおこなう代わりに、スクリプトを使用してセットアップとプロビジョニングを実行できます。手順は次のとおりです。
送信するパラメーターは、次のように場合によって異なります。
必要な資格情報がすべて入力された marketingcloud.properties ファイルを使用する場合は、次のパラメーターを送信する必要があります。
automaticProvisioning
= true
servicename
= analytics|target
path
=作成したクラウドサービス設定を接続する AEM ページへのパス例えば、Analytics と Target の両方の設定を作成し、それらを we.retail ページに添付する curl 要求は次のとおりです。
curl -v -u admin:admin -X POST -d"automaticProvisioning=true&servicename=target&servicename=analytics&path=/content/we-retail" http://localhost:4502/libs/cq/cloudservicesprovisioning/content/autoprovisioning.json
を使用しない場合は、 marketingcloud.properties ファイルを作成したら、パラメーターと共に認証情報を送信する必要があります。例:
true
analytics|target
https://servername
Name of company
me
secret
we-retail
mycompany
me@adobe.com
password
この場合、Analytics と Target の両方の設定を作成し、それらを we-retail ページに添付する curl 要求は次のようになります。
curl -v -u admin:admin -X POST -d"automaticProvisioning=false&servicename=target&servicename=analytics&path=/content/we-retail&analytics.server=https://servername/&analytics.company=Name of company&analytics.username=me&analytics.secret=secret&analytics.reportsuite=weretail&target.clientcode=mycompany&target.email=me@adobe.com&target.password=password" http://localhost:4502/libs/cq/cloudservicesprovisioning/content/autoprovisioning.json