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

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

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

The Opt-in wizard that integrates AEM with Adobe Target automatically creates a Target cloud configuration named Provisioned Target Configuration. また、ウィザードではプロビジョニングされた Target フレームワークという名前のクラウド設定の Target フレームワークも作成されます。クラウド設定とフレームワークのプロパティは、必要に応じて変更できます。

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

To locate the cloud configuration and the framework, Navigate to Cloud Services via Tools > Deployment > Cloud. (http://localhost:4502/libs/cq/core/content/tools/cloudservices.html)。
Adobe Targetの下の「設定を 表示」をクリックまたはタップします。

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

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

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

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

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

  • API のタイプ: REST

  • Adobe Targetからのセグメントの同期: 選択済み。

  • クライアントライブラリ: mbox.jsを参照してください。

  • DTMを使用したクライアントライブラリの配信: 未選択。 Select this option if you use DTM or another tag management system to host the mbox.js or AT.js file. ライブラリの配信には AEM ではなく DTM を使用することをお勧めします。

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

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

メモ

In AEM 6.3, you can select the Target Library file, AT.JS, which is a new implementation library for Adobe Target that is designed for both typical web implementations and single-page applications.

AT.js は、mbox.js ライブラリと比較して、いくつかの点で改善されています。

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

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

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

chlimage_1-158

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

A4T Analytics クラウド設定の設定

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

これをおこなうには、Adobe Target クラウド設定を接続する A4T クラウド設定を指定する必要があります。

  1. Navigate to Cloud Services via the AEM logo > Tools > Deployment > Cloud Services.

  2. In the Adobe Target section, click Configure Now.

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

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

    メモ

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

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

    1. ツール / 一般 / ​CRXDE Liteに移動します。
    2. Navigate to /libs/cq/analytics/components/testandtargetpage/dialog/items/tabs/items/tab1_general/items/a4tAnalyticsConfig
    3. Set the property disable to false.
    4. すべて保存」をタップまたはクリックします。

    chlimage_1-159

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

手動での Adobe Target との統合

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

メモ

The Target Library file, AT.JS, is a new implementation library for Adobe Target that is designed for both typical web implementations and single-page applications. mbox.js の代わりに AT.js をクライアントライブラリとして使用することをお勧めします。
AT.js は、mbox.js ライブラリと比較して、いくつかの点で改善されています。

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

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

Target クラウド設定の作成

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

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

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

次の手順を実行して、AEM に Target クラウド設定を作成します。

  1. Navigate to Cloud Services via the AEM logo > Tools > Deployment > Cloud Services. (http://localhost:4502/libs/cq/core/content/tools/cloudservices.html)。

    The Adobe Marketing Cloud overview page opens.

  2. In the Adobe Target section, click Configure Now.

  3. In the Create Configuration dialog:

    1. Give the configuration a Title.
    2. Select the Adobe Target Configuration template.
    3. 作成」をクリックします。

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

    chlimage_1-160

    メモ

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

    1. ツール / 一般 / ​CRXDE Liteに移動します。
    2. Navigate to /libs/cq/analytics/components/testandtargetpage/dialog/items/tabs/items/tab1_general/items/a4tAnalyticsConfig
    3. Set the property disable to false.
    4. すべて保存」をタップまたはクリックします。
  4. ダイアログで、次のプロパティの値を入力します。

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

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

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

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

    • A4T Analytics クラウド設定:ターゲットアクティビティの目標と指標に使用する Analytics クラウド設定。これは、コンテンツをターゲット化するときに、Adobe Analytics をレポートソースとして使用している場合に必要です。If you do not see your cloud configuration, see note in Configuring A4T Analytics Cloud Configuration.

    • 正確なターゲット設定を使用:デフォルトでは、このチェックボックスはオンになっています。オンにすると、クラウドサービス設定はコンテンツが読み込まれるまでコンテキストの読み込みを待機します。続きのメモを確認してください。

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

    • クライアントライブラリ: mbox.jsまたはAT.jsクライアントライブラリのどちらにするかを選択します。

    • DTMを使用してクライアントライブラリを提供 - DTMまたは他のタグ管理システムのAT.jsまたはmbox.jsを使用する場合は、このオプションを選択します。 You must configure the DTM integration to use this option. ライブラリの配信には 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 はこのパラメーターを使用して、現在のコンテキストに該当するセグメントを判別します。

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

  1. On your Target configuration page, click the + (plus sign) next to Available Frameworks.

  2. In the Create Framework dialog, specify a Title, select the Adobe Target Framework, and click Create.

    chlimage_1-161

    フレームワークページが表示されます。Sidekick provides components that represent information from the Client Context or ContextHub that you can map.

    chlimage_1-162

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

    メモ

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

    For example, to use Profile Data about your site vistors to control your Target campaign, drag the Profile Data component to the page. Target パラメーターへのマッピングに使用できるプロファイルデータ変数が表示されます。

    chlimage_1-163

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

    chlimage_1-164

    メモ

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

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

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

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

メモ

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

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

追加のメモ: xt_only オプションは特定の Target テナント(clientcode)に適用される設定で、Adobe Target でのみ直接編集できます。このオプションは AEM で有効および無効にすることはできません。

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

AEM に Target フレームワークを作成したら、Web ページとフレームワークを関連付けます。この Web ページ上のターゲット化されたコンポーネントが、フレームワークで定義されたデータを追跡のために Adobe Target に送信します(コンテンツのターゲティングを参照)。

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

  1. In the Sites console, navigate to the site that you want to configure.

  2. Using either quick actions or selection mode, select View Properties.

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

  4. 編集」をタップまたはクリックします。

  5. クラウドサービス設定」で「設定を追加」をタップまたはクリックして「Adobe Target」を選択します。

    chlimage_1-165

  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 に設定することで、これを回避します。

このページ