How to solve compatibility issues - Google Tag Manager Enhanced Ecommerce

If you successfully followed all installation instructions but notice that extension is breaking your product grid or some user actions are not tracked correctly (ex: product view, add to cart, checkout, ..) most probably issues come from compatibility with the custom theme or 3rd party extensions that are installed on your store and probably alters default Magento functionality for that particular sections. We only guarantee full compatibility of our extensions with default Magento behaviour and our magento 2 Theme Pearl as it's impossible to know how each vendor change default Magento code in their products and the quality of their code.

Solution: 

Yes, we have a solution for you.  If you are using a custom template and experiencing a conflict, most probably (95% of the cases) the fix presented below will solve your problem. 

If you have a customized theme, not our Pearl theme or the default Magento theme, you might need to do the following adjustments if the product listing is customized in your theme, in order to not break your product listing pages and to fully benefit of our GTM tracking implementation.

As in the displayed screenshot comment out the highlighted area ( this contains the changed product listing from our module, located in WeltPixel/GoogleTagManager/view/frontend/layout/default.xml ). After this in your custom listing template add the following line inside the <a> tag for the displayed image:

<?php echo $this->helper('WeltPixel\GoogleTagManager\Helper\Data')->addProductClick($_product, $iterator-1); ?>

Instead of the origin Magento code:
<?php // Product Image ?>
<a href="<?php /* @escapeNotVerified */ echo $_product->getProductUrl() ?>" class="product photo product-item-photo" tabindex="-1">
<?php echo $productImage->toHtml(); ?>
</a>

it would be:

<?php // Product Image ?>
<a <?php echo $this->helper('WeltPixel\GoogleTagManager\Helper\Data')>addProductClick($_product, $iterator-1); ?> href="<?php /* @escapeNotVerified */ echo $_product>getProductUrl() ?>" class="product photo product-item-photo" tabindex="-1">
<?php echo $productImage->toHtml(); ?>
</a>

If the fix doesn't work or you don't manage to implement it properly you can consider our custom development services. We can implement above fix for you in 1 hour of custom development. (please do not ask for more detailed conflict solving instructions over email as it takes more time to verify/explain/re-verify than actually do it). For other more complicated types of conflicts debugging time is estimated 2-4 hours, if the conflict cannot be fixed in this time we'll let you know the additional time needed.

Example of category page conflict solving:

Issue:

" I recently downloaded and installed your GTM extension for M2. I have noticed, since installing it, its make over-rides to my product grid look. Can you help fixing this conflict?"

Solution:

"These 2 files were modified:

/mnt/data/home/master/applications/magento/public_html/app/design/frontend/Infortis/ultimo/Magento_Catalog/templates/product/list.phtml
/mnt/data/home/master/applications/magento/public_html/app/code/WeltPixel/GoogleTagManager/view/frontend/layout/default.xml

In the first one we removed the category product listing template rewrite, our GoogleTagManager module also rewrites the by default the listing template
In the second one, which is used for the current product listing template, we added the product click GTM tracking code snippet, which was originally introduced in our rewritten template."

Note: At this moment we do not have a conflict free "out of the box" solution for the themes that customize category layout. We are investigating potential solutions, any suggestions from you guys are welcomed.

-------- 

If you are not too advanced with your current project, you can take a look at our integrated solution. It may be more cost / time efficient to use it:

Take a look at Pearl Theme that already includes Google Tag Manager , Quick View, Banner Slider, Instagram Widget and 10 other extensions that are already provided with the theme and fully compatible. We created this solution in order for the users to be able to focus on store development instead of compatibility issues. Maybe it's a good alternative for you. https://www.weltpixel.com/magento-2-theme-pearl

If we can help with any of the above feel free to contact us!

--------