インストール

必要条件

以下の項目が必要です：

• アクティブなTealium iQタグ管理アカウント
• あなたのTealiumアカウントID
• あなたのTealiumプロファイル名
• 使用するTealium環境（prod、qa、dev、またはカスタム）

仕組み

Tealium for Magento拡張機能は、さまざまなページタイプでユニバーサルデータオブジェクト（UDOs）を実装し、拡張するための最小限のボイラープレートコードの堅牢な実装を提供します。 Magentoの推奨される依存性注入とレイアウトシステムを活用して、モジュールはUDOsの作成と拡張を簡素化します。

拡張機能には、新しいUDOを作成するときにボイラープレートコードをスキャフォールド化するシンプルなスクリプトが含まれています。 これにより、新しいUDOが拡張する可能性のあるUDOを指定し、新しいUDOが表示されるサイトのページを指定できます。 完了すると、特定のユースケースのデータ固有のロジックで埋める必要があるスキャフォールド化されたテンプレートが作成されます。

Magentoについての詳細情報は、Magento Documentationを参照してください。

インストール

以下の手順はUbuntuサーバー環境のコマンドを使用します。他のサーバー環境の場合は、コマンドを適宜調整してください。

あなたのMagnetoシステムにTealiumをインストールするには：

1. メンテナンスモードを有効にする：拡張機能をインストールする前にメンテナンスモードを有効にし、ユーザーの問題を避けます。 メンテナンスモードを有効にするには、次のコマンドを実行します：

   php bin/magento maintenance:enable
   

2. Tealiumフォルダをコピーする：GitHubからTealiumフォルダをapp/code/Tealium/Tagsにコピーします。 app/code/Tealium/Tagsが存在しない場合は、それを作成します。
3. 変更を更新する：次のコマンドを実行して変更を更新します：

   php bin/magento setup:upgrade
   php bin/magento setup:di:compile
   php bin/magento setup:static-content:deploy -f
   php bin/magento cache:flush
   

4. メンテナンスモードを無効にする：インストールが完了したら、ユーザーがサイトにアクセスできるようにメンテナンスモードを無効にします。 メンテナンスモードを無効にするには、次のコマンドを実行します：

   php bin/magento maintenance:disable
   

構成

Magento 2を構成するには、次の手順を実行します：

1. 管理パネルで、Stores > Configuration > Tealium > Tag Managementに移動します。
2. 拡張機能を有効にし、Tealium iQアカウント、プロファイル、環境を入力します。
3. ファーストパーティドメインを使用している場合は、First Party Domainフィールドにクライアントドメインを入力します。
4. 平文の顧客メールアドレスを許可するには、Allow plain text customer emailドロップダウンリストでNoを選択します。 それ以外の場合、メールアドレスはSHA-256ハッシュを使用して暗号化されます。

テスト

TealiumとMagentoの構成が正しく連携して動作していることを確認するために、次のテストを使用します：

• Code Sniffer
• Installation and Varnish Tests
• MFTF Commerce-supplied Tests

リリースノート

3.2.0

• 任意のFPD（First-Party Domain）構成。詳細については、Manage First-Party Domainsを参照してください。
• メールハッシング：Yesに構成すると、customer_emailパラメータのメールアドレスにSHA256()が適用されます。
• 拡張機能のetcディレクトリ（public_html/integration-magento/etc）のcsp_whitelist.xmlファイルを更新しました。
• Magento 2.4.6のCSP（Content Security Policy）の更新
• バグ修正

3.1.0

• Magento 2.4のサポートの更新
• ユーザーが提出した製品レビューの追跡を追加
• バグ修正

3.0.2

• Magento 2.3.3のサポートを追加

3.0.1

• Magento 2.2.8、2.3.0、および2.3.1-2のサポートを追加

2.0.0

• composer.JSONを更新
• readmeを更新
• すべての以前のコミットをリリース

1.0.1

• Magento拡張機能を介してデプロイされるデフォルトのUDO（ページソースのutag_data JSONオブジェクト）は、Tealium iQ TMS Data Layerバンドルと一致します
• 管理パネルでアカウント情報を構成します
• UDOを拡張し、カスタマイズします