yii2-google-tag-manager's Introduction

Google Tag Manager extension for the Yii2 framework

Integration Google Tag Manager in your application

Installation

The preferred way to install this extension is through composer.

Either run

php composer.phar require --prefer-dist ezoterik/yii2-google-tag-manager "*"

or add

"ezoterik/yii2-google-tag-manager": "*"

to the require section of your composer.json file.

Setup

Add this code in your @app/config/main.php config file with the other previous config:

'bootstrap' => ['googleTagManager'],
'components' => [
    'googleTagManager' => [
        'class' => 'ezoterik\googleTagManager\GoogleTagManager',
        'tagManagerId' => 'GOOGLE_TAG_MANAGER_ID', //Your Google Tag Manager ID without "GTM-" prefix
    ],
],

Usage

You can generate events:

Yii::$app->googleTagManager->dataLayerPushItemDelay('event', 'example_event');

Or push event as object:

Yii::$app->googleTagManager->dataLayerPushItem(null, (object)[
    'event' => 'view_item',
    'ecommerce' => (object)[
        'currency' => 'UAH',
        'value' => '500',
        'items' => [
            (object)[
                'item_name' => 'Product name',
                'item_id' => '12345',
                'price' => '500',
                'item_brand' => 'Analytics',
                'item_category' => 'Very Good Category',
                'item_category2' => 'Very Good Category 2',
                'item_category3' => 'Very Good Category 3',
                'item_category4' => 'Very Good Category 4',
                'item_variant' => 'full',
                'item_list_name' => 'sales',
                'item_list_id' => 'sales2022',
            ],
        ],
    ],
]);

yii2-google-tag-manager's People

Contributors

Stargazers

Watchers

yii2-google-tag-manager's Issues

Example addToCart

Hi, thank's for this work. I'm trying to use this extension, for my first ecommerce. I can't find any example so can you tell me if this is the right way? Thank's

            $productAddToCartArray = array (
                'name'      => $ass->nome,
                'id'        => $ass->id,
                'price'     => number_format($this->prezzo,2,'.',''),
                'brand'     => $ass->vet->name,
                'category'  => $ass->mainCategoria,
                'variant'   => $variant,
                'quantity'  => $this->qta,
            );
            $ecommerceObject = array(
                'event'     => 'addToCart',
                'ecommerce' => array(
                    'currencyCode'  => 'EUR',
                    'add'           => array(
                        'products'  => $productAddToCartArray,
                    )
                ),
            );
            \Yii::$app->googleTagManager->dataLayerPushItem('addToCart', $ecommerceObject);