Adobe Analytics および Adobe Target との統合のオプトイン opting-into-adobe-analytics-and-adobe-target
AEM には、Adobe Analytics および Adobe Target との統合に役立つオプトイン手順が用意されています。このタスクは、あらかじめ読み込まれて管理者ユーザーグループに割り当てられており、すぐに使用できます。
管理者としてログインすると、このタスク(分析とターゲティングを設定)をインボックスから使用できます。指定された資格情報に基づいて、これらのサービスを設定および統合できます。
統合の設定には、次のオプションがあります。
-
タスクによる統合の設定。
この設定は、すぐに行うことも、後で行うこともできます。タスクは、何らかのアクションが実行されるまでインボックスに残ります。どちらの場合でも、UI で直接設定することも、事前定義済みの
.properties
ファイルを使用して設定することもできます。 -
統合のオプトアウト。
手動で統合を設定する場合は、このオプションを検討してください。DTM を使用した AEM と Adobe Target および Adobe Analytics の統合も参照してください。
-
スクリプトを使用してセットアップとプロビジョニングを設定します。
統合の設定 configuring-the-integration
次との統合をオプトインします。
- Analytics(ページ追跡および分析機能を使用できます)
- Target(パーソナライゼーション機能を使用できます)
どちらのオプションでも、ユーザーアカウント情報を設定して、追跡するページを指定する必要があります。
統合をオプトインすると、AEM が次のタスクを実行します。
- Analytics および Target への接続を可能にするクラウド設定を作成します。
- 追跡するデータを決定するフレームワークを作成します。
- これらのサービスを使用するように web ページを設定します。
事前に読み込まれた標準タスクからオプトインするには、次の手順を実行します。
-
インボックスから、Analytics & Targeting の設定タスクを選択して 開きます。
-
Analytics の場合:
- Analytics のユーザーアカウント情報を入力し、対応する「追加」ボタンをクリックします。
- 適切な資格情報が認証されます。
- Analytics アカウントが認証されたら、使用する Analytics レポートスイートを選択します。AEM がこれらの Analytics レポートスイートを取得します。ステータスが「追加済み」に更新されます。
-
Target の場合:
- Target のユーザーアカウント情報を入力し、対応する「追加」ボタンをクリックします。
- 適切な資格情報が認証されます。ステータスが「追加済み」に更新されます。
-
「次へ」を選択します。
-
Analytics や Target を使用する必要のあるサイトを選択します。
-
「完了」を選択して完了します。
note caution CAUTION 設定をオプトインしたら、その変更内容をパブリッシュインスタンスにレプリケーションするために、影響を受けるサイト/ページを公開する必要があります。
統合のオプトアウト opting-out-of-the-integration
次の場合に、Analytics および Target との統合をオプトアウトします。
-
これらの製品と統合したくない場合。
-
手動で統合を設定したい場合。
手動での統合の設定については、Adobe Analytics との統合および Adobe Target との統合を参照してください。
オプトアウトするには、事前に読み込まれたタスクを完了する必要があります。
プロパティファイルを使用したアカウント情報の設定 providing-account-information-using-a-properties-file
Analytics および Target との統合用のアカウントプロパティを設定するために、AEM がサーバーの起動時に読み込むプロパティファイルをインストールします。プロパティファイルを使用すると、オプトインウィザードにファイルのプロパティが自動的に設定され、それに従ってクラウド設定が作成されます。
プロパティファイルは marketingcloud.properties という名前のテキストファイルで、AEM プロセスが使用する作業ディレクトリ(通常は JAR ファイルと同じディレクトリ)に保存します。このファイルには次のプロパティが含まれます。
- analytics.server:使用する Analytics データセンターの URL。
- analytics.company:Analytics ユーザーアカウントに関連付けられた会社。
- analytics.username:Analytics ユーザー名。
- analytics.secret:Analytics ユーザー名に関連付けられた秘密鍵。
- analytics.reportsuite:使用する Analytics レポートスイートの名前。
- target.clientcode:Target アカウントに関連付けられたクライアントコード。
- target.email:Target アカウントの認証に使用するメールアドレス。
- target.password:メールアドレスに関連付けられたパスワード。
プロパティと値は等号(=)で区切ります。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
ファイルを作成します。note note NOTE 作業ディレクトリは、通常 jar または license.properties
ファイルを保持するディレクトリです。ただし、システムプロパティによる絶対パスとして定義することもできます。 mac.provisioning.file.container
-
Analytics または Target のアカウントに従って、プロパティ値を追加します。
-
サーバーを起動または再起動し、管理者アカウントを使用してログインします。
-
統合の設定で説明されているように、分析とターゲティングを設定タスクを開きます。アカウント情報を要求する代わりに、ウィザードに
.properties
ファイルの値が設定されます。適切なサービスに対して 追加 を選択し、ウィザードを続行します。
クラウド設定について about-the-cloud-configurations
Analytics および Target との統合を設定すると、必要なクラウド設定とフレームワークを AEM が自動的に作成します。例えば、Analytics のクラウド設定は Provisioned Analytics Account という名前です。
このクラウド設定を変更する必要はありません。ただし、必要に応じてフレームワークを設定できます。(コンポーネントデータと Adobe Analytics プロパティのマッピングおよび Target フレームワークの追加を参照)
reportsuite
が選択されると、フレームワークがパブリッシュ実行モードに制限されます。これは、パブリッシュインスタンスに対してのみトラッキングが機能することを意味します。all
に変更する必要があります。スクリプトを使用したセットアップとプロビジョニングの設定 configuring-the-setup-and-provisioning-via-script
管理者の場合、ウィザードの手順に従って手動でおこなう代わりに、スクリプトを使用してセットアップとプロビジョニングをトリガーすることをお勧めします。手順は次のとおりです。
- POST リクエストと必要なパラメーターを /libs/cq/cloudservicesprovisioning/content/autoprovisioning.json に送信します。
送信するパラメーターは、次のように場合によって異なります。
-
必要な資格情報がすべて入力された marketingcloud.properties ファイルを使用する場合は、次のパラメーターを送信する必要があります。
automaticProvisioning
=true
servicename
=analytics|target
path
=作成したクラウドサービス設定を接続する AEM ページへのパス
例えば、Analytics と Target の両方の設定を作成し、それらを we.retail ページに添付する cURL リクエストは次のとおりです。
code language-shell 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 ファイルを使用しない場合は、資格情報とパラメーターを送信する必要があります。例:
- automaticProvisioning=
true
- serviceName=
analytics|target
- path=作成したクラウドサービス設定を接続する AEM ページへのパス(複数のパスを定義可能)
- analytics.server=
https://servername
- analytics.company=
Name of company
- analytics.username=
me
- analytics.secret=
secret
- analytics.reportsuite=
we-retail
- target.clientcode=
mycompany
- target.email=
me@adobe.com
- target.password=
password
この場合、Analytics と Target の両方の設定を作成し、それらを we-retail ページに添付する cURL リクエストは次のようになります。
code language-shell 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
- automaticProvisioning=