Hybris統合

前提条件

• Tag Managementアカウント。
• B2C Commerce Acceleratorを含む、展開およびビルド済みのhybris v5.0.1以降。

定義

• Universal Data Object（UDO）＝キーと値のペアで構成されるデータレイヤーオブジェクト。
  このオブジェクトは、グローバルJavaScriptオブジェクトutag_dataとしてページ内に生成されます。Tealiumのutag.jsは、タグのベースデータレイヤーとしてutag_dataを使用します。
• Tealiumアカウント＝Tag Managementの購入時に割り当てられたアカウント。
• Tealiumプロファイル＝Webサイトに対応する特定のWebプロパティ名。

アドオンのインストール

GitHubリポジトリ：https://github.com/Tealium/integration-hybris

1. tealiumiqaddonディレクトリを${HYBRIS_BIN}/customに配置します。このディレクトリは、リポジトリ内の/hybris/bin/custom/フォルダーにあります。
2. <extension dir="${HYBRIS_BIN}/custom/tealiumiqaddon"/\>をconfig/localextensions.xmlに追加します。
3. 次のコマンドを使用して、tealiumiqaddonをyacceleratorstorefrontに追加します。

• sudo ant addoninstall -Daddonnames="tealiumiqaddon"
• DaddonStorefront.yacceleratorstorefront="yacceleratorstorefront"

1. 次のファイルを更新します。

• ${HYBRIS_BIN\}/ext-template/yacceleratorstorefront/web/webroot/WEB-INF/tags/desktop/template/master.tagでは、次の内容を追加します。
  ファイルの先頭に<%@ taglib prefix=“tealiumiqaddon” tagdir="/WEB-INF/tags/addons/tealiumiqaddon/shared/analytics" %>
  <head>タグの後に<tealiumiqaddon:sync/>
  <body>タグの後に<tealiumiqaddon:tealium/>
• ${HYBRIS_BIN}/custom/tealiumiqaddon/project.properties.templateでは、次の内容を変更します。
  tealiumiqaddon.account、tealiumiqaddon.profile、tealiumiqaddon.targetを、Tag Managementアカウント固有の情報に変更します。
  HTMLページの<head>にutag.sync.jsを挿入する場合は、tealiumiqaddon.utagSyncEnabled = 1に変更します。この機能は任意であり、デフォルトでは無効になっています。

カスタムデータの追加

デフォルトでは、このアドオンは標準的なEコマース変数の包括的なリストを提供します。これらのデフォルト値がインストール環境に十分でない場合は、デフォルトのページタイプを拡張したり、新しいカスタムページタイプを作成したりできます。

1. インターフェイスcom.tealium.dataconnector.hybris.HybrisDataConverter.HybrisCustomDataConverterを実装する新しいクラスを作成し、インターフェイスのすべてのメソッドを実装します。

package com.tealium.dataconnector.hybris;
import com.tealium.dataconnector.hybris.HybrisDataConverter.HybrisCustomDataConverter;
import com.tealium.dataconnector.hybris.HybrisDataConverter.HybrisCustomPageTypeCustomData;
import com.tealium.util.udohelpers.UDO;
import com.tealium.util.udohelpers.exceptions.UDOUpdateException;
public class TealiumCustomData implements HybrisCustomDataConverter {
	// ... add unimplemented methods of interface.
}

1. インターフェイスのいずれのメソッドにも値を追加しない場合は、必ずudoオブジェクトを返してください。

@Override
public UDO homePage(UDO udo) {
	return udo;
}

1. デフォルトページの値を追加または変更するには、そのページのオーバーライドメソッドに処理を追加します。

@Override
public UDO searchPage(UDO udo) {
	try {
		udo.setValue("page_name", "new search page name");
		udo.setValue("custom_key", "custom_value");
		} catch (UDOUpdateException e) {
			e.printStackTrace();
	    }
		return udo;
	 }

1. 値を含む新しいページタイプを追加するには、クラスに静的変数を追加し、addCustomPagesメソッドに新しいページを追加します。

public class TealiumCustomData implements HybrisCustomDataConverter {
private static Map<String, HybrisCustomPageTypeCustomData> customPagesMap;
@Override
public Map<String, HybrisCustomPageTypeCustomData> getHybrisCustomPageTypes() {
	return customPagesMap;
}
//... other methods
@Override
public void addCustomPages() {
	if (customPagesMap == null){
	    customPagesMap = new HashMap<>();
	}
		customPagesMap.put("custom_one", new HybrisCustomPageTypeCustomData(){
	@Override
	public UDO getCustomDataUdo(UDO udo) {
		try {
		     udo.setValue("page_name", "custom page 1");
		     udo.setValue("custom_page1_key", "custom value");
		    } catch (UDOUpdateException e) {
			e.printStackTrace();
		    }
		    return udo;
	        }
	});
	customPagesMap.put("custom_two", new HybrisCustomPageTypeCustomData(){
	@Override
	public UDO getCustomDataUdo(UDO udo) {
		try {
			udo.setValue("page_name", "custom page 2");
			udo.setValue("custom_page2_key", "custom value");
		    } catch (UDOUpdateException e) {
			e.printStackTrace();
		    }
		return udo;
		}
	});
	}
}

1. 次のファイルを変更します。
   ${HYBRIS_BIN\}/custom/tealiumiqaddonweb/webroot/WEB-INF/tags/addons/tealiumiqaddon/shared/analytics/data.tag

• CLASS_NAMEをクラス名（例：TealiumCustomData）に置き換えます。
• 新しいクラスを追加します：<%@ tag import=“com.tealium.dataconnector.hybris. CLASS_NAME “%>
• 新しいクラスをHybrisDataConverterに登録します：<%HybrisDataConverter.registerCustomDataClass(“ID”, new CLASS_NAME ()); %>

完了

hybrisを再ビルドして再起動します。

• sudo ant all
• sudo ./hybrisserver.sh

デフォルトのデータソース

すべてのページ

検索ページ

カテゴリページ

商品ページ

カートページ

注文確認

顧客情報ページ