Install

Requirements

The following items are required:

• An active Tealium iQ Tag Management account
• Your Tealium account ID
• Your Tealium profile name
• The Tealium environment to use (prod, qa, dev, or custom)

How it Works

The Tealium for Magento extension provides a robust implementation of minimal boilerplate code to implement and extend universal data objects (UDOs) across various page types. Leveraging Magento’s prescribed dependency injection and layout systems, the module simplifies the process of creating and extending UDOs.

The extension includes a simple script that scaffolds out boilerplate code when creating a new UDO. It allows you to specify any UDOs that it may extend and which pages of the site the new UDO should appear on. When finished, you will have a scaffolded template that needs to be filled in with any data-specific logic for your particular use case.

For more information about Magento, see Magento Documentation.

Install

The following prodecure uses commands for an Ubuntu server environment. For other server environments, adjust the commands accordingly.

To install Tealium in your Magneto system:

1. Enable maintenance mode: Enable maintenance mode before installing the extension to avoid any user issues. To enable maintenance mode, run the following command:

   php bin/magento maintenance:enable
   

2. Copy the Tealium folder: Copy the Tealium folder from GitHub to app/code/Tealium/Tags within your Magento folder. If app/code/Tealium/Tags doesn’t exist, create it.
3. Update changes: Run the following commands to update changes:

   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. Disable maintenance mode: After the installation is complete, disable maintenance mode to allow users to access the site. To disable maintenance mode, run the following command:

   php bin/magento maintenance:disable
   

Configure

To configure Magento 2, perform the following steps:

1. In the admin panel, go to Stores > Configuration > Tealium > Tag Management.
2. Enable the extension and enter your Tealium iQ account, profile, and environment.
3. If you are using a first-party domain, enter your client domain in the First Party Domain field.
4. To allow plaintext customer email addresses, select No under the Allow plain text customer email drop-down list. Otherwise, email addresses will be encrypted using a SHA-256 hash.

Tests

To test your Tealium and Magento configuration to ensure that they are working properly together, use the following tests:

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

Release Notes

3.2.0

• Optional FPD (First-Party Domain) configuration. For more information, see Manage First-Party Domains.
• Email Hashing: If set to Yes, SHA256() will be applied to email addresses in customer_email parameterss.
• Updated the csp_whitelist.xml file in the extension’s etc directory (public_html/integration-magento/etc).
• CSP (Content Security Policy) updates for Magento 2.4.6
• Bug fixes

3.1.0

• Update for support of Magento 2.4
• Add tracking for user-submitted product reviews
• Bug fixes

3.0.2

• Add support for Magento 2.3.3

3.0.1

• Add support for Magento 2.2.8, 2.3.0, and 2.3.1-2

2.0.0

• Updated composer.JSON
• Updated readme
• Releasing all previous commits

1.0.1

• Default UDO (utag_data JSON object in page source) deployed via Magento Extension to match Tealium iQ TMS Data Layer bundle
• Configure account info in admin panel Extend and customize UDOs