at.js 2.0 を使用したAdobe Targetのシングルページアプリケーション (SPA) への実装

Adobe Targetの at.js 2.0 は、次世代のクライアント側テクノロジーでパーソナライゼーションを実行するための機能セットを提供します。 このバージョンでは、単一ページアプリケーション (SPA) と調和したインタラクションを実現するために、at.js のアップグレードに焦点を当てています。

SPAで at.js 2.0 を実装する方法

  • シングルページアプリケーションの <head> に at.js 2.0 を実装します。
  • SPAでビューが変更された場合は常に、 adobe.target.triggerView() 関数を実装します。 これをおこなうには、URL ハッシュの変更のリッスン、SPAで発生したカスタムイベントのリッスン、triggerView() コードを直接アプリケーションに埋め込むなど、様々な方法を使用できます。 特定の単一ページアプリケーションに最適なオプションを選択する必要があります。
  • ビュー名は、triggerView() 関数の最初のパラメータです。 シンプルで明確で一意の名前を使用して、Target の Visual Experience Composer で簡単に選択できるようにします。
  • トリガービューは、小さなビューの変更に加えて、SPA以外のコンテキスト(無限にスクロールするページの半分下など)でも表示できます。
  • at.js 2.0 および triggerView() は、Adobe Experience Platform Launchなどのタグ管理ソリューションを介して実装できます。

at.js 2.0 の制限

アップグレードする前に、at.js 2.0 に関する次の制限事項に注意してください。

  • at.js 2.0 では、クロスドメイントラッキングはサポートされていません
  • mboxOverride.browserIp および mboxSession URL パラメーターは、at.js 2.0 ではサポートされていません
  • at.js 2.0 では、従来の関数 mboxCreate、mboxDefine、mboxUpdate が廃止されました。デフォルトのコンテンツが表示され、ネットワークリクエストはおこなわれません。

ビデオで使用されるライブラリのフッターコード

以下のコードは、ビデオの実行中に at.js ライブラリの「ライブラリフッター」セクションに追加されました。 アプリが最初に読み込まれ、次にアプリ内のハッシュの変更時に実行されます。 ビュー名にはハッシュのクリーンアップバージョンが使用され、ハッシュが空の場合は「home」が使用されます。 SPAを識別するために、コードは URL 内で「react/」というテキストを探します。このテキストは、サイト上で更新する必要がある可能性が高くなります。 また、SPAでカスタムイベントから triggerView() を実行したり、コードを直接アプリに埋め込んだりする方が適している場合もあることに注意してください。

function sanitizeViewName(viewName) {
  if (viewName.startsWith('#')) {
    viewName = viewName.substr(1);
  }
  if (viewName.startsWith('/')) {
    viewName = viewName.substr(1);
  }
  return viewName;
}
function triggerView(viewName) {
  viewName = sanitizeViewName(viewName) || 'home';
  // Validate if the Target Libraries are available on your website
  if (typeof adobe != 'undefined' && adobe.target && typeof adobe.target.triggerView === 'function') {
    adobe.target.triggerView(viewName);
    console.log('AT: View triggered on page load: '+viewName)
  }
}
//fire triggerView when the SPA loads and when the hash changes in the SPA
if(window.location.pathname.indexOf('react/') >-1){
    triggerView(location.hash);
}
window.onhashchange = function() {
    if(window.location.pathname.indexOf('react/') >-1){
        triggerView(location.hash);
    }
}

その他のリソース

このページ