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(パーソナライゼーション機能を使用できます)

どちらのオプションでも、ユーザーアカウント情報を設定して、追跡するページを指定する必要があります。

NOTE
オプションで、サーバーの起動時に読み込まれるプロパティファイルを使用して、Analytics および Target のアカウント情報を設定できます。プロパティファイルを使用したアカウント情報の設定を参照してください。

統合をオプトインすると、AEM が次のタスクを実行します。

  • Analytics および Target への接続を可能にするクラウド設定を作成します。
  • 追跡するデータを決定するフレームワークを作成します。
  • これらのサービスを使用するように web ページを設定します。
NOTE
デフォルトのクライアントライブラリは AT.js です。これは、Target のクラウドサービス設定で設定されています。
AT.js をクライアントライブラリとして使用することをお勧めします。

事前に読み込まれた標準タスクからオプトインするには、次の手順を実行します。

  1. インボックスから、Analytics & Targeting の設定タスクを選択して​ 開きます

    optin-01

  2. Analytics の場合:

    1. Analytics のユーザーアカウント情報を入力し、対応する「追加」ボタンをクリックします。
    2. 適切な資格情報が認証されます。
    3. Analytics アカウントが認証されたら、使用する Analytics レポートスイートを選択します。AEM がこれらの Analytics レポートスイートを取得します。ステータスが「追加済み」に更新されます。
  3. Target の場合:

    1. Target のユーザーアカウント情報を入力し、対応する「追加」ボタンをクリックします。
    2. 適切な資格情報が認証されます。ステータスが「追加済み」に更新されます。
  4. 次へ」を選択します。

  5. Analytics や Target を使用する必要のあるサイトを選択します。

  6. 完了」を選択して完了します。

    note caution
    CAUTION
    設定をオプトインしたら、その変更内容をパブリッシュインスタンスにレプリケーションするために、影響を受けるサイト/ページを公開する必要があります。

統合のオプトアウト opting-out-of-the-integration

次の場合に、Analytics および 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=

プロパティファイルを使用して統合をオプトインする手順を以下に示します。

  1. AEM プロセスが使用する作業ディレクトリ(オーサーインスタンス)に marketingcloud.properties ファイルを作成します。

    note note
    NOTE
    作業ディレクトリは、通常 jar または license.properties ファイルを保持するディレクトリです。
    ただし、システムプロパティによる絶対パスとして定義することもできます。
    mac.provisioning.file.container
  2. Analytics または Target のアカウントに従って、プロパティ値を追加します。

  3. サーバーを起動または再起動し、管理者アカウントを使用してログインします。

  4. 統合の設定で説明されているように、分析とターゲティングを設定タスクを開きます。アカウント情報を要求する代わりに、ウィザードに .properties ファイルの値が設定されます。

    適切なサービスに対して​ 追加 ​を選択し、ウィザードを続行します。

    optin-02

クラウド設定について about-the-cloud-configurations

Analytics および Target との統合を設定すると、必要なクラウド設定とフレームワークを AEM が自動的に作成します。例えば、Analytics のクラウド設定は Provisioned Analytics Account という名前です。

このクラウド設定を変更する必要はありません。ただし、必要に応じてフレームワークを設定できます。(コンポーネントデータと Adobe Analytics プロパティのマッピングおよび Target フレームワークの追加を参照)

NOTE
デフォルトでは、Adobe Target 設定ウィザードをオプトインすると、正確なターゲット設定が有効になります。
正確なターゲティングとは、クラウドサービスの設定が、コンテキストの読み込みを待ってからコンテンツを読み込むことを意味します。その結果、パフォーマンスに関しては、正確なターゲティングによって、コンテンツを読み込む前に数ミリ秒の遅延が生じる場合があります。
正確なターゲティングは、オーサーインスタンスで常に有効になっています。ただし、パブリッシュインスタンスでは、クラウドサービス設定(http://localhost:4502/etc/cloudservices.html)の「正確なターゲティング」の横にあるチェックマークをオフにすることで、正確なターゲティングをグローバルにオフにできますまた、クラウドサービス設定での設定に関係なく、個々のコンポーネントに対して正確なターゲティングのオン/オフを切り替えることもできます。
この設定を変更しても、作成済みの対象コンポーネントには影響しません​***。***​これらのコンポーネントには直接変更を加えてください。
CAUTION
Analytics 設定をオプトインして特定の 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
    
recommendation-more-help
19ffd973-7af2-44d0-84b5-d547b0dffee2