手動での Adobe Target との統合の設定

最終更新日: 2023-12-19

ウィザードを使用するときに作成したオプトインウィザードの設定を変更するか、ウィザードを使用しないで手動で Adobe Target と統合できます。

オプトインウィザードの設定の変更

AEM を Adobe Target と統合するオプトインウィザードでは、プロビジョニングされた Target 設定という名前の Target クラウド設定が自動的に作成されます。また、ウィザードではプロビジョニングされた Target フレームワークという名前のクラウド設定の Target フレームワークも作成されます。クラウド設定とフレームワークのプロパティは、必要に応じて変更できます。

また、コンテンツをターゲット化するときに、A4T Analytics クラウド設定を変更して、Adobe Analytics をレポートソースとして使用するように Adobe Target を設定できます。

クラウド設定とフレームワークの場所を特定するには、ツールデプロイメントtクラウド​の クラウドサービス​に移動します。(http://localhost:4502/libs/cq/core/content/tools/cloudservices.html)Adobe Targetの下で、 設定を表示.

プロビジョニングされた Target 設定のプロパティ

次のプロパティ値は、オプトインウィザードで作成されるプロビジョニングされた Target 設定のクラウド設定で使用されます。

  • クライアントコード:​オプトインウィザードに入力されているとおりです。

  • メール:​オプトインウィザードに入力されているとおりです。

  • パスワード:​オプトインウィザードに入力されているとおりです。

  • API のタイプ: REST

  • Adobe Target からセグメントを同期: 選択されています。

  • クライアントライブラリ: mbox.js

  • DTM を使用してクライアントライブラリを提供:​選択されていません。DTMまたは別のタグ管理システムを使用して mbox.js または AT.js ファイルをホストする場合は、このオプションを選択します。ライブラリの配信には AEM ではなく DTM を使用することをお勧めします。

  • カスタム mbox.js:何も指定されておらず、デフォルトの mbox.js ファイルが使用されます。必要に応じて、使用するカスタム mbox.js を指定します。mbox.js を選択した場合にのみ表示されます。

  • カスタム AT.js:​何も指定されておらず、デフォルトの AT.js ファイルが使用されます。必要に応じて、使用するカスタム AT.js を指定します。AT.js を選択した場合にのみ表示されます。

メモ

AEM 6.3 では、Target ライブラリファイル AT.JS を選択できます。このファイルは、Adobe Target 用の新しい実装ライブラリであり、通常の web 実装と単一ページアプリケーションの両方に使用できるように設計されています。

AT.js は mbox.js ライブラリよりも、次のような強化点を提供します。

  • Web 実装のページ読み込み時間の向上
  • セキュリティの向上
  • 単一ページアプリケーション向けの実装オプションの改善
  • target.js に含まれていたコンポーネントが AT.js にも含まれているので、ターゲットへの呼び出しがなくなりました。

プロビジョニングされた Target フレームワークのプロパティ

オプトインウィザードで作成されるプロビジョニングされた Target フレームワークはプロファイルデータストアからコンテキストデータを送信するように設定されています。ストアの年齢と性別のデータ項目はデフォルトで Target に送信されます。お使いのソリューションでは追加のパラメーターを送信する必要があります。

プロビジョニングされた Target フレームワーク

Target フレームワークの追加で説明されている通り、追加のコンテキスト情報を Target に送信するようにフレームワークを設定できます。

A4T Analytics クラウド設定の設定

コンテンツをターゲット化するときに、Adobe Analytics をレポートソースとして使用するように Adobe Target を設定できます。

メモ

ユーザー資格情報認証(レガシー)は、A4T(Target と Analytics の両方)では機能しません。そのため、ユーザー資格情報認証の代わりに IMS 認証を使用する必要があります。

これを行うには、Adobe Target クラウド設定を接続する A4T クラウド設定を指定します。

  1. AEM のロゴツールデプロイメントクラウドサービス​の順に移動して​クラウドサービス​にアクセスします。

  2. Adobe Target」セクションで、「今すぐ設定」をクリックします。

  3. Adobe Target 設定に再接続します。

  4. A4T Analytics クラウド設定​ドロップダウンメニューで、フレームワークを選択します。

    メモ

    A4T に対して有効化されている Analytics 設定のみを使用できます。

    AEM で A4T を設定する際には、「設定の参照が欠落しています」というエントリが表示される場合があります。分析フレームワークを選択できるようにするには、次の操作を行います。

    1. ツール一般CRXDE Lite に移動します。
    2. A4T Analytics 設定ダイアログに移動します(以下を参照)。
    3. プロパティ 無効化false に設定します。
    4. すべて保存」をクリックします。

A4T Analytics 設定ダイアログ

/libs/cq/analytics/components/testandtargetpage/dialog/items/tabs/items/tab1_general/items/a4tAnalyticsConfig

AdobeTargetSettings

OK」をクリックします。Adobe Target でコンテンツのターゲットに設定すると、レポートソースを選択できるようになります。

手動での Adobe Target との統合

オプトインウィザードを使用せずに手動で Adobe Target と統合します。

メモ

Target ライブラリファイル AT.JS は、Adobe Target 用の新しい実装ライブラリであり、通常の web 実装と単一ページアプリケーションの両方に使用できるように設計されています。アドビは、クライアントライブラリとして mbox.js ではなく AT.js を使用することをお勧めします。

AT.js は mbox.js ライブラリよりも、次のような強化点を提供します。

  • Web 実装のページ読み込み時間の向上
  • セキュリティの向上
  • 単一ページアプリケーション向けの実装オプションの改善
  • AT.js は、target.js に含まれていたコンポーネントを含むので、target.js を呼び出す必要がなくなりました

クライアントライブラリ​ドロップダウンメニューでは、AT.js または mbox.js を選択できます。

Target クラウド設定の作成

AEM が Adobe Target とやり取りできるようにするには、Target クラウド設定を作成します。設定を作成するには、Adobe Target のクライアントコードとユーザーの資格情報を指定します。

複数の AEM キャンペーンに設定を関連付けることができるので、Target クラウド設定を作成するのは 1 回のみです。複数の Adobe Target クライアントコードがある場合、各クライアントコードに対して 1 つの設定を作成します。

クラウド設定を設定して、Adobe Target からセグメントを同期することができます。同期を有効にした場合は、クラウド設定が保存されるとすぐに、バックグラウンドでセグメントが Target から読み込まれます。

AEMで Target クラウド設定を作成するには、以下の手順を実行します。

  1. AEM ロゴツールクラウドサービス従来のクラウドサービス​を使用して、クラウドサービス​に移動します。(http://localhost:4502/libs/cq/core/content/tools/cloudservices.html

    クラウドサービス​概要ページが開きます。

  2. Adobe Target」セクションで、「今すぐ設定」をクリックします。

  3. 設定を作成​ダイアログで、次の操作を実行します。

    1. 設定の「タイトル」を入力します。
    2. Adobe Target 設定」テンプレートを選択します。
    3. 作成」をクリックします。

    編集ダイアログが開きます。

    AdobeTargetSettings

    メモ

    AEM で A4T を設定する際には、「設定の参照が欠落しています」というエントリが表示される場合があります。分析フレームワークを選択できるようにするには、次の操作を行います。

    1. ツール一般CRXDE Lite に移動します。
    2. /libs/cq/analytics/components/testandtargetpage/dialog/items/tabs/items/tab1_general/items/a4tAnalyticsConfig に移動します。
    3. プロパティ 無効化false に設定します。
    4. すべて保存」をクリックします。
  4. ダイアログで、次のプロパティの値を入力します。

    • クライアントコード:Target アカウントのクライアントコード

    • メール:Target アカウントのメール

    • パスワード:Target アカウントのパスワード

    • API のタイプ:REST または XML

    • A4T Analytics クラウド設定:ターゲットアクティビティの目標と指標に使用する Analytics クラウド設定を選択します。この設定は、コンテンツをターゲティングするときに、Adobe Analytics をレポートソースとして使用している場合に必要です。クラウド設定が表示されない場合は、A4T Analytics クラウドの設定のメモを参照してください。

    • 正確なターゲット設定を使用:デフォルトでは、このチェックボックスはオンになっています。選択した場合、クラウドサービス設定は、コンテキストの読み込みを待ってからコンテンツを読み込みます。次のメモを参照してください。

    • Adobe Target からセグメントを同期: Target で定義されているセグメントをダウンロードして AEM で使用するには、このオプションをオンにします。API Type プロパティが REST の場合は、このオプションを選択する必要があります。インラインセグメントはサポートされず、Target のセグメントを使用する必要があるからです。(AEM の用語「セグメント」は、Target の「オーディエンス」と同じです。)

    • クライアントライブラリ:​クライアントライブラリとして mbox.js と AT.js のいずれを使用するかを選択します。

    • DTM を使用してクライアントライブラリを提供 - AT.js または mbox.js を DTM または別のタグ管理システムから使用する場合は、このオプションを選択します。このオプションを使用するには、DTM 統合を設定します。ライブラリの配信には AEM ではなく DTM を使用することをお勧めします。

    • カスタム mbox.js:DTM ボックスをオンにした場合またはデフォルトの mbox.js を使用する場合は空にします。それ以外の場合は、カスタム mbox.js をアップロードします。mbox.js を選択した場合にのみ表示されます。

    • カスタム AT.js:DTM ボックスをオンにした場合またはデフォルトの AT.js を使用する場合は空にします。それ以外の場合は、カスタム AT.js をアップロードします。AT.js を選択した場合にのみ表示されます。

    メモ

    デフォルトでは、Adobe Target 設定ウィザードをオプトインすると、正確なターゲット設定が有効になります。

    正確なターゲティングとは、クラウドサービスの設定が、コンテキストの読み込みを待ってからコンテンツを読み込むことを意味します。その結果、パフォーマンスに関しては、正確なターゲティングによって、コンテンツを読み込む前に数ミリ秒の遅延が生じる場合があります。

    正確なターゲティングは、オーサーインスタンスで常に有効になっています。ただし、パブリッシュインスタンスでは、クラウドサービス設定(http://localhost:4502/etc/cloudservices.html)の「正確なターゲティング」の横にあるチェックマークをオフにすることで、正確なターゲティングをグローバルにオフにできますまた、クラウドサービス設定での設定に関係なく、個々のコンポーネントに対して正確なターゲティングのオン/オフを切り替えることもできます。

    この設定を変更しても、作成済みの対象コンポーネントには影響しません​***。***​これらのコンポーネントを直接変更します。

  5. Target に接続」をクリックして、Target との接続を開始します。接続に成功すると、「接続に成功しました」というメッセージが表示されます。メッセージの「OK」をクリックして、ダイアログの「OK」をクリックします。

    Target に接続できない場合は、トラブルシューティングの節を参照してください。

Target フレームワークの追加

Target クラウド設定を設定したら、Target フレームワークを追加します。このフレームワークは、使用可能な Client Context コンポーネントまたは ContextHub コンポーネントから Adobe Target に送信されるデフォルトのパラメーターを識別します。Target は、パラメーターを使用して、現在のコンテキストに適用されるセグメントを決定します。

1 つの Target 設定に対して複数のフレームワークを作成できます。Web サイトのセクションごとに異なるパラメーターセットを Target に送信する必要がある場合は、複数のフレームワークが便利です。送信するパラメーターのセットごとにフレームワークを作成します。Web サイトの各セクションを適切なフレームワークに関連付けます。1 つの web ページは一度に 1 つのフレームワークしか使用できません。

  1. Target 設定ページで、「使用できるフレームワーク」の横の「+」(プラス符号)をクリックします。

  2. フレームワークを作成ダイアログで、「タイトル」を指定し、「Adobe Target フレームワーク」を選択して、「作成」をクリックします。

    フレームワークを作成ダイアログ

    フレームワークページが表示されます。サイドキックに、マッピングできる ClientContext または ContextHub の情報を表すコンポーネントが表示されます。

    フレームワークのコンポーネント

  3. マッピングに使用するデータを表す ClientContext コンポーネントをドロップターゲットにドラッグします。または、ContextHub ストア​コンポーネントをフレームワークにドラッグします。

    メモ

    マッピング時に、パラメーターは単純な文字列を使用して mbox に渡されます。ContextHub から配列をマッピングすることはできません。

    例えば、サイト訪問者に関する​プロファイルデータ​を使用して Target キャンペーンを管理するには、プロファイルデータ​コンポーネントをページにドラッグします。Target パラメーターへのマッピングに使用できるプロファイルデータ変数が表示されます。

    プロファイルデータ

  4. 該当する列の「共有」チェックボックスをオンにして、Adobe Target システムで表示する変数を選択します。

    共有

    メモ

    パラメーターの同期は、AEM から Adobe Target への一方向のみです。

フレームワークが作成されました。フレームワークをパブリッシュインスタンスにレプリケートするには、サイドキックの「フレームワークをアクティベート」オプションを使用します。

アクティビティと Target クラウド設定の関連付け

AEM アクティビティを Target クラウド設定に関連付け、アクティビティを Adobe Target にミラーリングできるようにします。

メモ

使用可能なアクティビティの種類は、次のオプションによって決まります。

  • Adobe Target の接続に AEM 側で使用される Adobe Target テナント(clientcode)で xt_only オプションがオンになっている場合は、XT アクティビティ​のみ​を AEM で作成できます。

  • Adobe Target テナント(clientcode)で xt_only オプションが​オフ​になっている場合は、XT アクティビティと A/B アクティビティの​両方​を AEM で作成できます。

追加のメモ:xt_only オプションは、特定の Target テナント(クライアントコード)に対して適用される設定であり、Adobe Target 内でのみ直接変更できます。このオプションは AEM で有効および無効にすることはできません。

Target フレームワークとサイトの関連付け

AEM で Target フレームワークを作成した後、web ページをフレームワークに関連付けます。ページ上のターゲットコンポーネントは、フレームワークで定義されたデータをトラッキングするために Adobe Target に送信します。(コンテンツのターゲティングを参照)。

ページをフレームワークに関連付けると、子ページが関連付けを継承します。

  1. Sites コンソールで、設定するサイトに移動します。

  2. クイックアクションまたは選択モードを使用して、「プロパティを表示」を選択します。

  3. クラウドサービス」タブを選択します。

  4. クリック 編集.

  5. クリック 設定を追加 under Cloud Service設定 を選択し、 Adobe Target.

    設定を追加

  6. 設定の参照」で必要なフレームワークを選択します。

    メモ

    作成の基になった Target クラウド設定ではなく、作成した固有の​フレームワーク​を選択してください。

  7. 完了」をクリックします。

  8. Web サイトのルートページをアクティベートして、公開サーバーにレプリケーションします。(ページを公開する方法を参照)

    メモ

    ページにアタッチしたフレームワークがまだアクティベートされていなかった場合は、ウィザードが開き、フレームワークを公開することもできます。

Target の接続に関する問題のトラブルシューティング

Target に接続する際に発生する問題のトラブルシューティングを行うには、次のタスクを実行します。

  • 入力したユーザー資格情報が正しいことを確認します。
  • AEM インスタンスが Target サーバーに接続できることを確認します。例えば、ファイアウォールのルールが AEM のアウトバウンド接続をブロックしていないこと、または AEM が必要なプロキシを使用するように設定されていることを確認します。
  • AEM のエラーログで参考になるメッセージを探します。error.log ファイルは、AEM がインストールされている crx-quickstart/logs ディレクトリにあります。
  • Adobe Target でアクティビティを編集すると、URL は localhost を指します。この問題を回避するには、AEM Externalizer を正しい URL に設定してください。

このページ