Show Menu
トピック×

Adobe Target v2 拡張機能

このリファレンスは、この拡張機能を使用してルールを作成するときに使用できるオプションに関する情報です。

Adobe Target v2 拡張機能の設定

Adobe Target 拡張機能には At.js 2.x が必要です。
Adobe Target 拡張機能がまだインストールされていない場合は、プロパティを開いてから「 Extensions > Catalog 」をクリックし、Adobe Target 拡張機能にカーソルを置いて「 Install 」をクリックします。
拡張機能を設定するには、「Extensions」タブを開き、「 Configure 」をクリックします。

at.js の設定

タイムアウトを除く at.js 設定はすべて、Target ユーザーインターフェイスで at.js 設定から自動的に取得されます。拡張機能は、最初に追加されたときに Target にユーザーインターフェイスから設定を取得するだけです。追加の更新が必要な場合は、すべての設定を Launch インターフェイスで管理する必要があります。
以下の設定オプションを使用できます。

Client Code

クライアントコードは Target のアカウント識別子です。このコードはほとんど常にデフォルト値のまま使用されます。
データ要素を使用して変更できます。

Organization ID

この ID は、実装を Adobe Experience Cloud アカウントと結び付けます。このコードはほとんど常にデフォルト値のまま使用されます。
データ要素を使用して変更できます。

Server Domain

Target リクエストが送信されるドメイン。このコードはほとんど常にデフォルト値のまま使用されます。

GDPR Opt-In

有効にすると、Adobe Target はオプトイン機能を提供して同意の管理戦略をサポートします。オプトイン機能を使用すると、Target タグを実行する方法とタイミングを制御できます。アドビのオプトインについて詳しくは、「 プライバシーと EU 一般データ保護規則(GDPR) 」を参照してください。

Timeout (ms)

定義された期間内に Target からの受信されなかった場合、リクエストはタイムアウトし、デフォルトコンテンツが表示されます。訪問者のセッション中、追加のリクエストが引き続き試行されます。デフォルト値は「3000ms」です(Target ユーザーインターフェイスで設定されているタイムアウトとは異なる可能性があります)。
タイムアウトの設定の仕組みについて詳しくは、 Adobe Target ヘルプ を参照してください。

Target 拡張機能のアクションタイプ

ここでは、Target 拡張機能で使用できるアクションタイプについて説明します。
Target 拡張機能は、ルールの「Then」部分に次のアクションを提供します。

Load Target

Launch ルールのコンテキストで Target を読み込むと効果的な場合、 ルールにこのアクションを追加します。これにより、at.js ライブラリがページに読み込まれます。ほとんどの実装では、サイトの各ページに Target を読み込む必要があります。
設定は不要です。

Add Params to All Requests

すべての Target リクエストにパラメーターを追加します。これより前に、Load Target アクションを使用する必要があります。
  1. 追加するパラメーターの名前と値を指定します。
  2. パラメーターを追加するには、追加アイコンをクリックします。

Add Params to Page Load Request

ページ読み込みリクエストにのみパラメーターを追加します。これより前に、Load Target アクションを使用する必要があります。
  1. 追加するパラメーターの名前と値を指定します。
  2. パラメーターを追加するには、追加アイコンをクリックします。

Fire Page Load Request

ページの読み込み時に Target リクエストを実行します。これより前に、Load Target アクションを使用する必要があります。
ちらつきを防ぐために本分の非表示を有効にするかどうか、および body 要素を非表示にするときに使用するスタイルを指定します。
以下のオプションがあります。
  • Body Hiding: ​この設定を有効または無効にすることができます。デフォルト値は false です。この場合、HTML BODY は非表示にはなります。
  • Body Hidden Style: ​デフォルトの値は「body」です。この値は body など他の値に変更することもできます。
詳しくは、 Target のオンラインヘルプドキュメント を参照してください。

Trigger View

単一ページアプリケーションのビューをトリガーします。
  1. トリガーするビューの名前を指定します。
  2. 「Page」チェックボックスをオンにして、ビューのトリガーをレポートのインプレッションに含めるかどうかを指定します。再レンダリングされ、レポートのインプレッションに属していないコンポーネントとビューが相関関係にある場合は、「Page」チェックボックスをオフにしたままにします。
ビューのトリガーについて詳しくは、 triggerView() を参照してください。

Adobe Target の基本的なデプロイメント

Target 拡張機能がインストールされたら、1 つ以上のルールを作成して適切にデプロイします。最初に、Target ライブラリ(at.js)を読み込み、ページ読み込みリクエストで使用するパラメーターを指定してから、ページ読み込みリクエストを実行します。
この基本的な実装を含む Target ルールは次のようになります。
このルールを保存したら、動作をテストできるよう、ライブラリに追加してビルド/デプロイします。

非同期デプロイメントを使用した Adobe Target 拡張機能

Launch は非同期でデプロイできます。Target を使用して Launch ライブラリを非同期で読み込む場合、Target も非同期で読み込まれます。これは完全にサポートされているシナリオですが、処理が必要な追加の検討事項が 1 つあります。
非同期デプロイメントでは、Target ライブラリが完全に読み込まれてコンテンツの入れ替えが実行される前に、ページがデフォルトコンテンツのレンダリングを終了する可能性があります。これにより、Target で指定し、パーソナライズされたコンテンツに置き換えられる前に、デフォルトのコンテンツが短時間表示される、「ちらつき」と呼ばれる現象が発生することがあります。コンテンツのちらつきを回避するには、事前非表示のスニペットを使用して、Launch バンドルを非同期で読み込むことをお勧めします。
事前非表示のスニペットを使用する際には、次の点に注意してください。
  • Launch ヘッダー埋め込みコードを読み込むには、スニペットを追加する必要があります。
  • このコードは Launch では管理できないので、直接ページに追加する必要があります。
  • ページは、次のイベントのうち最も早いタイミングで表示されます。
    • ページ読み込み応答を受信したとき
    • ページ読み込みリクエストがタイムアウトしたとき
    • スニペット自体がタイムアウトしたとき
  • 事前非表示の時間を最小限に抑えるために、「Fire Page Load Request」アクションは、事前非表示スニペットを使用するすべてのページで使用する必要があります。
  • Launch で Target に使用するページ読み込みルールのページ読み込みリクエストアクションでも、本文の非表示を有効にする必要があります。そうしないと、すべてのページ読み込みがタイムアウト期間中非表示のままになります。
事前非表示スニペットの例を次に示します。これらは縮小できます。設定可能なオプションは最後にあります。
;(function(win, doc, style, timeout) {
  var STYLE_ID = 'at-body-style';

  function getParent() {
    return doc.getElementsByTagName('head')[0];
  }

  function addStyle(parent, id, def) {
    if (!parent) {
      return;
    }

    var style = doc.createElement('style');
    style.id = id;
    style.innerHTML = def;
    parent.appendChild(style);
  }

  function removeStyle(parent, id) {
    if (!parent) {
      return;
    }

    var style = doc.getElementById(id);

    if (!style) {
      return;
    }

    parent.removeChild(style);
  }

  addStyle(getParent(), STYLE_ID, style);
  setTimeout(function() {
    removeStyle(getParent(), STYLE_ID);
  }, timeout);
}(window, document, "body {opacity: 0 !important}", 3000));

デフォルトでは、このスニペットによって HTML BODY 全体が事前に非表示になります。ページ全体ではなく、特定の HTML 要素のみを事前に非表示したい場合もあります。その場合はスタイルのパラメーターをカスタマイズします。ページ内の特定の領域のみを事前に非表示にするよう置き換えることができます。
例えば、container-1 と container-2 という ID で識別される 2 つのセクションがある場合は、次のスタイルに置き換えることができます。
#container-1, #container-2 {opacity: 0 !important}

デフォルトの代わりに次を使用します。
body {opacity: 0 !important}

デフォルトでは、スニペットは 3000 ミリ秒または 3秒でタイムアウトします。この値はカスタマイズできます。